How prasanna-ks-85/incident-analysis-system works
Civic Sentinel turns citizen grievances into prioritized, geolocated incidents for administrative response. The main path runs from citizen submission through translation, classification, sentiment and urgency analysis, and CCI scoring, then stores the ticket for administrative review. The README also documents voice/image evidence, cluster detection, geospatial visualization and routing, PDF reporting, and resolution emails. Some integrations are documented rather than visible in sampled implementation; those links are marked accordingly.
Main entry points: grievance_pipeline.py Grievance Orchestrator · citizen_portal.py Citizen Portal · db_handler.py Grievance Database Handler · admin_dashboard.py Admin Dashboard
Components 19
Citizen and Admin Interfaces
- Citizen Portal
citizen_portal.py - MVP Application
7_mvp_application/app.py - Legacy MVP
7_mvp_application/app_OLD.py - Admin Dashboard
admin_dashboard.py
Grievance Analysis
- Grievance Orchestrator
4_pipeline/grievance_pipeline.py - Translation Agent
3_agents/translation_agent/translator.py - Classification Agent
3_agents/classification_agent/classifier.py - Sentiment Agent
3_agents/sentiment_agent/sentiment.py - Urgency Agent
3_agents/urgency_agent/urgency_detect.py - CCI Decision Agent
3_agents/decision_agent/decision.py
Incident Operations
- Location Manager
utils/location_manager.py - Cluster Detection
utils/cluster_engine.py - Facility and Route Engine
utils/route_engine.py - Google Maps Services
Persistence and Reporting
- Grievance Database Handler
utils/db_handler.py - MongoDB Atlas
- PDF Report Generator
utils/report_generator.py
Other components
- Citizen
- Citizen Email Service
Connections 20
- Citizen → Citizen Portal: submits reports
README.md - Citizen Portal → Grievance Orchestrator: analyzes complaints
citizen_portal.py - Citizen Portal → Location Manager: gets GPS
citizen_portal.py - Citizen Portal → Grievance Database Handler: saves tickets
citizen_portal.py - Grievance Orchestrator → Translation Agent: translates text
4_pipeline/grievance_pipeline.py - Grievance Orchestrator → Classification Agent: classifies text
4_pipeline/grievance_pipeline.py - Grievance Orchestrator → Sentiment Agent: analyzes sentiment
4_pipeline/grievance_pipeline.py - Grievance Orchestrator → Urgency Agent: detects urgency
4_pipeline/grievance_pipeline.py - Grievance Orchestrator → CCI Decision Agent: computes CCI
4_pipeline/grievance_pipeline.py - MVP Application → Grievance Orchestrator: analyzes complaints
7_mvp_application/app.py - MVP Application → PDF Report Generator: generates PDF
7_mvp_application/app.py - Legacy MVP → Grievance Orchestrator: analyzes complaints
7_mvp_application/app_OLD.py - Admin Dashboard → Grievance Database Handler: fetches tickets
admin_dashboard.py - Admin Dashboard → Cluster Detection: scans incidents
admin_dashboard.py - Admin Dashboard → Facility and Route Engine: requests routes
admin_dashboard.py - Facility and Route Engine → Google Maps Services: queries places and directions
utils/route_engine.py - Cluster Detection → Grievance Database Handler: reads tickets; upserts clusters
utils/cluster_engine.py - Grievance Database Handler → MongoDB Atlas: reads and writes
utils/db_handler.py - Citizen Portal → Citizen Email Service: receives resolution updates
README.md - Citizen Portal → Citizen Portal: uploads image evidence
README.md