Admin Dashboard Overview
The admin dashboard provides a central overview of your e-voting system at/admin/dashboard.
Dashboard Statistics
Your dashboard displays key metrics:- Total Elections: All elections in the system (draft, active, and closed)
- Active Elections: Currently open elections accepting votes
- Total Voters: All registered voters
- Total Votes: Sum of all votes cast across all elections
Admin Navigation
The admin sidebar provides quick access to:- Dashboard: Overview and statistics
- Elections: Manage all elections
- Voters: Review and approve voter registrations
- Results: View election outcomes
- Settings: Configure platform settings
- Admin Users: Manage administrator accounts
Managing Voters
Access voter management at/admin/voters.
Viewing Registered Voters
The voters page shows all registered users with:- Name and email
- Registration status (Pending, Approved, Rejected)
- Registration date
- Quick action buttons
Filtering Voters
Use the filter tabs to view:- All: Every registered voter
- Pending: Registrations awaiting approval
- Approved: Voters who can participate in elections
- Rejected: Registrations that were declined
Search Functionality
Use the search bar to find voters by:- Name
- Email address
- Any text in their profile
Approving Voter Registrations
Review Voter Details
Click the eye icon to view detailed information about a voter:
- Full name
- Email address
- Registration date
- Voter ID
If auto-approval is enabled in settings, new registrations are automatically approved and won’t appear in the pending list.
Viewing Voter Details
Click on any voter to access their detail page (/admin/voters/:id) showing:
- Complete registration information
- Current status
- Registration timestamp
- Voter ID
- Action buttons to approve/reject
Managing Elections
For detailed information on creating and managing elections, see the Creating Elections Guide. Quick access:/admin/elections
Election Overview
The elections management page displays:- All elections in your system
- Filter tabs: All, Draft, Active, Closed
- Search functionality
- Create election button
Election Statuses
DRAFT- Newly created election
- Not visible to voters
- Can add/remove candidates
- Can be activated when ready
- Election is open for voting
- Visible to approved voters
- Automatically opens at start date
- Automatically closes at end date
- Cannot modify candidates
- Voting has ended
- Results are calculated
- Results visible to all users
- Cannot be reopened
Quick Election Actions
From the elections list, you can:- View Details: Eye icon - see full election information
- Public View: External link icon - preview what voters see
Viewing Results
Access election results at/admin/results.
Results Dashboard
The results page shows:- All elections with their status
- Vote counts for each election
- Winners (for closed elections)
- Tie indicators
- Top 3 candidates per election
Election Results Details
Click on any closed election to view:- Full candidate rankings
- Vote totals and percentages
- Winner determination
- Tie resolution information (if applicable)
Understanding Results by Election Type
First Past The Post (FPTP)- Shows vote count per candidate
- Candidate with most votes wins
- Displays percentage of total votes
- Shows preference distribution
- Round-by-round elimination process
- Transfer of votes between candidates
- Final winner after all transfers
Handling Tied Elections
When an election results in a tie:Choose Resolution Method
Three options are available:Random Selection
- System randomly selects winner from tied candidates
- Fair and unbiased
- Immediate resolution
- Administrator manually chooses winner
- Requires selecting from tied candidates only
- Include notes to document decision
- Declares no winner
- Indicates need for a new election
- No winner assigned
Administrative Settings
Access platform settings at/admin/management.
Available Settings
Voter Registration- Signup Enabled: Allow new voter registrations
- Login Enabled: Allow voters to log in
- Auto-Approval: Automatically approve new registrations
- Guest Voting Enabled: Allow anonymous voting by IP address
- Requires public IP addresses
- Auto-creates guest accounts
- Turnstile (CAPTCHA): Enable bot protection
- Site Key: Cloudflare Turnstile site key
- Secret Key: Cloudflare Turnstile secret key
Turnstile is automatically disabled in development and test environments.
Updating Settings
Managing Administrator Accounts
Access at/admin/admins.
Viewing Administrators
See all administrator accounts with:- Username
- Creation date
- Last login
Creating New Administrators
Changing Your Password
Navigate to/admin/change-password to update your admin password.
Best Practices
Troubleshooting
Can’t access admin panel
- Verify you’re using the correct admin login at
/admin/login - Check your admin credentials
- Ensure your admin account hasn’t been removed
- Voters cannot access admin functions
Voter approvals not working
- Refresh the page after clicking approve/reject
- Check the voter’s status in their detail page
- Verify you’re logged in as an administrator
Election won’t activate
- Ensure at least one candidate is added
- Check that start/end dates are valid
- Verify election is in DRAFT status
- Start date must be before end date
Results not showing
- Election must be CLOSED status
- Wait for end date to pass (or close manually)
- Verify votes were cast in the election
- Check for calculation errors in system logs
Data & Privacy
As an administrator, you have access to:- Voter registration information (name, email, status)
- Election metadata (names, dates, candidates)
- Vote counts and results
- Who individual voters voted for
- Specific ballot choices
- Vote-to-voter mappings