How vikasgupta37/project-swarma works
SWARMA is a real-time crowd-operations platform: video and footfall signals become zone metrics, forecasts and risk assessments that support incidents, alerts and diversion plans for venue operators. The FastAPI backend exposes these capabilities to a React dashboard, which also receives live events. Major documented branches include video/CV, zone mapping, prediction, risk, routing, incident and alert workflows, audit, and grounded AI assistance. The graph emphasizes relationships shown in excerpts, the source index, or README; unsampled subsystem internals and some integrations are represented only where documented.
Main entry points: metrics_service.py Zone metrics · assistant_service.py Grounded assistant · routing.py Route planning endpoint · App.tsx Dashboard application
Components 24
Operator dashboard
- Dashboard application
frontend/src/App.tsx - Live state hook
frontend/src/hooks/useLiveState.ts - API client
frontend/src/services/api.ts - Live events client
frontend/src/services/websocket.ts - Live state store
frontend/src/store/liveStateStore.ts - Venue administration
frontend/src/pages/AdminPage.tsx - Incident views
frontend/src/components/dashboard/IncidentList.tsx
API and operations
- FastAPI application
backend/app/main.py - API router
backend/app/api/router.py - Route planning endpoint
backend/app/api/routes/routing.py - Incident lifecycle
backend/app/services/incident_service.py - Live event service
backend/app/services/live_event_service.py - Grounded assistant
backend/app/services/assistant_service.py
Crowd intelligence
- Zone metrics
backend/app/services/metrics_service.py - Occupancy forecasts
backend/app/services/prediction_service.py - Risk assessment
backend/app/services/risk_service.py - Risk engine
backend/app/risk/engine.py - Diversion planning
backend/app/services/routing_service.py
Video and mapping
- Video analysis pipeline
backend/app/cv/pipeline.py - Zone occupancy mapping
backend/app/zone/occupancy.py
State and integrations
- PostgreSQL
- Redis
- OpenAI services
Other components
- Venue operator
Connections 28
- Venue operator → Dashboard application: uses
README.md - Dashboard application → Live state hook: loads live state
frontend/src/App.tsx - Dashboard application → Venue administration: renders
frontend/src/App.tsx - Dashboard application → Incident views: renders
frontend/src/App.tsx - Live state hook → API client: fetches data
frontend/src/hooks/useLiveState.ts - Live state hook → Live events client: connects events
frontend/src/hooks/useLiveState.ts - Live state hook → Live state store: updates state
frontend/src/hooks/useLiveState.ts - API client → FastAPI application: calls API
README.md - FastAPI application → API router: mounts routes
backend/app/main.py - API router → Route planning endpoint: registers
backend/app/api/router.py - Route planning endpoint → Zone metrics: loads metrics
backend/app/api/routes/routing.py - Route planning endpoint → Occupancy forecasts: forecasts zones
backend/app/api/routes/routing.py - Route planning endpoint → Risk assessment: assesses zones
backend/app/api/routes/routing.py - Route planning endpoint → Diversion planning: plans route
backend/app/api/routes/routing.py - Risk assessment → Risk engine: assesses risk
backend/app/services/risk_service.py - Zone metrics → Video analysis pipeline: analyzes video
backend/app/services/metrics_service.py - Zone metrics → Zone occupancy mapping: calculates occupancy
backend/app/services/metrics_service.py - Video analysis pipeline → Zone occupancy mapping: maps detections
README.md - Incident lifecycle → Live event service: broadcasts updates
backend/app/services/incident_service.py - Grounded assistant → OpenAI services: requests completions
backend/app/services/assistant_service.py - Grounded assistant → Zone metrics: loads context
backend/app/services/assistant_service.py - Grounded assistant → Occupancy forecasts: loads context
backend/app/services/assistant_service.py - Grounded assistant → Risk assessment: loads context
backend/app/services/assistant_service.py - Zone metrics → Redis: caches live metrics
backend/app/services/metrics_service.py - Zone metrics → PostgreSQL: persists metrics
- Occupancy forecasts → PostgreSQL: persists forecasts
- Incident lifecycle → PostgreSQL: stores incidents
- Grounded assistant → PostgreSQL: stores query logs