How shamiul-bashar/crisismesh-2.0-dynamic-emergency-decision-routing-resource-allocation-simulator works
CrisisMesh is a fictional-city emergency decision and resource-allocation simulator. A citizen reports an incident; the authoritative C++ engine queues and prioritizes it, evaluates compatible responders, routes and dispatches one, then manages completion, citizen confirmation or escalation, and archival. The React app provides citizen and command-center workflows, map visualization, and algorithm playback; the browser requests simulation state and commands through an API bridge. The README documents several stages and capabilities whose implementation excerpts were not sampled, so those links cite the README; the bridge is development-only, not a production service.
Main entry points: SimulationEngine.cpp Simulation engine · api.ts Simulation API client · CitizenDashboard.tsx Citizen portal · CommandCenter.tsx Command center
Components 22
User experiences
- Citizen portal
features/citizen/CitizenDashboard.tsx - Emergency reporting
features/emergency/EmergencyReport.tsx - Command center
features/command-center/CommandCenter.tsx - Tactical map
features/command-center/TacticalMap.tsx - Algorithm playback
features/command-center/AlgorithmPlayback.tsx - DSA views
features/command-center/MasterDSALab.tsx
Browser client
- Simulation API client
core/simulation/api.ts - Simulation state contract
core/simulation/types.ts - Development bridge
server/index.mjs
Operational engine
- Simulation engine
backend/src/simulation/SimulationEngine.cpp - Incident lifecycle
backend/include/domain/Incident.hpp - Responder allocation
backend/include/allocation/AllocationEngine.hpp - Incident archive
backend/include/tree/IncidentArchiveIndex.hpp
Routing and DSA
- City road graph
backend/include/graph/Graph.hpp - Weighted routing
backend/include/dijkstra/Dijkstra.hpp - Queue and priority
backend/include/queue/Queue.hpp - Candidate ranking
backend/include/sort/CandidateMergeSort.hpp - BFS / DFS analysis
backend/include/bfs/BFS.hpp - Road-change undo
backend/include/stack/Stack.hpp - Allocation algorithms
backend/src/allocation/AllocationEngine.cpp
Other components
- Citizen
- Author / responder
Connections 25
- Citizen → Citizen portal: uses
README.md - Citizen portal → Emergency reporting: opens report
features/citizen/CitizenDashboard.tsx - Citizen portal → Simulation API client: submits commands
features/citizen/CitizenDashboard.tsx - Author / responder → Command center: operates
README.md - Command center → Simulation API client: requests state
features/command-center/CommandCenter.tsx - Emergency reporting → Simulation API client: submits report
core/simulation/api.ts - Simulation API client → Development bridge: POSTs requests
core/simulation/api.ts - Development bridge → Simulation engine: forwards commands
README.md - Simulation engine → Simulation API client: returns state
README.md - Simulation API client → Simulation state contract: validates response
core/simulation/api.ts - Simulation engine → Queue and priority: queues and schedules
README.md - Simulation engine → Incident lifecycle: updates lifecycle
README.md - Simulation engine → Responder allocation: evaluates responders
- Simulation engine → Candidate ranking: ranks candidates
README.md - Simulation engine → Weighted routing: calculates routes
backend/src/simulation/SimulationEngine.cpp - Weighted routing → City road graph: reads topology
backend/include/dijkstra/Dijkstra.hpp - Simulation engine → City road graph: changes road state
README.md - Simulation engine → Road-change undo: records road undo
- Simulation engine → Incident archive: archives closed incidents
README.md - Simulation engine → BFS / DFS analysis: runs graph analysis
README.md - Simulation engine → Allocation algorithms: allocates resources
- Command center → Tactical map: renders operations
features/command-center/CommandCenter.tsx - Tactical map → Algorithm playback: shows route playback
features/command-center/TacticalMap.tsx - Command center → DSA views: shows DSA view
features/command-center/CommandCenter.tsx - Citizen portal → Simulation engine: confirms or escalates
README.md