How nithish23013509/smart-public-grievance-managment-system works
This repository is a public-grievance web application with a React client and a Python department-recommendation service. A citizen submits a text or voice grievance with optional location and supporting image; the client sends it to the documented backend, where grievances are stored and AI classification/routing is available. Citizens track progress, while officers and administrators manage complaints and review AI recommendations. The tree does not include the documented Spring backend or database implementation, so these appear only as external systems; duplicate detection is a README capability but its implementation is not identifiable here.
Main entry points: complaintService.js Complaint API service · AppRoutes.jsx Role-based routes · citizen Citizen pages · api.js HTTP API client
Components 23
Citizen client
- Role-based routes
frontend/src/routes/AppRoutes.jsx - Authentication state
frontend/src/context/AuthContext.jsx - Citizen pages
frontend/src/pages/citizen - Notifications and profile
frontend/src/pages - Complaint location map
frontend/src/components/complaint/ComplaintLocationMap.jsx - Speech input
frontend/src/services/speechService.js
Complaint operations
- Admin pages
frontend/src/pages/admin - Officer pages
frontend/src/pages/officer - AI review display
frontend/src/pages/officer/AiReviewDetail.jsx - AI analytics
frontend/src/pages/admin/AiAnalyticsDashboard.jsx
AI recommendation
- Python NLP service
ai-department-recommendation/ml/app.py - Category and department recommendation
ai-department-recommendation/ml/recommendation_service.py - Confidence decision
ai-department-recommendation/ml/recommendation_decision.py - Model preparation and training
ai-department-recommendation/ml
Client services
- Complaint API service
frontend/src/services/complaintService.js - Authentication service
frontend/src/services/authService.js - Department service
frontend/src/services/departmentService.js - Location service
frontend/src/services/locationService.js - Notification service
frontend/src/services/notificationService.js - HTTP API client
frontend/src/services/api.js
Other components
- Citizen
- Spring Boot API
- MySQL grievance store
Connections 26
- Citizen → Role-based routes: uses
README.md - Role-based routes → Citizen pages: routes to
frontend/src/routes/AppRoutes.jsx - Role-based routes → Admin pages: routes to
frontend/src/routes/AppRoutes.jsx - Role-based routes → Officer pages: routes to
frontend/src/routes/AppRoutes.jsx - Role-based routes → Notifications and profile: routes to
frontend/src/routes/AppRoutes.jsx - Citizen pages → Complaint API service: submits and tracks
frontend/src/pages/citizen/CreateComplaint.jsx - Citizen pages → Complaint location map: renders
frontend/src/pages/citizen/CreateComplaint.jsx - Citizen pages → Location service: loads locations
frontend/src/pages/citizen/CreateComplaint.jsx - Citizen pages → Speech input: uses speech input
frontend/src/pages/citizen/CreateComplaint.jsx - Officer pages → Complaint API service: reviews complaints
frontend/src/pages/officer/AiReviewQueue.jsx - AI review display → Complaint API service: loads and submits review
frontend/src/pages/officer/AiReviewDetail.jsx - AI review display → Department service: loads departments
frontend/src/pages/officer/AiReviewDetail.jsx - Admin pages → Complaint API service: manages complaints
frontend/src/pages/admin/AdminComplaintDetails.jsx - AI analytics → Complaint API service: requests analytics
- Notifications and profile → Notification service: loads notifications
frontend/src/pages/Notifications.jsx - Authentication state → Authentication service: authenticates
frontend/src/context/AuthContext.jsx - Authentication service → HTTP API client: sends auth requests
frontend/src/services/authService.js - Complaint API service → HTTP API client: sends complaint requests
frontend/src/services/complaintService.js - Department service → HTTP API client: sends department requests
frontend/src/services/departmentService.js - Location service → HTTP API client: sends location requests
frontend/src/services/locationService.js - HTTP API client → Spring Boot API: calls REST API
README.md - Spring Boot API → MySQL grievance store: reads and writes
README.md - Spring Boot API → Python NLP service: requests NLP routing
README.md - Python NLP service → Category and department recommendation: dispatches recommendation
ai-department-recommendation/ml/app.py - Category and department recommendation → Confidence decision: gets decision
ai-department-recommendation/ml/recommendation_service.py - Model preparation and training → Category and department recommendation: supplies trained models
ai-department-recommendation/ml/app.py