How yash-petkar/resilient-edge---multi-robot-resilient-simulation works
ResilientEdge is a multi-robot resilience simulation and telemetry platform. Users enter through the React application to inspect fleet state, dispatch tasks, inject faults, and review metrics or experiments; FastAPI enforces application permissions and serves simulation controls and telemetry, while the Python SimulationEngine remains authoritative for simulation behavior and SQLite persists application and simulation data. The graph preserves the documented experiment, recovery, networking, and administration capabilities. Source excerpts are partial, so some subsystem relationships are included only where the README or SOURCE INDEX supports them.
Main entry points: engine.py Simulation engine · fastapi_app.py FastAPI application · App.tsx React console · runner.py Experiment runner
Components 22
User application
- React console
src/App.tsx - API client
src/services/apiService.ts - Fleet and control views
src/components - Admin console
src/components/admin/AdminConsole.tsx
Application backend
- FastAPI application
backend/api/fastapi_app.py - Server permissions
backend/api/permissions.py - Authentication
backend/auth.py
Simulation runtime
- Simulation engine
core/simulation/engine.py - Path planning
core/planning/astar.py - Task allocation
core/coordination/allocator.py - Motion reservations
core/coordination/reservation_manager.py
Resilience and telemetry
- Fault injection
core/faults/fault_engine.py - Failure recovery
core/resilience/recovery_manager.py - Network simulation
core/networking/network_sim.py - Metrics collection
core/metrics/collector.py
Persistence and experiments
- Experiment runner
experiments/runner.py - Scenario definitions
experiments/scenarios.py - Persistence factory
backend/database/factory.py - SQLite repository
backend/database/sqlite_repository.py - SQLite database
backend/database/sqlite_db.py - Async write worker
backend/database/worker.py
Other components
- Admin / Observer
Connections 23
- Admin / Observer → React console: use console
README.md - React console → API client: request data
README.md - React console → Fleet and control views: render views
src/App.tsx - React console → Admin console: render admin
src/App.tsx - API client → FastAPI application: call API
README.md - FastAPI application → Server permissions: check access
backend/api/fastapi_app.py - FastAPI application → Authentication: authenticate
backend/api/fastapi_app.py - FastAPI application → Simulation engine: control simulation
backend/api/fastapi_app.py - Simulation engine → Path planning: plan routes
core/simulation/engine.py - Simulation engine → Task allocation: allocate tasks
core/simulation/engine.py - Simulation engine → Motion reservations: coordinate motion
core/simulation/engine.py - Simulation engine → Fault injection: apply faults
core/simulation/engine.py - Simulation engine → Network simulation: simulate transport
core/simulation/engine.py - Simulation engine → Failure recovery: execute recovery
core/simulation/engine.py - Simulation engine → Metrics collection: collect metrics
core/simulation/engine.py - FastAPI application → Experiment runner: serve experiment APIs
backend/api/fastapi_app.py - Experiment runner → Simulation engine: run simulations
experiments/runner.py - Experiment runner → Scenario definitions: load scenarios
experiments/runner.py - Experiment runner → Persistence factory: persist results
experiments/runner.py - FastAPI application → Persistence factory: access persistence
backend/api/fastapi_app.py - FastAPI application → Async write worker: enqueue writes
backend/api/fastapi_app.py - Persistence factory → SQLite repository: create repository
backend/database/factory.py - SQLite repository → SQLite database: read and write
backend/database/sqlite_repository.py