# ankidevelops/aashray architecture

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

- Interactive diagram: https://gitdiagram.com/ankidevelops/aashray
- Repository: https://github.com/ankidevelops/aashray

## Overview

AASHRAY is a student prototype for landslide situation awareness: citizens submit SOS reports and check-ins; responders review fused incidents, GIS/rule assessments, routes, and status. Its main flow runs from evidence intake through fusion and decision support to API snapshots and role-specific web views. The README documents several simulated or precomputed capabilities whose implementations were not sampled; those are represented at their supported directory paths. Relationships are limited to sampled calls, indexed references, and README statements.

Main entry points: [`frontend/src/api.ts`](https://github.com/ankidevelops/aashray/blob/main/frontend/src/api.ts) (API client), [`backend/aashray/main.py`](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/main.py) (FastAPI application), [`backend/aashray/services/decision.py`](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/decision.py) (Incident decisions), [`frontend/src/CitizenPage.tsx`](https://github.com/ankidevelops/aashray/blob/main/frontend/src/CitizenPage.tsx) (Citizen portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_citizen["Citizen portal<br/>[CitizenPage.tsx]"]
  node_ops["Responder console<br/>[OpsPage.tsx]"]
  node_login["Login and roles<br/>[LoginPage.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
  node_map["Decision map<br/>[DecisionMap.tsx]"]
  node_app["Web app routing<br/>[App.tsx]"]
end

subgraph group_api["API and identity"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_auth["Authentication<br/>[auth.py]"]
  node_identity["Identity and access<br/>[deps.py]"]
  node_evidence_api["Evidence endpoints<br/>[evidence.py]"]
  node_incident_api["Incident endpoints<br/>[incidents.py]"]
  node_snapshot["Situation snapshots<br/>[snapshot.py]"]
  node_database[("SQLite persistence<br/>[database.py]")]
  node_domain_data["Operational records<br/>[models.py]"]
  node_route_api["Safe routes endpoint<br/>[routes.py]"]
end

subgraph group_signals["Evidence and incidents"]
  node_ingest["Evidence and check-in ingest<br/>[ingest.py]"]
  node_fusion["Evidence fusion<br/>[fusion.py]"]
end

subgraph group_support["Decision support"]
  node_decision["Incident decisions<br/>[decision.py]"]
  node_rules["GIS and safety rules"]
  node_routing["Route scoring<br/>[routes.py]"]
  node_demo["Demo clock and scenario<br/>[clock.py]"]
  node_llm["Optional sitrep LLM<br/>[llm.py]"]
end

node_citizens(("Citizens"))
node_responders(("Responders"))
node_external_llm["LLM service"]

node_citizens -->|"submit reports"| node_citizen
node_responders -->|"review situation"| node_ops
node_app -->|"routes to"| node_citizen
node_app -->|"routes to"| node_ops
node_app -->|"routes to"| node_login
node_citizen -->|"uses"| node_api_client
node_ops -->|"uses"| node_api_client
node_citizen -->|"renders"| node_map
node_ops -->|"renders"| node_map
node_api_client -->|"posts login"| node_auth
node_api_client -->|"posts evidence"| node_evidence_api
node_api_client -->|"fetches incidents"| node_incident_api
node_api_client -->|"fetches snapshots"| node_snapshot
node_api_client -->|"fetches routes"| node_route_api
node_api_app -->|"registers router"| node_auth
node_api_app -->|"registers router"| node_evidence_api
node_api_app -->|"registers router"| node_incident_api
node_api_app -->|"registers router"| node_route_api
node_auth -->|"authenticates users"| node_identity
node_evidence_api -->|"calls ingest"| node_ingest
node_ingest -->|"fuses evidence"| node_fusion
node_ingest -->|"runs decisions"| node_decision
node_incident_api -->|"uses snapshots"| node_snapshot
node_decision -->|"uses assessments"| node_rules
node_decision -->|"uses route scoring"| node_routing
node_route_api -->|"scores candidates"| node_routing
node_routing -->|"checks hazards"| node_rules
node_api_app -.->|"supports demo clock"| node_demo
node_decision -->|"enhances sitrep"| node_llm
node_llm -.->|"calls when configured"| node_external_llm
node_api_app -->|"initializes database"| node_database
node_database -->|"stores records"| node_domain_data

click node_citizen "https://github.com/ankidevelops/aashray/blob/main/frontend/src/CitizenPage.tsx"
click node_ops "https://github.com/ankidevelops/aashray/blob/main/frontend/src/OpsPage.tsx"
click node_login "https://github.com/ankidevelops/aashray/blob/main/frontend/src/LoginPage.tsx"
click node_api_client "https://github.com/ankidevelops/aashray/blob/main/frontend/src/api.ts"
click node_map "https://github.com/ankidevelops/aashray/blob/main/frontend/src/DecisionMap.tsx"
click node_app "https://github.com/ankidevelops/aashray/blob/main/frontend/src/App.tsx"
click node_api_app "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/main.py"
click node_auth "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/auth.py"
click node_identity "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/deps.py"
click node_evidence_api "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/evidence.py"
click node_incident_api "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/incidents.py"
click node_snapshot "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/snapshot.py"
click node_database "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/database.py"
click node_domain_data "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/models.py"
click node_ingest "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/ingest.py"
click node_fusion "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/fusion.py"
click node_decision "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/decision.py"
click node_rules "https://github.com/ankidevelops/aashray/tree/main/backend/aashray/intelligence"
click node_routing "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/routes.py"
click node_route_api "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/routes.py"
click node_demo "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/clock.py"
click node_llm "https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/llm.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_citizen,node_ops,node_login,node_api_client,node_map,node_app toneBlue
class node_api_app,node_auth,node_identity,node_evidence_api,node_incident_api,node_snapshot,node_database,node_domain_data,node_route_api toneAmber
class node_ingest,node_fusion toneMint
class node_decision,node_rules,node_routing,node_demo,node_llm toneRose
class node_citizens,node_responders,node_external_llm toneIndigo
```

## Components

### Web experience

- [Citizen portal](https://github.com/ankidevelops/aashray/blob/main/frontend/src/CitizenPage.tsx): `frontend/src/CitizenPage.tsx`
- [Responder console](https://github.com/ankidevelops/aashray/blob/main/frontend/src/OpsPage.tsx): `frontend/src/OpsPage.tsx`
- [Login and roles](https://github.com/ankidevelops/aashray/blob/main/frontend/src/LoginPage.tsx): `frontend/src/LoginPage.tsx`
- [API client](https://github.com/ankidevelops/aashray/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Decision map](https://github.com/ankidevelops/aashray/blob/main/frontend/src/DecisionMap.tsx): `frontend/src/DecisionMap.tsx`
- [Web app routing](https://github.com/ankidevelops/aashray/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### API and identity

- [FastAPI application](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/main.py): `backend/aashray/main.py`
- [Authentication](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/auth.py): `backend/aashray/routers/auth.py`
- [Identity and access](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/deps.py): `backend/aashray/deps.py`
- [Evidence endpoints](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/evidence.py): `backend/aashray/routers/evidence.py`
- [Incident endpoints](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/incidents.py): `backend/aashray/routers/incidents.py`
- [Situation snapshots](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/snapshot.py): `backend/aashray/services/snapshot.py`
- [SQLite persistence](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/database.py): `backend/aashray/database.py`
- [Operational records](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/models.py): `backend/aashray/models.py`
- [Safe routes endpoint](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/routers/routes.py): `backend/aashray/routers/routes.py`

### Evidence and incidents

- [Evidence and check-in ingest](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/ingest.py): `backend/aashray/services/ingest.py`
- [Evidence fusion](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/fusion.py): `backend/aashray/services/fusion.py`

### Decision support

- [Incident decisions](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/decision.py): `backend/aashray/services/decision.py`
- [GIS and safety rules](https://github.com/ankidevelops/aashray/tree/main/backend/aashray/intelligence): `backend/aashray/intelligence`
- [Route scoring](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/routes.py): `backend/aashray/services/routes.py`
- [Demo clock and scenario](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/clock.py): `backend/aashray/services/clock.py`
- [Optional sitrep LLM](https://github.com/ankidevelops/aashray/blob/main/backend/aashray/services/llm.py): `backend/aashray/services/llm.py`

### Other components

- **Citizens**
- **Responders**
- **LLM service**

## Connections

- Citizens → Citizen portal: submit reports
- Responders → Responder console: review situation
- Web app routing → Citizen portal: routes to (evidence: `frontend/src/App.tsx`)
- Web app routing → Responder console: routes to (evidence: `frontend/src/App.tsx`)
- Web app routing → Login and roles: routes to (evidence: `frontend/src/App.tsx`)
- Citizen portal → API client: uses (evidence: `frontend/src/CitizenPage.tsx`)
- Responder console → API client: uses (evidence: `frontend/src/OpsPage.tsx`)
- Citizen portal → Decision map: renders (evidence: `frontend/src/CitizenPage.tsx`)
- Responder console → Decision map: renders (evidence: `frontend/src/OpsPage.tsx`)
- API client → Authentication: posts login (evidence: `frontend/src/api.ts`)
- API client → Evidence endpoints: posts evidence (evidence: `frontend/src/api.ts`)
- API client → Incident endpoints: fetches incidents (evidence: `frontend/src/api.ts`)
- API client → Situation snapshots: fetches snapshots (evidence: `frontend/src/api.ts`)
- API client → Safe routes endpoint: fetches routes (evidence: `frontend/src/api.ts`)
- FastAPI application → Authentication: registers router (evidence: `backend/aashray/main.py`)
- FastAPI application → Evidence endpoints: registers router (evidence: `backend/aashray/main.py`)
- FastAPI application → Incident endpoints: registers router (evidence: `backend/aashray/main.py`)
- FastAPI application → Safe routes endpoint: registers router (evidence: `backend/aashray/main.py`)
- Authentication → Identity and access: authenticates users (evidence: `backend/aashray/routers/auth.py`)
- Evidence endpoints → Evidence and check-in ingest: calls ingest (evidence: `backend/aashray/routers/evidence.py`)
- Evidence and check-in ingest → Evidence fusion: fuses evidence (evidence: `backend/aashray/services/ingest.py`)
- Evidence and check-in ingest → Incident decisions: runs decisions (evidence: `backend/aashray/services/ingest.py`)
- Incident endpoints → Situation snapshots: uses snapshots (evidence: `backend/aashray/routers/incidents.py`)
- Incident decisions → GIS and safety rules: uses assessments (evidence: `backend/aashray/services/decision.py`)
- Incident decisions → Route scoring: uses route scoring (evidence: `backend/aashray/services/decision.py`)
- Safe routes endpoint → Route scoring: scores candidates (evidence: `backend/aashray/routers/routes.py`)
- Route scoring → GIS and safety rules: checks hazards (evidence: `backend/aashray/services/routes.py`)
- FastAPI application → Demo clock and scenario: supports demo clock
- Incident decisions → Optional sitrep LLM: enhances sitrep (evidence: `backend/aashray/services/decision.py`)
- Optional sitrep LLM → LLM service: calls when configured
- FastAPI application → SQLite persistence: initializes database (evidence: `backend/aashray/main.py`)
- SQLite persistence → Operational records: stores records (evidence: `backend/aashray/models.py`)
