# swapnilbamble1438/votingapp architecture

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

- Interactive diagram: https://gitdiagram.com/swapnilbamble1438/votingapp
- Repository: https://github.com/swapnilbamble1438/votingapp

## Overview

This is a Spring Boot/Thymeleaf voting application. Users register and authenticate, vote for a candidate, and admins view vote totals. The graph covers the documented user/admin capabilities and the sampled controller-to-service, service-to-repository, and security lookup paths. The README documents MySQL/Hibernate; some template and security wiring is not shown in the excerpts, so those links are omitted or marked unverified.

Main entry points: [`MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/UserService.java`](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/UserService.java) (User operations), [`MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/CandidateRepository.java`](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/CandidateRepository.java) (Candidate repository), [`MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/UserRepository.java`](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/UserRepository.java) (User repository), [`MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java`](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java) (User dashboard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_home["Home pages"]
  node_registration["Registration"]
  node_user_dashboard["User dashboard"]
  node_vote["Cast vote"]
  node_admin_dashboard["Admin dashboard"]
  node_templates["Thymeleaf pages"]
end

subgraph group_voting["Voting domain"]
  node_candidate_service["Candidate operations"]
  node_user_service["User operations<br/>[UserService.java]"]
  node_candidate["Candidate record<br/>[Candidate.java]"]
  node_user_record["User record<br/>[User.java]"]
end

subgraph group_identity["Identity and access"]
  node_security_config["Security configuration<br/>[MyConfig.java]"]
  node_user_lookup["Load user identity"]
  node_user_details["Security user details"]
  node_success_handler["Login success handler"]
end

subgraph group_persistence["Persistence"]
  node_candidate_repo["Candidate repository"]
  node_user_repo["User repository"]
  node_mysql[("MySQL database")]
  node_startup["Seed admin and candidates"]
end

node_visitor(("Visitor"))
node_user(("Registered user"))
node_admin(("Administrator"))

node_visitor -.->|"opens"| node_home
node_visitor -.->|"registers"| node_registration
node_user -.->|"views"| node_user_dashboard
node_user -.->|"casts vote"| node_vote
node_admin -.->|"views totals"| node_admin_dashboard
node_registration -->|"creates user"| node_user_service
node_user_dashboard -->|"loads user"| node_user_service
node_vote -->|"loads voter"| node_user_service
node_vote -->|"updates vote"| node_candidate_service
node_admin_dashboard -->|"reads totals"| node_candidate_service
node_user_dashboard -->|"renders"| node_templates
node_admin_dashboard -->|"renders"| node_templates
node_candidate_service -->|"queries and saves"| node_candidate_repo
node_user_service -->|"queries and saves"| node_user_repo
node_user_service -->|"uses repository"| node_candidate_repo
node_candidate_repo -->|"persists"| node_candidate
node_user_repo -->|"persists"| node_user_record
node_security_config -->|"configures lookup"| node_user_lookup
node_user_lookup -->|"finds by email"| node_user_repo
node_user_lookup -->|"wraps user"| node_user_details
node_user_details -->|"reads credentials"| node_user_record
node_startup -->|"seeds admin"| node_user_repo
node_startup -->|"seeds candidates"| node_candidate_repo
node_candidate_repo -.->|"stores records"| node_mysql
node_user_repo -.->|"stores records"| node_mysql

click node_home "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/HomeController.java"
click node_registration "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java"
click node_user_dashboard "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java"
click node_vote "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/CandidateController.java"
click node_admin_dashboard "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/AdminController.java"
click node_candidate_service "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/CandidateService.java"
click node_user_service "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/UserService.java"
click node_candidate "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/model/Candidate.java"
click node_user_record "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/model/User.java"
click node_security_config "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/MyConfig.java"
click node_user_lookup "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/UserDetailsServiceImpl.java"
click node_user_details "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/CustomUserDetails.java"
click node_success_handler "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/CustomSuccessHandler.java"
click node_candidate_repo "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/CandidateRepository.java"
click node_user_repo "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/UserRepository.java"
click node_templates "https://github.com/swapnilbamble1438/votingapp/tree/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/resources/templates"
click node_startup "https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/MySpringBootAa23vVotingAppFinalApplication.java"

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_home,node_registration,node_user_dashboard,node_vote,node_admin_dashboard,node_templates,node_user toneBlue
class node_candidate_service,node_user_service,node_candidate,node_user_record toneAmber
class node_security_config,node_user_lookup,node_user_details,node_success_handler toneMint
class node_candidate_repo,node_user_repo,node_mysql,node_startup toneRose
class node_visitor,node_admin toneIndigo
```

## Components

### Web workflows

- [Home pages](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/HomeController.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/HomeController.java`
- [Registration](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java`
- [User dashboard](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java`
- [Cast vote](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/CandidateController.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/CandidateController.java`
- [Admin dashboard](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/AdminController.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/AdminController.java`
- [Thymeleaf pages](https://github.com/swapnilbamble1438/votingapp/tree/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/resources/templates): `MySpring_Boot_aa23v_VotingApp_Final/src/main/resources/templates`

### Voting domain

- [Candidate operations](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/CandidateService.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/CandidateService.java`
- [User operations](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/UserService.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/UserService.java`
- [Candidate record](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/model/Candidate.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/model/Candidate.java`
- [User record](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/model/User.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/model/User.java`

### Identity and access

- [Security configuration](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/MyConfig.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/MyConfig.java`
- [Load user identity](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/UserDetailsServiceImpl.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/UserDetailsServiceImpl.java`
- [Security user details](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/CustomUserDetails.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/CustomUserDetails.java`
- [Login success handler](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/CustomSuccessHandler.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/CustomSuccessHandler.java`

### Persistence

- [Candidate repository](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/CandidateRepository.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/CandidateRepository.java`
- [User repository](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/UserRepository.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/UserRepository.java`
- **MySQL database**
- [Seed admin and candidates](https://github.com/swapnilbamble1438/votingapp/blob/master/MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/MySpringBootAa23vVotingAppFinalApplication.java): `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/MySpringBootAa23vVotingAppFinalApplication.java`

### Other components

- **Visitor**
- **Registered user**
- **Administrator**

## Connections

- Visitor → Home pages: opens (evidence: `README.md`)
- Visitor → Registration: registers (evidence: `README.md`)
- Registered user → User dashboard: views (evidence: `README.md`)
- Registered user → Cast vote: casts vote (evidence: `README.md`)
- Administrator → Admin dashboard: views totals (evidence: `README.md`)
- Registration → User operations: creates user (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java`)
- User dashboard → User operations: loads user (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java`)
- Cast vote → User operations: loads voter (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/CandidateController.java`)
- Cast vote → Candidate operations: updates vote (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/CandidateController.java`)
- Admin dashboard → Candidate operations: reads totals (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/AdminController.java`)
- User dashboard → Thymeleaf pages: renders (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/UserController.java`)
- Admin dashboard → Thymeleaf pages: renders (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/controller/AdminController.java`)
- Candidate operations → Candidate repository: queries and saves (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/CandidateService.java`)
- User operations → User repository: queries and saves (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/UserService.java`)
- User operations → Candidate repository: uses repository (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/service/UserService.java`)
- Candidate repository → Candidate record: persists (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/CandidateRepository.java`)
- User repository → User record: persists (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/repository/UserRepository.java`)
- Security configuration → Load user identity: configures lookup (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/MyConfig.java`)
- Load user identity → User repository: finds by email (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/UserDetailsServiceImpl.java`)
- Load user identity → Security user details: wraps user (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/UserDetailsServiceImpl.java`)
- Security user details → User record: reads credentials (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/config/CustomUserDetails.java`)
- Seed admin and candidates → User repository: seeds admin (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/MySpringBootAa23vVotingAppFinalApplication.java`)
- Seed admin and candidates → Candidate repository: seeds candidates (evidence: `MySpring_Boot_aa23v_VotingApp_Final/src/main/java/com/MySpringBootAa23vVotingAppFinalApplication.java`)
- Candidate repository → MySQL database: stores records (evidence: `README.md`)
- User repository → MySQL database: stores records (evidence: `README.md`)
