# ZyQueue - Smart OPD & Clinic Queue Management SaaS

ZyQueue is a modern, commission-free, flat-rate Queue Management System (QMS) and patient appointment scheduling SaaS tailored for independent practices, outpatient clinics, and diagnostic labs in India. It serves as a premium, direct alternative to legacy platforms like Practo, HealthPlix, and Q-Up.

## Core Value Proposition
- **Commission-Free:** Flat monthly subscription of ₹799 (annual billing) or ₹999 (monthly billing) with unlimited patients, replacing per-booking commissions (which charge ₹100-200 per appointment on legacy platforms).
- **Patient Autonomy:** Patients scan a physical QR code at reception to self-check-in and track their live queue token position on their own mobile browsers.
- **Lobby Optimization:** Reduces waiting room crowding and receptionist phone call inquiries by up to 70%.

---

## Key Features & Capabilities

### 1. Smart TV Waiting Board & Voice Announcer
- **Visual Display:** High-contrast, responsive dashboard designed to run fullscreen on any Smart TV browser, secondary display, or tablet.
- **Bilingual Sequential Audio Announcer:** Automatically chimes and announces called tokens sequentially in both English and Hindi:
  - *English:* "Token number 5, please proceed to Dr. Roy in Cabin A."
  - *Hindi:* "टोकन नंबर पांच, कृपया केबिन ए में डॉक्टर रॉय से मिलें।"
  - Uses native synthesizers (e.g. Indian English female voices like Veena/Heera and native Hindi voices like Swara) for clear, natural pronunciation.

### 2. Reception Self Check-In QR Standee
- **Dynamic Check-In:** Walk-in patients scan the QR code standee, enter their registered WhatsApp number, and instantly mark themselves as arrived.
- **Atomic Token Assignment:** Automatically and atomically assigns sequential queue numbers upon check-in.

### 3. Patient Mobile Live Queue Tracker
- **Real-Time Position:** Patients track how many people are ahead of them and view dynamically calculated wait times (based on an average 15-minute consultation duration).
- **Zero App Downloads:** Works directly in standard mobile browsers (Safari, Chrome, etc.) to keep patient friction at zero.

### 4. Advanced Queue Management Console (Admin Panel)
- **Queue Actions:** Clinic staff can Call Next, Recall, Reset, or set states.
- **No-Show Handling:** Mark patients as absent, which automatically re-queues them at the end of the line, keeping the queue moving.
- **Emergency / VIP Override:** Manually prioritize any booking (e.g. emergencies) to place them as next-in-line (`current_serving_token + 1`), shifting subsequent slots down atomically.
- **On-Hold Status:** Temporarily place a patient slot on hold.

### 5. Automated WhatsApp Notification Engine
- **Instant Alerts:** Sends booking confirmations, live tracking links, check-in tokens, and pre-appointment reminders directly to patient WhatsApp numbers out of the box with zero custom setup.

### 6. Operations Analytics & ROI Dashboard
- **Operational Insights:** Displays average patient wait times, doctor consultation punctuality rates, peak clinic congestion hours, and overall patient completion statistics.
- **ROI Yield Calculator:** Quantifies staff hours saved, inquiry phone calls avoided, and revenue protected (averting patient leakage due to long wait times).

### 7. Basement-Proof Offline Resiliency (PWA Support)
- **Service Worker Caching:** Smart TV wait boards and self-check-in kiosks cache configurations. If the local internet drops in hospital basements, they remain interactive, show friendly offline/reconnecting banners, and resume real-time sync automatically when connection is restored.

---

## Technical Stack & Architecture
- **Frontend:** React, TypeScript, Vite, Tailwind CSS, Lucide Icons.
- **Backend/Database:** Supabase (PostgreSQL, Realtime replication subscriptions, Row Level Security, Secure SQL RPCs).
- **Offline Sync:** Service worker-based Progressive Web App (PWA) framework.

---

## Application URL Routes & Structure
- `/` - Marketing Landing Page (Public features, ROI Calculator, Pricing, FAQs)
- `/login` - Clinic Administrator & Doctor Login
- `/signup` - Clinic Registration & Onboarding
- `/book/:clinic_slug` - Public Clinic Patient Appointment Booking Form
- `/book/:clinic_slug/success` - Successful Appointment Receipt & Ticket Page
- `/queue/:clinic_slug` - Live Waiting Board TV Display Screen
- `/track/:appointment_id` - Patient Live Queue Mobile Tracker
- `/checkin/:clinic_slug` - Self Check-In Kiosk for Reception Lobbies
- `/dashboard/` - Private Admin Dashboard (Appointments, Doctors, Roster, Analytics, Settings)