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
  1. 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
  2. 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
  3. 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
  4. 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
  5. 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
  6. 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
  7. 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
  8. 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
  9. 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