Decisions · Architecture records
The decisions that shape the platform.
Civistara Compliance is a platform of architectural decisions. Every load-bearing choice is a decision someone made, and that the platform now enforces in code. Append-only audit. Type-system separation between read and write. Statute-bound action enums. The cure-period procedure that cannot skip a phase.
This page is the formal record of those decisions. Each entry follows the canonical Architecture Decision Record (ADR) format: the situation that required the decision, the decision itself, and the consequences. Procurement architecture teams can deep-link to any individual record. The collection grows over time and is append-only; superseded records remain visible alongside their replacements.
- Records
- 9 architectural decisions
- Status
- All accepted
- First published
- 2026-04-29
- Last updated
- 2026-11-17
- 001
Append-only decision ledger
Compliance determinations are written as new rows; never updated in place. Storage-layer integrity, enforced by row-level triggers, not by policy.
Accepted - 002
Deterministic replayability
Status calculations are deterministic and tied to a versioned rule set, so the same inputs under the same rule version give the same result. Built so a reviewer can reconstruct how a status was reached.
Accepted - 003
Fail-closed audit transaction
Audit-log write and business mutation share one database transaction. Audit-write failure rolls back the mutation. No silent state changes.
Accepted - 004
View / mutation type separation
Read endpoints can only call read-tagged functions; write endpoints can only call mutation-tagged functions. Compile-time refusal of code that crosses the boundary.
Accepted - 005
Closed-set actions
Audit actions and compliance statuses are typed enums constrained at the database layer. Values outside the fixed lists are rejected.
Accepted - 006
Phased noncompliance procedure
A 15-state noncompliance procedure with notice, cure, hearing and appeal branches. A case moves only along defined transitions; moving toward closure before the response deadline throws in code. The state agency decides.
Accepted - 007
Capacity-shortage tolling
Cure periods pause while a person waits for a volunteer placement. Implementation in progress. Informed by federal court decisions on earlier Medicaid work-requirement waivers.
Accepted - 008
AI auto-approve only
The status calculation has no AI input path. CivicAI is read-only by design; it cannot import, call, or mutate compliance functions. The state agency decides.
Accepted - 009
Public / NDA disclosure split
Public-facing pages route capability claims through the MechanismCard primitive. Source citations and code-level evidence are reserved for NDA-gated channels.
Accepted