How uday-mahajan-dev/cycloneguard works
CycloneGuard is a cyclone early-warning and disaster-response platform with a web operations dashboard and a FastAPI/PostGIS backend. The principal workflow is to review storm conditions, simulate coastal surge and inundation, assess exposed infrastructure, and use the resulting intelligence for response and insurance decisions. The tree also indicates live marine, alerting, and AI capabilities. README content and most service/router implementations were not provided, so uncertain internal call relationships are omitted.
Main entry points: main.py FastAPI application · infrastructure.py Infrastructure endpoints · page.tsx Operations dashboard · MapContainer.tsx Storm and asset map
Components 25
Operations interface
- Operations dashboard
frontend/app/dashboard/page.tsx - Storm and asset map
frontend/components/map/MapContainer.tsx - Radar tile hook
frontend/hooks/useRainViewerTiles.ts - Storm state
frontend/lib/stores/useStormStore.ts - Frontend API client
frontend/lib/api.ts
API and orchestration
- FastAPI application
backend/main.py - Storm endpoints
backend/routers/storm.py - Surge endpoints
backend/routers/surge.py - Infrastructure endpoints
backend/routers/infrastructure.py - AI endpoints
backend/routers/gemini.py - Alert endpoints
backend/routers/alerts.py - Insurance endpoints
backend/routers/insurance.py
Hazard intelligence
- Storm data fetch
backend/services/storm_fetcher.py - Marine data fetch
backend/services/marine_fetcher.py - Surge simulation
backend/services/surge_model.py - Geospatial processing
backend/services/gee_processor.py
Response and risk
- Exposure analysis
backend/services/infrastructure_query.py - OSM asset loader
backend/services/osm_loader.py - AI analysis
backend/services/gemini_agent.py - Alert dispatch
backend/services/alert_dispatcher.py
Persistence and shared data
- PostGIS database
backend/db/connection.py - Shared HTTP client
backend/utils/http_client.py
Other components
- Operator
- RainViewer
- OSM Overpass
Connections 18
- Operator → Operations dashboard: uses
- Operations dashboard → Frontend API client: requests data
- Operations dashboard → Storm state: updates state
- Operations dashboard → Storm and asset map: renders map
- Storm and asset map → Radar tile hook: loads radar
- Radar tile hook → RainViewer: fetches tiles
- FastAPI application → Storm endpoints: mounts routes
- FastAPI application → Surge endpoints: mounts routes
- FastAPI application → Infrastructure endpoints: mounts routes
- FastAPI application → AI endpoints: mounts routes
- FastAPI application → Alert endpoints: mounts routes
- FastAPI application → Insurance endpoints: mounts routes
- Infrastructure endpoints → Exposure analysis: runs exposure
- Infrastructure endpoints → PostGIS database: queries assets
- Infrastructure endpoints → Shared HTTP client: uses client
- Infrastructure endpoints → OSM Overpass: fetches assets
- FastAPI application → PostGIS database: checks connection
- FastAPI application → Shared HTTP client: initializes client