Functional standard / Governance / Instance
Approval
A request to enter a gated state. Someone other than the requester decides.
- Kind
- approval
- Collection
- /v1/approvals
- Initial state
- pending
- Classification
- Operational
Scope and usage
Created by the harness when a transition targets an approval state, or a definition lists approval_required_for. There is no create operation for callers.
Boundaries and relationships
- Accepting a proposal is not an approval. That is Proposal.
- The decision does not bypass the clinical rule. The underlying transition still runs as the decider.
Resource content
Elements this resource adds. It also carries the Instance.
| Name | Card. | Type | Flags | Description |
|---|---|---|---|---|
| patient_id | 0..1 | id | — | Patient, when the subject has one. |
| subject_kind | 1..1 | code | — | Resource being gated. |
| subject_id | 1..1 | id | — | That record. |
| to_state | 1..1 | code | — | The state that was requested. |
| reason | 0..1 | string | — | Why the requester asked. |
| decided_by | 0..1 | id | R | Harness-owned. |
| decision_note | 0..1 | string | R | Harness-owned. |
State machine
pending/ initial — Waiting.approved— Accepted. Frozen.rejected— Declined. Frozen.
Decided only through /decide, not the generic transition.
Frozen: approved and rejected.
Invariants
ccs-app-1— decided_by must differ from created_by.
Operations
| Method | Path | Meaning |
|---|---|---|
| GET | /v1/approvals | List approvals. |
| GET | /v1/approvals/{id} | Read one. |
| POST | /v1/approvals/{id}/decide | Body is { approve, note }. |
Example
{ "subject_kind": "note_page", "subject_id": "page_…", "to_state": "approved", "reason": "Please countersign" }