How ankidevelops/aashray works
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: api.ts API client · main.py FastAPI application · decision.py Incident decisions · CitizenPage.tsx Citizen portal
Components 25
Web experience
- Citizen portal
frontend/src/CitizenPage.tsx - Responder console
frontend/src/OpsPage.tsx - Login and roles
frontend/src/LoginPage.tsx - API client
frontend/src/api.ts - Decision map
frontend/src/DecisionMap.tsx - Web app routing
frontend/src/App.tsx
API and identity
- FastAPI application
backend/aashray/main.py - Authentication
backend/aashray/routers/auth.py - Identity and access
backend/aashray/deps.py - Evidence endpoints
backend/aashray/routers/evidence.py - Incident endpoints
backend/aashray/routers/incidents.py - Situation snapshots
backend/aashray/services/snapshot.py - SQLite persistence
backend/aashray/database.py - Operational records
backend/aashray/models.py - Safe routes endpoint
backend/aashray/routers/routes.py
Evidence and incidents
- Evidence and check-in ingest
backend/aashray/services/ingest.py - Evidence fusion
backend/aashray/services/fusion.py
Decision support
- Incident decisions
backend/aashray/services/decision.py - GIS and safety rules
backend/aashray/intelligence - Route scoring
backend/aashray/services/routes.py - Demo clock and scenario
backend/aashray/services/clock.py - Optional sitrep LLM
backend/aashray/services/llm.py
Other components
- Citizens
- Responders
- LLM service
Connections 32
- Citizens → Citizen portal: submit reports
- Responders → Responder console: review situation
- Web app routing → Citizen portal: routes to
frontend/src/App.tsx - Web app routing → Responder console: routes to
frontend/src/App.tsx - Web app routing → Login and roles: routes to
frontend/src/App.tsx - Citizen portal → API client: uses
frontend/src/CitizenPage.tsx - Responder console → API client: uses
frontend/src/OpsPage.tsx - Citizen portal → Decision map: renders
frontend/src/CitizenPage.tsx - Responder console → Decision map: renders
frontend/src/OpsPage.tsx - API client → Authentication: posts login
frontend/src/api.ts - API client → Evidence endpoints: posts evidence
frontend/src/api.ts - API client → Incident endpoints: fetches incidents
frontend/src/api.ts - API client → Situation snapshots: fetches snapshots
frontend/src/api.ts - API client → Safe routes endpoint: fetches routes
frontend/src/api.ts - FastAPI application → Authentication: registers router
backend/aashray/main.py - FastAPI application → Evidence endpoints: registers router
backend/aashray/main.py - FastAPI application → Incident endpoints: registers router
backend/aashray/main.py - FastAPI application → Safe routes endpoint: registers router
backend/aashray/main.py - Authentication → Identity and access: authenticates users
backend/aashray/routers/auth.py - Evidence endpoints → Evidence and check-in ingest: calls ingest
backend/aashray/routers/evidence.py - Evidence and check-in ingest → Evidence fusion: fuses evidence
backend/aashray/services/ingest.py - Evidence and check-in ingest → Incident decisions: runs decisions
backend/aashray/services/ingest.py - Incident endpoints → Situation snapshots: uses snapshots
backend/aashray/routers/incidents.py - Incident decisions → GIS and safety rules: uses assessments
backend/aashray/services/decision.py - Incident decisions → Route scoring: uses route scoring
backend/aashray/services/decision.py - Safe routes endpoint → Route scoring: scores candidates
backend/aashray/routers/routes.py - Route scoring → GIS and safety rules: checks hazards
backend/aashray/services/routes.py - FastAPI application → Demo clock and scenario: supports demo clock
- Incident decisions → Optional sitrep LLM: enhances sitrep
backend/aashray/services/decision.py - Optional sitrep LLM → LLM service: calls when configured
- FastAPI application → SQLite persistence: initializes database
backend/aashray/main.py - SQLite persistence → Operational records: stores records
backend/aashray/models.py