How bhavnapatel-6/civicpulse-backend works
CivicPulse is a civic-issue reporting and municipal-resolution API. Citizens submit geo-tagged reports, follow their status, and participate through upvotes; authorities review, assign, and resolve complaints, while admins configure categories and SLAs and inspect analytics. The ComplaintService is the central workflow layer; supporting branches include AI validation, priority scoring, SLA monitoring, and reputation/leaderboard features. Several of those branches are documented but their implementation was not sampled, so those links are shown only where README evidence supports them.
Main entry points: ComplaintService.java Complaint lifecycle · AdminController.java Admin API · AuthService.java Authentication · ComplaintController.java Complaint API
Components 25
API entry points
- Complaint API
src/main/java/com/civicPulse/civicPulse_backend/controller/ComplaintController.java - Authority API
src/main/java/com/civicPulse/civicPulse_backend/controller/AuthorityController.java - Admin API
src/main/java/com/civicPulse/civicPulse_backend/controller/AdminController.java - Auth API
src/main/java/com/civicPulse/civicPulse_backend/controller/AuthController.java - Leaderboard API
src/main/java/com/civicPulse/civicPulse_backend/controller/LeaderboardController.java
Complaint workflow
- Complaint lifecycle
src/main/java/com/civicPulse/civicPulse_backend/service/ComplaintService.java - AI validation
src/main/java/com/civicPulse/civicPulse_backend/service/AIValidationService.java - Priority scoring
src/main/java/com/civicPulse/civicPulse_backend/service/PriorityEngine.java - Category management
src/main/java/com/civicPulse/civicPulse_backend/service/CategoryService.java
Civic operations
- SLA monitoring
src/main/java/com/civicPulse/civicPulse_backend/scheduler/SLAScheduler.java - SLA configuration
src/main/java/com/civicPulse/civicPulse_backend/service/SLARuleService.java - Email alerts
src/main/java/com/civicPulse/civicPulse_backend/service/EmailService.java - Admin analytics
src/main/java/com/civicPulse/civicPulse_backend/service/StatsService.java - Rewards and badges
src/main/java/com/civicPulse/civicPulse_backend/service/BadgeService.java
Domain and persistence
- Complaint records
src/main/java/com/civicPulse/civicPulse_backend/entity/Complaint.java - User records
src/main/java/com/civicPulse/civicPulse_backend/entity/User.java - Categories
src/main/java/com/civicPulse/civicPulse_backend/entity/Category.java - Complaint repository
src/main/java/com/civicPulse/civicPulse_backend/repository/ComplaintRepository.java - User repository
src/main/java/com/civicPulse/civicPulse_backend/repository/UserRepository.java
Identity and access
- Authentication
src/main/java/com/civicPulse/civicPulse_backend/service/AuthService.java - JWT service
src/main/java/com/civicPulse/civicPulse_backend/service/JwtService.java
Other components
- Citizen
- Authority
- Admin
- Groq AI service
Connections 23
- Citizen → Complaint API: submits reports
README.md - Authority → Authority API: reviews reports
README.md - Admin → Admin API: manages platform
README.md - Complaint API → Complaint lifecycle: delegates to
src/main/java/com/civicPulse/civicPulse_backend/controller/ComplaintController.java - Authority API → Complaint lifecycle: delegates to
src/main/java/com/civicPulse/civicPulse_backend/controller/AuthorityController.java - Admin API → Category management: manages categories
src/main/java/com/civicPulse/civicPulse_backend/controller/AdminController.java - Admin API → SLA configuration: manages SLA rules
src/main/java/com/civicPulse/civicPulse_backend/controller/AdminController.java - Admin API → Admin analytics: requests metrics
src/main/java/com/civicPulse/civicPulse_backend/controller/AdminController.java - Complaint lifecycle → Complaint repository: reads and writes
src/main/java/com/civicPulse/civicPulse_backend/service/ComplaintService.java - Complaint lifecycle → User repository: looks up users
src/main/java/com/civicPulse/civicPulse_backend/service/ComplaintService.java - Complaint lifecycle → Category management: gets category
src/main/java/com/civicPulse/civicPulse_backend/service/ComplaintService.java - Complaint lifecycle → AI validation: validates report
src/main/java/com/civicPulse/civicPulse_backend/service/ComplaintService.java - Complaint lifecycle → Priority scoring: scores priority
src/main/java/com/civicPulse/civicPulse_backend/service/ComplaintService.java - Complaint repository → Complaint records: persists
src/main/java/com/civicPulse/civicPulse_backend/repository/ComplaintRepository.java - User repository → User records: persists
src/main/java/com/civicPulse/civicPulse_backend/repository/UserRepository.java - AI validation → Groq AI service: requests validation
src/main/java/com/civicPulse/civicPulse_backend/service/AIValidationService.java - Admin API → Authentication: creates authority
src/main/java/com/civicPulse/civicPulse_backend/controller/AdminController.java - Auth API → Authentication: authenticates
- Authentication → JWT service: issues tokens
src/main/java/com/civicPulse/civicPulse_backend/service/AuthService.java - Leaderboard API → User records: ranks citizens
README.md - Complaint lifecycle → SLA configuration: uses deadlines
README.md - SLA monitoring → Email alerts: sends alerts
README.md - Complaint lifecycle → Rewards and badges: awards activity
README.md