How aadityasingh0709/taap-chetna works
Taap Chetna is a citizen heat-health assessment and municipal response platform. Citizens use the web app to assess personal risk, compare travel climates, and explore safer activity times; municipal officers use a role-restricted dashboard for ward conditions, alerts, and heat-health burden, while admins manage authority access. The Node API connects these workflows to weather telemetry, domain calculations, and MongoDB-backed records. The README also describes a macro-burden ML capability. Some frontend-to-API and ML-service wiring is not visible in the excerpts, so those links are omitted or marked unverified.
Main entry points: routes Route dispatch · App.jsx Role-based app · authorityController.js Authority operations · citizenController.js Citizen profile & risk
Components 30
Web experience
- Role-based app
frontend/src/App.jsx - Sign-in & registration
frontend/src/components/AuthModal.jsx - Personal risk
frontend/src/components/PersonalRiskCalculator.jsx - Travel analyzer
frontend/src/components/TravelRiskAnalyzer.jsx - Time-shift planner
frontend/src/components/WhatIfPlanner.jsx - Municipal dashboard
frontend/src/components/MunicipalDashboard.jsx - Burden panel
frontend/src/components/HeatHealthBurdenPanel.jsx - Admin portal
frontend/src/components/AdminPortal.jsx - Authentication state
frontend/src/context/AuthContext.jsx - API client
frontend/src/services/api.js
API workflows
- API server
backend/index.js - Route dispatch
backend/routes - Identity & access
backend/controllers/authController.js - Citizen profile & risk
backend/controllers/citizenController.js - Authority operations
backend/controllers/authorityController.js - Admin operations
backend/controllers/adminController.js - Weather endpoints
backend/controllers/weatherController.js - Travel comparison
backend/controllers/travelController.js - What-if simulation
backend/controllers/whatIfController.js
Heat intelligence
- Weather & geocoding
backend/services/weatherService.js - Heat burden estimates
backend/services/heatBurdenService.js
Platform records
- MongoDB records
backend/config/db.js - Users & profiles
backend/models/User.js - Citizen profiles
backend/models/CitizenProfile.js - Ward records
backend/models/Ward.js - Alert records
backend/models/Alert.js - Authority requests
backend/models/AuthorityRequest.js
ML intelligence
- Burden ML service
ml/serve.py - ML feature utilities
ml/utils/heat_metrics.py
Other components
- Citizen / officer
Connections 32
- Citizen / officer → Role-based app: uses
frontend/src/App.jsx - Role-based app → Personal risk: routes to
frontend/src/App.jsx - Role-based app → Travel analyzer: routes to
frontend/src/App.jsx - Role-based app → Time-shift planner: routes to
frontend/src/App.jsx - Role-based app → Municipal dashboard: routes to
frontend/src/App.jsx - Role-based app → Admin portal: routes to
frontend/src/App.jsx - Role-based app → Sign-in & registration: renders
frontend/src/App.jsx - Sign-in & registration → Authentication state: invokes
frontend/src/components/AuthModal.jsx - Authentication state → API client: uses
frontend/src/context/AuthContext.jsx - API client → API server: requests
- API server → Route dispatch: mounts
backend/index.js - Route dispatch → Identity & access: dispatches
backend/routes/auth.js - Route dispatch → Citizen profile & risk: dispatches
backend/routes/citizen.js - Route dispatch → Authority operations: dispatches
backend/routes/authority.js - Route dispatch → Admin operations: dispatches
backend/routes/admin.js - Route dispatch → Weather endpoints: dispatches
backend/routes/weather.js - Route dispatch → Travel comparison: dispatches
backend/routes/travel.js - Route dispatch → What-if simulation: dispatches
- Identity & access → Users & profiles: reads & writes
backend/controllers/authController.js - Citizen profile & risk → Citizen profiles: reads & writes
backend/controllers/citizenController.js - Citizen profile & risk → Users & profiles: reads & updates
backend/controllers/citizenController.js - Citizen profile & risk → Weather & geocoding: fetches weather
backend/controllers/citizenController.js - Weather endpoints → Weather & geocoding: fetches weather
backend/controllers/weatherController.js - Authority operations → Weather & geocoding: fetches weather
backend/controllers/authorityController.js - Authority operations → Heat burden estimates: requests estimates
backend/controllers/authorityController.js - Authority operations → Ward records: reads
backend/controllers/authorityController.js - Authority operations → Alert records: reads & writes
backend/controllers/authorityController.js - Admin operations → Authority requests: reads & updates
backend/controllers/adminController.js - Admin operations → Users & profiles: creates & updates
backend/controllers/adminController.js - Burden ML service → ML feature utilities: uses metrics
- Heat burden estimates → Burden ML service: may query
- MongoDB records → Users & profiles: stores