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.