# yash-petkar/resilient-edge---multi-robot-resilient-simulation architecture

> Architecture diagram of the GitHub repository yash-petkar/resilient-edge---multi-robot-resilient-simulation, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation
- Repository: https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation

## Overview

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: [`core/simulation/engine.py`](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/simulation/engine.py) (Simulation engine), [`backend/api/fastapi_app.py`](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/api/fastapi_app.py) (FastAPI application), [`src/App.tsx`](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/src/App.tsx) (React console), [`experiments/runner.py`](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/experiments/runner.py) (Experiment runner)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User application"]
  node_react["React console<br/>[App.tsx]"]
  node_api_client["API client<br/>[apiService.ts]"]
  node_console_views["Fleet and control views"]
  node_admin_views["Admin console<br/>[AdminConsole.tsx]"]
end

subgraph group_backend["Application backend"]
  node_fastapi["FastAPI application<br/>[fastapi_app.py]"]
  node_permissions["Server permissions<br/>[permissions.py]"]
  node_auth["Authentication<br/>[auth.py]"]
end

subgraph group_simulation["Simulation runtime"]
  node_engine["Simulation engine<br/>[engine.py]"]
  node_planning["Path planning<br/>[astar.py]"]
  node_allocation["Task allocation<br/>[allocator.py]"]
  node_reservations["Motion reservations"]
end

subgraph group_resilience["Resilience and telemetry"]
  node_faults["Fault injection<br/>[fault_engine.py]"]
  node_recovery["Failure recovery"]
  node_network["Network simulation<br/>[network_sim.py]"]
  node_metrics["Metrics collection<br/>[collector.py]"]
end

subgraph group_persistence["Persistence and experiments"]
  node_experiments["Experiment runner<br/>[runner.py]"]
  node_scenarios["Scenario definitions<br/>[scenarios.py]"]
  node_persistence_factory["Persistence factory<br/>[factory.py]"]
  node_sqlite_repository["SQLite repository"]
  node_sqlite[("SQLite database<br/>[sqlite_db.py]")]
  node_write_worker["Async write worker<br/>[worker.py]"]
end

node_users(("Admin / Observer"))

node_users -->|"use console"| node_react
node_react -->|"request data"| node_api_client
node_react -->|"render views"| node_console_views
node_react -->|"render admin"| node_admin_views
node_api_client -->|"call API"| node_fastapi
node_fastapi -->|"check access"| node_permissions
node_fastapi -->|"authenticate"| node_auth
node_fastapi -->|"control simulation"| node_engine
node_engine -->|"plan routes"| node_planning
node_engine -->|"allocate tasks"| node_allocation
node_engine -->|"coordinate motion"| node_reservations
node_engine -->|"apply faults"| node_faults
node_engine -->|"simulate transport"| node_network
node_engine -.->|"execute recovery"| node_recovery
node_engine -.->|"collect metrics"| node_metrics
node_fastapi -->|"serve experiment APIs"| node_experiments
node_experiments -->|"run simulations"| node_engine
node_experiments -->|"load scenarios"| node_scenarios
node_experiments -->|"persist results"| node_persistence_factory
node_fastapi -->|"access persistence"| node_persistence_factory
node_fastapi -->|"enqueue writes"| node_write_worker
node_persistence_factory -->|"create repository"| node_sqlite_repository
node_sqlite_repository -->|"read and write"| node_sqlite

click node_react "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/src/App.tsx"
click node_api_client "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/src/services/apiService.ts"
click node_console_views "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/tree/main/src/components"
click node_admin_views "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/src/components/admin/AdminConsole.tsx"
click node_fastapi "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/api/fastapi_app.py"
click node_permissions "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/api/permissions.py"
click node_auth "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/auth.py"
click node_engine "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/simulation/engine.py"
click node_planning "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/planning/astar.py"
click node_allocation "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/coordination/allocator.py"
click node_reservations "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/coordination/reservation_manager.py"
click node_faults "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/faults/fault_engine.py"
click node_recovery "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/resilience/recovery_manager.py"
click node_network "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/networking/network_sim.py"
click node_metrics "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/metrics/collector.py"
click node_experiments "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/experiments/runner.py"
click node_scenarios "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/experiments/scenarios.py"
click node_persistence_factory "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/factory.py"
click node_sqlite_repository "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/sqlite_repository.py"
click node_sqlite "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/sqlite_db.py"
click node_write_worker "https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/worker.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_react,node_api_client,node_console_views,node_admin_views toneBlue
class node_fastapi,node_permissions,node_auth toneAmber
class node_engine,node_planning,node_allocation,node_reservations,node_users toneMint
class node_faults,node_recovery,node_network,node_metrics toneRose
class node_experiments,node_scenarios,node_persistence_factory,node_sqlite_repository,node_sqlite,node_write_worker toneIndigo
```

## Components

### User application

- [React console](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/src/App.tsx): `src/App.tsx`
- [API client](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/src/services/apiService.ts): `src/services/apiService.ts`
- [Fleet and control views](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/tree/main/src/components): `src/components`
- [Admin console](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/src/components/admin/AdminConsole.tsx): `src/components/admin/AdminConsole.tsx`

### Application backend

- [FastAPI application](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/api/fastapi_app.py): `backend/api/fastapi_app.py`
- [Server permissions](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/api/permissions.py): `backend/api/permissions.py`
- [Authentication](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/auth.py): `backend/auth.py`

### Simulation runtime

- [Simulation engine](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/simulation/engine.py): `core/simulation/engine.py`
- [Path planning](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/planning/astar.py): `core/planning/astar.py`
- [Task allocation](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/coordination/allocator.py): `core/coordination/allocator.py`
- [Motion reservations](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/coordination/reservation_manager.py): `core/coordination/reservation_manager.py`

### Resilience and telemetry

- [Fault injection](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/faults/fault_engine.py): `core/faults/fault_engine.py`
- [Failure recovery](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/resilience/recovery_manager.py): `core/resilience/recovery_manager.py`
- [Network simulation](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/networking/network_sim.py): `core/networking/network_sim.py`
- [Metrics collection](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/core/metrics/collector.py): `core/metrics/collector.py`

### Persistence and experiments

- [Experiment runner](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/experiments/runner.py): `experiments/runner.py`
- [Scenario definitions](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/experiments/scenarios.py): `experiments/scenarios.py`
- [Persistence factory](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/factory.py): `backend/database/factory.py`
- [SQLite repository](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/sqlite_repository.py): `backend/database/sqlite_repository.py`
- [SQLite database](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/sqlite_db.py): `backend/database/sqlite_db.py`
- [Async write worker](https://github.com/yash-petkar/resilient-edge---multi-robot-resilient-simulation/blob/main/backend/database/worker.py): `backend/database/worker.py`

### Other components

- **Admin / Observer**

## Connections

- Admin / Observer → React console: use console (evidence: `README.md`)
- React console → API client: request data (evidence: `README.md`)
- React console → Fleet and control views: render views (evidence: `src/App.tsx`)
- React console → Admin console: render admin (evidence: `src/App.tsx`)
- API client → FastAPI application: call API (evidence: `README.md`)
- FastAPI application → Server permissions: check access (evidence: `backend/api/fastapi_app.py`)
- FastAPI application → Authentication: authenticate (evidence: `backend/api/fastapi_app.py`)
- FastAPI application → Simulation engine: control simulation (evidence: `backend/api/fastapi_app.py`)
- Simulation engine → Path planning: plan routes (evidence: `core/simulation/engine.py`)
- Simulation engine → Task allocation: allocate tasks (evidence: `core/simulation/engine.py`)
- Simulation engine → Motion reservations: coordinate motion (evidence: `core/simulation/engine.py`)
- Simulation engine → Fault injection: apply faults (evidence: `core/simulation/engine.py`)
- Simulation engine → Network simulation: simulate transport (evidence: `core/simulation/engine.py`)
- Simulation engine → Failure recovery: execute recovery (evidence: `core/simulation/engine.py`)
- Simulation engine → Metrics collection: collect metrics (evidence: `core/simulation/engine.py`)
- FastAPI application → Experiment runner: serve experiment APIs (evidence: `backend/api/fastapi_app.py`)
- Experiment runner → Simulation engine: run simulations (evidence: `experiments/runner.py`)
- Experiment runner → Scenario definitions: load scenarios (evidence: `experiments/runner.py`)
- Experiment runner → Persistence factory: persist results (evidence: `experiments/runner.py`)
- FastAPI application → Persistence factory: access persistence (evidence: `backend/api/fastapi_app.py`)
- FastAPI application → Async write worker: enqueue writes (evidence: `backend/api/fastapi_app.py`)
- Persistence factory → SQLite repository: create repository (evidence: `backend/database/factory.py`)
- SQLite repository → SQLite database: read and write (evidence: `backend/database/sqlite_repository.py`)
