Functional standard / What is being done / PatientInstance
Regimen
A set of drugs and orders prescribed together.
- Kind
- regimen
- Collection
- /v1/regimens
- Initial state
- proposed
- Classification
- Clinical
Scope and usage
Prescribing is clinical. A regimen is proposed, signed, counter-signed by a second clinician, and then activated. Activating it records each drug as a Medication and each order as a proposed CareAction. Stopping or superseding it stops those medications.
Boundaries and relationships
- A single medicine row can exist without a regimen when it is reported only.
- Stopped and superseded are frozen. A dose change is a new regimen that names the one it supersedes.
- Orders from a regimen are proposed and are not dispatched.
Resource content
Elements this resource adds. It also carries the Instance, including patient_id.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| name | 1..1 | string | — | Regimen name. |
| regimen_type | 1..1 | code | B | management, diagnostic, or self_care. |
| careplan_id | 0..1 | id | — | Plan it belongs to. |
| orders | 0..* | CodedItem | — | code, display, instructions. |
| drugs | 0..* | CodedItem | — | code, display, dose, frequency, duration_days, instructions. |
| reason | 0..1 | string | — | Why this regimen. |
| supersedes | 0..1 | id | — | Previous regimen this one replaces. |
| signed_by | 0..1 | id | R | Clinician who signed. Harness-owned. |
| counter_signed_by | 0..1 | id | R | Second clinician who counter-signed. Harness-owned. |
State machine
proposed/ initial — Drafted. Not a prescription yet.signed— Signed by a clinician.counter_signed— Signed by a second, different clinician.active— Current prescription.stopped— Stopped. Frozen.superseded— Replaced by a newer regimen. Frozen.
proposed → signed, stopped, or active when counter-signing is switched off. signed → counter_signed, stopped. counter_signed → active, stopped. active → stopped, superseded.
Frozen: stopped and superseded.
Invariants
ccs-reg-1— Activating a regimen writes Medication rows and proposed order CareActions. Stopping or superseding it stops those medications, as a cascade.ccs-reg-2— The counter-signer must differ from the signer. A proposed regimen cannot become active directly while counter-signing is required.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/regimens | List regimen. Filter by patient_id, status, and where the model has them, encounter_id or definition_key. |
| POST | /v1/regimens | Create a regimen. Body is the resource minus harness-owned elements. |
| GET | /v1/regimens/{id} | Read one regimen. |
| PATCH | /v1/regimens/{id} | Update elements that are not immutable, frozen, or harness-owned. |
| POST | /v1/regimens/{id}/transition | Move status. Body is { to, reason }. A gated move returns 202 and an Approval. |
| DELETE | /v1/regimens/{id}?reason= | Soft-delete. Reason is required. Refused when the resource is not deletable or is frozen. |
Notes
- Definition kind regimen.
Example
{ "patient_id": "pat_…", "name": "Sertraline first line", "drugs": [{ "code": "sertraline", "display": "Sertraline", "dose": "50 mg", "frequency": "daily" }] }