Core domain model
CA-A1 architecture record. Updated: 2026-10-05. Canonical objects with stable CA-OBJ identifiers. Field structure is logical (no SQL types chosen). Every object carries common fields unless noted:
Common fields: id, created_at, created_by, provenance (source + authority artefact ref), status, privacy_class, retention_class.
CA-OBJ catalogue
| ID | Object | Purpose | Mutability |
|---|---|---|---|
| CA-OBJ-001 | AssemblyInstitution | permanent/temporary institution identity | amendments versioned |
| CA-OBJ-002 | InstitutionalModel | declared pattern + parameter set | versioned |
| CA-OBJ-003 | AssemblyCycle | one issue/mandate cycle of an institution | stateful |
| CA-OBJ-004 | EligiblePopulationRule | who may be invited/selected | versioned; never silent edit |
| CA-OBJ-005 | InvitationFrame | sampling frame + coverage declaration | versioned |
| CA-OBJ-006 | InvitationCampaign | invitations sent + weighting + funnel | append-only counts |
| CA-OBJ-007 | RespondentPoolRef | pool descriptor + digest + custody | append-only |
| CA-OBJ-008 | SelectionSpecification | authorised strata/quotas/weights/policies | versioned; locked at run |
| CA-OBJ-009 | SelectionRun | engine execution record | append-only |
| CA-OBJ-010 | AuditBundle | witness/seed/digests/verification | immutable |
| CA-OBJ-011 | Person | identity shell | minimal; privacy-classed |
| CA-OBJ-012 | Membership | person×cycle statused membership | transitions append-only |
| CA-OBJ-013 | MembershipTransition | state event with authority | append-only |
| CA-OBJ-014 | Remit | authorised scope/question set | versioned |
| CA-OBJ-015 | AgendaItem | ordered work item w/ proposer/approver | versioned |
| CA-OBJ-016 | EvidenceItem | submission w/ provenance + disclosure | statused; content versioned |
| CA-OBJ-017 | EvidenceAssessment | human balance judgement record | append-only |
| CA-OBJ-018 | Session | deliberation event w/ modality/facilitation | append-only records |
| CA-OBJ-019 | DeliberationRecord | protected/public session artefact | access-classed |
| CA-OBJ-020 | DecisionEvent | question+method+electorate+result | immutable on closure |
| CA-OBJ-021 | Recommendation | output text + support levels | immutable on closure |
| CA-OBJ-022 | DissentStatement | minority position object | immutable on closure |
| CA-OBJ-023 | ReceivingAuthority | institution that must respond | stateful |
| CA-OBJ-024 | ResponseObligation | obligation + deadline declaration | versioned |
| CA-OBJ-025 | Response | authority’s reply object | versioned |
| CA-OBJ-026 | ImplementationCommitment | accepted commitment | stateful |
| CA-OBJ-027 | ImplementationMilestone | progress checkpoint + evidence | stateful |
| CA-OBJ-028 | FollowUpReview | periodic accountability event | append-only |
| CA-OBJ-029 | NestingRelation | delegation/linkage between assemblies | versioned |
| CA-OBJ-030 | AuthorityArtefact | institutional authority record | revocable, append-only |
| CA-OBJ-031 | ExternalChannel | linked external system + seam descriptor | stateful |
| CA-OBJ-032 | ProvisionRecord | support/compensation delivered to member | append-only |
| CA-OBJ-033 | ExclusionEvent | selected-but-could-not-participate record | append-only |
Exemplar field structures
SelectionSpecification (CA-OBJ-008)
id,institution_id,cycle_id,version,status(draft → authorised → locked → superseded)authorised_by(authority artefact ref),authorised_ateligibility_rule_ref→ CA-OBJ-004strata_definition(declared categories + rationale + legal basis)quota_definition(targets: counts/min/max per stratum)weighting_policy(invitation oversampling declaration)permitted_fields(selection-visible attributes)attitudinal_criteria(declared-permitted/prohibited + legal basis)algorithm_policy(allowed algorithm identifiers + versions, not a choice of engine)replacement_policy(ordering, exhaustion, max rate)publication_policy(what is published vs protected)seed_policy(entropy source + ceremony)
Membership (CA-OBJ-012)
id,person_ref→ CA-OBJ-011 (separate identity),cycle_idstatus(invited/responded/eligible/ineligible/selected/reserve/seated/withdrawn/replaced/removed/completed — see MEMBERSHIP-LIFECYCLE)selection_run_ref→ CA-OBJ-009,terms(term bounds, rotation tranche)public_profile_policy(named/anonymous/protected)support_provisions→ CA-OBJ-032 refs;conflicts(declarations)- retention: member records outlive cycles; respondent-class data does not
DecisionEvent (CA-OBJ-020)
id,cycle_id,session_refsquestion_wording(exact),method(consensus/consent/majority/supermajority/rank/score/secret/open)eligible_electorate(membership snapshot ref),quorumresult(counts/distribution per method),abstentionsunresolvedflag (no-decision terminal state)closed_at,closed_by,provenance,version- immutability: on closure,
question_wording+resultfreeze; amendments create new versions
Relationships (logical)
Institution 1—n Cycle 1—1..n SelectionSpecification —n→ SelectionRun —1→ AuditBundle
Cycle 1—n Membership —1→ Person
Cycle 1—1..n Remit —1—n AgendaItem
Cycle 1—n Session 1—n DeliberationRecord
Cycle 1—n DecisionEvent 1—n Recommendation 1—n DissentStatement
Recommendation n—1 ReceivingAuthority; ResponseObligation 1—n Response
Response 1—n ImplementationCommitment 1—n ImplementationMilestone —n→ FollowUpReview
Cycle n—n Cycle via NestingRelation (delegation/fresh-draw declared)
Every consequential object —n→ AuthorityArtefact (who authorised)
Retention classes
permanent: institution, specs, runs, bundles, decisions, responsesterm-bound: membership, provisions, session recordsprivacy-limited: respondent pool refs, non-selected respondent data, support-need details — deletion schedules are institutional declarations recorded in the spec/policy artefacts