Facilities

What it does

A facility is a physical site where care is delivered — a clinic, hospital, or office. Facilities belong to a tenant and are organized into departments and units (for staffing and form visibility). Physical space — wards, rooms, beds — is modeled as a care-location tree, not as separate “locations” and “rooms” tables.

Where to find it

Administrators manage facilities under Admin → Facilities (/admin/facilities). Related screens:

• Care locations — /admin/facility/care-locations
• Unit ↔ care-location mapping — /admin/facility/unit-care-locations
• Bed board — /admin/facility/bed-board (live occupancy; also used from clinical workflows)

If you work at more than one site, use Select facility (/select-facility) after sign-in.

📸 Screenshot: the Facilities admin list (facilities-list).

📸 Screenshot: care locations admin (care-locations).

📸 Screenshot: bed board (bed-board).

Common tasks

Choose the facility you're working at

Use the facility switcher or Select facility so your work is recorded against the right site. Your session is scoped to one tenant and one facility at a time.

Add or edit a facility (administrators)

1. In Admin → Facilities, select New (or open an existing facility).
2. Enter name, code, and address/geography fields your organization requires, then Save.
3. Open the facility to manage Departments and, under each department, Units.

Fresh deployment — demonstration clinic (SEED-108)

A new database already contains one FMoH demonstration facility DEMO-CLINIC with a starter structure (department GEN, unit GOPD, consultation room CR1) so administrators can sign in and explore before creating real sites. It is ordinary facility data — not locked or hidden — and you may edit or add facilities alongside it. The national facility register (40k+ rows) remains a separate, opt-in seed and is not loaded by default.

What departments a facility starts with

Every facility starts with the standard departments its facility type has, each with its units. You do not have to create them:

Facility type	Departments
Hospital	Outpatient, Emergency, Inpatient, Critical care, Maternity, Surgery, Laboratory, Radiology, Pharmacy, Health records, Administration
Health Centre	Outpatient, Emergency, Inpatient, Maternity, Laboratory, Pharmacy, Health records, Administration
Clinic	Outpatient, Laboratory, Pharmacy, Health records, Administration
Maternity Centre	Outpatient, Maternity, Pharmacy, Health records, Administration
Health Post	Outpatient, Pharmacy, Health records, Administration
Pharmacy, Laboratory, Eye Clinic, Dental Clinic	the one they are, plus Health records and Administration
A facility with no recorded type	Outpatient, Health records, Administration

A department is given where the capability is: an intensive care unit belongs to a hospital, so a health post is not handed one. Intensive care, high dependency and neonatal intensive care are units of Critical care, not of Emergency — Emergency triages, resuscitates and observes, then hands over.

These are a starting point, not a rule. Rename them, add to them, or retire the ones your facility does not run, exactly as you would any department you created yourself.

Manage departments, units, and leaders

1. Open a facility → Departments.
2. Create departments as needed.
3. On a department, open Units to create units (rosters and home engagements attach here).
4. Assign department leads (department → Leads) and unit leaders (unit → Leaders) by person id, with an effective date range. Leadership uses the same person UUID as the workforce staff profile.

Manage care locations (physical space)

1. Open Facility → Care locations.
2. Build a tree of typed places (building, ward, room, bed, theatre, waiting area, and so on).
3. Nest children under a parent so the tree matches your building.
4. Map each unit to the care locations it operates under Unit ↔ care-location mapping — without that mapping, clinical forms that ask for a care location will offer an empty list for that unit.

Use the bed board

1. Open Facility → Bed board (or the clinical bed-board entry when available).
2. Review which beds are occupied and which patients are placed.
3. Admit, transfer, and discharge actions that change bed occupancy are done from the patient clinical record (ADT), not by editing the bed board table directly.

Tips & limitations

• A facility belongs to one tenant; managing facilities requires administrator permissions.
• Older “Locations” and “Rooms” admin screens were retired — use care locations instead.
• Units are nested under departments; you cannot create a unit without knowing its department.
• Rostering and credential rules for a unit are configured in Workforce unit roster policy.

---

When something looks wrong

What you see	What it usually is
No units offered	Units are filtered by the chosen department — choose it first
A bed does not appear on the board	The care location exists but is not marked as a bed, or belongs to another facility
A facility cannot be re-parented	A facility belongs to its tenant permanently
Occupancy looks wrong	The board shows current occupancy — a discharge that was not recorded leaves a bed held

For the causes common to every screen — a missing menu item, an empty list, a refusal — see Why a screen will not work.