Occupancy & capacity data model
Licensed capacity, bed states, block reasons, expected admissions and discharge orders, census snapshots and reporting periods — with physical bed state kept distinct from calculated reporting values.
- Document version
- 1.0
- Last updated
- 2026-09-08
- Document owner
- OWNER INPUT REQUIRED — DOCUMENT GOVERNANCE
- Applies to
- OCRS 2.4.0 (multi-tenant hosted edition)
- Status
- Approved
- Audience
- Technical evaluators, State agencies, Provider organizations
- Evidence source
- src/lib/obcc/state-csv.ts · src/lib/reporting/census-template.ts
Physical bed state
Physical bed state is what a facility records about a real bed. It is entered and corrected by facility users, and it is what the extract reports one row per physical bed.
| Concept | Meaning | Implemented as |
|---|---|---|
| Licensed capacity | The number of beds the facility is licensed to operate. | Facility licensed bed count |
| Active bed | A physical bed currently part of active licensed capacity. | isActive on the bed row |
| Occupied bed | A bed held by a resident at the reporting moment. | isOccupied on the bed row |
| Blocked bed | A bed that exists but cannot accept an admission. | isBlocked on the bed row |
| Block reason | Why a blocked bed is unavailable, where a reason is recorded. | isBlockedReason on the bed row |
| Available bed | A bed that can accept an admission today. | Calculated — see below |
| Reporting level of care | The licensed level of care the facility reports under. | levelOfCare on the facility record |
| Expected admission | An admission anticipated into a bed, with its anticipated date. | expectedAdmission / expectedAdmissionDate |
| Discharge order | A discharge order recorded for the current occupant, with its date. | dischargeOrder / dischargeOrderDate |
Calculated census and reporting values
Calculated values are never entered by a user. They are computed from physical bed state and from the census submitted for a reporting date, which is why a rollup can always be traced back to the facility rows behind it.
- Available capacity — active beds that are neither occupied nor blocked. A blocked bed is never counted as available anywhere in the product.
- Occupancy — occupied beds against licensed capacity for the facility, organization or jurisdiction in view.
- Census snapshot — the immutable set of figures and attribution recorded when a census is submitted for a reporting date. Later edits to a facility or a user profile do not change a historical snapshot.
- Reporting period — the window a submission or an extract belongs to; the extract for a period is generated from the records on file and then locked.
- Reporting coverage — whether a facility has reported for the period. A reported zero is a real submission; a missing submission is reported as not reported and is never treated as spare capacity.
Note: Blocking a bed is not the same as reducing licensed capacity. Licensed capacity changes only when the facility's licensed bed configuration changes.
Not yet in the public model
OWNER INPUT REQUIRED — DOCUMENT GOVERNANCE
Waitlist and admission/discharge workflow concepts exist in the product but have no approved public definition yet, so they are deliberately not documented here as reporting concepts.
Version history
This document covers a change-managed subject, so every substantive change is versioned with its effective date and the audience it affects.
| Version | Effective date | What changed | Affected audience |
|---|---|---|---|
| 1.0 | 2026-09-08 | First published occupancy and capacity model. | All audiences |