# vikram0678/rasad-ai architecture

> Architecture diagram of the GitHub repository vikram0678/rasad-ai, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vikram0678/rasad-ai
- Repository: https://github.com/vikram0678/rasad-ai

## Overview

RASAD-AI is a tactical logistics dashboard and FastAPI service for high-altitude military supply operations. Users inspect depot and convoy conditions, forecast demand, plan routes and fleets, and access logistics guidance; the backend exposes domain APIs backed by specialized engines. The README also documents multimodal logistics, electronic-warfare resilience, explainability, and air-gapped operation. Edges reflect the README or shown imports and references in the source index; where implementation details were not sampled, the graph avoids inferring additional wiring.

Main entry points: [`backend/app/api/v1/router.py`](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/router.py) (API router), [`frontend/src/App.tsx`](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/App.tsx) (Dashboard app), [`backend/app/api/v1/endpoints/demand.py`](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/demand.py) (Demand API), [`frontend/src/components/TacticalMap.tsx`](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/TacticalMap.tsx) (Tactical map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Operations dashboard"]
  node_dashboard["Dashboard app<br/>[App.tsx]"]
  node_tacticalmap["Tactical map<br/>[TacticalMap.tsx]"]
  node_iplms["IPLMS dashboard<br/>[IplmsDashboard.tsx]"]
  node_iplmsmap["IPLMS map<br/>[IplmsMap.tsx]"]
  node_planner["Route planner"]
  node_balancing["Depot balancing"]
  node_copilotui["Sahayak assistant"]
  node_telemetrymodal["Convoy telemetry"]
  node_audio["Tactical audio<br/>[audio.ts]"]
end

subgraph group_api["Service API"]
  node_apiapp["FastAPI service<br/>[main.py]"]
  node_apirouter["API router<br/>[router.py]"]
  node_demandapi["Demand API<br/>[demand.py]"]
  node_routeapi["Routing API<br/>[routes.py]"]
  node_copilotapi["Copilot API<br/>[rasad_sahayak.py]"]
  node_cvrptwapi["CVRPTW API<br/>[cvrptw_api.py]"]
  node_multimodalapi["Multimodal API<br/>[multimodal_api.py]"]
  node_ewapi["EW API<br/>[ew_api.py]"]
  node_federatedapi["Federated API<br/>[federated_api.py]"]
  node_xaiapi["XAI API<br/>[xai_api.py]"]
end

subgraph group_engines["Logistics engines"]
  node_demandengine["Demand forecasting<br/>[demand_engine.py]"]
  node_routeengine["Terrain routing<br/>[route_engine.py]"]
  node_fleetengine["Fleet scheduling<br/>[cvrptw_engine.py]"]
  node_rag["Doctrine retrieval<br/>[rag_engine.py]"]
  node_multimodalengine["Transport fusion"]
  node_ewengine["EW resilience<br/>[ew_resilience.py]"]
  node_federatedengine["Federated learning"]
  node_xiaengine["Explainable AI<br/>[xai_engine.py]"]
end

subgraph group_state["Data and state"]
  node_database[("Operational database<br/>[database.py]")]
  node_mockdata["Tactical sample data<br/>[mockData.ts]"]
  node_iplmsdata["IPLMS data<br/>[iplmsData.ts]"]
end

node_operator(("Operations staff"))

node_operator -->|"uses"| node_dashboard
node_dashboard -->|"renders"| node_tacticalmap
node_dashboard -->|"renders"| node_copilotui
node_dashboard -->|"renders"| node_planner
node_dashboard -->|"controls"| node_telemetrymodal
node_tacticalmap -->|"reads"| node_mockdata
node_iplmsmap -->|"reads"| node_iplmsdata
node_planner -->|"uses"| node_balancing
node_apiapp -->|"mounts"| node_apirouter
node_apirouter -->|"registers"| node_demandapi
node_apirouter -->|"registers"| node_routeapi
node_apirouter -->|"registers"| node_copilotapi
node_apirouter -->|"registers"| node_cvrptwapi
node_apirouter -->|"registers"| node_multimodalapi
node_apirouter -->|"registers"| node_ewapi
node_apirouter -->|"registers"| node_federatedapi
node_apirouter -->|"registers"| node_xaiapi
node_demandapi -->|"calls"| node_demandengine
node_demandapi -->|"accesses"| node_database
node_routeapi -->|"calls"| node_routeengine
node_copilotapi -->|"queries"| node_rag
node_cvrptwapi -->|"calls"| node_fleetengine
node_multimodalapi -->|"uses"| node_multimodalengine
node_ewapi -->|"calls"| node_ewengine
node_federatedapi -->|"uses"| node_federatedengine
node_xaiapi -->|"uses"| node_xiaengine

click node_dashboard "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/App.tsx"
click node_tacticalmap "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/TacticalMap.tsx"
click node_iplms "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/iplms/IplmsDashboard.tsx"
click node_iplmsmap "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/iplms/IplmsMap.tsx"
click node_planner "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/workspaces/PlannerWorkspace.tsx"
click node_balancing "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/workspaces/MultiDepotBalancing.tsx"
click node_copilotui "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/copilot/RasadSahayakBot.tsx"
click node_telemetrymodal "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/modals/ConvoyTelemetryModal.tsx"
click node_audio "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/utils/audio.ts"
click node_apiapp "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/main.py"
click node_apirouter "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/router.py"
click node_demandapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/demand.py"
click node_routeapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/routes.py"
click node_copilotapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/rasad_sahayak.py"
click node_cvrptwapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/cvrptw_api.py"
click node_multimodalapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/multimodal_api.py"
click node_ewapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/ew_api.py"
click node_federatedapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/federated_api.py"
click node_xaiapi "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/xai_api.py"
click node_demandengine "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/demand_engine.py"
click node_routeengine "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/route_engine.py"
click node_fleetengine "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/cvrptw_engine.py"
click node_rag "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/rag_engine.py"
click node_multimodalengine "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/multimodal_engine.py"
click node_ewengine "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/ew_resilience.py"
click node_federatedengine "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/federated_learning.py"
click node_xiaengine "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/xai_engine.py"
click node_database "https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/database.py"
click node_mockdata "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/data/mockData.ts"
click node_iplmsdata "https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/data/iplmsData.ts"

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_dashboard,node_tacticalmap,node_iplms,node_iplmsmap,node_planner,node_balancing,node_copilotui,node_telemetrymodal,node_audio toneBlue
class node_apiapp,node_apirouter,node_demandapi,node_routeapi,node_copilotapi,node_cvrptwapi,node_multimodalapi,node_ewapi,node_federatedapi,node_xaiapi toneAmber
class node_demandengine,node_routeengine,node_fleetengine,node_rag,node_multimodalengine,node_ewengine,node_federatedengine,node_xiaengine toneMint
class node_database,node_mockdata,node_iplmsdata toneRose
class node_operator toneIndigo
```

## Components

### Operations dashboard

- [Dashboard app](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Tactical map](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/TacticalMap.tsx): `frontend/src/components/TacticalMap.tsx`
- [IPLMS dashboard](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/iplms/IplmsDashboard.tsx): `frontend/src/components/iplms/IplmsDashboard.tsx`
- [IPLMS map](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/iplms/IplmsMap.tsx): `frontend/src/components/iplms/IplmsMap.tsx`
- [Route planner](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/workspaces/PlannerWorkspace.tsx): `frontend/src/components/workspaces/PlannerWorkspace.tsx`
- [Depot balancing](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/workspaces/MultiDepotBalancing.tsx): `frontend/src/components/workspaces/MultiDepotBalancing.tsx`
- [Sahayak assistant](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/copilot/RasadSahayakBot.tsx): `frontend/src/components/copilot/RasadSahayakBot.tsx`
- [Convoy telemetry](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/components/modals/ConvoyTelemetryModal.tsx): `frontend/src/components/modals/ConvoyTelemetryModal.tsx`
- [Tactical audio](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/utils/audio.ts): `frontend/src/utils/audio.ts`

### Service API

- [FastAPI service](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/main.py): `backend/app/main.py`
- [API router](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/router.py): `backend/app/api/v1/router.py`
- [Demand API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/demand.py): `backend/app/api/v1/endpoints/demand.py`
- [Routing API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/routes.py): `backend/app/api/v1/endpoints/routes.py`
- [Copilot API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/rasad_sahayak.py): `backend/app/api/v1/endpoints/rasad_sahayak.py`
- [CVRPTW API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/cvrptw_api.py): `backend/app/api/v1/endpoints/cvrptw_api.py`
- [Multimodal API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/multimodal_api.py): `backend/app/api/v1/endpoints/multimodal_api.py`
- [EW API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/ew_api.py): `backend/app/api/v1/endpoints/ew_api.py`
- [Federated API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/federated_api.py): `backend/app/api/v1/endpoints/federated_api.py`
- [XAI API](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/api/v1/endpoints/xai_api.py): `backend/app/api/v1/endpoints/xai_api.py`

### Logistics engines

- [Demand forecasting](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/demand_engine.py): `backend/app/core/demand_engine.py`
- [Terrain routing](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/route_engine.py): `backend/app/core/route_engine.py`
- [Fleet scheduling](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/cvrptw_engine.py): `backend/app/core/cvrptw_engine.py`
- [Doctrine retrieval](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/rag_engine.py): `backend/app/core/rag_engine.py`
- [Transport fusion](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/multimodal_engine.py): `backend/app/core/multimodal_engine.py`
- [EW resilience](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/ew_resilience.py): `backend/app/core/ew_resilience.py`
- [Federated learning](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/federated_learning.py): `backend/app/core/federated_learning.py`
- [Explainable AI](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/xai_engine.py): `backend/app/core/xai_engine.py`

### Data and state

- [Operational database](https://github.com/vikram0678/rasad-ai/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Tactical sample data](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/data/mockData.ts): `frontend/src/data/mockData.ts`
- [IPLMS data](https://github.com/vikram0678/rasad-ai/blob/main/frontend/src/data/iplmsData.ts): `frontend/src/data/iplmsData.ts`

### Other components

- **Operations staff**

## Connections

- Operations staff → Dashboard app: uses (evidence: `README.md`)
- Dashboard app → Tactical map: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Sahayak assistant: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Route planner: renders (evidence: `frontend/src/App.tsx`)
- Dashboard app → Convoy telemetry: controls (evidence: `frontend/src/App.tsx`)
- Tactical map → Tactical sample data: reads (evidence: `frontend/src/components/TacticalMap.tsx`)
- IPLMS map → IPLMS data: reads (evidence: `frontend/src/components/iplms/IplmsMap.tsx`)
- Route planner → Depot balancing: uses (evidence: `frontend/src/components/workspaces/PlannerWorkspace.tsx`)
- FastAPI service → API router: mounts (evidence: `backend/app/main.py`)
- API router → Demand API: registers (evidence: `backend/app/api/v1/router.py`)
- API router → Routing API: registers (evidence: `backend/app/api/v1/router.py`)
- API router → Copilot API: registers (evidence: `backend/app/api/v1/router.py`)
- API router → CVRPTW API: registers (evidence: `backend/app/api/v1/router.py`)
- API router → Multimodal API: registers (evidence: `backend/app/api/v1/router.py`)
- API router → EW API: registers (evidence: `backend/app/api/v1/router.py`)
- API router → Federated API: registers (evidence: `backend/app/api/v1/router.py`)
- API router → XAI API: registers (evidence: `backend/app/api/v1/router.py`)
- Demand API → Demand forecasting: calls (evidence: `backend/app/api/v1/endpoints/demand.py`)
- Demand API → Operational database: accesses (evidence: `backend/app/api/v1/endpoints/demand.py`)
- Routing API → Terrain routing: calls (evidence: `backend/app/api/v1/endpoints/routes.py`)
- Copilot API → Doctrine retrieval: queries (evidence: `backend/app/api/v1/endpoints/rasad_sahayak.py`)
- CVRPTW API → Fleet scheduling: calls (evidence: `backend/app/api/v1/endpoints/cvrptw_api.py`)
- Multimodal API → Transport fusion: uses
- EW API → EW resilience: calls (evidence: `backend/app/api/v1/endpoints/ew_api.py`)
- Federated API → Federated learning: uses (evidence: `backend/app/api/v1/endpoints/federated_api.py`)
- XAI API → Explainable AI: uses
