Clinical Intelligence StandardsVersion 0.2

Functional standard / Foundation

Care workflows

A journey definition is the workflow language of this standard: named states, allowed moves, what must be done before leaving a state, what each state permits, and what moves care forward by itself.

A journey is attached to a care program, a care setting, or a single encounter through association_type. An encounter definition that names a workflow starts that journey with every encounter of its type.

ElementControlsApplies to
states, initial, terminalThe steps. Reaching a terminal step completes the journey.All journeys
transitionsAllowed next steps. A state with no entry may move anywhere.All journeys
on_enter, on_exitEffects when a step is entered or left. On a move, on_exit runs first.All journeys
stagesHow a step shows on the board: label, category, color, description, SLA minutes.Board presentation
requiresRecords that must exist, optionally in a named state, before the step may be left.Encounter journeys
gatesWhich operations a step allows: case_sheet, finalize_record, close_encounter. A step with gates blocks operations it does not list. A step without gates allows all.Encounter journeys
advance_onMoves the journey when a record of the encounter enters a state.Encounter journeys

Automatic moves

An advance_on rule names when_kind, when_state, and to, optionally limited by from_states and definition_key. With no from_states, a rule only moves forward in the order of states. The first matching rule applies. If a move is refused, for example by an unmet requirement, the journey stays where it is and the timeline records journey.advance_skipped.

Forced moves

Care-team staff may force a move past the allowed transitions or unmet requirements by giving a reason. Patients, agents, and system actors may not. The step is recorded in the journey history and timeline as forced.

The workflow board

GET /v1/workflows lists workflows. GET /v1/workflows/{key}/board shows every encounter on a workflow by stage, and flags cards that have waited longer than the stage's sla_minutes.