ClinicOS is a multi-tenant clinic management system for small Indian practices — built solo, one migration and one screen at a time. This page is the build log: the constraints, the trade-offs, and what finally shipped.
A folder per patient, smudged pages, a file cabinet that grows. Past visits get lost when a receptionist rotates out.
Pharmacists guess at dosages. Patients forget what was said. No digital record exists to reference next time.
Hand-written tokens, shouted names, angry relatives. No one in the waiting room knows how many people are ahead.
Carbon-copy receipt books, manual tallying at closing, disputes when a number doesn't match.
12 tables, RLS policies, Flyway baseline. No endpoint was written until the data model was provably correct.
Spring Security with a custom TenantContextFilter that extracts clinic_id from the JWT and sets the Postgres session variable before any query.
Registration number generator (P-00001 per clinic), full-text search on name/phone, duplicate detection on phone.
One FIFO per doctor. State machine: WAITING → CALLED → IN_CONSULTATION → COMPLETED. Waiting-room TVs subscribe to SSE and update in under a second.
Auto-save drafts every few seconds. Medicine autocomplete from a master list. Finalize cuts an Rx number from a DB sequence and renders a PDF.
Consultation fee + optional discount. Receipt number R-2026-NNNN issued on payment. Handoff is deliberate: doctor doesn't collect — the receptionist does.
Daily cash summary, top-diagnosis chart, clinic-level settings (doctors, services, working hours). Role-gated per RBAC matrix.
Fullscreen public view for the waiting room. No auth — just a clinic-scoped token. Large type, quiet animation, server-sent updates.
Backend Docker on Render. Frontend on Vercel. Supabase for Postgres + storage. Cold start budget accepted as a trade for the price tag.
Two-pane live workspace: left pane writes, right pane renders the PDF. Vitals inline, templates, doctor-profile letterhead overlay, atomic Rx numbering.
Every screen rebuilt against a tighter mockup set — TopBar, Sidebar, PageTransition, and every role-facing page. One consistent visual language, end-to-end.
Pulse-C logo with a live beating dot. Cosmo, a sidebar mascot that blinks on human cadence. Split-pane login with a tenant chip.
Split-pane login. Tenant chip bottom-left, app version bottom-right. One password for reception, doctor, and admin — RBAC decides the rest.
Reception staff log in from ₹8,000 Android tablets. The split pane stacks, the ID badge shrinks, nothing else changes.
Pulse-C mark with a 62-bpm heartbeat. Cosmo — our Saturday mascot — keeps the sidebar from feeling clinical.
Today's tokens, waits, collection, and tomorrow's appointments. Built for someone who just walked in, not someone who has an hour to onboard.
Search, paginate, register. Phone-number duplicate check runs server-side before a new patient row is ever written.
Name, phone, DOB or age, gender. Registration number (P-NNNNN) issued on save. ABHA optional.
Three visits over five months. Every past diagnosis, prescription, and receipt reachable in two clicks.
Empty state shows recent patients by default — the most common case. Typing filters against name, phone, or reg number.
Patient picked, doctor chosen, walk-in or appointment toggled. Token number assigned atomically when Issue is pressed.
Eight tokens across Waiting, Called, In Consultation, Completed. Reception manages the room; nobody shouts names.
No login. Big numbers, room IDs, called tokens pulsing. Any ₹8,000 Android TV does the job.
Left: the line. Right: the selected patient's vitals, last visit, and open consultation button. One keyboard flow.
Editable vitals up top, empty medicine list, live preview on the right. Zero modal dialogs; everything is inline.
Medicine search with composition + strength autocomplete. 1-0-1 dosage shorthand. Right pane updates on every keystroke.
OpenPDF output, A5, clinic letterhead margin-aware. Rx number (RX-DEMOCLI-2026-NNNNNN) issued atomically from a DB sequence.
Pending payments sit here until reception collects. Doctor is never on the money side — that was a deliberate design choice.
The receipt number is the same on screen, on print, and in the database. No drift, no disputes.
Today's collection, pending dues, bill count. Staff performance and revenue trends live behind the same screen.
A single SVG path. Beats once per second with a secondary echo ring. Respects prefers-reduced-motion.
Hover to wiggle. The waiting-room face of the app — why this was built on a Saturday.