How mansi-bk/civic-issue-resolver-springboot works
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: IssueService.java Issue workflow · App.jsx Route entry · IssueDetailPage.jsx Issue details · issues.js Issue requests
Components 29
Web application
- Route entry
civic-issue-resolver-frontend/src/App.jsx - Report issues
civic-issue-resolver-frontend/src/pages/ReportIssuePage.jsx - My issues
civic-issue-resolver-frontend/src/pages/MyIssuesPage.jsx - Issue details
civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx - Admin dashboard
civic-issue-resolver-frontend/src/pages/AdminHome.jsx - Staff dashboard
civic-issue-resolver-frontend/src/pages/StaffHome.jsx - Location picker
civic-issue-resolver-frontend/src/components/LocationPicker.jsx - Status display
civic-issue-resolver-frontend/src/components/StatusBadge.jsx - HTTP client
civic-issue-resolver-frontend/src/api/client.js - Issue requests
civic-issue-resolver-frontend/src/api/issues.js - Auth requests
civic-issue-resolver-frontend/src/api/auth.js - Admin requests
civic-issue-resolver-frontend/src/api/admin.js - Staff requests
civic-issue-resolver-frontend/src/api/staff.js - Geocoding requests
civic-issue-resolver-frontend/src/api/geocode.js
API and workflow
- Issue endpoints
civic-issue-resolver/src/main/java/com/civicissue/controller/IssueController.java - Admin endpoints
civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java - Staff endpoints
civic-issue-resolver/src/main/java/com/civicissue/controller/StaffController.java - Issue workflow
civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java - Photo storage
civic-issue-resolver/src/main/java/com/civicissue/service/CloudinaryService.java
Identity and access
- Session state
civic-issue-resolver-frontend/src/context/AuthContext.jsx - Auth endpoints
civic-issue-resolver/src/main/java/com/civicissue/controller/AuthController.java - Account workflow
civic-issue-resolver/src/main/java/com/civicissue/service/AuthService.java
Issue data
- Issue records
civic-issue-resolver/src/main/java/com/civicissue/repository/IssueRepository.java - User records
civic-issue-resolver/src/main/java/com/civicissue/repository/UserRepository.java - Issue model
civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java - User model
civic-issue-resolver/src/main/java/com/civicissue/entity/User.java - Issue photos
civic-issue-resolver/src/main/java/com/civicissue/entity/IssuePhoto.java - Status history
civic-issue-resolver/src/main/java/com/civicissue/entity/StatusHistory.java
Other components
- Civic users
Connections 33
- Civic users → Route entry: uses
civic-issue-resolver-frontend/src/App.jsx - Route entry → Report issues: routes
civic-issue-resolver-frontend/src/App.jsx - Route entry → My issues: routes
civic-issue-resolver-frontend/src/App.jsx - Route entry → Issue details: routes
civic-issue-resolver-frontend/src/App.jsx - Report issues → Location picker: uses
civic-issue-resolver-frontend/src/pages/ReportIssuePage.jsx - Issue details → Status display: renders
civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx - Admin dashboard → Status display: renders
civic-issue-resolver-frontend/src/pages/AdminHome.jsx - Issue details → Issue requests: requests
civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx - Issue details → Staff requests: requests
civic-issue-resolver-frontend/src/pages/IssueDetailPage.jsx - Admin dashboard → Admin requests: requests
civic-issue-resolver-frontend/src/pages/AdminHome.jsx - Admin dashboard → Issue requests: requests
civic-issue-resolver-frontend/src/pages/AdminHome.jsx - Route entry → Session state: mounted by
civic-issue-resolver-frontend/src/main.jsx - Issue requests → HTTP client: uses
civic-issue-resolver-frontend/src/api/issues.js - Admin requests → HTTP client: uses
- Auth requests → HTTP client: uses
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
civic-issue-resolver/src/main/java/com/civicissue/controller/IssueController.java - Admin endpoints → Issue workflow: delegates
civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java - Admin endpoints → Account workflow: delegates
civic-issue-resolver/src/main/java/com/civicissue/controller/AdminController.java - Staff endpoints → Issue workflow: delegates
civic-issue-resolver/src/main/java/com/civicissue/controller/StaffController.java - Auth endpoints → Account workflow: delegates
civic-issue-resolver/src/main/java/com/civicissue/controller/AuthController.java - Issue workflow → Issue records: reads and writes
civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java - Issue workflow → User records: looks up
civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java - Issue workflow → Photo storage: uploads photos
civic-issue-resolver/src/main/java/com/civicissue/service/IssueService.java - Account workflow → User records: reads and writes
civic-issue-resolver/src/main/java/com/civicissue/service/AuthService.java - Issue records → Issue model: persists
civic-issue-resolver/src/main/java/com/civicissue/repository/IssueRepository.java - User records → User model: persists
civic-issue-resolver/src/main/java/com/civicissue/repository/UserRepository.java - Issue model → Issue photos: has photos
civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java - Issue model → Status history: tracks changes
civic-issue-resolver/src/main/java/com/civicissue/entity/Issue.java - Geocoding requests → Location picker: resolves address
civic-issue-resolver-frontend/src/components/LocationPicker.jsx