Election & Electoral Process

Findings

Catalogue-native findings must describe the information grouped by each layer. This legacy version does not declare them separately.

Questions & artifacts

Questions, artifact requirements and serial naming rules are required by Vercy vNext; they remain unassigned in this reference version.

Dimension & namespace

• REFERENCE `world.person` (P1): voters and candidates resolve to persons
• REFERENCE `world.publicOffice` (A11): mandate grants seat elected offices defined there
• REFERENCE `world.publicOffice` (A11): the bodies whose composition the election determines
• REFERENCE `world.registryMandate` (A12): the electoral register operates under its own independent mandate
• MIX-IN `world.auditTrail` (S4): every roll change and count step is append-only and independently checkable
• imports: oasis-eml (ALIGN): election process and results interchange structure
• imports: popolo (ALIGN): candidacies, posts and memberships for civic data consumers

Canon, patches & standards

• REFERENCE `world.person` (P1): voters and candidates resolve to persons
• REFERENCE `world.publicOffice` (A11): mandate grants seat elected offices defined there
• REFERENCE `world.publicOffice` (A11): the bodies whose composition the election determines
• REFERENCE `world.registryMandate` (A12): the electoral register operates under its own independent mandate
• MIX-IN `world.auditTrail` (S4): every roll change and count step is append-only and independently checkable
• imports: oasis-eml (ALIGN): election process and results interchange structure
• imports: popolo (ALIGN): candidacies, posts and memberships for civic data consumers

Artifact formats & serial data

Format-independent core. Concrete artifact formats and naming prefixes are not declared in this legacy version.

Policies & accepted processes

• `openResults`: public access to declared results, tallies and turnout, permanently retained
• `accreditedObserverAccess`: process access for accredited observers to counting and casting-channel records
• `voterRollExtract`: restricted, purpose-bound extracts of the roll, granted by the electoral registrar under the access regime

Read / add / edit / delete

CRUD procedures and interface bindings are not declared in this legacy version.

Ownership, roles & access

An independent electoral registrar, holding its own A12 mandate, stewards this model. Results and statistics are public; voter rolls and channel records are graded, and any access beyond a person's view of their own registration is granted only by the registrar via S1 and S2.

Objects

• `election`: one called electoral event; key attributes: electionType, calledOn, pollingDates, legalBasisRef
• `constituency`: a territorial or corporate unit returning seats; key attributes: name, magnitude, boundaryRef
• `voterRegistration`: one person's entry on a voter roll; key attributes: personRef, rollRef, status, basis
• `candidacy`: a validated bid for a mandate; key attributes: candidateRef, nominatorRef, listPosition, status
• `ballot`: the designed ballot instrument, not a marked paper; key attributes: constituencyRef, contests, layout, languageSet
• `tally`: the counted totals for one ballot in one constituency; key attributes: countsPerOption, invalidCount, turnout, recountFlag
• `result`: the legally declared outcome; key attributes: constituencyRef, allocation, declaredOn, challengeWindow
• `mandateGrant`: the award that seats a winner into an office; key attributes: candidacyRef, officeRef, term, certifiedOn

Relationships

• `election` -> contestedIn -> `constituency` (1:N): an election is decided constituency by constituency
• `voterRegistration` -> enfranchises -> `personRef` (N:1): a roll entry resolves to a person in P1, one active entry per roll
• `candidacy` -> contests -> `election` (N:1): each candidacy belongs to one election
• `tally` -> counts -> `ballot` (N:1): totals are produced per ballot design per constituency
• `result` -> declaredFrom -> `tally` (1:N): a declared result consolidates one or more tallies, including recounts
• `mandateGrant` -> awardedTo -> `candidacy` (1:1): each seat awarded traces to exactly one winning candidacy
• `mandateGrant` -> seats -> `officeRef` (N:1): the grant fills an office defined in A11

Events

• `electionCalled`: an election was formally called with its dates and legal basis
• `candidacyValidated`: a nomination was checked and admitted to the ballot
• `votingOpened`: casting began through the authorized channels
• `votingClosed`: casting ended and counting became permissible
• `tallyCompleted`: a count for one ballot and constituency was finalized
• `recountOrdered`: a tally was reopened under the correction procedure
• `resultDeclared`: the outcome of a constituency was legally declared
• `mandateGranted`: a winner was certified and the corresponding office seat filled

Projections

• `resultsBoard`: declared results and allocations per constituency; omits roll data and individual ballots, which are never stored linkably
• `turnoutStatistics`: participation aggregates by area and channel; omits all person-level data
• `mandateLedger`: who received which mandate for which office and term; omits count detail