QueueCure (Real-Time Smart Clinic Queue Management System)
Project Links
🌐 Live Demo: https://your-live-demo.vercel.app
💻 GitHub Repository: https://github.com/Tiku57/Queue-Cure
🎥 Demo Video: https://drive.google.com/file/d/1tupuAkVZfU5osTT5ZCUvRG6mMhQFKrSM/view?usp=sharing
QueueCure is a production-inspired, real-time clinic queue management platform designed to replace traditional paper-token systems used in neighbourhood clinics. It enables live queue tracking, predictive wait-time estimation, priority and emergency patient handling, QR-based patient tracking, and instant synchronisation across Receptionist, Doctor, Patient, and TV interfaces using Socket.IO.
Tech Stack: Next.js, React, TypeScript, Express.js, Node.js, MongoDB Atlas, Socket.IO, Tailwind CSS, Zustand, Shadcn UI, and Zod.
Key Engineering Highlights
Real-time synchronization across all connected screens using Socket.IO (no page refreshes).
Predictive wait-time engine based on recent consultation history instead of fixed estimates.
Atomic MongoDB operations to prevent race conditions during concurrent queue updates.
Priority & emergency queue handling for real-world clinical workflows.
Offline recovery using automatic REST polling when WebSocket connections are unavailable.
Scalable multi-clinic architecture using clinicId isolation and Socket.IO Rooms.
What to Review
Please evaluate:
Receptionist workflow (patient registration in under 10 seconds)
Live synchronization across Receptionist, Doctor, Patient, and TV screens
Dynamic wait-time calculation
Priority/Emergency queue management
Responsive UI across all devices
Real-time updates without page refreshes
Due to the platform's upload limitations, I couldn't attach the separate Thought Process PDF and Socket Event Diagram. Their contents—including system architecture, engineering decisions, concurrency handling, scalability strategy, wait-time algorithm, and implementation details—have been incorporated into the GitHub repository documentation and README.
17 media files · queue-cure-plum.vercel.appView