Skip to content

codinggita/queue_ease

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

8 Commits
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

queue_ease

πŸš€ Smart Queue Management System

A Smart Queue Management System is a full stack web application designed to digitize traditional queue systems used in places like hospitals, banks, government offices, and service centers.

The system allows users to book service tokens online, track their queue position, and reduce waiting time, while administrators can manage queues efficiently.


πŸ“Œ Problem Statement

In many service organizations such as hospitals, banks, and government offices, people often need to wait in long physical queues to access services.

This creates several problems:

  • ⏳ Long waiting times
  • πŸ‘₯ Overcrowded waiting areas
  • ❓ Lack of transparency about queue position
  • πŸ“‰ Inefficient service management

The Smart Queue Management System aims to solve these problems by providing a digital platform for online token booking and queue tracking.


πŸ’‘ Proposed Solution

This system provides a web-based queue management platform where users can:

  • Register and login
  • Book service tokens online
  • Track their queue position
  • View estimated waiting time
  • Cancel or manage tokens

Admins can monitor and manage the queue through a dashboard.


🎯 Project Objectives

  • Digitize traditional queue systems
  • Reduce waiting time
  • Improve service efficiency
  • Provide real-time queue tracking
  • Demonstrate full stack MERN development

πŸ›  Tech Stack

Frontend

  • ReactJS
  • Tailwind CSS
  • React Router

Backend

  • Node.js
  • Express.js

Database

  • MongoDB

βš™οΈ Core Features

πŸ‘€ Authentication System

  • Signup
  • Login
  • Logout
  • Password validation
  • Protected routes

🎫 Token Booking System

  • Book service tokens
  • Track token number
  • Cancel tokens

πŸ“Š Queue Tracking

  • Current token being served
  • User token number
  • Remaining queue count

πŸ”Ž Search, Filter & Sorting

  • Search tokens
  • Filter by service
  • Sort tokens by time

πŸ“„ Pagination

Pagination is implemented for large datasets such as token lists.

⚑ Debouncing

Search input uses debouncing to prevent excessive API calls.

πŸŒ™ Theme Support

  • Dark Mode
  • Light Mode
  • Theme stored in LocalStorage

πŸ” CRUD Operations

  • Create β†’ Book token
  • Read β†’ View tokens
  • Update β†’ Update token status
  • Delete β†’ Cancel token

πŸ”₯ Additional Innovative Features

  • ⏳ Estimated waiting time
  • πŸ”„ Live queue updates
  • πŸ“± QR code token system
  • πŸ“Š Admin analytics dashboard
  • πŸ₯ Multi-service queue support
  • ⭐ Priority queue support

πŸ“± Application Pages

  • Home Page
  • Signup Page
  • Login Page
  • Dashboard
  • Queue Status Page
  • Profile / Settings Page
  • Admin Dashboard

🧠 React Hooks Used

The project demonstrates usage of important React hooks:

  • useState
  • useEffect
  • useRef
  • useContext

πŸ”— Backend API Routes

Authentication

POST /api/auth/signup
POST /api/auth/login

Tokens

POST /api/token/book
GET /api/token
PUT /api/token/cancel/:id

Queue

GET /api/queue/status
GET /api/queue/current

Admin

GET /api/admin/tokens
PUT /api/admin/next-token


πŸ—„ Database Design

Users Collection

{ _id, name, email, password, role }

Services Collection

{ _id, serviceName, description }

Tokens Collection

{ _id, userId, serviceId, tokenNumber, status, createdAt }


πŸ“± Responsive Design

The UI is built using Tailwind CSS, ensuring responsiveness across:

  • Desktop
  • Tablet
  • Mobile devices

❗ Error Handling

Backend

  • Try-catch blocks
  • Proper HTTP status codes

Frontend

  • Error messages
  • Loading indicators
  • API error handling

πŸš€ Future Improvements

  • Real-time notifications
  • SMS alerts
  • AI-based waiting time prediction
  • Mobile app integration

πŸ† Benefits of the System

  • Reduces waiting time
  • Improves service efficiency
  • Enhances user experience
  • Provides transparent queue management

πŸ‘¨β€πŸ’» Developed For

Full Stack Hackathon Event

Using MERN Stack (MongoDB, Express.js, React.js, Node.js)

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors