How ashneetjha/fixmycity works
FixMyCity is a civic issue-reporting platform: residents submit geolocated infrastructure reports, the backend checks nearby reports and assigns priority, and users can follow status updates while viewing issue clusters and dashboard metrics. Staff can update issue status with an attributed note. The README documents the frontend-to-API relationship and API capabilities; sampled backend code shows controller-to-service calls and service persistence. The frontend source was read but its UI-to-feature wiring is not represented here, so those feature links are documented rather than inferred from unsampled code.
Main entry points: IssueController.java REST endpoints · IssueService.java Issue operations · IssueRepository.java Issue repository · IssueUpdateRepository.java Timeline repository
Components 11
Citizen interface
- Map and dashboard
frontend/src/main.tsx
Issue API
- REST endpoints
backend/src/main/java/com/fixmycity/issue/IssueController.java - Report validation
backend/src/main/java/com/fixmycity/issue/IssueRequest.java - Status input
backend/src/main/java/com/fixmycity/issue/StatusRequest.java
Report workflow
- Issue operations
backend/src/main/java/com/fixmycity/issue/IssueService.java - Status timeline
backend/src/main/java/com/fixmycity/issue/IssueUpdate.java
Issue records
- Issue records
backend/src/main/java/com/fixmycity/issue/Issue.java - Issue repository
backend/src/main/java/com/fixmycity/issue/IssueRepository.java - Timeline repository
backend/src/main/java/com/fixmycity/issue/IssueUpdateRepository.java - Issue database
Other components
- Residents and staff
Connections 11
- Residents and staff → Map and dashboard: use
README.md - Map and dashboard → REST endpoints: calls API
README.md - REST endpoints → Issue operations: dispatches
backend/src/main/java/com/fixmycity/issue/IssueController.java - REST endpoints → Report validation: accepts
backend/src/main/java/com/fixmycity/issue/IssueController.java - REST endpoints → Status input: accepts
backend/src/main/java/com/fixmycity/issue/IssueController.java - Issue operations → Issue repository: reads and writes
backend/src/main/java/com/fixmycity/issue/IssueService.java - Issue operations → Timeline repository: reads and writes
backend/src/main/java/com/fixmycity/issue/IssueService.java - Issue repository → Issue records: stores
backend/src/main/java/com/fixmycity/issue/IssueRepository.java - Timeline repository → Status timeline: stores
backend/src/main/java/com/fixmycity/issue/IssueUpdateRepository.java - Issue repository → Issue database: persists
- Timeline repository → Issue database: persists