How sujith553/civicpulse works
CivicPulse is a civic-issue reporting and municipal management platform. Citizens register and verify email, authenticate, submit geotagged reports, and track their issues; administrators review reports, change statuses, and view analytics. The React app routes users to these workflows and calls Spring Boot APIs; backend services enforce business rules and persist user/issue data. The README documents mapping, email, JWT/RBAC, rate limiting, and analytics. Some backend wiring and frontend pages were not sampled, so those links reflect documented capabilities or are omitted where evidence is insufficient.
Main entry points: App.jsx React app routing · axiosConfig.js HTTP API client · AuthController.java Authentication endpoints · IssueService.java Issue workflows
Components 25
Citizen experience
- React app routing
frontend/src/App.jsx - Sign-in and signup
frontend/src/pages - Report issue
frontend/src/pages/ReportIssue.jsx - Location picker
frontend/src/components/LocationPickerMap.jsx - Issue history and details
frontend/src/pages/ViewIssues.jsx - Citizen profile
frontend/src/pages/UserProfile.jsx - HTTP API client
frontend/src/api/axiosConfig.js
Municipal operations
- Admin analytics
frontend/src/pages/AdminDashboard.jsx
Backend workflows
- Issue endpoints
backend/src/main/java/com/civicpulse/backend/controller/IssueController.java - Authentication endpoints
backend/src/main/java/com/civicpulse/backend/controller/AuthController.java - Dashboard endpoint
backend/src/main/java/com/civicpulse/backend/controller/DashboardController.java - Issue workflows
backend/src/main/java/com/civicpulse/backend/service/IssueService.java - Registration and verification
backend/src/main/java/com/civicpulse/backend/service/UserService.java - Request and response models
backend/src/main/java/com/civicpulse/backend/dto
Identity and security
- JWT and access control
backend/src/main/java/com/civicpulse/backend/jwt/JwtService.java - Auth rate limiting
backend/src/main/java/com/civicpulse/backend/config/RateLimitingFilter.java
Persistence and messaging
- Issue repository
backend/src/main/java/com/civicpulse/backend/repository/IssueRepository.java - User repository
backend/src/main/java/com/civicpulse/backend/repository/UserRepository.java - User and issue records
backend/src/main/java/com/civicpulse/backend/entity - MySQL database
- Email notifications
backend/src/main/java/com/civicpulse/backend/service/EmailNotificationService.java
Other components
- Citizen
- Administrator
- SMTP mail service
- Nominatim geocoding
Connections 30
- Citizen → React app routing: uses
README.md - Administrator → React app routing: uses
README.md - React app routing → Sign-in and signup: routes to
frontend/src/App.jsx - React app routing → Report issue: routes to
frontend/src/App.jsx - React app routing → Issue history and details: routes to
frontend/src/App.jsx - React app routing → Admin analytics: guards and routes
frontend/src/App.jsx - React app routing → Citizen profile: routes to
frontend/src/App.jsx - Report issue → Location picker: uses map
frontend/src/pages/ReportIssue.jsx - Report issue → HTTP API client: submits reports
frontend/src/pages/ReportIssue.jsx - Issue history and details → HTTP API client: loads issue data
frontend/src/pages/ViewIssues.jsx - Admin analytics → HTTP API client: loads analytics
frontend/src/pages/AdminDashboard.jsx - Location picker → Nominatim geocoding: resolves addresses
README.md - Sign-in and signup → HTTP API client: calls authentication API
frontend/src/pages/ViewIssues.jsx - HTTP API client → Issue endpoints: sends API requests
README.md - HTTP API client → Authentication endpoints: sends API requests
README.md - Issue endpoints → Issue workflows: delegates issue operations
backend/src/main/java/com/civicpulse/backend/controller/IssueController.java - Authentication endpoints → Registration and verification: delegates auth operations
backend/src/main/java/com/civicpulse/backend/controller/AuthController.java - Dashboard endpoint → Issue workflows: requests statistics
backend/src/main/java/com/civicpulse/backend/controller/DashboardController.java - Issue workflows → Issue repository: queries and updates
backend/src/main/java/com/civicpulse/backend/service/IssueService.java - Registration and verification → User repository: reads and saves users
backend/src/main/java/com/civicpulse/backend/service/UserService.java - Issue repository → User and issue records: persists issues
backend/src/main/java/com/civicpulse/backend/repository/IssueRepository.java - User repository → User and issue records: persists users
backend/src/main/java/com/civicpulse/backend/repository/UserRepository.java - User and issue records → MySQL database: stored in
README.md - Issue workflows → Email notifications: notifies status changes
backend/src/main/java/com/civicpulse/backend/service/IssueService.java - Registration and verification → Email notifications: sends verification codes
backend/src/main/java/com/civicpulse/backend/service/UserService.java - Email notifications → SMTP mail service: dispatches email
README.md - Auth rate limiting → Authentication endpoints: limits auth requests
README.md - JWT and access control → Authentication endpoints: authenticates requests
README.md - Issue endpoints → Request and response models: accepts and returns models
backend/src/main/java/com/civicpulse/backend/controller/IssueController.java - Authentication endpoints → Request and response models: accepts and returns models
backend/src/main/java/com/civicpulse/backend/controller/AuthController.java