QFlow - Smart Queue Management System

A full-stack queue management app with AI-powered wait time predictions and real-time updates.

Features

• Customer Portal — Get tickets and track position in real-time
• Staff Panel — Manage counters and serve customers
• Admin Dashboard — View analytics and performance metrics
• AI Predictions — Wait time estimates based on historical data
• Live Display — Real-time queue display for waiting rooms

Tech Stack

• Frontend: React, React Router, Recharts, Socket.io-client
• Backend: Node.js, Express, JWT Authentication
• Database: MongoDB
• Real-time: Socket.io

Quick Start

# Backend
cd backend
npm install
cp .env.example .env
npm run seed
npm start

# Frontend (new terminal)
cd frontend
npm install
npm start

Open http://localhost:3000

Author

Ibrahim Al Shouli
Software Engineering Student — University of Doha for Science and Technology