How satishmeher26/civiclens-ai works
CivicLens AI is a civic-issue reporting and municipal operations platform. Citizens submit and track geolocated complaints; backend services classify, deduplicate, score, and route them; municipal staff dispatch work and reviewers verify resolution. The product also exposes GIS and analytics for recurrence and hotspot intelligence. The graph follows documented workflows and source-index references; unsampled frontend and backend details are represented at subsystem level where exact implementation links are not shown.
Main entry points: reports_routes.py Report intake · api.ts REST client · issues_routes.py Issue lifecycle API · App.tsx Web application
Components 25
Citizen reporting
- Web application
frontend/src/App.tsx - Report wizard
frontend/src/components/citizen/ReportModal.tsx - Issue tracking
frontend/src/components/citizen/TrackModal.tsx - REST client
frontend/src/services/api.ts
Issue intelligence
- Report intake
backend/app/api/v1/reports_routes.py - AI classification
backend/app/services/classification_service.py - Duplicate detection
backend/app/services/duplicate_service.py - Priority scoring
backend/app/services/priority_service.py - Department routing
backend/app/services/routing_service.py - Generative AI
backend/app/services/genai_service.py - Civic issue model
backend/app/models/domain.py
Municipal operations
- Issue and report store
backend/app/core/database.py - Authority desk
frontend/src/pages/AuthorityPortal.tsx - Issue lifecycle API
backend/app/api/v1/issues_routes.py - Work verification
backend/app/services/verification_service.py - Role and session
frontend/src/context/AuthContext.tsx - Authentication API
backend/app/api/v1/auth_routes.py - Access control
backend/app/services/auth_service.py
GIS and analytics
- GIS explorer
frontend/src/components/gis/CivicMap.tsx - GIS API
backend/app/api/v1/gis_routes.py - Spatial analysis
backend/app/services/spatial_service.py - Analytics dashboard
frontend/src/components/analytics/AnalyticsDashboard.tsx - Analytics API
backend/app/api/v1/analytics_routes.py - Recurrence analysis
backend/app/services/recurrence_service.py
Other components
- Citizen
Connections 31
- Citizen → Web application: uses
README.md - Web application → Report wizard: opens
frontend/src/App.tsx - Web application → Issue tracking: opens
frontend/src/App.tsx - Report wizard → REST client: submits report
frontend/src/components/citizen/ReportModal.tsx - Issue tracking → REST client: requests tracking
- REST client → Report intake: calls report endpoints
frontend/src/services/api.ts - REST client → Issue lifecycle API: calls issue endpoints
frontend/src/services/api.ts - Report intake → AI classification: classifies
backend/app/api/v1/reports_routes.py - Report intake → Duplicate detection: checks duplicates
backend/app/api/v1/reports_routes.py - Report intake → Priority scoring: scores urgency
backend/app/api/v1/reports_routes.py - Report intake → Department routing: recommends department
backend/app/api/v1/reports_routes.py - Report intake → Issue and report store: stores report
backend/app/api/v1/reports_routes.py - Duplicate detection → Spatial analysis: uses distance analysis
backend/app/services/duplicate_service.py - Priority scoring → Spatial analysis: uses proximity factors
backend/app/services/priority_service.py - Report intake → Generative AI: requests AI assistance
- Report intake → Civic issue model: builds issue records
backend/app/api/v1/reports_routes.py - Authority desk → REST client: requests operations
frontend/src/pages/AuthorityPortal.tsx - Authority desk → Web application: is presented by
frontend/src/App.tsx - Issue lifecycle API → Issue and report store: reads and updates
backend/app/api/v1/issues_routes.py - Issue lifecycle API → Department routing: looks up department
backend/app/api/v1/issues_routes.py - Issue lifecycle API → Work verification: verifies evidence
backend/app/api/v1/issues_routes.py - Role and session → Authentication API: authenticates
frontend/src/context/AuthContext.tsx - Authentication API → Access control: delegates authentication
backend/app/api/v1/auth_routes.py - Access control → Issue and report store: reads and writes accounts
backend/app/services/auth_service.py - GIS explorer → GIS API: requests map data
- GIS API → Issue and report store: reads issues
backend/app/api/v1/gis_routes.py - GIS API → Spatial analysis: uses spatial analysis
backend/app/api/v1/gis_routes.py - Analytics dashboard → REST client: requests analytics
- REST client → Analytics API: calls analytics endpoints
frontend/src/services/api.ts - Analytics API → Recurrence analysis: analyzes recurrence
- Recurrence analysis → Spatial analysis: uses spatial analysis
backend/app/services/recurrence_service.py