/en/work/vote
Vote
An election system that installs on a school computer with no internet and keeps the vote auditable.
Problem
Schools and institutions in Haiti need to run elections, but many have no reliable internet and no IT staff. The system had to install from a step-by-step guide, run offline, and still let an observer trust the result.
What I built
- A Laravel API and a Next.js web app on MariaDB and Redis.
- Voters open a personal link, enter an access code and vote; results are shown only after the election is closed.
- Three installers: native Linux (no Docker), native Windows (no Docker or WSL), and an online edition with Docker and automatic HTTPS.
- A votectl command for password resets, account creation, two-factor reset and mail tests; updates with backup, migrations and automatic rollback.
- Step-by-step guides in French and English for people with basic computer skills.
Hard problems
- Installing a full stack (web, API, database, queue) on a school PC offline, with pinned checksums and a dry-run mode that changes nothing.
- Keeping the audit private key off the server: the installer writes it once, for a USB key, then it is deleted from the machine.
- Updating a production election server safely: backup first, migrations, and a return to the previous version if anything fails.
Security
Two-factor authentication for owners and admins. The audit private key leaves the machine. The serving containers use a database account that can only insert into the append-only tables. Dependencies are audited with make audit, with accepted advisories recorded with a reason and a review date.