# aayushpathrabe05/argus architecture

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

- Interactive diagram: https://gitdiagram.com/aayushpathrabe05/argus
- Repository: https://github.com/aayushpathrabe05/argus

## Overview

ARGUS-Lite is a disaster-relief logistics system operated through a geospatial dashboard. Field users submit road-condition reports; the backend fuses evidence into risk and confidence estimates, plans safe routes, and supports prioritizing relief requests and assigning trucks. Its documented workflow also includes cargo loading and network-wide delivery-capacity analysis. The repository includes a separate scenario simulator for evaluating routing against hidden ground truth. Dashboard orchestration and core algorithm calls are visible in excerpts; flow integration and some UI wiring are documented or indicated by the tree but not shown in sampled source.

Main entry points: [`code/argus_core/dashboard/app.py`](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/dashboard/app.py) (Dashboard Backend), [`code/argus_core/routing_engine/engine.py`](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/routing_engine/engine.py) (Safe Routing), [`code/argus_core/simulator/evaluator.py`](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/evaluator.py) (Strategy Evaluator), [`code/argus_core/simulator/scenario.py`](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/scenario.py) (Scenario Definitions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_operations["Operations Dashboard"]
  node_dashboard_backend["Dashboard Backend<br/>[app.py]"]
  node_dashboard_ui["Dashboard UI<br/>[app.js]"]
  node_dashboard_store[("Dashboard Persistence<br/>[persistence.py]")]
end

subgraph group_intelligence["Road Intelligence"]
  node_evidence_engine["Evidence Fusion<br/>[engine.py]"]
  node_evidence_models["Evidence Models<br/>[models.py]"]
  node_road_graph["Road Graph<br/>[graph.py]"]
  node_routing_engine["Safe Routing<br/>[engine.py]"]
  node_dstar["D* Lite Reference<br/>[d_star_lite.py]"]
end

subgraph group_logistics["Relief Logistics"]
  node_allocation_engine["Request Allocation<br/>[engine.py]"]
  node_hungarian["Hungarian Assignment<br/>[hungarian.py]"]
  node_flow_engine["Delivery Max Flow<br/>[max_flow.py]"]
end

subgraph group_simulation["Scenario Evaluation"]
  node_scenario_config["Scenario Definitions<br/>[scenario.py]"]
  node_ground_truth["Hidden Road Truth<br/>[ground_truth.py]"]
  node_evaluator["Strategy Evaluator<br/>[evaluator.py]"]
end

node_field_user(("Field Operator"))

node_field_user -->|"submits reports"| node_dashboard_backend
node_dashboard_backend -.->|"serves dashboard"| node_dashboard_ui
node_dashboard_backend -->|"persists state"| node_dashboard_store
node_dashboard_backend -->|"fuses reports"| node_evidence_engine
node_evidence_engine -->|"uses models"| node_evidence_models
node_dashboard_backend -->|"builds network"| node_road_graph
node_dashboard_backend -->|"plans routes"| node_routing_engine
node_routing_engine -->|"queries graph"| node_road_graph
node_routing_engine -->|"reads summaries"| node_evidence_models
node_routing_engine -->|"dispatches planner"| node_dstar
node_dashboard_backend -->|"assigns relief"| node_allocation_engine
node_allocation_engine -->|"uses assignment"| node_hungarian
node_dashboard_backend -.->|"analyzes capacity"| node_flow_engine
node_scenario_config -->|"builds scenarios"| node_road_graph
node_scenario_config -->|"defines events"| node_ground_truth
node_evaluator -->|"evaluates scenarios"| node_scenario_config
node_evaluator -->|"checks outcomes"| node_ground_truth
node_evaluator -->|"tests strategies"| node_routing_engine
node_evaluator -->|"generates evidence"| node_evidence_engine

click node_dashboard_backend "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/dashboard/app.py"
click node_dashboard_ui "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/dashboard/static/app.js"
click node_dashboard_store "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/dashboard/persistence.py"
click node_evidence_engine "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/evidence_engine/engine.py"
click node_evidence_models "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/evidence_engine/models.py"
click node_road_graph "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/routing_engine/graph.py"
click node_routing_engine "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/routing_engine/engine.py"
click node_dstar "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/routing_engine/d_star_lite.py"
click node_allocation_engine "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/allocation_engine/engine.py"
click node_hungarian "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/allocation_engine/hungarian.py"
click node_flow_engine "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/flow_engine/max_flow.py"
click node_scenario_config "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/scenario.py"
click node_ground_truth "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/ground_truth.py"
click node_evaluator "https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/evaluator.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_dashboard_backend,node_dashboard_ui,node_dashboard_store toneBlue
class node_evidence_engine,node_evidence_models,node_road_graph,node_routing_engine,node_dstar toneAmber
class node_allocation_engine,node_hungarian,node_flow_engine toneMint
class node_scenario_config,node_ground_truth,node_evaluator toneRose
class node_field_user toneIndigo
```

## Components

### Operations Dashboard

- [Dashboard Backend](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/dashboard/app.py): `code/argus_core/dashboard/app.py`
- [Dashboard UI](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/dashboard/static/app.js): `code/argus_core/dashboard/static/app.js`
- [Dashboard Persistence](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/dashboard/persistence.py): `code/argus_core/dashboard/persistence.py`

### Road Intelligence

- [Evidence Fusion](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/evidence_engine/engine.py): `code/argus_core/evidence_engine/engine.py`
- [Evidence Models](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/evidence_engine/models.py): `code/argus_core/evidence_engine/models.py`
- [Road Graph](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/routing_engine/graph.py): `code/argus_core/routing_engine/graph.py`
- [Safe Routing](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/routing_engine/engine.py): `code/argus_core/routing_engine/engine.py`
- [D* Lite Reference](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/routing_engine/d_star_lite.py): `code/argus_core/routing_engine/d_star_lite.py`

### Relief Logistics

- [Request Allocation](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/allocation_engine/engine.py): `code/argus_core/allocation_engine/engine.py`
- [Hungarian Assignment](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/allocation_engine/hungarian.py): `code/argus_core/allocation_engine/hungarian.py`
- [Delivery Max Flow](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/flow_engine/max_flow.py): `code/argus_core/flow_engine/max_flow.py`

### Scenario Evaluation

- [Scenario Definitions](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/scenario.py): `code/argus_core/simulator/scenario.py`
- [Hidden Road Truth](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/ground_truth.py): `code/argus_core/simulator/ground_truth.py`
- [Strategy Evaluator](https://github.com/aayushpathrabe05/argus/blob/main/code/argus_core/simulator/evaluator.py): `code/argus_core/simulator/evaluator.py`

### Other components

- **Field Operator**

## Connections

- Field Operator → Dashboard Backend: submits reports (evidence: `code/argus_core/dashboard/app.py`)
- Dashboard Backend → Dashboard UI: serves dashboard
- Dashboard Backend → Dashboard Persistence: persists state (evidence: `code/argus_core/dashboard/app.py`)
- Dashboard Backend → Evidence Fusion: fuses reports (evidence: `code/argus_core/dashboard/app.py`)
- Evidence Fusion → Evidence Models: uses models (evidence: `code/argus_core/evidence_engine/engine.py`)
- Dashboard Backend → Road Graph: builds network (evidence: `code/argus_core/dashboard/app.py`)
- Dashboard Backend → Safe Routing: plans routes (evidence: `code/argus_core/dashboard/app.py`)
- Safe Routing → Road Graph: queries graph (evidence: `code/argus_core/routing_engine/engine.py`)
- Safe Routing → Evidence Models: reads summaries (evidence: `code/argus_core/routing_engine/engine.py`)
- Safe Routing → D* Lite Reference: dispatches planner (evidence: `code/argus_core/routing_engine/engine.py`)
- Dashboard Backend → Request Allocation: assigns relief (evidence: `code/argus_core/dashboard/app.py`)
- Request Allocation → Hungarian Assignment: uses assignment (evidence: `code/argus_core/allocation_engine/engine.py`)
- Dashboard Backend → Delivery Max Flow: analyzes capacity (evidence: `README.md`)
- Scenario Definitions → Road Graph: builds scenarios (evidence: `code/argus_core/simulator/scenario.py`)
- Scenario Definitions → Hidden Road Truth: defines events (evidence: `code/argus_core/simulator/scenario.py`)
- Strategy Evaluator → Scenario Definitions: evaluates scenarios (evidence: `code/argus_core/simulator/evaluator.py`)
- Strategy Evaluator → Hidden Road Truth: checks outcomes (evidence: `code/argus_core/simulator/evaluator.py`)
- Strategy Evaluator → Safe Routing: tests strategies (evidence: `code/argus_core/simulator/evaluator.py`)
- Strategy Evaluator → Evidence Fusion: generates evidence (evidence: `code/argus_core/simulator/evaluator.py`)
