Clinical Intelligence StandardsVersion 0.2

Functional standard / How they are / PatientInstance

Outcome

A target. When it is reached, the harness can propose a new clinical state.

Kind
outcome
Collection
/v1/outcomes
Initial state
expected
Classification
Clinical

Scope and usage

The closing of the loop: expected, then achieved or unachieved. The measure is an observation code.

Boundaries and relationships

Resource content

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

NameCard.TypeFlagsDescription
name1..1string—Name of the target.
outcome_type1..1codeBclinical, functional, patient_reported, process, or experience.
perceived_by1..1codeBpatient or care_team.
condition_code0..1code—Condition this target belongs to.
measure_code0..1code—Observation code tracked, for example phq9_score.
comparator0..1codeB<, <=, >, >=, or ==.
target0..1decimal—Numeric target.
due_by0..1dateTime—When it should have been met.
on_achieved_state0..1code—Clinical state to propose when achieved, for example remission.
protocol_assignment_id0..1id—Protocol that instantiated it.
evidence0..*id—Observation ids that showed it.

State machine

expected → achieved, unachieved. unachieved → expected.

Frozen: achieved.

Invariants

Operations

MethodPathMeaning
GET/v1/outcomesList outcome. Filter by patient_id, status, and where the model has them, encounter_id or definition_key.
POST/v1/outcomesCreate a outcome. Body is the resource minus harness-owned elements.
GET/v1/outcomes/{id}Read one outcome.
PATCH/v1/outcomes/{id}Update elements that are not immutable, frozen, or harness-owned.
POST/v1/outcomes/{id}/transitionMove status. Body is { to, reason }. A gated move returns 202 and an Approval.
DELETE/v1/outcomes/{id}?reason=Soft-delete. Reason is required. Refused when the resource is not deletable or is frozen.
GET/v1/outcomes/{id}/evaluateTrajectory of the measure against the target.

Example

{ "patient_id": "pat_…", "name": "Remission", "measure_code": "phq9_score", "comparator": "<", "target": 5, "on_achieved_state": "remission" }