Inpatient Admission Profile Dashboard - hmislk/hmis GitHub Wiki

Inpatient Admission Profile (Dashboard)

The Admission Profile is the central dashboard for a single BHT (admission episode). It brings together patient information, clinical actions, billing controls, room management, pharmacy, and reports in one screen. Almost every inpatient workflow is launched from or returns to this page.

Page: Inpatient → Admissions Search → select patient or navigated to automatically after admitting a patient
XHTML: /inward/admission_profile.xhtml
Controller: BhtSummeryController.navigateToInpatientProfile()

Patient Identity Banner

A prominent strip directly under the page title always shows the patient's Name, Age, Sex, and BHT No in large text, so the most important identifying details are visible at a glance without scanning the smaller Patient Details panel. Any encounter flag (e.g. On Admission Death, Rapid/Temp A&E pending completion) is also shown here as a badge.

Patient identity banner and Actions/Reports panel layout

Layout Overview

The dashboard is organised into four columns. Within each column, panels that mix stateful actions (things that change data) with read-only reports/history (things you look up) are split into separate sub-panels — Actions panels use a green accent, Reports/Status panels use a grey accent — so it's clear at a glance which buttons do something and which ones just show something.

Column	Contents
1 — Patient	Patient details, admission details, allergies panel
2 — Admission / Billing / Services / Room	Admission actions, billing actions, service ordering, Room Status (grey) + Room Actions (green)
3 — Surgeries / Clinical Data	Surgery list, Clinical Actions (green) + Clinical Reports & Records (grey)
4 — Pharmaceuticals / Reports / Discharge	Pharmacy Actions (green) + Pharmacy Reports & History (grey), other reports, deposit and discharge controls

Column 1 — Patient Details

Admission details panel — admission type, BHT number, consultant, medical officer, payment mode, admission time
Allergies panel — lists all recorded allergies as amber alert badges. If no allergies are recorded, displays "No known allergies". See Inpatient EHR — Allergies

(Name, gender, age, mobile, phone, and NIC remain listed here too as secondary reference fields — the primary Name/Age/Sex/BHT No are in the banner above.)

Column 2 — Admission, Billing, Services, Room

Admission Panel

Edit Admission — correct admission details (Inpatient — Edit Admission Details)
Edit Patient Details — update patient demographics
Edit Payment Details — change payment mode or credit company
Manage Allergies — add/remove allergy records (Inpatient EHR — Allergies)
Cancel Admission — void the admission (Inpatient — Cancel Admission)
Add Baby Admission — create a linked newborn admission (Inpatient — Baby Admission) — only shown when the current BHT is not a baby admission itself
Mother's Inpatient Profile — navigate to the mother's dashboard — only shown when the current BHT has a parent admission

Billing Panel (hidden for baby admissions that have a parent BHT)

Interim Bill — view the running total of all charges (Inpatient — Final Bill Generation)
Provisional Bill — shown instead of Interim Bill when a provisional bill exists
Final Bill — shown after discharge and payment finalisation
Payments — view payment history
Estimated Bill — view an estimate including professional fees

Services Panel

Add Services & Investigations — order procedures and diagnostics
Add Outside Charges — enter external charges
Add Professional Fees — record consultant fees
Add Estimated Professional Fee — record fee estimates
Add Timed Services — record ongoing time-based charges (room rent, oxygen)

Room Status Panel (grey)

Shows the current room assignment(s), with admission time and a View link
Room Details — view current room assignment and history (Inpatient — Patient Room Details)

Room Actions Panel (green)

Add New Room / Add Guardian Room — assign a room to the patient or their guardian
Room Change — move patient to a different room (Inpatient — Room Change and Guardian Room Change)
Guardian Room Change — move the patient's guardian
Initiate Transfer — transfer the patient to another ward or department (Inpatient — Patient Transfer Between Wards) — visible only with InwardRoomTransferInitiate privilege
Accept Patients — accept incoming transfer requests — visible only with InwardRoomPatientAccept privilege; disabled when no pending requests exist

Column 3 — Surgeries and Clinical Data

Surgeries Panel

Lists all surgery bills linked to this BHT
Add Surgeries — create a new surgery record on the theatre workbench (disabled after payment is finalised)
Manage Surgeries — view and manage the surgery list

Clinical Actions Panel (green)

Stateful workflow transitions — each button is colour-coded (amber = pending, green = done):

Clinical Discharge — record the doctor's clinical discharge decision; requires InpatientClinicalDischarge privilege (Inpatient EHR — Clinical Discharge)
Nursing Discharge — requires InwardNursingDischarge privilege (Inpatient — Nursing Discharge)
Physical Discharge — requires InwardPhysicalDischarge privilege

Clinical Reports & Records Panel (grey)

Patient History — open the patient's OPD history profile
Clinical Notes — view the list of clinical assessments (Inpatient EHR — Clinical Assessment and Notes)
Ward Medications — prescribe and view inpatient ward medications (Inpatient EHR — Ward Medications)
Medicine Timeline — colour-coded timeline of ward medications (Active = green, Expired = grey, Omitted = red); requires InpatientClinicalAssessment privilege
Discharge Medications — manage take-home prescriptions (Inpatient EHR — Discharge Medications)
Investigations — view lab investigation results linked to this BHT
Images — view radiology and clinical images
Diagnosis Card — view/print the diagnosis card (Inpatient EHR — Clinical Data)

Documents Panel

Uploads — upload, view, download, and remove documents (consent forms, insurance letters, referral letters) attached to this admission (Inpatient — Document Upload); requires InwardDocumentUpload privilege
Letters — generate, edit, save, print, and download covering letters using templates or AI (Inpatient Covering Letters); requires InpatientLetter privilege
Fill Forms — fill, edit and delete the hospital's custom dynamic forms for this admission (Inpatient Dynamic Forms); requires InwardFormFill privilege

Column 4 — Pharmaceuticals, Reports, Deposits, Discharge

Pharmacy Actions Panel (green)

Request from Pharmacy — nurse raises a medicine request to the pharmacy
Direct Issue to BHTs — pharmacist issues medicines directly (requires PharmacySale)
Issue Discharge Medicines — issue take-home medicines at discharge (requires PharmacyDischargeMedicineIssue)
Direct Issue to Theatre Cases — pharmacy issues to the theatre
Receive Medicines from Pharmacy — ward confirms receipt of medicines issued by the pharmacy and brought by a porter (Ward Medicine Request, Issue, and Return Workflow)
Return Medicines to Pharmacy — ward returns unused medicines back to the pharmacy via a porter (Ward Medicine Request, Issue, and Return Workflow)

Pharmacy Reports & History Panel (grey)

Three buttons open dedicated, encounter-scoped history pages for this BHT only — the data for this patient is already loaded when the page opens, with no date range or department filter to fill in first (unlike the general pharmacy search pages reachable from the main Pharmacy menu, which are built for browsing across all patients and always require picking a date range).

Pharmacy Requests — every medicine request bill raised for this BHT, with an Issued/Not Issued status tag per request, an expandable row showing the bill(s) that fulfilled each request, a View Request button, and an Issue Medicines button on any request still awaiting fulfilment (requires PharmacyBHTIssueAccept or InwardPharmacyIssueRequestSearch). Replaces the former separate "BHT Issue Requests" and "View Pharmacy Requests" buttons.
Direct Issues — every direct pharmacy-issue bill for this BHT, with an expandable row showing the item-level breakdown (item, code, qty, net value) and a View Bill button that opens the reprint page (requires PharmacySale). Replaces the former separate "Search Direct Issues by Bill" and "by Item" buttons.
Issue Returns — every returned pharmacy-issue bill for this BHT, showing both the original sale bill number and the return bill number, with the same expandable item-level breakdown and View Bill action (requires PharmacySale). Replaces the former separate "Search Issue Returns by Bill" and "by Item" buttons.

Pharmacy Requests page — encounter-scoped, no filters needed

Direct Issues page with an expanded row showing item-level detail

Issue Returns page with an expanded row showing the returned item

For the general, all-patient pharmacy search pages (still available from the main Pharmacy menu for browsing across every BHT with date filters), see Search Inpatient Direct Issue By Bill and Search Inpatient Direct Issue Returns.

Reports Panel

Discharge Summary — generate the discharge summary letter (Inpatient — Discharge Summary and Diagnosis Card)
Inpatient Analytics — BHT-level analytics

Deposits Panel

Collect Deposit — record a deposit payment against the BHT (Inpatient — Patient Deposits)
Deposit Summary — view all deposits collected

Discharge Panel

Room Discharge — formally discharge the patient from the room (Inpatient — Room Discharge)
Navigation to final bill and payment is available from the Billing panel once discharge is complete

Provisional Emergency Banner

When a BHT was admitted as a Provisional Emergency Admission (demographics were incomplete at the time of admission), an amber warning banner is displayed at the top of the profile:

Provisional Emergency Admission — patient demographics may be incomplete. Please add the patient data, or change to the correct patient if this is a duplicate record.

Four action buttons are shown in the banner:

Button	Purpose
Add Patient Data	Navigate to the Patient Edit page to fill in NIC, name, address, date of birth, and contact details
Edit Admission Details	Navigate to the Admission Edit page to add consultant, medical officer, payment method, room, and referral details
Change Patient	Reassign this BHT to a different (existing) patient record — used when the provisional patient turns out to be a duplicate. Goes directly to the change-patient form with this admission pre-selected
Mark as Verified	Clear the Provisional Emergency flag once all details have been confirmed. The banner disappears and the admission becomes a standard admission

The banner is hidden automatically once Mark as Verified is clicked. See Provisional Emergency Admission for the full workflow.

Navigation Buttons (Header)

Back to Search Admission — return to the admissions search (requires InwardSearch)
Nursing WorkBench — jump to the nursing workbench for this patient (requires NursingWorkBench)

Inpatient Module — Overview — module-level orientation
Inpatient — Admissions Search — finding a BHT
Inpatient EHR — Overview — overview of EHR sections
Inpatient Dynamic Forms — creating and filling custom forms
Inpatient — Nursing Workbench — the equivalent all-patient view for nurses/pharmacists working across many BHTs at once
Search Inpatient Direct Issue By Bill / Search Inpatient Direct Issue Returns — the general, date-filtered, all-patient pharmacy search pages