How aruchith08/geoalert-sih-2026 works
GEOALERT is a landslide-risk intelligence platform for exploring spatial susceptibility, current rainfall and weather-driven forecasts. The user workflow runs from choosing a location or map cell, through API-backed terrain and weather evaluation, to coupled risk tiers and map/timeline inspection. Backend routes are the documented API entry points; startup also loads the frozen models and starts weather synchronization. The README documents major map layers and the 12-station mesh. Some links are omitted where sampled code does not show the call path; unsampled subsystems are represented only at supported directory paths.
Main entry points: main.py FastAPI application · weather_service.py Weather intelligence · api.ts API client · risk.py Risk endpoints
Components 25
Web GIS
- Dashboard
frontend/app/page.tsx - Risk map
frontend/app/risk-map/page.tsx - Map canvas
frontend/components/map/LeafletMap.tsx - Location inspector
frontend/components/dashboard/InspectorPanel.tsx - Forecast timeline
frontend/components/dashboard/ForecastRiskTimeline.tsx - Rainfall panel
frontend/components/dashboard/RainfallIntelligencePanel.tsx - API client
frontend/lib/api.ts - Sync status hook
frontend/lib/useWeatherSync.ts
API and routes
- FastAPI application
backend/app/main.py - Risk endpoints
backend/app/routes/risk.py - Weather endpoints
backend/app/routes/weather.py - Rainfall endpoints
backend/app/routes/rainfall.py - Spatial endpoints
backend/app/routes/spatial.py
Risk intelligence
- Dual model inference
backend/app/model_service.py - Risk coupling and tiers
backend/app/risk_engine.py - Terrain and risk layers
backend/app
Weather intelligence
- Weather intelligence
backend/app/weather_service.py - Rain feature engine
backend/app/weather_feature_engine.py - NWP provider
backend/app/weather_provider.py - Weather cache
backend/app/weather_cache.py - Station mesh
backend/app/weather_mesh.py - Weather synchronization
backend/app/weather_sync_service.py
Other components
- Analyst
- Open-Meteo
- Map user
Connections 29
- Analyst → Dashboard: opens
frontend/app/page.tsx - Analyst → Risk map: opens
frontend/app/risk-map/page.tsx - Risk map → Map canvas: renders
- Map canvas → Location inspector: selects location
- Location inspector → API client: requests risk data
- Forecast timeline → API client: requests forecast
- Rainfall panel → API client: requests rainfall
- Sync status hook → API client: polls status
frontend/lib/useWeatherSync.ts - API client → FastAPI application: HTTP requests
- FastAPI application → Risk endpoints: registers
backend/app/main.py - FastAPI application → Weather endpoints: registers
backend/app/main.py - FastAPI application → Rainfall endpoints: registers
backend/app/main.py - FastAPI application → Spatial endpoints: registers
backend/app/main.py - FastAPI application → Dual model inference: loads models
backend/app/main.py - FastAPI application → Weather synchronization: starts service
backend/app/main.py - Risk endpoints → Dual model inference: invokes inference
backend/app/routes/risk.py - Risk endpoints → Risk coupling and tiers: calculates risk
backend/app/routes/risk.py - Risk endpoints → Weather intelligence: requests weather risk
backend/app/routes/risk.py - Weather endpoints → Weather intelligence: serves weather
backend/app/routes/weather.py - Weather endpoints → Station mesh: updates stations
backend/app/routes/weather.py - Weather intelligence → NWP provider: fetches forecasts
backend/app/weather_service.py - Weather intelligence → Weather cache: reads and writes
backend/app/weather_service.py - Weather intelligence → Rain feature engine: derives features
backend/app/weather_service.py - Weather intelligence → Dual model inference: predicts trigger
backend/app/weather_service.py - Weather synchronization → Weather intelligence: refreshes data
backend/app/weather_sync_service.py - Weather synchronization → Weather cache: checks freshness
backend/app/weather_sync_service.py - NWP provider → Open-Meteo: retrieves telemetry
- Rainfall endpoints → Terrain and risk layers: serves rainfall data
backend/app/routes/rainfall.py - Spatial endpoints → Terrain and risk layers: serves grid data
backend/app/routes/spatial.py