Clinical Intelligence StandardsVersion 0.2

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

Resource content

Elements this resource adds. It also carries the Instance, including patient_id.

NameCard.TypeFlagsDescription
name1..1string—Regimen name.
regimen_type1..1codeBmanagement, diagnostic, or self_care.
careplan_id0..1id—Plan it belongs to.
orders0..*CodedItem—code, display, instructions.
drugs0..*CodedItem—code, display, dose, frequency, duration_days, instructions.
reason0..1string—Why this regimen.
supersedes0..1id—Previous regimen this one replaces.
signed_by0..1idRClinician who signed. Harness-owned.
counter_signed_by0..1idRSecond clinician who counter-signed. Harness-owned.

State machine

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

Operations

MethodPathMeaning
GET/v1/regimensList regimen. Filter by patient_id, status, and where the model has them, encounter_id or definition_key.
POST/v1/regimensCreate 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}/transitionMove 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

Example

{ "patient_id": "pat_…", "name": "Sertraline first line", "drugs": [{ "code": "sertraline", "display": "Sertraline", "dose": "50 mg", "frequency": "daily" }] }