Clincos

Med Track

Clinic management platform built for independent doctors and small clinics in India. Handles appointments, live patient queue, billing with PDF receipts, patient records with document vault, WhatsApp notifications, income tracking, and subscription management — all from a single web app. No app download needed for patients.

**Live:** Deployed on Railway with PostgreSQL.

---

Table of Contents

• Features
• Tech Stack
• Architecture
• Project Structure
• Local Setup
• Environment Variables
• Database
• Queue System
• Billing Flow
• Notification System
• Subscription & Payments
• Multi-Doctor Clinic
• Security
• Public Booking
• Design System
• Mobile & Tablet
• Deployment
• API Reference
• Roadmap

---

Features

Appointments & Live Queue

• Live token queue — check in walk-ins, call next, serve, promote emergencies
• Queue state machine: Waiting → Serving → Billing Pending → Done, with a resumable On Hold branch
• Hold & Resume — park the patient being served (sent for an x-ray, lab work, or dressing) and auto-call the next patient so the doctor keeps moving. Resuming serves them immediately if the doctor is free, otherwise puts them at the front of the queue
• Walk-in quick booking with automatic check-in
• Returning patient detection — entering a known phone shows a Returning badge with visit count
• Slot-based scheduling with conflict prevention (no double booking)
• Create, edit, reschedule, and cancel appointments
• Appointment detail card overlay with full patient history
• Booking channel badges: Walk-in, Doctor, Patient, Reception
• Monthly calendar view with daily appointme