========================================================================
                      BHARAT E-VOTING SYSTEM (v5.0)
             Secure • Transparent • Verifiable • Accessible
========================================================================

[ PROJECT OVERVIEW ]
This is a web-based simulation of the Indian Electronic Voting Machine (EVM) 
and VVPAT (Voter Verifiable Paper Audit Trail) system. It demonstrates a 
complete polling booth flow, from voter authentication to the final digital 
certification, built entirely with HTML, CSS, and JavaScript.

[ KEY FEATURES ]
1. Realistic EVM Interface:
   - Functioning Ballot Unit with "Blue Button" logic.
   - VVPAT Simulation: A paper slip drops and stays visible for 7 seconds.
   - Real Audio Feedback: Generates the specific EVM "Beep" frequency.

2. Security Simulation:
   - Voter Identification (EPIC & Aadhaar validation).
   - OTP Verification (Mock Two-Factor Authentication).
   - Duplicate Vote Prevention (Checks if ID has already voted).

3. Accessibility & UI:
   - Glassmorphism Design: Modern, clean user interface.
   - Bilingual Support: Toggle instantly between English and Hindi.
   - High Contrast Mode: Accessibility feature for visually impaired voters.

4. Admin Control Panel:
   - Secure login for Presiding Officers.
   - Real-time vote analytics and bar charts.
   - Ability to reset election data.

========================================================================
[ INSTALLATION & SETUP ]
========================================================================
1. Ensure all three files are in the same folder:
   - index.html
   - style.css
   - script.js

2. Double-click "index.html" to open it in any modern web browser 
   (Chrome, Edge, Firefox, Safari).

* No server or database is required. The app uses your browser's 
  LocalStorage to save votes temporarily.

========================================================================
[ HOW TO USE (DEMO CREDENTIALS) ]
========================================================================

--- 1. VOTER FLOW ---
   Step A: Voter Authentication
   - Voter ID: Enter any dummy ID (e.g., ABC1234567).
   - Aadhaar: Enter any 12-digit number (e.g., 123412341234).
   - Click "Send OTP".

   Step B: OTP Verification
   - A prompt will appear asking for an OTP.
   - USE OTP: 1234 (This is the hardcoded demo OTP).
   - Click "Unlock EVM".

   Step C: Casting Vote
   - The EVM Unit will appear.
   - Press the Blue Button next to your chosen candidate.
   - Watch the VVPAT slip drop in the glass window.
   - Wait for the "Beep" sound.

   Step D: Completion
   - A "Vote Successful" digital certificate will be displayed.

--- 2. ADMIN FLOW (PRESIDING OFFICER) ---
   Step A: Login
   - Click the "PO Login" button at the bottom of the page.
   - Enter the Security PIN.
   - USE PIN: admin123

   Step B: Dashboard
   - View live vote counts and leading candidates.
   - Use "Clear All Data" to reset the election (delete all votes).

========================================================================
[ FILE STRUCTURE ]
========================================================================
1. index.html  - The main structure containing the EVM layout and forms.
2. style.css   - Styling for Glassmorphism, animations, and High Contrast mode.
3. script.js   - Logic for voting, audio generation, language switching, 
                 and LocalStorage management.

========================================================================
[ TROUBLESHOOTING ]
========================================================================
- No Sound? 
  Browsers block audio from playing automatically. You must interact with 
  the page (click anywhere) before the EVM beep will work.

- Changes not saving?
  The app uses LocalStorage. If you clear your browser cache or open an 
  Incognito window, the vote data will be reset.