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.
| Element | Controls | Applies to |
|---|---|---|
| states, initial, terminal | The steps. Reaching a terminal step completes the journey. | All journeys |
| transitions | Allowed next steps. A state with no entry may move anywhere. | All journeys |
| on_enter, on_exit | Effects when a step is entered or left. On a move, on_exit runs first. | All journeys |
| stages | How a step shows on the board: label, category, color, description, SLA minutes. | Board presentation |
| requires | Records that must exist, optionally in a named state, before the step may be left. | Encounter journeys |
| gates | Which 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_on | Moves 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.