Clinical Intelligence StandardsVersion 0.2

Functional standard / How they are / PatientInstance

ClinicalState

The current grading of a condition, or a general state such as emergency or pregnant.

Kind
clinical_state
Collection
/v1/clinical-states
Initial state
current
Classification
Clinical in some uses

Scope and usage

One current state for the general scope, and one current state per condition. A new current state supersedes the previous. Nothing is overwritten.

Boundaries and relationships

Resource content

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

NameCard.TypeFlagsDescription
scope1..1codeBgeneral or condition.
condition_code0..1code—Required when scope is condition.
state1..1code—For example moderate, severe, remission, emergency, pregnant.
grade0..1string—Optional grade label.
basis0..*id—Observation or assessment ids this judgment rests on.
source_outcome_id0..1id—Outcome that proposed this state, when that is the origin.
note0..1string—Short rationale.

State machine

current → entered_in_error. Supersede is a harness cascade, not a caller move.

Frozen: current, superseded, and entered_in_error.

Terminology bindings

ElementStrengthValues
scoperequiredgeneral | condition

Invariants

Operations

MethodPathMeaning
GET/v1/clinical-statesList clinical state. Filter by patient_id, status, and where the model has them, encounter_id or definition_key.
POST/v1/clinical-statesCreate a clinical state. Body is the resource minus harness-owned elements.
GET/v1/clinical-states/{id}Read one clinical state.
PATCH/v1/clinical-states/{id}Update elements that are not immutable, frozen, or harness-owned.
POST/v1/clinical-states/{id}/transitionMove status. Body is { to, reason }. A gated move returns 202 and an Approval.

Example

{ "patient_id": "pat_…", "scope": "condition", "condition_code": "mdd", "state": "moderate" }