How deo-haneesh/city_pulse works
CityPulse is a disaster-intelligence dashboard: it loads regional signals, combines them with reports and mitigation state to assess sector risk, then presents prioritized zones and supports operator actions. The README documents the map, ranked queue, live feed, recommendations, dispatch, and scenario controls; source excerpts show the frontend context coordinating live ingestion, Supabase snapshots, report creation/import, and scoring. Backend function details and some UI wiring are supported by the SOURCE INDEX rather than inspected excerpts, so uncertain connections are omitted.
Main entry points: DisasterContext.jsx Disaster State · App.jsx Dashboard Shell · ZoneDetailDrawer.jsx Zone Detail · LiveStreamControls.jsx Stream Controls
Components 30
Command Dashboard
- Dashboard Shell
src/App.jsx - Tactical Map
src/components/map/CityMap.jsx - Priority Queue
src/components/queue/PriorityQueue.jsx - Live Report Feed
src/components/feed/LiveReportFeed.jsx - Zone Detail
src/components/detail/ZoneDetailDrawer.jsx - Risk Trend Chart
src/components/detail/RiskTrendChart.jsx - Action Recommendations
src/components/detail/RecommendationCard.jsx
Operator Controls
- Command Header
src/components/header/CommandHeader.jsx - Stream Controls
src/components/header/LiveStreamControls.jsx - Manual Reports
src/components/header/ManualReportModal.jsx - Report Import
src/components/header/DataImportModal.jsx - Scenario Replay
src/components/header/ReplayControls.jsx - Supabase Auth
src/components/header/SupabaseAuthControl.jsx
Risk Intelligence
- Disaster State
src/context/DisasterContext.jsx - Risk Scoring Engine
src/utils/scoringEngine.js - Regional Sector Data
src/data/realWorldRegions.js - Live Signal Ingestion
src/services/realWorldDataService.js
Supabase Functions
- Create Report
supabase/functions/create-report/index.ts - Import Reports
supabase/functions/import-reports/index.ts - Telemetry Ingestion
supabase/functions/ingest-telemetry/index.ts - Resource Dispatch
supabase/functions/dispatch-resource/index.ts - Server Scoring
supabase/functions/_shared/scoring.ts - Server Supabase Access
supabase/functions/_shared/supabase.ts
Data Services
- Supabase Data Service
src/services/supabaseDataService.js - Supabase Client
src/services/supabaseClient.js - Supabase Database
supabase/migrations/202608230001_initial_schema.sql
Other components
- Emergency Operator
- USGS Feed
- Open-Meteo Feed
- NASA EONET Feed
Connections 46
- Emergency Operator → Dashboard Shell: uses
README.md - Dashboard Shell → Disaster State: provides state
src/App.jsx - Dashboard Shell → Command Header: renders
src/App.jsx - Dashboard Shell → Tactical Map: renders
src/App.jsx - Dashboard Shell → Priority Queue: renders
src/App.jsx - Dashboard Shell → Live Report Feed: renders
src/App.jsx - Dashboard Shell → Zone Detail: renders
src/App.jsx - Tactical Map → Disaster State: reads state
src/components/map/CityMap.jsx - Priority Queue → Disaster State: reads state
src/components/queue/PriorityQueue.jsx - Live Report Feed → Disaster State: reads state
src/components/feed/LiveReportFeed.jsx - Zone Detail → Disaster State: reads and acts
src/components/detail/ZoneDetailDrawer.jsx - Zone Detail → Risk Trend Chart: renders
src/components/detail/ZoneDetailDrawer.jsx - Zone Detail → Action Recommendations: renders
src/components/detail/ZoneDetailDrawer.jsx - Command Header → Disaster State: reads state
src/components/header/CommandHeader.jsx - Command Header → Stream Controls: renders
src/components/header/CommandHeader.jsx - Stream Controls → Manual Reports: opens
src/components/header/LiveStreamControls.jsx - Stream Controls → Report Import: opens
src/components/header/LiveStreamControls.jsx - Stream Controls → Scenario Replay: renders
src/components/header/LiveStreamControls.jsx - Stream Controls → Supabase Auth: renders
src/components/header/LiveStreamControls.jsx - Manual Reports → Disaster State: submits report
src/components/header/ManualReportModal.jsx - Report Import → Disaster State: imports reports
src/components/header/DataImportModal.jsx - Scenario Replay → Disaster State: controls replay
src/components/header/ReplayControls.jsx - Supabase Auth → Supabase Client: authenticates
src/components/header/SupabaseAuthControl.jsx - Disaster State → Regional Sector Data: selects region
src/context/DisasterContext.jsx - Disaster State → Live Signal Ingestion: requests live data
src/context/DisasterContext.jsx - Disaster State → Supabase Data Service: loads and invokes
src/context/DisasterContext.jsx - Disaster State → Risk Scoring Engine: calculates actions
src/context/DisasterContext.jsx - Live Signal Ingestion → USGS Feed: fetches events
src/services/realWorldDataService.js - Live Signal Ingestion → Open-Meteo Feed: fetches weather
src/services/realWorldDataService.js - Live Signal Ingestion → NASA EONET Feed: fetches hazards
src/services/realWorldDataService.js - Supabase Data Service → Supabase Client: queries through
src/services/supabaseDataService.js - Supabase Data Service → Supabase Database: reads and writes
- Supabase Data Service → Create Report: invokes function
- Supabase Data Service → Import Reports: invokes function
- Supabase Client → Supabase Database: connects
- Create Report → Server Scoring: uses
supabase/functions/create-report/index.ts - Create Report → Server Supabase Access: accesses data
supabase/functions/create-report/index.ts - Import Reports → Server Scoring: uses
supabase/functions/import-reports/index.ts - Import Reports → Server Supabase Access: accesses data
supabase/functions/import-reports/index.ts - Telemetry Ingestion → Server Scoring: uses
supabase/functions/ingest-telemetry/index.ts - Telemetry Ingestion → Server Supabase Access: accesses data
supabase/functions/ingest-telemetry/index.ts - Resource Dispatch → Server Scoring: uses
supabase/functions/dispatch-resource/index.ts - Resource Dispatch → Server Supabase Access: accesses data
supabase/functions/dispatch-resource/index.ts - Server Scoring → Supabase Database: updates risk state
- Server Supabase Access → Supabase Database: connects
- Zone Detail → Resource Dispatch: authorizes dispatch