The whole HMS,
on one page

The receptionist collects the patient's demographics, emergency contact, and insurance details. The system assigns a unique Patient ID.

• First name, last name, DOB, gender, phone, national ID
• Emergency contact name & phone
• Insurance provider & policy number (optional)
• Blood type (optional but recommended)

A Visit record is opened linking the patient to this encounter. Visit type is set — walk-in, outpatient, inpatient, or emergency.

• Visit type: OUTPATIENT · INPATIENT · EMERGENCY
• Chief complaint (free text)
• For appointments: check-in converts the appointment to a visit automatically
• Visit date & time recorded

The nurse records all vital signs and assigns a clinical priority. The patient moves from the waiting list into the sorted Priority Queue.

• BP (systolic/diastolic), heart rate, temperature, O2 sat, respiratory rate
• Weight, height, pain level (0–10)
• Priority: CRITICAL · URGENT · SEMI-URGENT · NON-URGENT
• Queue sorted by severity — critical patients always seen first

The doctor selects a patient from the queue and begins the consultation. SOAP notes are documented with ICD-10 coded diagnosis and a visit outcome is set.

• S — Chief complaint, History of Present Illness (LOCQOPAT)
• O — Physical examination findings across all systems
• A — Diagnosis with ICD-10 code
• P — Treatment plan; Outcome: DISCHARGED · ADMITTED · REFERRED · CONTINUE

Doctor orders tests from the catalog. Lab tech processes them, enters results with NORMAL/ABNORMAL/CRITICAL status, and marks them complete. Bill items are auto-generated.

• Doctor selects tests (CBC, Malaria RDT, Blood Glucose, Urinalysis, etc.)
• Lab tech: PENDING → PROCESSING → COMPLETED
• Result values, reference ranges, and files attached per test
• BillItem (LAB_TEST) auto-added to patient bill on completion

Doctor writes a multi-drug prescription. Pharmacist checks stock, dispenses medications, or flags issues. Bill items are auto-generated on dispense.

• Doctor: drug name, dosage, frequency, duration, instructions per item
• Pharmacist: Dispense (→ DISPENSED) or Flag (→ FLAGGED)
• FLAGGED prescriptions shown back to the doctor for revision
• BillItem (DRUG) auto-added to patient bill on dispense

If the doctor's outcome is ADMITTED, the receptionist assigns an available bed. Daily bed charges are tracked automatically.

• Bed types: Standard · ICU · High Dependency · Isolation
• Bed status updates to OCCUPIED on assignment
• BillItem (BED) calculated: daily_rate × number of days
• Bed returns to AVAILABLE when patient is discharged

The bill consolidates all charges — consultation, lab, drugs, bed, EMS. Receptionist records payments. The system checks discharge eligibility.

• Bill items: CONSULTATION · LAB_TEST · DRUG · BED · PROCEDURE · EMS
• Payment methods: CASH · CARD · M-PESA · INSURANCE
• Payments are immutable — only new transactions can be added
• System blocks discharge until all bills are PAID or WAIVED

Doctor sets the diagnosis outcome to DISCHARGED. All bills must be cleared. Inpatient bed assignment is closed. Patient record is preserved for future visits.

• All bills must be PAID or WAIVED before discharge
• If inpatient: bed discharged_at must be set
• Bed returns to AVAILABLE status
• Full encounter history retained on patient record