📌 Smart Appointment & Queue Management System (MVP)

A modern full-stack scheduling and queue management platform for clinics, salons, and service businesses. Built with Next.js 14, Express.js, MongoDB, and Socket.io, this system allows customers to book appointments, staff to manage queues, and admins to control services and staff availability — all in real-time.

🚀 Tech Stack Frontend

Next.js 14 (App Router)

TailwindCSS + ShadCN UI

Axios

React Query/SWR (optional)

Backend

Node.js + Express.js

MongoDB + Mongoose

JWT Authentication (Access + Refresh tokens)

Socket.io (Real-time updates)

DevOps & Tools

Nodemon

Environment Variables (.env)

CORS + Morgan logging

Docker-ready structure (optional)

🧩 MVP Features (Month 1) 👤 Authentication

Customer, Staff, and Admin roles

JWT Access + Refresh Token login

Protected routes

💈 Booking System

View available services

Select staff member

Pick date & time slot

Real-time validation

Create, reschedule, and cancel appointments

🧑‍🔧 Staff Dashboard

View daily appointments

View and manage queue tokens

Start / Complete queue tasks

Toggle availability

📊 Admin Dashboard

Manage staff

Manage services

View all appointments

⏱️ Queue Management

Token generator

Real-time queue updates via Socket.io

Customer sees live position

Estimated waiting time