VIP VVIP and Staff Patient Status - hmislk/hmis GitHub Wiki

VIP, VVIP and Staff Patient Status

Overview

HMIS allows patients to be classified with a specific status beyond their standard active/blacklisted state. This is used to flag patients who require special attention or protocol during their visit.

Available Statuses

Status Meaning
NORMAL Default — no special status
VIP Very Important Person — requires elevated service protocol
VVIP Very Very Important Person — highest priority protocol
STAFF Hospital staff member registered as a patient

Where the Status Appears

The status badge is displayed throughout the system wherever a patient's name is shown:

  • Patient Profile (opd/patient.xhtml) — shown as a coloured badge next to the patient name
  • Patient Edit (opd/patient_edit.xhtml) — editable dropdown in the patient details form
  • Patient Search (opd/patient_search.xhtml) — shown in the Patient Status column and filterable via the search panel
  • OPD Billing pages
  • Pharmacy retail sale pages
  • Inward admission and appointment pages
  • Channel booking pages
  • EMR patient composite

The badge is red for VIP, VVIP, and STAFF statuses and invisible (white/empty) for NORMAL.

How to Set or Change a Patient's Status

  1. Navigate to Patient Search and locate the patient
  2. Click Edit on the patient row
  3. On the Patient Edit page, scroll to the Patient Specific Status row
  4. Select the appropriate status from the dropdown (NORMAL / VIP / VVIP / STAFF)
  5. Click Save

No special privilege is required beyond the standard patient edit privilege.

Filtering by Status in Patient Search

On the Patient Search page:

  1. Use the Patient Specific Status dropdown filter on the left panel
  2. Select VIP, VVIP, STAFF, or leave blank for all
  3. Click Search

Administrator Notes

  • The status is stored as the specificStatus enum field on the Patient entity (com.divudi.core.entity.Patient)
  • The enum is SpecificPatientStatus with values: NORMAL, VIP, VVIP, STAFF
  • No configuration key is required — this feature is always active for all installations
  • Previously gated behind Enable patient specific status management in the system config key — this gate was removed; the feature is now unconditionally enabled