User Guide
Ward
General inpatient stays, elective admissions, and post-transfer recovery — the fifth and last ward kiosk.
A.1 What a Ward doctor / nurse owns
| Responsibility | Detail |
|---|---|
| Ward board | The single screen they sign in to. Two tabs: Ward Patients (admitted, currently on a wing) and Waiting List (queued for a bed). Wing filter chips at the top let staff focus on one wing at a time. |
| Patient chart | A popup that opens when they click a patient name. Holds Admission snapshot, Vitals, Allergies, Conditions, Nursing Assess., Medications, Lab/Imaging Orders, Results, Care Plans, Consents. |
| Recording observations | They can add new vitals, allergies, conditions, and nursing assessments directly from the chart popup. Vitals form has the standard 7 chips: BP, HR, Temp, SpO2, RR, Wt, Pain. |
| Nursing assessments | The assessment-type dropdown is tuned for ward work: Braden (skin), Morse (fall), Pain, CAM (confusion), ADL (activities of daily living). |
| Placing orders | The + Order button on each row opens Quick Orders (Prescription / Lab / Imaging). Pharmacy / Laboratory / Radiology are notified but invisible to the ward clinician. |
| Waiting list | Add patients to the queue with a priority (1–4), preferred wing, reason, and diagnosis. When a bed frees up, Assign the patient to a room and they jump straight onto the ward tab. |
| Daily rounds | Edit each patient row to update room/bed, attending nurse, mobility status, diet restrictions, expected stay, visiting hours, care plan. |
A.2 What they cannot do
The Ward shell is intentionally narrow — kiosk-style, like the four specialty wards:
- No sidebar, no global navigation, no dashboard.
- No access to lab, pharmacy, radiology, billing, HR, or admissions screens.
- No access to ICU / Maternity / Emergency / Operations boards (use the standard transfer flow).
- No access to patients who are not on the ward board.
Forbidden URLs land on the standard Forbidden page.
A.3 What the screen looks like
When a ward doctor or nurse logs in:
┌──────────────────────────────────────────────────────────────────────────────┐
│ M Mando · Ward [ Ward ] 🔔 Dr. Maya Farah ┄ │
├──────────────────────────────────────────────────────────────────────────────┤
│ │
│ 🏥 Ward Management [+ Waiting List] [+ Acceptance] │
│ 3 patients • 1 waiting │
│ │
│ [ Ward Patients (3) ] Waiting List (1) │
│ │
│ ┌ All Wings ─ Cardiology ─ Neurology ─ Orthopedics ─ Pediatrics ─ … ─┐ │
│ │
│ ┌ general ─ John Smith ─ Dr. Maya Farah ─ Room 305 ─ [Cardiology Wing]┐ │
│ │ Bed: B-2 Nurse: Sarah Mobility: assisted Stay: 3-5 days │ │
│ │ Diet: Low-sodium Visiting Hours: 14:00-17:00, 19:00-20:30 │ │
│ │ Care Plan: Daily ECG, BP q4h, monitor for arrhythmia │ │
│ │ ───────────────────────────── [+ Order] [Edit] [🗑] │ │
│ └────────────────────────────────────────────────────────────────────────┘│
└──────────────────────────────────────────────────────────────────────────────┘
Top bar: brand → single static tab “Ward” → notification bell → user pill → Sign out.
A.4 The day, end to end
- Sign in. The system bounces them straight to
/normal-acceptance(the ward board). No dashboard. - Read the board. Two tabs — Ward Patients and Waiting List. On Ward Patients, wing-filter chips at the top show occupancy per wing.
- Click a wing chip to focus on one wing’s patients only, or All Wings to see everyone.
- Click the patient name. The chart popup opens with 11 cards: Admission, Vitals, Allergies, Conditions, Nursing Assess., Medications, Lab Orders, Imaging Orders, Results, Care Plans, Consents. Each card shows a count.
- Click “Admission”. Read-only snapshot: wing, room, bed, ward type, attending nurse, mobility, expected stay, visiting hours, diet restrictions, care plan, notes. The chart’s bottom hint reminds the user that editing the admission record happens on the board (Edit on the row).
- Click “Vitals” → + Add. Form has seven chips: BP, HR, Temp, SpO2, RR, Wt, Pain. Click a chip → fields pre-fill → type the value → Save.
- Click “Allergies / Conditions / Nursing Assess.” → + Add. Same flow. The Nursing Assess. dropdown is tuned for ward routine: Braden, Morse, Pain, CAM, ADL.
- Place an order. Close the chart, click
+ Orderon the row. Three tabs: Prescription, Lab, Imaging. Submit → Pharmacy / Lab / Radiology gets the alert. - Update rounds. Click Edit on the row to change wing/room/bed, nurse, mobility, diet, expected stay, visiting hours, care plan, notes.
- Discharge. The bin icon removes the acceptance record (the patient’s underlying admission is closed via the standard reception/cashier discharge flow).
- Manage the queue. Switch to the Waiting List tab. + Waiting List adds a new entry. When a bed opens, click Assign on a waiting entry → pick an available room → it admits immediately.
A.5 Notifications
Inbound (the bell flashes):
- Patient transferred from ICU / ER / Operations to a regular ward — fired by the originating ward’s “Transfer to Ward” handoff.
- New planned/elective admission landed — fired by Reception with admission_type =
inpatient/planned/daycase. - Stat lab or imaging result finalised on one of their patients (planned).
Outbound (they create them implicitly):
- Placing a Lab order → Laboratory.
- Placing an Imaging order → Radiology.
- New prescription → MAR / pharmacy queue.
- Assigning a waiting-list patient to a room → Reception (so the bill state stays in sync).
A.6 Common pitfalls
- “I can’t find a place to update post-op notes.” Post-op notes belong on the Operations board, not the ward board. The ward chart shows medications and care plans; the originating OR record stays where it was created.
- “I want to upgrade a patient to ICU.” Today the ward board has no direct To ICU button. Use the existing room-transfer flow (Edit → change wing) or close the case and have ICU re-admit. Future enhancement could mirror ER’s “To ICU” handoff.
- “The patient I’m looking for isn’t on Ward Patients.” They might be on the waiting list. Check the second tab. If they’re nowhere, Reception hasn’t admitted them yet (admission_type =
inpatient/planned/daycase/normal). - “I tried to open the lab page and got Forbidden.” Correct — ward staff place orders but never browse lab/pharmacy/radiology. Use
+ Orderon the row. - “My patient transferred from ICU isn’t here.” ICU’s “Transfer to Ward” creates an
acceptancerecord in this ward. If they don’t appear, check the wing filter — they may be on a different wing.