Skip to content

peephole5layer/smart_queue_system

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

📌 Smart Queue Management System

The Smart Queue Management System is a Spring Boot application designed to manage queues efficiently in real-time.
It allows users to generate tokens, get their estimated waiting time, and receive notifications when their turn is near.
Admins can monitor the queue, manage service counters, and optimize the flow of customers.


🚀 Features

  • ✅ User can generate a queue token (online or at kiosk).
  • ✅ Real-time queue updates and estimated waiting time.
  • ✅ Admin dashboard for managing counters and queues.
  • ✅ Notifications when the user’s turn is about to come.
  • ✅ Role-based authentication with JWT & Spring Security.
  • ✅ REST API support for integration with frontend or mobile app.

🛠️ Tech Stack

  • Backend: Spring Boot (REST APIs)
  • Security: Spring Security + JWT
  • Database: MySQL
  • Build Tool: Maven
  • Other: JPA/Hibernate, Lombok


⚙️ API Endpoints

👤 User APIs

  • POST /api/auth/register → Register new user
  • POST /api/auth/login → Login & get JWT token
  • POST /api/queue/token → Generate queue token
  • GET /api/queue/status/{tokenId} → Check token status

🛠️ Admin APIs

  • GET /api/admin/queue → Get all queues
  • PUT /api/admin/queue/next → Call next token
  • POST /api/admin/counter → Add new service counter

🔄 System Flow

flowchart TD

A[User Arrives] --> B[Generate Token via API/Kiosk]
B --> C[Token Stored in DB]
C --> D[User Gets Estimated Waiting Time]
D --> E[Admin Dashboard Monitors Queue]
E --> F[Admin Calls Next Token]
F --> G[User Notified: It's Your Turn!]
G --> H[User Served and Token Closed]

Loading

About

an online system where users can take tokens for services (doctor, salon, etc.) and track their queue position in real time, while admins can manage the queue smoothly.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages