How vaibhavdsonawane/citypulse-ai works
CityPulse AI is a civic-issue reporting and municipal response platform. Citizens register, submit a geolocated complaint with optional photos and text, and follow its status; AI services analyze the report before it enters administrative review and department assignment. Administrators review predictions, dispatch work, and advance complaint status, while public and administrative views surface impact and geographic hotspots. The source excerpts show the main Flask routes, prediction services, and relational models; forecast and some interface capabilities are documented or indexed but not fully sampled.
Main entry points: admin_routes.py Admin command center · citizen_routes.py Citizen portal · models.py Complaint and workflow models · __init__.py Flask application
Components 16
Access and portals
- Flask application
app/__init__.py - Authentication
app/routes/auth_routes.py - Portal and map UI
app/templates
Complaint intake and AI
- Citizen portal
app/routes/citizen_routes.py - Photo verification
app/controllers/cv_service.py - Text priority engine
app/controllers/nlp_service.py - Severity prediction
app/controllers/ml_service.py
Municipal operations
- Admin command center
app/routes/admin_routes.py - Public impact views
app/routes/main_routes.py - AJAX dispatch controls
app/static/js/main.js - Hotspot clustering
app/controllers/hotspot_service.py - Complaint forecasting
app/controllers/forecast_service.py
Application data
- Complaint and workflow models
app/models.py - SQLite database
citypulse.db
Other components
- Citizen
- Administrator
Connections 23
- Citizen → Authentication: registers or signs in
app/routes/auth_routes.py - Administrator → Authentication: signs in
app/routes/auth_routes.py - Flask application → Authentication: registers route
app/__init__.py - Flask application → Citizen portal: registers route
app/__init__.py - Flask application → Admin command center: registers route
app/__init__.py - Flask application → Public impact views: registers route
app/__init__.py - Citizen → Citizen portal: reports and tracks
README.md - Administrator → Admin command center: reviews and dispatches
README.md - Citizen portal → Photo verification: analyzes photos
app/routes/citizen_routes.py - Citizen portal → Text priority engine: scores descriptions
app/routes/citizen_routes.py - Citizen portal → Severity prediction: predicts severity
app/routes/citizen_routes.py - Citizen portal → Complaint and workflow models: records reports
app/routes/citizen_routes.py - Admin command center → Complaint and workflow models: updates workflow
app/routes/admin_routes.py - Admin command center → Complaint forecasting: requests forecast
app/routes/admin_routes.py - Admin command center → Hotspot clustering: requests clusters
app/routes/admin_routes.py - Public impact views → Complaint and workflow models: queries city data
app/routes/main_routes.py - Public impact views → Hotspot clustering: analyzes complaints
app/routes/main_routes.py - Authentication → Complaint and workflow models: looks up users
app/routes/auth_routes.py - Complaint and workflow models → SQLite database: persists records
app/models.py - Citizen portal → Portal and map UI: serves portal views
README.md - Admin command center → Portal and map UI: serves admin views
README.md - AJAX dispatch controls → Admin command center: sends AJAX dispatch
README.md - Admin command center → Administrator: shows GIS and review queue
README.md