How michiganflyers/elections works
Project type and purpose
• This is a full-stack, containerized PHP web application called “Election Runner.”
• Purpose: a hybrid digital/paper ballot tally system supporting three user roles (voter, admin, pollworker), plus CLI utilities for data setup and processing.
File structure
• Top-level folders:
• cli/ → shell scripts for database initialization (sqlize.sh), user list generation (userlist.sh), vote processing (process.sh)
• container/ → Caddy web server config (Caddyfile) and PHP-FPM pool config
• web/ → PHP application code, JS, CSS, templates, organized by role (admin/, pollworker/) plus shared inc/ utilities
• Key files:
• Containerfile → Docker build instructions (Caddy + PHP-FPM)
• .do/deploy.template.yaml → DigitalOcean App Platform manifest
• web/inc/db.php & db_func.php → database access abstraction
README
• Confirms project name and purpose
• Links to DigitalOcean deploy button (indicates containerized deployment)
• Browser_Voter -->|HTTP POST vote| Caddy_Server
• Caddy_Server --> PHP_FPM
• PHP_FPM -->|SQL INSERT| Database
• CLI_Scripts -->|DB Migration| Database