How densilraja/online-polling-voting-system works
This repository implements an online polling and voting application: people authenticate, browse active positions and candidates, cast a vote, and view results; administrators manage users, candidates, positions, poll settings, and analytics. The React client routes role-specific pages through an API client to a Spring Boot REST backend. The shown voting service validates eligibility and duplicate voting, persists votes, and aggregates results. Several frontend and backend modules are unsampled, so their links are shown only where documented or marked unverified.
Main entry points: axios.js HTTP client · App.jsx Route application · VoteService.java Vote rules and results · AuthServiceImpl.java Auth service
Components 20
Web client
- Route application
Frontend/src/App.jsx - Admin management
Frontend/src/pages/admin - Voting pages
Frontend/src/pages/user - API services
Frontend/src/services - HTTP client
Frontend/src/api/axios.js
Identity and access
- Auth state
Frontend/src/context/AuthContext.jsx - Login and registration
Frontend/src/pages/auth - Auth endpoints
Backend/src/main/java/com/raja/Backend/controller/AuthController.java - Auth service
Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java - JWT service
Backend/src/main/java/com/raja/Backend/security/JwtService.java - Security filter and config
Backend/src/main/java/com/raja/Backend/security
Election operations
- Admin endpoints
Backend/src/main/java/com/raja/Backend/controller - Voting endpoints
Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java - Vote rules and results
Backend/src/main/java/com/raja/Backend/service/VoteService.java - Poll domain services
Backend/src/main/java/com/raja/Backend/service
Persistence
- Data repositories
Backend/src/main/java/com/raja/Backend/repository - User, candidate, position, vote
Backend/src/main/java/com/raja/Backend/entity - MySQL database
Other components
- Voter or admin
- Vote results
Connections 23
- Voter or admin → Route application: uses
README.md - Route application → Login and registration: routes to
Frontend/src/App.jsx - Route application → Admin management: routes to
Frontend/src/App.jsx - Route application → Voting pages: routes to
Frontend/src/App.jsx - Login and registration → Auth state: updates auth
- Auth state → HTTP client: stores token
- Admin management → API services: requests data
Frontend/src/pages/admin/ManageUsers.jsx - Voting pages → API services: requests data
- API services → HTTP client: uses client
Frontend/src/services/userService.js - HTTP client → Auth endpoints: calls API
- HTTP client → Voting endpoints: calls API
- HTTP client → Admin endpoints: calls API
- Auth endpoints → Auth service: delegates
- Auth service → JWT service: creates tokens
Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java - Security filter and config → JWT service: validates tokens
- Auth service → Data repositories: uses user data
Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java - Admin endpoints → Poll domain services: delegates
Backend/src/main/java/com/raja/Backend/controller/AdminUserController.java - Voting endpoints → Vote rules and results: casts and queries
Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java - Voting endpoints → Poll domain services: loads options
Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java - Vote rules and results → Data repositories: reads and saves
Backend/src/main/java/com/raja/Backend/service/VoteService.java - Vote rules and results → User, candidate, position, vote: checks vote entities
Backend/src/main/java/com/raja/Backend/service/VoteService.java - Data repositories → MySQL database: persists records
- Vote rules and results → Vote results: aggregates
Backend/src/main/java/com/raja/Backend/service/VoteService.java