Token Dispenser System

Android application developed in Java for controlling and managing Token Dispenser and Queue Display systems through an ESP32-based controller over Wi-Fi.

---

Overview

Token Dispenser System is designed to automate customer queue management in banks, hospitals, government offices, service centers, retail counters, and public waiting areas.

The application allows operators to generate tokens, manage queue flow, update display information in real time, and synchronize data with ESP32-powered display boards.

The system improves customer experience by providing organized queue handling and real-time token display management.

---

Features

Token Generation

• Generate customer tokens instantly
• Automatic token sequencing
• Queue number management
• Real-time token updates

Queue Management

• Current token display
• Next token management
• Queue flow control
• Live status updates

Display Management

• Real-time display synchronization
• Dynamic display content updates
• Queue information display
• Instant content refresh

Device Connectivity

• ESP32 connection monitoring
• Wi-Fi connectivity verification
• Network status monitoring

Real-Time Communication

• HTTP communication with ESP32
• Fast and reliable data transfer
• Instant display updates

Local Data Persistence

• SharedPreferences integration
• Automatic data restoration
• Persistent configuration storage

User Authentication

• Secure login functionality
• Authorized access control

---

Technology Stack

Frontend

• Android XML Layouts
• Material Design Components

Backend Logic

• Java

Networking

• OkHttp / HTTP Communication

Local Storage

• SharedPreferences

Device Communication

• ESP32 Wi-Fi Controller

---

Project Structure

app/
├── src/main/java
│   ├── LoginActivity.java
│   ├── MainActivity.java
│   ├── SettingsActivity.java
│   └── Utility Classes
│
├── src/main/res
│   ├── layout
│   ├── drawable
│   ├── values
│   └── mipmap
│
├── AndroidManifest.xml
└── build.gradle.kts

---

Requirements

• Android Studio
• Android SDK 24+
• Java 8+
• ESP32 Device
• Wi-Fi Network

---

Installation

Clone Repository

git clone <repository-url>

Open Project

1. Open Android Studio
2. Select Open Existing Project
3. Choose the project folder

Build Project

./gradlew build

Run Application

1. Connect an Android device or emulator
2. Click Run in Android Studio

---

Usage

Step 1

Launch the application.

Step 2

Login using authorized credentials.

Step 3

Connect to the ESP32 Wi-Fi network.

Step 4

Verify device connectivity status.

Step 5

Generate or update queue tokens.

Step 6

Send token information to the display controller.

Step 7

Verify updates on the connected queue display.

Step 8

Continue managing customer flow through real-time token updates.

---

Permissions Used

• INTERNET
• ACCESS_NETWORK_STATE
• ACCESS_WIFI_STATE

---

Key Functionalities

• Token generation
• Queue management
• Real-time display updates
• ESP32 communication
• Wi-Fi connectivity monitoring
• Local data persistence
• User authentication

---

Use Cases

• Bank Token Systems
• Hospital Queue Management
• Service Centers
• Government Offices
• Customer Waiting Areas
• Public Queue Management Systems

---

Future Enhancements

• Voice token announcements
• Multi-counter support
• Cloud synchronization
• Remote monitoring dashboard
• Analytics and reporting
• Multi-branch deployment

---

Security Notes

• Store credentials securely.
• Avoid exposing production endpoints publicly.
• Use secure communication methods in production deployments.

---

Author

Developed for Token Dispenser and Queue Management System.