CrowdSafe

README excerpt

# CrowdSafe

CrowdSafe is a real-time crowd simulation and intelligent evacuation management platform for large venues (e.g. stadiums). It includes a command-centre dashboard, live map, CCTV-style person detection, sector-based crowd tracking, and a mobile attendee view that receives evacuation redirects in real time.

## Features

- **Landing & map** — Landing at `/`, interactive Mapbox map at `/map` with agents, exits, and hazards. Agent sectors (North / East / West / South) are assigned at spawn and shown in tooltips.
- **Dashboard** — Command centre at `/dashboard`: total in stadium, evacuation progress, exit load chart, crowd-by-sector breakdown, alert log, CCTV preview with sector dropdown, minimap (links to map), and controls to send notifications to attendees or first responders.
- **CCTV** — `/cctv`: choose sector, capture from webcam or upload an image; Roboflow workflow returns person count and annotated image. People-by-sector totals update as you scan; clicking the total or card takes you back to the map.
- **Mobile** — `/mobile`: simple attendee view with hardcoded location, sector, and nearest exit; indoor map image; when the dashboard sends a notification, all connected mobile clients see a popup with the redirect exit.

## Tech Stack

- **Frontend:** React 18, TypeScript, Vite, Tailwind CSS, Zustand, Mapbox GL JS, Recharts
- **Backend:** FastAPI (Python 3.11+), Uvicorn, Pydantic
- **Integrations:** Roboflow (workflow + optional detection API) for CCTV

## Pro