Poonggundraan S

clinic management

Currently, 76% of India’s 1.5 million independent health clinics rely on chaotic, outdated paper token systems and verbal shouting to manage patient flow. This creates severe operational bottlenecks where receptionists are forced to manage triage entirely from memory, leading to human error and skipped turns. Consequently, patients endure unpredictable 2–3 hour wait times in crowded lobbies with zero visibility into their queue status, degrading the patient experience and increasing the risk of cross-infection in waiting rooms. Process Architecture & Tech Stack: Node.js + Socket.io for zero-latency WebSocket syncing (outperforming standard polling), paired with Vanilla JS/HTML/CSS for a lightning-fast, lightweight frontend. State Management: A centralized server-side Single Source of Truth (clinicState) automatically handles concurrency and eliminates race conditions via strict, event-driven broadcasts. Edge Case Engineering: Designed for real human behavior with a "No-Show" bypass, dynamic Emergency wait-time reductions, and Browser Voice API announcements for distracted patients. UI/UX & Analytics: A premium SaaS interface featuring live Chart.js triage analytics, color-coded psychological proximity alerts, and a 1-click JSON data export for local clinic backups. Results Replaced a chaotic analog workflow with a deterministic, zero-latency WebSocket system. The receptionist dashboard successfully centralizes intake, providing instant visibility into the live clinic load via Chart.js triage analytics. On the patient side, the portal dynamically calculates projected consultation times and triggers automated AI-voice proximity alerts. The system successfully handles real-world edge cases without breaking chronological order, effectively eliminating lobby crowding and patient anxiety. Reflection For a true production environment, I would replace the in-memory JavaScript array (clinicState) with a persistent database like PostgreSQL or MongoDB to ensure queue data survives server restarts. I would also implement JWT authentication to secure the receptionist dashboard from unauthorized access. From a UX perspective, I would integrate a service like Twilio to send SMS notifications, allowing patients to confidently close their browser tabs while waiting. Finally, I'd add strict unit tests for the queue mathematics to guarantee stability during sudden traffic spikes.