Patients & Encounters¶
The clinical core: register patients, open encounters (visits), book appointments, capture consent, and watch clinical alerts. Everything else in the hospital hangs off a patient and an encounter.
Screenshot: Medical dashboard — TODO
The Medical Overview (/medical/dashboard) shows active patients, encounters, today's
appointments, and available providers.
Patients¶
Medical → Patients (/medical/patients) — register and maintain patients: given/family name,
gender, date of birth, blood group, national ID, address, and emergency contact. Status is Active,
Inactive, or Deceased.
Screenshot: Patient registration — TODO
Scan card — the National ID and National Health ID (HIB) fields each have a small camera-scan
button next to them. Click it to open a QR scanner and point the camera at the card; the scanned value
fills the field automatically (it reads a JSON payload, a Key: value line, or plain text off the
card). Typing the value in by hand always works too — the scan button is an optional shortcut, not a
requirement.
Registration photo — an optional "Capture photo" button opens the device camera, lets you take a snapshot, and shows a preview before saving. It's for at-a-glance identification at the counter, not a formal ID photo. The form saves normally whether or not a photo is captured.
After registering, you land on the patient's profile with a prompt to print their card or OPD stickers straight away.
Patient profile¶
Click a patient's name (/medical/patients/{id}) to open the read‑only profile — the single hub
for that patient:
- Allergy safety band at the top — red with the active allergens, or green "No known allergies" (see Allergies & Safety).
- Identity & demographics, contact & address.
- Recent encounters (with a per‑visit sticker link).
- Diagnostics — recent lab and imaging orders with status, linking to each order.
- Insurance and Consent at a glance.
- A side rail with the patient's QR + barcode, print card / stickers buttons, quick stats (encounters, last visit, active allergies, policies, consents), and related links.
- Edit is one click away.
Patient card, QR & OPD stickers¶
Medical → Patient QR / Scan (/medical/labels) — find a patient (camera‑scan a card QR, type an
MRN, or search) and print their identity labels. Every label encodes the MRN as both a QR (fast
counter lookup) and a Code 128 barcode (lab/pharmacy/handheld scanners), so the same printed label
resolves at any station.
- Registration card (
…/card) — a QR + barcode card for the patient to carry. - OPD stickers (
…/stickers) — a sheet of identical stickers (choose how many) to peel into the paper OPD register, onto specimen tubes, or onto forms. Each sticker shows MRN (barcode + QR), name, age/sex, DOB and blood group; printing from an encounter also stamps the OPD visit date. - PDF — open a print‑ready PDF of the card or sticker sheet (archival / batch printing).
- ZPL — download ZPL for a Zebra‑class thermal label printer instead of an A4 sheet.
Screenshot: OPD sticker sheet — TODO
Scan to find
Scan a card's QR with the camera (or a USB barcode scanner into the manual box) to jump straight to that patient.
Encounters¶
Medical → Encounters (/medical/encounters) — open a clinical visit and classify it as
Outpatient, Inpatient, or Emergency, with start/end times and the attending provider.
The encounter is the container for vitals, notes, orders, and charges. A finished or cancelled
encounter locks — its clinical data can no longer be edited.
Appointments¶
Medical → Appointments (/medical/appointments) — book visits with a date, provider, and
channel (In Person, Telehealth, Phone), choosing from the provider's bookable slots.
Track status: Booked → Checked In → Completed (or Cancelled / No Show). Patients can also
self‑book from the patient portal.
Consents¶
Medical → Consents (/medical/consents) — record patient consent by scope: Treatment,
Data Sharing, Research, Marketing — as Granted or Withdrawn, with dates for the
audit trail. Each consent can capture an e‑signature: the document/form version, who signed
and their relationship to the patient, the timestamp, and a drawn signature (a signature pad
on the form). Re‑signing replaces the captured signature; the version records exactly what was agreed.
Capture the patient's e-signature on the signature pad, choose the signature type (Signature, Thumb impression, Mark (X)), and record the document form version and who signed (signed by / relationship).
A witness is auto-required for minors and thumb/mark consents
When the patient is a minor (under 18), or the consent is taken by thumb impression or mark (illiterate signer), the system blocks saving until a witness name and a witness signature are captured. Fill the Witness card to proceed.
Clinical Alerts¶
Medical → Alerts (/medical/alerts) — critical lab values, drug recalls, stock, and claims alerts.
Filter by type/severity/status and Acknowledge or Resolve each one.
Consent gates research & data sharing
Research enrollment and data-sharing exports respect the consent record — a withdrawn consent blocks those uses. Keep consents current.
Registration category & card scan¶
- Registration category — each patient is registered under a category — OPD, Emergency, EHS or HIB — which drives billing routing.
- Card scan — scan a patient card (its QR / barcode encodes the MRN) to jump straight to the profile; an unknown code returns to the list with an advisory.
Public appointment booking¶
Patients can request appointments from the embeddable /book-appointment widget, which the hospital
iframes into its own website. A submission is quarantined — it never creates a patient record or a
confirmed appointment. Front desk reviews requests under Medical → Booking Requests and confirms or
rejects each; a confirmed request is then turned into a real appointment.