How saisreejakasireddy/votehub works
VoteHub is a Flask-based college-club voting platform. Students register and sign in, discover or join clubs, then participate in club elections; admins manage clubs, membership, nominees, and voting schedules, while users can view results. The product is concentrated in a single Flask module, with browser scripts providing API-driven screens and SQLite storing application data. The README documents capabilities beyond the sampled backend excerpts; where route-level implementation was not shown, relationships are limited to documented API use.
Main entry points: app.py Routes and workflows · database.db SQLite application data · login.js Account screens · results.js Results chart
Components 21
Browser experience
- Account screens
votehub/static/js/login.js - Registration screen
votehub/static/js/register.js - Shared session logic
votehub/static/js/main.js - Role dashboards
votehub/static/js/dashboard.js - Club browser
votehub/static/js/clubs.js - Poll creation and voting
votehub/static/js/polls.js - Results chart
votehub/static/js/results.js - Page templates
votehub/templates
Flask application
- Routes and workflows
votehub/app.py - Authentication and roles
votehub/app.py - SQLite application data
votehub/database.db - Runtime configuration
config.py
Club administration
- Club and member management
votehub/app.py - Nominee management
votehub/app.py - Voting schedule
votehub/app.py - Club membership
votehub/app.py
Voting and results
- Election and vote recording
votehub/app.py - Voting credentials
votehub/app.py - Result calculation and views
votehub/app.py
Other components
- Student
- Platform or club admin
Connections 26
- Student → Registration screen: registers through
README.md - Student → Account screens: signs in through
README.md - Platform or club admin → Account screens: signs in through
README.md - Account screens → Authentication and roles: requests login
votehub/static/js/login.js - Registration screen → Authentication and roles: requests registration
votehub/static/js/register.js - Authentication and roles → SQLite application data: reads and writes
votehub/app.py - Routes and workflows → Runtime configuration: loads
votehub/app.py - Routes and workflows → SQLite application data: opens SQLite
votehub/app.py - Role dashboards → Routes and workflows: fetches club data
votehub/static/js/dashboard.js - Club browser → Routes and workflows: lists and joins
votehub/static/js/clubs.js - Poll creation and voting → Routes and workflows: creates and votes
votehub/static/js/polls.js - Results chart → Routes and workflows: requests results
votehub/static/js/results.js - Shared session logic → Account screens: stores session for
votehub/static/js/login.js - Routes and workflows → Page templates: renders pages
- Platform or club admin → Club and member management: manages clubs
README.md - Platform or club admin → Nominee management: manages nominees
README.md - Platform or club admin → Voting schedule: sets voting times
votehub/app.py - Club and member management → SQLite application data: stores club changes
votehub/app.py - Platform or club admin → Club membership: assigns members
votehub/app.py - Club membership → Voting credentials: creates credentials
votehub/app.py - Student → Election and vote recording: casts vote
README.md - Election and vote recording → Voting credentials: checks and marks
votehub/app.py - Election and vote recording → SQLite application data: records vote
votehub/app.py - Student → Results chart: views results
README.md - Results chart → Result calculation and views: displays chart data
votehub/static/js/results.js - Result calculation and views → SQLite application data: reads vote totals