Inpatient Room Change and Guardian Room Change - hmislk/hmis GitHub Wiki

Inpatient — Room Change and Guardian Room Change

Room Change moves a currently admitted patient from one room to another. Guardian Room Change does the same for a guardian/attendant accompanying the patient. Both actions close the existing room record and open a new one with accurate timestamps so that time-based charges (room rent, oxygen, etc.) are calculated correctly for each room.

Room Change

Page: Inpatient → Room → Room Change
XHTML: /inward/inward_room_change.xhtml
Controller: RoomChangeController.recreate()
Privilege: InwardRoomRoomChange

Steps

  1. Search for the patient by name, BHT number, or PHN. Filter by institution if needed.
  2. Select the patient from the auto-complete results.
  3. The current room details are shown.
  4. Select the new room from the available vacancy list.
  5. The change date/time defaults to now but can be adjusted.
  6. Click Save.

What Happens

  • The existing PatientRoom record's end time is set to the change timestamp.
  • A new PatientRoom record is created for the new room, starting at the change timestamp.
  • Timed service charges (room rent, etc.) are split at the change timestamp so each room is charged for the correct duration.
  • The Room Occupancy board updates immediately.

Guardian Room Change

Page: Inpatient → Room → Guardian Room Change
XHTML: /inward/inward_room_change_guardian.xhtml
Controller: RoomChangeController.recreate()
Privilege: InwardRoomGurdianRoomChange

Follows the same process as a patient room change, but applies to the guardian's room assignment rather than the patient's. Guardian room charges are tracked separately.

Room Change from the Admission Profile

Both room change and guardian room change can also be launched directly from the Admission Profile Dashboard → Room Management panel. This pre-populates the patient so the search step is skipped.

Audit Trail

Both changes are recorded with the user's identity and the change timestamp.

Related Articles