Functional standard / Governance / Instance
Proposal
A suggested create, update, or transition waiting for a clinician.
- Kind
- proposal
- Collection
- /v1/proposals
- Initial state
- pending
- Classification
- Clinical
Scope and usage
The tiered rule. Reactions, agents and cohort rules put clinical effects here. A clinician accepts, with optional edits, or rejects with a reason.
Boundaries and relationships
- Accepting writes the target under the clinician's name, not the agent's and not the system's.
- Non-clinical effects never become proposals. They are applied.
Resource content
Elements this resource adds. It also carries the Instance.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| patient_id | 0..1 | id | — | Patient the suggestion is about. |
| op | 1..1 | code | B | create, transition, or update. |
| target_kind | 1..1 | code | — | Resource to change. |
| target_id | 0..1 | id | — | Existing record, for transition or update. |
| data | 0..1 | object | — | Proposed body or patch. |
| to_state | 0..1 | code | — | For a transition. |
| origin | 1..1 | string | — | reaction:key, agent:id, cohort:key, or protocol:key. |
| rationale | 0..1 | string | — | Why it was suggested. |
| result_id | 0..1 | id | R | Record created or changed. Harness-owned. |
| decided_by | 0..1 | id | R | Harness-owned. |
State machine
pending/ initial — Waiting.accepted— Applied. Frozen. result_id is the record.rejected— Declined. Frozen.
Decided only through /accept and /reject.
Frozen: accepted and rejected.
Terminology bindings
| Element | Strength | Values |
|---|---|---|
| op | required | create | transition | update |
Invariants
ccs-prp-1— A clinical effect from a reaction or an agent is stored as a pending proposal.ccs-prp-2— Accept runs the change as the accepting clinician.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/proposals | List. Inbox is the pending list. |
| GET | /v1/proposals/{id} | Read one. |
| POST | /v1/proposals | Create a proposal. Agents use this rather than a clinical create. |
| POST | /v1/proposals/{id}/accept | Body may include edits. |
| POST | /v1/proposals/{id}/reject | Body includes reason. |
Example
{ "patient_id": "pat_…", "op": "create", "target_kind": "clinical_state", "data": { "scope": "condition", "condition_code": "mdd", "state": "severe" }, "origin": "reaction:severe_phq9_flag" }