Getting started
…d on 24 July 2026. It is written for organisations that must install, configure, operate, audit and support an election without depending on the original developers. It explains the normal workflow, the authority boundaries, each important form field, the data handled by the system, and the conditio…
Open documentation
Getting started
…e accounts rather than deleting historical users referenced by appointments, approvals or audit records. 3.3 Platform Administrators Appoint active ordinary users through the Platform Administrator assignment workflow. Record appointment reference and dates. Revoke with a reason when authority ends.…
Open documentation
Getting started
Complete Electoral Workflow 1. Governance authorisation Before creating records, identify the governing constitution, election regulations, appointing authority, data controller, dispute process, result approval requirement and retention rule. CivitasVote enforces software controls but does not crea…
Open documentation
Getting started
…two application users. Full name The name displayed in lists, appointments, approvals and audit information. During bulk import, first name and last name are supplied separately and combined for display. Temporary password The initial password given to the authorised user. It must comply with Django…
Open documentation
Getting started
…n where enabled; appoint and revoke Platform Administrators; inspect technical, security, audit and deployment System Documentation material; bypass some application role checks for recovery and testing. Boundaries: should not be used for routine election operations; must not be shared; should not b…
Open documentation
Platform administration
…valid rows. Uploaded source files and batch history are retained in protected storage for audit. Supported formats are CSV and XLSX. The current upload limit is 5 MB for authorised user, voter and candidate imports. 2. General procedure 1. Download the template from the relevant page. 2. Do not rena…
Open documentation
Platform administration
…d ordinary authorised users, assigns association governance and maintains platform access records. Appointment A technical superuser appoints an active ordinary application user. The appointee must not be a Django staff user or superuser. Record the authority reference and validity dates. Revoke the…
Open documentation
Association governance
…e organisation. The role creates election cycles, appoints election officers and oversees records, but does not automatically become the operational Commissioner or a voter. Before an election 1. Confirm the governing rules and election timetable. 2. confirm the association’s data controller, contac…
Open documentation
Election setup
…tly in the database. Use the normal service actions because they freeze registers, create audit events and apply readiness checks. 5. Verification options Select only methods the organisation can actually support. Email and SMS require reliable delivery. Passkeys require HTTPS and correct relying pa…
Open documentation
Election setup
…ioner. Deputy, Gender and Inclusion, Appeals, Returning, Registration, Polling, Observer, Auditor and general Committee roles are optional. 3. Appointment record Each appointment should contain: active authorised user; role; official reference; start and end dates; protected PDF appointment letter; …
Open documentation
Election setup
Nomination Modes Purpose The nomination mode determines how people become candidate records, whether the public self nomination portal is available, whether nomination dates are compulsory and which records may appear on the final candidate list. Select the mode before receiving nominations or enter…
Open documentation
Election operations
…plete every self nomination decision, require photographs, synchronise approved candidate records, remove invalid Self mode unlinked candidates, investigate Mixed mode duplicates and publish the final list. Readiness Resolve all service errors. Confirm appointment letters, register digest, eligible …
Open documentation
Election operations
…valid rows. Uploaded source files and batch history are retained in protected storage for audit. Supported formats are CSV and XLSX. The current upload limit is 5 MB for authorised user, voter and candidate imports. 2. General procedure 1. Download the template from the relevant page. 2. Do not rena…
Open documentation
Election operations
…valid rows. Uploaded source files and batch history are retained in protected storage for audit. Supported formats are CSV and XLSX. The current upload limit is 5 MB for authorised user, voter and candidate imports. 2. General procedure 1. Download the template from the relevant page. 2. Do not rena…
Open documentation
Election operations
… appear on the final list and ballot. Rejected and Withdrawn nominations remain completed audit records. Their linked candidate must not remain Approved. 5. Commission candidates Direct entry/import is valid in Upload and Mixed modes. It is invalid in Self mode. The management page detects unlinked …
Open documentation
Election operations
…eadiness, certified register and fingerprints, freezes the eligible register snapshot and records the action. 2. Voter journey The voter opens the public election page, verifies eligibility through an enabled method, receives a short lived voting ticket, completes one ballot page, reviews choices an…
Open documentation
Results and disputes
…on Guide 1. Tally snapshot After closing, the Commissioner generates a tally snapshot. It records version, ballot count, rejected ballot count, tally data, digest, signature, actor and recount information. Previous versions remain immutable evidence. 2. Reconciliation Compare ballot envelopes with r…
Open documentation
Results and disputes
…ly concerns officer misconduct or conflict of interest. Submission fields The public form records the officer, complaint type, description, requested remedy, recusal request and optional evidence. Evidence is stored in protected media and is not publicly downloadable. Competent review authority The …
Open documentation
Results and disputes
Audit and Records Guide 1. Audit ledger CivitasVote records significant actions as keyed, hash chained AuditEvent entries and tracks the ledger head. Events include actor, organisation, election, object type/identifier, request context, metadata, previous hash and event hash. Run: A failed verificat…
Open documentation
Governance reference
…hots, reasoned recounts, independent approvals, public results, exports and declarations. Audit Keyed, hash chained administrative audit events plus register/configuration/tally integrity values. Retention Organisation retention value and supported retention operations, subject to governance and leg…
Open documentation