# saptarshipal33/ambulance_system architecture

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

- Interactive diagram: https://gitdiagram.com/saptarshipal33/ambulance_system
- Repository: https://github.com/saptarshipal33/ambulance_system

## Overview

This is a Bangalore emergency-hospital routing product with ambulance dispatch, hospital resource reporting, and administration portals. The main workflow captures a victim location, requests ranked eligible hospitals, and presents routing choices; ambulance endpoints also support case triage, alerts, and offline-region calculation. Hospital staff submit availability ranges that are stored as conservative counts and used in ranking. The graph reflects documented and sampled relationships; some endpoint modules appear in the source index but are not shown as registered in the sampled application entry point.

Main entry points: [`backend/app/api/hospital.py`](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/hospital.py) (Hospital endpoints), [`backend/app/core/database.py`](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/database.py) (SQLAlchemy database), [`backend/app/main.py`](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/main.py) (FastAPI application), [`backend/app/api/ambulance.py`](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/ambulance.py) (Ambulance endpoints)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ambulance["Ambulance Dispatch"]
  node_ambulance_ui["Dispatch dashboard<br/>[App.jsx]"]
  node_map["Routing map<br/>[MapView.jsx]"]
  node_ambulance_client["Ambulance API client<br/>[api.js]"]
end

subgraph group_hospital["Hospital Resources"]
  node_hospital_ui["Resource update form<br/>[App.jsx]"]
  node_hospital_client["Hospital API client<br/>[api.js]"]
end

subgraph group_backend["API and Domain Logic"]
  node_api_app["FastAPI application<br/>[main.py]"]
  node_ambulance_routes["Ambulance endpoints<br/>[ambulance.py]"]
  node_hospital_routes["Hospital endpoints<br/>[hospital.py]"]
  node_admin_routes["Admin endpoints<br/>[admin.py]"]
  node_role_check["Role authorization<br/>[dependencies.py]"]
  node_ranking["Hospital ranking<br/>[ranking.py]"]
  node_resource_utils["Resource and freshness rules<br/>[utils.py]"]
  node_hospital_portal_endpoints["Hospital discovery endpoints<br/>[hospitals.py]"]
  node_ai_endpoint["AI endpoint module<br/>[ai.py]"]
  node_alert_endpoint["Alert endpoint module<br/>[alerts.py]"]
  node_hospital_schema["Hospital API schemas<br/>[hospital.py]"]
end

subgraph group_data["Persistence"]
  node_hospital_model["Hospital domain model<br/>[hospital.py]"]
  node_database[("SQLAlchemy database<br/>[database.py]")]
  node_seed["Startup data seeding<br/>[seed.py]"]
end

node_ambulance_user(("Ambulance operator"))
node_hospital_user(("Hospital staff"))
node_postgres[("PostgreSQL")]

node_ambulance_user -->|"uses"| node_ambulance_ui
node_ambulance_ui -->|"calls"| node_ambulance_client
node_ambulance_ui -->|"renders"| node_map
node_ambulance_client -->|"requests"| node_ambulance_routes
node_hospital_user -->|"uses"| node_hospital_ui
node_hospital_ui -->|"calls"| node_hospital_client
node_hospital_client -->|"requests"| node_hospital_routes
node_api_app -->|"registers"| node_ambulance_routes
node_api_app -->|"registers"| node_hospital_routes
node_api_app -->|"registers"| node_admin_routes
node_api_app -->|"initializes"| node_database
node_api_app -->|"runs at startup"| node_seed
node_ambulance_routes -->|"ranks hospitals"| node_ranking
node_ambulance_routes -->|"queries"| node_database
node_ambulance_routes -->|"authorizes"| node_role_check
node_hospital_routes -->|"updates resources"| node_database
node_hospital_routes -->|"parses ranges"| node_resource_utils
node_hospital_routes -->|"authorizes"| node_role_check
node_admin_routes -->|"uses session"| node_database
node_admin_routes -->|"authorizes"| node_role_check
node_ranking -->|"calculates scores"| node_resource_utils
node_ranking -->|"queries records"| node_hospital_model
node_hospital_routes -->|"updates records"| node_hospital_model
node_database -.->|"connects"| node_postgres
node_seed -->|"seeds"| node_database
node_hospital_portal_endpoints -->|"queries records"| node_hospital_model

click node_ambulance_ui "https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/ambulance-portal/src/App.jsx"
click node_map "https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/ambulance-portal/src/MapView.jsx"
click node_ambulance_client "https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/ambulance-portal/src/api.js"
click node_hospital_ui "https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/hospital-portal/src/App.jsx"
click node_hospital_client "https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/hospital-portal/src/api.js"
click node_api_app "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/main.py"
click node_ambulance_routes "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/ambulance.py"
click node_hospital_routes "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/hospital.py"
click node_admin_routes "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/admin.py"
click node_role_check "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/dependencies.py"
click node_ranking "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/ranking.py"
click node_resource_utils "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/utils.py"
click node_hospital_portal_endpoints "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/endpoints/hospitals.py"
click node_ai_endpoint "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/endpoints/ai.py"
click node_alert_endpoint "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/endpoints/alerts.py"
click node_hospital_model "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/models/hospital.py"
click node_hospital_schema "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/schemas/hospital.py"
click node_database "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/database.py"
click node_seed "https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/seed.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_ambulance_ui,node_map,node_ambulance_client toneBlue
class node_hospital_ui,node_hospital_client,node_postgres toneAmber
class node_api_app,node_ambulance_routes,node_hospital_routes,node_admin_routes,node_role_check,node_ranking,node_resource_utils,node_hospital_portal_endpoints,node_ai_endpoint,node_alert_endpoint,node_hospital_schema toneMint
class node_hospital_model,node_database,node_seed toneRose
class node_ambulance_user,node_hospital_user toneIndigo
```

## Components

### Ambulance Dispatch

- [Dispatch dashboard](https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/ambulance-portal/src/App.jsx): `frontend/ambulance-portal/src/App.jsx`
- [Routing map](https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/ambulance-portal/src/MapView.jsx): `frontend/ambulance-portal/src/MapView.jsx`
- [Ambulance API client](https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/ambulance-portal/src/api.js): `frontend/ambulance-portal/src/api.js`

### Hospital Resources

- [Resource update form](https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/hospital-portal/src/App.jsx): `frontend/hospital-portal/src/App.jsx`
- [Hospital API client](https://github.com/saptarshipal33/ambulance_system/blob/main/frontend/hospital-portal/src/api.js): `frontend/hospital-portal/src/api.js`

### API and Domain Logic

- [FastAPI application](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/main.py): `backend/app/main.py`
- [Ambulance endpoints](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/ambulance.py): `backend/app/api/ambulance.py`
- [Hospital endpoints](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/hospital.py): `backend/app/api/hospital.py`
- [Admin endpoints](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/admin.py): `backend/app/api/admin.py`
- [Role authorization](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/dependencies.py): `backend/app/api/dependencies.py`
- [Hospital ranking](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/ranking.py): `backend/app/core/ranking.py`
- [Resource and freshness rules](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/utils.py): `backend/app/core/utils.py`
- [Hospital discovery endpoints](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/endpoints/hospitals.py): `backend/app/api/endpoints/hospitals.py`
- [AI endpoint module](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/endpoints/ai.py): `backend/app/api/endpoints/ai.py`
- [Alert endpoint module](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/api/endpoints/alerts.py): `backend/app/api/endpoints/alerts.py`
- [Hospital API schemas](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/schemas/hospital.py): `backend/app/schemas/hospital.py`

### Persistence

- [Hospital domain model](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/models/hospital.py): `backend/app/models/hospital.py`
- [SQLAlchemy database](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/database.py): `backend/app/core/database.py`
- [Startup data seeding](https://github.com/saptarshipal33/ambulance_system/blob/main/backend/app/core/seed.py): `backend/app/core/seed.py`

### Other components

- **Ambulance operator**
- **Hospital staff**
- **PostgreSQL**

## Connections

- Ambulance operator → Dispatch dashboard: uses (evidence: `README.md`)
- Dispatch dashboard → Ambulance API client: calls (evidence: `frontend/ambulance-portal/src/App.jsx`)
- Dispatch dashboard → Routing map: renders (evidence: `frontend/ambulance-portal/src/App.jsx`)
- Ambulance API client → Ambulance endpoints: requests (evidence: `README.md`)
- Hospital staff → Resource update form: uses (evidence: `README.md`)
- Resource update form → Hospital API client: calls (evidence: `frontend/hospital-portal/src/App.jsx`)
- Hospital API client → Hospital endpoints: requests (evidence: `README.md`)
- FastAPI application → Ambulance endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Hospital endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → Admin endpoints: registers (evidence: `backend/app/main.py`)
- FastAPI application → SQLAlchemy database: initializes (evidence: `backend/app/main.py`)
- FastAPI application → Startup data seeding: runs at startup (evidence: `backend/app/main.py`)
- Ambulance endpoints → Hospital ranking: ranks hospitals (evidence: `backend/app/api/ambulance.py`)
- Ambulance endpoints → SQLAlchemy database: queries (evidence: `backend/app/api/ambulance.py`)
- Ambulance endpoints → Role authorization: authorizes (evidence: `backend/app/api/ambulance.py`)
- Hospital endpoints → SQLAlchemy database: updates resources (evidence: `backend/app/api/hospital.py`)
- Hospital endpoints → Resource and freshness rules: parses ranges (evidence: `backend/app/api/hospital.py`)
- Hospital endpoints → Role authorization: authorizes (evidence: `backend/app/api/hospital.py`)
- Admin endpoints → SQLAlchemy database: uses session (evidence: `backend/app/api/admin.py`)
- Admin endpoints → Role authorization: authorizes (evidence: `backend/app/api/admin.py`)
- Hospital ranking → Resource and freshness rules: calculates scores (evidence: `backend/app/core/ranking.py`)
- Hospital ranking → Hospital domain model: queries records (evidence: `backend/app/core/ranking.py`)
- Hospital endpoints → Hospital domain model: updates records (evidence: `backend/app/api/hospital.py`)
- SQLAlchemy database → PostgreSQL: connects (evidence: `README.md`)
- Startup data seeding → SQLAlchemy database: seeds (evidence: `backend/app/main.py`)
- Hospital discovery endpoints → Hospital domain model: queries records (evidence: `backend/app/api/endpoints/hospitals.py`)
