# densilraja/online-polling-voting-system architecture

> Architecture diagram of the GitHub repository densilraja/online-polling-voting-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/densilraja/online-polling-voting-system
- Repository: https://github.com/densilraja/online-polling-voting-system

## Overview

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: [`Frontend/src/api/axios.js`](https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/api/axios.js) (HTTP client), [`Frontend/src/App.jsx`](https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/App.jsx) (Route application), [`Backend/src/main/java/com/raja/Backend/service/VoteService.java`](https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/service/VoteService.java) (Vote rules and results), [`Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java`](https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java) (Auth service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_app["Route application<br/>[App.jsx]"]
  node_adminpages["Admin management"]
  node_userpages["Voting pages"]
  node_services["API services"]
  node_http["HTTP client<br/>[axios.js]"]
end

subgraph group_identity["Identity and access"]
  node_authstate["Auth state<br/>[AuthContext.jsx]"]
  node_authpages["Login and registration"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Auth service"]
  node_jwt["JWT service<br/>[JwtService.java]"]
  node_security["Security filter and config"]
end

subgraph group_election["Election operations"]
  node_admincontrollers["Admin endpoints"]
  node_votec["Voting endpoints"]
  node_voteservice["Vote rules and results<br/>[VoteService.java]"]
  node_domainservices["Poll domain services"]
end

subgraph group_persistence["Persistence"]
  node_repositories["Data repositories"]
  node_domain["User, candidate, position, vote"]
  node_mysql[("MySQL database")]
end

node_voter(("Voter or admin"))
node_results["Vote results"]

node_voter -->|"uses"| node_app
node_app -->|"routes to"| node_authpages
node_app -->|"routes to"| node_adminpages
node_app -->|"routes to"| node_userpages
node_authpages -.->|"updates auth"| node_authstate
node_authstate -.->|"stores token"| node_http
node_adminpages -->|"requests data"| node_services
node_userpages -.->|"requests data"| node_services
node_services -->|"uses client"| node_http
node_http -.->|"calls API"| node_authcontroller
node_http -.->|"calls API"| node_votec
node_http -.->|"calls API"| node_admincontrollers
node_authcontroller -.->|"delegates"| node_authservice
node_authservice -->|"creates tokens"| node_jwt
node_security -.->|"validates tokens"| node_jwt
node_authservice -->|"uses user data"| node_repositories
node_admincontrollers -->|"delegates"| node_domainservices
node_votec -->|"casts and queries"| node_voteservice
node_votec -->|"loads options"| node_domainservices
node_voteservice -->|"reads and saves"| node_repositories
node_voteservice -->|"checks vote entities"| node_domain
node_repositories -.->|"persists records"| node_mysql
node_voteservice -->|"aggregates"| node_results

click node_app "https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/App.jsx"
click node_authstate "https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/context/AuthContext.jsx"
click node_authpages "https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/pages/auth"
click node_adminpages "https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/pages/admin"
click node_userpages "https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/pages/user"
click node_services "https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/services"
click node_http "https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/api/axios.js"
click node_authcontroller "https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/controller/AuthController.java"
click node_authservice "https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java"
click node_jwt "https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/security/JwtService.java"
click node_security "https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/security"
click node_admincontrollers "https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/controller"
click node_votec "https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java"
click node_voteservice "https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/service/VoteService.java"
click node_domainservices "https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/service"
click node_repositories "https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/repository"
click node_domain "https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/entity"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_adminpages,node_userpages,node_services,node_http toneBlue
class node_authstate,node_authpages,node_authcontroller,node_authservice,node_jwt,node_security toneAmber
class node_admincontrollers,node_votec,node_voteservice,node_domainservices toneMint
class node_repositories,node_domain,node_mysql toneRose
class node_voter,node_results toneIndigo
```

## Components

### Web client

- [Route application](https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/App.jsx): `Frontend/src/App.jsx`
- [Admin management](https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/pages/admin): `Frontend/src/pages/admin`
- [Voting pages](https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/pages/user): `Frontend/src/pages/user`
- [API services](https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/services): `Frontend/src/services`
- [HTTP client](https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/api/axios.js): `Frontend/src/api/axios.js`

### Identity and access

- [Auth state](https://github.com/densilraja/online-polling-voting-system/blob/main/Frontend/src/context/AuthContext.jsx): `Frontend/src/context/AuthContext.jsx`
- [Login and registration](https://github.com/densilraja/online-polling-voting-system/tree/main/Frontend/src/pages/auth): `Frontend/src/pages/auth`
- [Auth endpoints](https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/controller/AuthController.java): `Backend/src/main/java/com/raja/Backend/controller/AuthController.java`
- [Auth service](https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java): `Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java`
- [JWT service](https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/security/JwtService.java): `Backend/src/main/java/com/raja/Backend/security/JwtService.java`
- [Security filter and config](https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/security): `Backend/src/main/java/com/raja/Backend/security`

### Election operations

- [Admin endpoints](https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/controller): `Backend/src/main/java/com/raja/Backend/controller`
- [Voting endpoints](https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java): `Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java`
- [Vote rules and results](https://github.com/densilraja/online-polling-voting-system/blob/main/Backend/src/main/java/com/raja/Backend/service/VoteService.java): `Backend/src/main/java/com/raja/Backend/service/VoteService.java`
- [Poll domain services](https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/service): `Backend/src/main/java/com/raja/Backend/service`

### Persistence

- [Data repositories](https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/repository): `Backend/src/main/java/com/raja/Backend/repository`
- [User, candidate, position, vote](https://github.com/densilraja/online-polling-voting-system/tree/main/Backend/src/main/java/com/raja/Backend/entity): `Backend/src/main/java/com/raja/Backend/entity`
- **MySQL database**

### Other components

- **Voter or admin**
- **Vote results**

## Connections

- Voter or admin → Route application: uses (evidence: `README.md`)
- Route application → Login and registration: routes to (evidence: `Frontend/src/App.jsx`)
- Route application → Admin management: routes to (evidence: `Frontend/src/App.jsx`)
- Route application → Voting pages: routes to (evidence: `Frontend/src/App.jsx`)
- Login and registration → Auth state: updates auth
- Auth state → HTTP client: stores token
- Admin management → API services: requests data (evidence: `Frontend/src/pages/admin/ManageUsers.jsx`)
- Voting pages → API services: requests data
- API services → HTTP client: uses client (evidence: `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 (evidence: `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 (evidence: `Backend/src/main/java/com/raja/Backend/service/impl/AuthServiceImpl.java`)
- Admin endpoints → Poll domain services: delegates (evidence: `Backend/src/main/java/com/raja/Backend/controller/AdminUserController.java`)
- Voting endpoints → Vote rules and results: casts and queries (evidence: `Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java`)
- Voting endpoints → Poll domain services: loads options (evidence: `Backend/src/main/java/com/raja/Backend/controller/UserVoteController.java`)
- Vote rules and results → Data repositories: reads and saves (evidence: `Backend/src/main/java/com/raja/Backend/service/VoteService.java`)
- Vote rules and results → User, candidate, position, vote: checks vote entities (evidence: `Backend/src/main/java/com/raja/Backend/service/VoteService.java`)
- Data repositories → MySQL database: persists records
- Vote rules and results → Vote results: aggregates (evidence: `Backend/src/main/java/com/raja/Backend/service/VoteService.java`)
