Population, frame and invitation model
CA-A1 architecture record. Updated: 2026-10-05. Do not store electoral registers in this architecture by default — references and controlled imports only.
Objects
EligiblePopulationRule (CA-OBJ-004)
id,institution_id,version,authority_refcriteria— structured eligibility declaration (age, residence, citizenship, exclusions such as elected office)frame_dependency— what frame type the rule presumeseffective_from/to; amendments version new records.
InvitationFrame (CA-OBJ-005)
id,type(postal household / open register / organisational roll / self-selecting / mixed)coverage_statement— declared who-is-missing assessment (CA-REQ-004)custody— external by default: registrar/operator holds the register; Cicada holds descriptor + count + digest of the draw inputsweighting_declaration(e.g. deprivation oversampling — CA-REQ-016)
InvitationCampaign (CA-OBJ-006)
id,frame_ref,method(postal/phone/online/mixed),sent_count,datesfunnel— invited → delivered → responded → consented → eligible → pool (counts as append-only snapshots; the funnel is evidence of self-selection, CA-REQ-006)reminder_policy,channel_mix(offline routes must be representable — CA-REQ-071)
RespondentPoolRef (CA-OBJ-007)
id,campaign_ref,pool_digest,respondent_countcustody(operator-held / Cicada-held),permitted_fieldsprojection used at selectionretention_rule— declared deletion schedule for non-selected respondents (CA-REQ-019); respondents-who-were-not-selected get the tightest retention classaccess_policy— who may view respondent identity (not auditors of the algorithm — they see digests + anonymised matrix)
Key architectural decisions
- Frame data never defaults into Cicada. The canonical objects are descriptors + digests + coverage statements. If an implementation needs imported rows, that is an explicit per-field decision with
privacy_classconsequences — not an ambient property of the model. - Duplicate prevention is expressed as a declared rule (
dedupe_policyon the pool: person-key, address-key, household-key) executed at custody — Cicada records the policy and its outcome counts, not the matching keys. - Non-response is first-class: the funnel stores
nonresponseas an analytic state — it is evidence for stratification-review, not noise. - Weighting is declared, not hidden: invitation weighting lives on the frame/campaign records so “equal invitation probability” claims are checkable.
- Respondent ≠ member: pool records and membership records never merge; selection is a crossing event recorded in the Membership + SelectionRun, so pool retention can burn down independently.