How mikhagirsang29/e-vote-stuco works
VoteStuCo is a LAN student-council election portal. Students sign in, view candidates and election status, cast one vote while voting is open, and receive a receipt; a successful vote also triggers live result updates. Administrators manage election data and settings, review results, and verify receipts. The graph includes the database and shared authentication/receipt helpers as internal layers. Unsampled templates and admin capabilities are included where supported by the README or source index; links are limited to evidenced calls or documented behavior.
Main entry points: client.py Voter routes · admin.py Admin routes · main.py FastAPI application · database.py Election database
Components 10
Voter workflow
- Voter routes
routes/client.py
Election administration
- Admin routes
routes/admin.py
Live results
- WebSocket manager
routes/admin.py - HTMX WebSocket client
static/ws.js
Application core
- Identity and receipts
utilities/utilities.py - Election database
database.py - FastAPI application
main.py - Page templates
templates
Other components
- Student voter
- Connected browsers
Connections 14
- Student voter → Voter routes: uses portal
README.md - Voter routes → Identity and receipts: uses identity helpers
routes/client.py - Voter routes → Election database: reads and records votes
routes/client.py - Voter routes → Page templates: renders voter pages
routes/client.py - Voter routes → WebSocket manager: broadcasts results
routes/client.py - WebSocket manager → Connected browsers: sends updates
routes/admin.py - Connected browsers → HTMX WebSocket client: receives messages
- Admin routes → Identity and receipts: uses identity helpers
routes/admin.py - Admin routes → Election database: manages election data
routes/admin.py - Admin routes → Page templates: renders admin pages
routes/admin.py - Admin routes → WebSocket manager: hosts WebSocket manager
routes/admin.py - FastAPI application → Voter routes: registers router
main.py - FastAPI application → Admin routes: registers router
main.py - FastAPI application → Election database: seeds election state
main.py