# mansi-bk/civic-issue-resolver-springboot architecture

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

- Interactive diagram: https://gitdiagram.com/mansi-bk/civic-issue-resolver-springboot
- Repository: https://github.com/mansi-bk/civic-issue-resolver-springboot

## Overview

This is a role-based civic issue reporting and resolution system: citizens submit geolocated reports and photos, administrators assign work and verify outcomes, and staff record resolution. The React application routes users to role-specific screens and calls a Spring API; backend services enforce workflow rules and persist issue and account data. The source index and excerpts support the main routing, controller/service, authentication, and persistence relationships; some page and integration behavior is unsampled, so those links are omitted or marked unverified.

Main entry points: [`civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java`](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java) (Issue workflow), [`civic-issue-resolver-frontend/src/App.jsx`](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/App.jsx) (Route entry), [`civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx`](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx) (Issue details), [`civic-issue-resolver-frontend/src/api/issues.js`](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/issues.js) (Issue requests)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web application"]
  node_app["Route entry<br/>[App.jsx]"]
  node_report["Report issues"]
  node_myissues["My issues<br/>[MyIssuesPage.jsx]"]
  node_detail["Issue details"]
  node_adminui["Admin dashboard<br/>[AdminHome.jsx]"]
  node_staffui["Staff dashboard<br/>[StaffHome.jsx]"]
  node_location["Location picker<br/>[LocationPicker.jsx]"]
  node_statusbadge["Status display<br/>[StatusBadge.jsx]"]
  node_apiclient["HTTP client<br/>[client.js]"]
  node_issueapi["Issue requests<br/>[issues.js]"]
  node_authapi["Auth requests<br/>[auth.js]"]
  node_adminapi["Admin requests<br/>[admin.js]"]
  node_staffapi["Staff requests<br/>[staff.js]"]
  node_geocodeapi["Geocoding requests<br/>[geocode.js]"]
end

subgraph group_api["API and workflow"]
  node_issuecontroller["Issue endpoints"]
  node_admincontroller["Admin endpoints"]
  node_staffcontroller["Staff endpoints"]
  node_issueservice["Issue workflow<br/>[IssueService.java]"]
  node_cloudinary["Photo storage"]
end

subgraph group_identity["Identity and access"]
  node_authctx["Session state<br/>[AuthContext.jsx]"]
  node_authcontroller["Auth endpoints"]
  node_authservice["Account workflow<br/>[AuthService.java]"]
end

subgraph group_domain["Issue data"]
  node_issue_repo[("Issue records")]
  node_user_repo[("User records")]
  node_issue_model["Issue model<br/>[Issue.java]"]
  node_user_model["User model<br/>[User.java]"]
  node_photo_model["Issue photos<br/>[IssuePhoto.java]"]
  node_history_model["Status history<br/>[StatusHistory.java]"]
end

node_citizen(("Civic users"))

node_citizen -->|"uses"| node_app
node_app -->|"routes"| node_report
node_app -->|"routes"| node_myissues
node_app -->|"routes"| node_detail
node_report -.->|"uses"| node_location
node_detail -->|"renders"| node_statusbadge
node_adminui -->|"renders"| node_statusbadge
node_detail -->|"requests"| node_issueapi
node_detail -->|"requests"| node_staffapi
node_adminui -->|"requests"| node_adminapi
node_adminui -->|"requests"| node_issueapi
node_app -->|"mounted by"| node_authctx
node_issueapi -.->|"uses"| node_apiclient
node_adminapi -.->|"uses"| node_apiclient
node_authapi -->|"uses"| node_apiclient
node_issueapi -.->|"calls"| node_issuecontroller
node_adminapi -.->|"calls"| node_admincontroller
node_staffapi -.->|"calls"| node_staffcontroller
node_authapi -.->|"calls"| node_authcontroller
node_issuecontroller -->|"delegates"| node_issueservice
node_admincontroller -->|"delegates"| node_issueservice
node_admincontroller -->|"delegates"| node_authservice
node_staffcontroller -->|"delegates"| node_issueservice
node_authcontroller -->|"delegates"| node_authservice
node_issueservice -->|"reads and writes"| node_issue_repo
node_issueservice -->|"looks up"| node_user_repo
node_issueservice -->|"uploads photos"| node_cloudinary
node_authservice -->|"reads and writes"| node_user_repo
node_issue_repo -->|"persists"| node_issue_model
node_user_repo -->|"persists"| node_user_model
node_issue_model -->|"has photos"| node_photo_model
node_issue_model -->|"tracks changes"| node_history_model
node_geocodeapi -->|"resolves address"| node_location

click node_app "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/App.jsx"
click node_report "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/ReportIssuePage.jsx"
click node_myissues "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/MyIssuesPage.jsx"
click node_detail "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx"
click node_adminui "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/AdminHome.jsx"
click node_staffui "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/StaffHome.jsx"
click node_location "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/components/LocationPicker.jsx"
click node_statusbadge "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/components/StatusBadge.jsx"
click node_authctx "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/context/AuthContext.jsx"
click node_apiclient "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/client.js"
click node_issueapi "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/issues.js"
click node_authapi "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/auth.js"
click node_adminapi "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/admin.js"
click node_staffapi "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/staff.js"
click node_geocodeapi "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/geocode.js"
click node_issuecontroller "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/IssueController.java"
click node_admincontroller "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java"
click node_staffcontroller "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/StaffController.java"
click node_authcontroller "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/AuthController.java"
click node_issueservice "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java"
click node_authservice "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/service/AuthService.java"
click node_cloudinary "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/service/CloudinaryService.java"
click node_issue_repo "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/repository/IssueRepository.java"
click node_user_repo "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/repository/UserRepository.java"
click node_issue_model "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java"
click node_user_model "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/User.java"
click node_photo_model "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/IssuePhoto.java"
click node_history_model "https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/StatusHistory.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_app,node_report,node_myissues,node_detail,node_adminui,node_staffui,node_location,node_statusbadge,node_apiclient,node_issueapi,node_authapi,node_adminapi,node_staffapi,node_geocodeapi,node_citizen toneBlue
class node_issuecontroller,node_admincontroller,node_staffcontroller,node_issueservice,node_cloudinary toneAmber
class node_authctx,node_authcontroller,node_authservice toneMint
class node_issue_repo,node_user_repo,node_issue_model,node_user_model,node_photo_model,node_history_model toneRose
```

## Components

### Web application

- [Route entry](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/App.jsx): `civic-issue-resolver-frontend/src/App.jsx`
- [Report issues](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/ReportIssuePage.jsx): `civic-issue-resolver-frontend/src/pages/ReportIssuePage.jsx`
- [My issues](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/MyIssuesPage.jsx): `civic-issue-resolver-frontend/src/pages/MyIssuesPage.jsx`
- [Issue details](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx): `civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx`
- [Admin dashboard](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/AdminHome.jsx): `civic-issue-resolver-frontend/src/pages/AdminHome.jsx`
- [Staff dashboard](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/pages/StaffHome.jsx): `civic-issue-resolver-frontend/src/pages/StaffHome.jsx`
- [Location picker](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/components/LocationPicker.jsx): `civic-issue-resolver-frontend/src/components/LocationPicker.jsx`
- [Status display](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/components/StatusBadge.jsx): `civic-issue-resolver-frontend/src/components/StatusBadge.jsx`
- [HTTP client](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/client.js): `civic-issue-resolver-frontend/src/api/client.js`
- [Issue requests](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/issues.js): `civic-issue-resolver-frontend/src/api/issues.js`
- [Auth requests](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/auth.js): `civic-issue-resolver-frontend/src/api/auth.js`
- [Admin requests](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/admin.js): `civic-issue-resolver-frontend/src/api/admin.js`
- [Staff requests](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/staff.js): `civic-issue-resolver-frontend/src/api/staff.js`
- [Geocoding requests](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/api/geocode.js): `civic-issue-resolver-frontend/src/api/geocode.js`

### API and workflow

- [Issue endpoints](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/IssueController.java): `civic-issue-resolver/src/main/java/com/civicissue/controller/IssueController.java`
- [Admin endpoints](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java): `civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java`
- [Staff endpoints](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/StaffController.java): `civic-issue-resolver/src/main/java/com/civicissue/controller/StaffController.java`
- [Issue workflow](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java): `civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java`
- [Photo storage](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/service/CloudinaryService.java): `civic-issue-resolver/src/main/java/com/civicissue/service/CloudinaryService.java`

### Identity and access

- [Session state](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver-frontend/src/context/AuthContext.jsx): `civic-issue-resolver-frontend/src/context/AuthContext.jsx`
- [Auth endpoints](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/controller/AuthController.java): `civic-issue-resolver/src/main/java/com/civicissue/controller/AuthController.java`
- [Account workflow](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/service/AuthService.java): `civic-issue-resolver/src/main/java/com/civicissue/service/AuthService.java`

### Issue data

- [Issue records](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/repository/IssueRepository.java): `civic-issue-resolver/src/main/java/com/civicissue/repository/IssueRepository.java`
- [User records](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/repository/UserRepository.java): `civic-issue-resolver/src/main/java/com/civicissue/repository/UserRepository.java`
- [Issue model](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java): `civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java`
- [User model](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/User.java): `civic-issue-resolver/src/main/java/com/civicissue/entity/User.java`
- [Issue photos](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/IssuePhoto.java): `civic-issue-resolver/src/main/java/com/civicissue/entity/IssuePhoto.java`
- [Status history](https://github.com/mansi-bk/civic-issue-resolver-springboot/blob/main/civic-issue-resolver/src/main/java/com/civicissue/entity/StatusHistory.java): `civic-issue-resolver/src/main/java/com/civicissue/entity/StatusHistory.java`

### Other components

- **Civic users**

## Connections

- Civic users → Route entry: uses (evidence: `civic-issue-resolver-frontend/src/App.jsx`)
- Route entry → Report issues: routes (evidence: `civic-issue-resolver-frontend/src/App.jsx`)
- Route entry → My issues: routes (evidence: `civic-issue-resolver-frontend/src/App.jsx`)
- Route entry → Issue details: routes (evidence: `civic-issue-resolver-frontend/src/App.jsx`)
- Report issues → Location picker: uses (evidence: `civic-issue-resolver-frontend/src/pages/ReportIssuePage.jsx`)
- Issue details → Status display: renders (evidence: `civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx`)
- Admin dashboard → Status display: renders (evidence: `civic-issue-resolver-frontend/src/pages/AdminHome.jsx`)
- Issue details → Issue requests: requests (evidence: `civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx`)
- Issue details → Staff requests: requests (evidence: `civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx`)
- Admin dashboard → Admin requests: requests (evidence: `civic-issue-resolver-frontend/src/pages/AdminHome.jsx`)
- Admin dashboard → Issue requests: requests (evidence: `civic-issue-resolver-frontend/src/pages/AdminHome.jsx`)
- Route entry → Session state: mounted by (evidence: `civic-issue-resolver-frontend/src/main.jsx`)
- Issue requests → HTTP client: uses (evidence: `civic-issue-resolver-frontend/src/api/issues.js`)
- Admin requests → HTTP client: uses
- Auth requests → HTTP client: uses (evidence: `civic-issue-resolver-frontend/src/api/auth.js`)
- Issue requests → Issue endpoints: calls
- Admin requests → Admin endpoints: calls
- Staff requests → Staff endpoints: calls
- Auth requests → Auth endpoints: calls
- Issue endpoints → Issue workflow: delegates (evidence: `civic-issue-resolver/src/main/java/com/civicissue/controller/IssueController.java`)
- Admin endpoints → Issue workflow: delegates (evidence: `civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java`)
- Admin endpoints → Account workflow: delegates (evidence: `civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java`)
- Staff endpoints → Issue workflow: delegates (evidence: `civic-issue-resolver/src/main/java/com/civicissue/controller/StaffController.java`)
- Auth endpoints → Account workflow: delegates (evidence: `civic-issue-resolver/src/main/java/com/civicissue/controller/AuthController.java`)
- Issue workflow → Issue records: reads and writes (evidence: `civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java`)
- Issue workflow → User records: looks up (evidence: `civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java`)
- Issue workflow → Photo storage: uploads photos (evidence: `civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java`)
- Account workflow → User records: reads and writes (evidence: `civic-issue-resolver/src/main/java/com/civicissue/service/AuthService.java`)
- Issue records → Issue model: persists (evidence: `civic-issue-resolver/src/main/java/com/civicissue/repository/IssueRepository.java`)
- User records → User model: persists (evidence: `civic-issue-resolver/src/main/java/com/civicissue/repository/UserRepository.java`)
- Issue model → Issue photos: has photos (evidence: `civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java`)
- Issue model → Status history: tracks changes (evidence: `civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java`)
- Geocoding requests → Location picker: resolves address (evidence: `civic-issue-resolver-frontend/src/components/LocationPicker.jsx`)
