Online Voting System with Face Recognition using Python Flask

• Admin dashboard for this final year project with voters, elections, votes, pending face tasks, completed elections, and audit snippets
• Admin profile update and password change
• Voter list, search, add, edit, delete, activate/deactivate, approve registration, and password reset
• Face data gallery management for voters
• Delete unclear face images and request re-upload
• Mark face enrollment complete
• Election creation and editing with title, description, start/end schedule, and ballot settings
• Election activation, deactivation, manual close, and deletion where allowed
• Ballot publishing and single-candidate-only option configuration
• Candidate add, edit, and delete with photo support
• Account control for pending, blocked, and locked users
• Face verification logs with score review and suspicious/reviewed status
• Fraud record viewing, resolving, flagging, and voting restriction support
• Cast vote monitoring with verification metadata
• Election result tallies, percentages, publish/hide controls, and CSV download
• Participation and verification-failure CSV reports
• In-app notification broadcast to all voters or selected users
• Audit log and login history
• SQLite database backup download

• Voter registration in this final year project with profile fields and optional face image
• Duplicate username, email, and voter ID validation
• Login using email or username and password
• Pending approval flow before full voter access
• Voter dashboard with profile summary, notifications, election status, and voted indicators
• Profile update for email, phone, and address
• Change password support
• Face enrollment with one or more images
• Face image preview list
• Re-upload response when admin requests clearer face data
• Open and all election listing
• Election detail view with candidates
• Ballot access during valid election window
• Webcam capture before voting
• Server-side face verification before vote submission
• Candidate selection and one-vote-per-election submission
• Published result viewing where allowed
• Logout functionality

• Public landing page included in this final year project
• Flask-Login session handling
• Werkzeug password hashing
• SQLite database with optional DATABASE_URL override
• Pillow-based image handling
• TensorFlow MobileNetV2 embeddings for face matching
• Cosine similarity threshold controlled by FACE_MATCH_THRESHOLD
• Configurable MAX_FACE_VERIFICATION_RETRIES reserved for future stricter retry handling
• In-app notifications stored in the database
• Seed data with admin, seven voters, elections, candidates, sample votes, and generated face images
• CSV exports for participation, verification failures, and election results
• Database backup download
• Suitable for final year project demo, viva, source code review, and report preparation

1. Open the final year project root folder containing run.py and requirements.txt.
2. Install dependencies:
   pip install -r requirements.txt
   Windows alternative:
   python -m pip install -r requirements.txt
3. Optional: load demo data using:
   python seed_data.py
   Note: this drops all tables and recreates demo records.
4. Start the final year Flask project server:
   python run.py
5. Open the application at:
   http://127.0.0.1:5000
6. Use these paths:
   • Home: /
   • Login: /auth/login
   • Voter registration: /auth/signup
   • Admin dashboard: /admin/dashboard
   • Voter dashboard: /voter/dashboard
7. For testing face verification, allow browser camera permission and enroll real photos if live capture does not match generated demo images.

Administrator

• Username: admin
• Password: admin123
• Access: /admin/*

Demo Voters

• Usernames: voter1 to voter7
• Password: voter123
• Access: /voter/* after login