🗳️ Electronic Voting System

A comprehensive web-based electronic voting platform built with PHP, MySQL, HTML, CSS, and JavaScript. This system enables secure and transparent democratic elections with separate interfaces for administrators and voters.

🌟 Features

👨‍💼 Administrator Module

• User Management: Complete admin authentication and registration system
• Party Management: Register and manage political parties with unique signs/symbols
• Candidate Management: Register candidates and assign them to parties and constituencies
• Election Management: Create, schedule, and monitor elections with real-time controls
• Seat Management: Manage National Assembly (NA) and Provincial Assembly (PA) seats
• Results Dashboard: Real-time election results with party-wise and candidate-wise analytics
• Voter Oversight: Monitor voter registration and voting patterns

🗳️ Voter Module

• Secure Authentication: Email-based login with encrypted passwords
• Constituency Assignment: Automatic assignment to NA and PA seats based on location
• Interactive Voting Interface: User-friendly ballot with candidate photos and party symbols
• Vote Verification: Prevents duplicate voting and ensures vote integrity
• Results Access: View election results after voting completion

🔒 Security Features

• Password Encryption: Bcrypt hashing for all user passwords
• Session Management: Secure PHP session handling
• SQL Injection Prevention: Prepared statements for all database queries
• Access Control: Role-based access control for admin and voter interfaces
• Vote Privacy: Anonymous voting with audit trails

📁 Project Structure

Website/
├── 📱 Admin/                    # Administrator Interface
│   ├── CSS/                     # Admin styling
│   │   ├── login.css
│   │   ├── register.css
│   │   └── Administration/      # Dashboard styles
│   └── HTML/                    # Admin pages
│       ├── login.php
│       ├── register.php
│       └── Administration/      # Admin dashboard pages
├── 🗳️ Voter/                    # Voter Interface
│   ├── CSS/                     # Voter styling
│   │   ├── login.css
│   │   └── Dashboard/           # Voting interface styles
│   └── HTML/                    # Voter pages
│       ├── login.php
│       ├── cast_vote_register.php
│       └── Dashboard/           # Voting pages
├── ⚙️ includes/                 # Backend Logic
│   ├── config_session.php      # Session configuration
│   ├── dbh.php                 # Database connection
│   ├── Admin/                  # Admin controllers
│   └── Voter/                  # Voter controllers
├── 🏠 first_page.php           # Landing page
├── 🎨 first_page.css           # Landing page styles
└── 🗃️ voting.sql              # Database schema

🚀 Installation & Setup

Prerequisites

• Web Server: Apache/Nginx with PHP support
• Database: MySQL 5.7+ or MariaDB
• PHP: Version 7.4 or higher
• Extensions: PDO, PDO_MySQL, bcrypt

Installation Steps

1. Clone the Repository

   git clone https://github.com/FayazNoor/Voting-System.git
   cd Voting-System

2. Database Setup

   # Create database
   CREATE DATABASE voting;
   
   # Import schema
   mysql -u root -p voting < voting.sql

3. Configuration

   • Update database credentials in includes/dbh.php:

   $host = 'localhost';
   $dbname = 'voting';
   $dbusername = 'your_username';
   $dbpassword = 'your_password';

4. Web Server Setup

   • Place project files in your web server document root
   • Ensure proper file permissions
   • Access via http://localhost/Voting-System/first_page.php

📸 Screenshots

🏠 Landing Page

The main entry point where users choose between Admin and Voter interfaces.

🔐 Admin Login

Secure authentication portal for election administrators.

📊 Admin Dashboard

Comprehensive control panel for election management with real-time statistics.

📊 Admin Dashboard - Candidate View

Detailed view showing candidates registered for a specific constituency seat with their party affiliations.

�‍🎓 Candidate Registration

Interface for registering candidates and assigning them to parties and constituencies.

🏛️ Party Registration

System for registering political parties with unique symbols and information.

⚡ Election Management

Election creation and scheduling interface with timing controls.

🗳️ Voter Dashboard

Main voter interface after authentication, showing available elections and options.

🗳️ Voting Interface

Interactive ballot interface with candidate selection and party symbols.

Note: The voting interface UI structure requires improvement and was not fully updated due to time constraints during development. Future updates will focus on enhancing the user experience and visual design of this critical component.

🗄️ Database Schema

The system uses a relational database with the following key entities:

• Users: Base user information (CNIC, name, demographics)
• Admins: Administrative accounts with elevated privileges
• Voters: Voter accounts linked to constituencies
• Parties: Political parties with symbols and leadership
• Candidates: Election candidates linked to parties and seats
• Seats: Electoral constituencies (NA/PA seats)
• Elections: Election cycles with timing and results
• Votes: Individual vote records with anonymity

🎯 Key Functionalities

Election Lifecycle Management

1. Pre-Election: Party and candidate registration, voter enrollment
2. Election Period: Real-time voting with security controls
3. Post-Election: Results compilation and result declaration

Voting Process

1. Voter authentication and verification
2. Constituency-based ballot generation
3. Secure vote casting with confirmation
4. Real-time vote counting and result updates

Administrative Controls

1. Election scheduling and management
2. Candidate and party oversight
3. Voter registration monitoring
4. Result compilation and announcement

🛠️ Technical Features

• MVC Architecture: Clean separation of concerns
• Responsive Design: Mobile-friendly interface
• Real-time Updates: AJAX-powered dynamic content
• Data Validation: Client and server-side validation
• Error Handling: Comprehensive error management
• Audit Trails: Complete election audit capabilities

📊 System Requirements

Minimum Requirements

• RAM: 512 MB
• Storage: 100 MB
• PHP Memory: 128 MB
• MySQL: 50 MB database space

Recommended Specifications

• RAM: 2 GB+
• Storage: 1 GB+
• Concurrent Users: 1000+
• Database: Dedicated MySQL server

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

Development Setup

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Test thoroughly
5. Submit a pull request

👥 Authors

• Fayaz Noor Afridi - Lead Developer - GitHub Profile

🙏 Acknowledgments

• Election Commission guidelines for system design
• Security best practices from OWASP
• PHP community for framework inspiration

📞 Support

For support, email fayaz.noor.afridi@gmail.com or create an issue in this repository.

---

⭐ Star this repository if you find it helpful!