# hasnainarefin/project-2-1 architecture

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

- Interactive diagram: https://gitdiagram.com/hasnainarefin/project-2-1
- Repository: https://github.com/hasnainarefin/project-2-1

## Overview

This is a terminal-based Khulna ambulance dispatch system. The main workflow is account/menu interaction, patient and pickup handling, normal or emergency request prioritization, ambulance and hospital selection, route display/animation, and trip logging. Administration, fleet and hospital management, location search, map/zone analytics, and trip/action history are separate capabilities. Edges reflect calls and references visible in the provided excerpts or SOURCE INDEX; some menu flows and subsystems are only partially sampled, so their internal links are omitted.

Main entry points: [`main.cpp`](https://github.com/hasnainarefin/project-2-1/blob/main/main.cpp) (Startup and saves), [`fleet_hospitals.cpp`](https://github.com/hasnainarefin/project-2-1/blob/main/fleet_hospitals.cpp) (Ambulance and hospitals), [`city_graph.cpp`](https://github.com/hasnainarefin/project-2-1/blob/main/city_graph.cpp) (Khulna road graph), [`dispatch.cpp`](https://github.com/hasnainarefin/project-2-1/blob/main/dispatch.cpp) (Trip dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_startup["Startup and saves<br/>[main.cpp]"]
  node_menus["User and admin menus<br/>[app_menu.cpp]"]
  node_shared["Shared records and console<br/>[common.cpp]"]
end

subgraph group_operations["Dispatch operations"]
  node_dispatch["Trip dispatch<br/>[dispatch.cpp]"]
  node_fleet["Ambulance and hospitals"]
end

subgraph group_city["City and routing"]
  node_mapview["Map and animation<br/>[map_view.cpp]"]
  node_citygraph["Khulna road graph<br/>[city_graph.cpp]"]
  node_traversal["Graph and zone traversal<br/>[traversal.cpp]"]
  node_search["Location sorting and search<br/>[sort_search.cpp]"]
end

subgraph group_records["Accounts and records"]
  node_accounts["Accounts and patients<br/>[hash_tables.cpp]"]
  node_history["Trips and action log<br/>[trip_history.cpp]"]
  node_fleetdata["Fleet save file<br/>[khulna_fleet.dat]"]
  node_hospitaldata["Hospital save file"]
  node_patientdata["Patient save file"]
  node_accountdata["Account save file"]
  node_tripdata["Trip save file<br/>[khulna_trips.dat]"]
end

subgraph group_queues["Request handling"]
  node_requests["Request queues<br/>[requests.cpp]"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_menus
node_startup -->|"runs"| node_menus
node_startup -->|"initializes"| node_citygraph
node_startup -->|"initializes zones"| node_traversal
node_menus -->|"looks up accounts"| node_accounts
node_menus -->|"uses queues"| node_requests
node_menus -.->|"starts dispatch"| node_dispatch
node_dispatch -->|"selects and updates"| node_fleet
node_dispatch -->|"routes with"| node_citygraph
node_dispatch -->|"animates route"| node_mapview
node_dispatch -->|"logs trip"| node_history
node_fleet -->|"ranks by distance"| node_citygraph
node_fleet -->|"sorts rankings"| node_search
node_fleet -->|"checks reachability"| node_traversal
node_mapview -->|"reads roads and nodes"| node_citygraph
node_traversal -->|"reads neighbors"| node_citygraph
node_search -->|"searches locations"| node_citygraph
node_history -->|"sorts trip report"| node_search
node_startup -->|"loads and saves fleet"| node_fleet
node_startup -->|"loads and saves"| node_hospitaldata
node_startup -->|"loads and saves"| node_patientdata
node_startup -->|"loads and saves"| node_accountdata
node_startup -->|"loads and saves"| node_tripdata
node_fleet -->|"reads and writes"| node_fleetdata
node_fleet -->|"reads and writes"| node_hospitaldata
node_accounts -->|"uses records"| node_shared
node_requests -->|"uses helpers"| node_shared
node_history -->|"uses helpers"| node_shared

click node_startup "https://github.com/hasnainarefin/project-2-1/blob/main/main.cpp"
click node_menus "https://github.com/hasnainarefin/project-2-1/blob/main/app_menu.cpp"
click node_requests "https://github.com/hasnainarefin/project-2-1/blob/main/requests.cpp"
click node_dispatch "https://github.com/hasnainarefin/project-2-1/blob/main/dispatch.cpp"
click node_fleet "https://github.com/hasnainarefin/project-2-1/blob/main/fleet_hospitals.cpp"
click node_mapview "https://github.com/hasnainarefin/project-2-1/blob/main/map_view.cpp"
click node_citygraph "https://github.com/hasnainarefin/project-2-1/blob/main/city_graph.cpp"
click node_traversal "https://github.com/hasnainarefin/project-2-1/blob/main/traversal.cpp"
click node_search "https://github.com/hasnainarefin/project-2-1/blob/main/sort_search.cpp"
click node_accounts "https://github.com/hasnainarefin/project-2-1/blob/main/hash_tables.cpp"
click node_history "https://github.com/hasnainarefin/project-2-1/blob/main/trip_history.cpp"
click node_shared "https://github.com/hasnainarefin/project-2-1/blob/main/common.cpp"
click node_fleetdata "https://github.com/hasnainarefin/project-2-1/blob/main/khulna_fleet.dat"
click node_hospitaldata "https://github.com/hasnainarefin/project-2-1/blob/main/khulna_hospitals.dat"
click node_patientdata "https://github.com/hasnainarefin/project-2-1/blob/main/khulna_patients.dat"
click node_accountdata "https://github.com/hasnainarefin/project-2-1/blob/main/khulna_accounts.dat"
click node_tripdata "https://github.com/hasnainarefin/project-2-1/blob/main/khulna_trips.dat"

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_startup,node_menus,node_shared toneBlue
class node_dispatch,node_fleet toneAmber
class node_mapview,node_citygraph,node_traversal,node_search toneMint
class node_accounts,node_history,node_fleetdata,node_hospitaldata,node_patientdata,node_accountdata,node_tripdata toneRose
class node_requests,node_operator toneIndigo
```

## Components

### Application entry

- [Startup and saves](https://github.com/hasnainarefin/project-2-1/blob/main/main.cpp): `main.cpp`
- [User and admin menus](https://github.com/hasnainarefin/project-2-1/blob/main/app_menu.cpp): `app_menu.cpp`
- [Shared records and console](https://github.com/hasnainarefin/project-2-1/blob/main/common.cpp): `common.cpp`

### Dispatch operations

- [Trip dispatch](https://github.com/hasnainarefin/project-2-1/blob/main/dispatch.cpp): `dispatch.cpp`
- [Ambulance and hospitals](https://github.com/hasnainarefin/project-2-1/blob/main/fleet_hospitals.cpp): `fleet_hospitals.cpp`

### City and routing

- [Map and animation](https://github.com/hasnainarefin/project-2-1/blob/main/map_view.cpp): `map_view.cpp`
- [Khulna road graph](https://github.com/hasnainarefin/project-2-1/blob/main/city_graph.cpp): `city_graph.cpp`
- [Graph and zone traversal](https://github.com/hasnainarefin/project-2-1/blob/main/traversal.cpp): `traversal.cpp`
- [Location sorting and search](https://github.com/hasnainarefin/project-2-1/blob/main/sort_search.cpp): `sort_search.cpp`

### Accounts and records

- [Accounts and patients](https://github.com/hasnainarefin/project-2-1/blob/main/hash_tables.cpp): `hash_tables.cpp`
- [Trips and action log](https://github.com/hasnainarefin/project-2-1/blob/main/trip_history.cpp): `trip_history.cpp`
- [Fleet save file](https://github.com/hasnainarefin/project-2-1/blob/main/khulna_fleet.dat): `khulna_fleet.dat`
- [Hospital save file](https://github.com/hasnainarefin/project-2-1/blob/main/khulna_hospitals.dat): `khulna_hospitals.dat`
- [Patient save file](https://github.com/hasnainarefin/project-2-1/blob/main/khulna_patients.dat): `khulna_patients.dat`
- [Account save file](https://github.com/hasnainarefin/project-2-1/blob/main/khulna_accounts.dat): `khulna_accounts.dat`
- [Trip save file](https://github.com/hasnainarefin/project-2-1/blob/main/khulna_trips.dat): `khulna_trips.dat`

### Request handling

- [Request queues](https://github.com/hasnainarefin/project-2-1/blob/main/requests.cpp): `requests.cpp`

### Other components

- **Operator**

## Connections

- Operator → User and admin menus: uses (evidence: `app_menu.cpp`)
- Startup and saves → User and admin menus: runs (evidence: `main.cpp`)
- Startup and saves → Khulna road graph: initializes (evidence: `main.cpp`)
- Startup and saves → Graph and zone traversal: initializes zones (evidence: `main.cpp`)
- User and admin menus → Accounts and patients: looks up accounts (evidence: `app_menu.cpp`)
- User and admin menus → Request queues: uses queues (evidence: `app_menu.cpp`)
- User and admin menus → Trip dispatch: starts dispatch (evidence: `app_menu.cpp`)
- Trip dispatch → Ambulance and hospitals: selects and updates (evidence: `dispatch.cpp`)
- Trip dispatch → Khulna road graph: routes with (evidence: `dispatch.cpp`)
- Trip dispatch → Map and animation: animates route (evidence: `dispatch.cpp`)
- Trip dispatch → Trips and action log: logs trip (evidence: `dispatch.cpp`)
- Ambulance and hospitals → Khulna road graph: ranks by distance (evidence: `fleet_hospitals.cpp`)
- Ambulance and hospitals → Location sorting and search: sorts rankings (evidence: `fleet_hospitals.cpp`)
- Ambulance and hospitals → Graph and zone traversal: checks reachability (evidence: `fleet_hospitals.cpp`)
- Map and animation → Khulna road graph: reads roads and nodes (evidence: `map_view.cpp`)
- Graph and zone traversal → Khulna road graph: reads neighbors (evidence: `traversal.cpp`)
- Location sorting and search → Khulna road graph: searches locations (evidence: `sort_search.cpp`)
- Trips and action log → Location sorting and search: sorts trip report (evidence: `trip_history.cpp`)
- Startup and saves → Ambulance and hospitals: loads and saves fleet (evidence: `main.cpp`)
- Startup and saves → Hospital save file: loads and saves (evidence: `main.cpp`)
- Startup and saves → Patient save file: loads and saves (evidence: `main.cpp`)
- Startup and saves → Account save file: loads and saves (evidence: `main.cpp`)
- Startup and saves → Trip save file: loads and saves (evidence: `main.cpp`)
- Ambulance and hospitals → Fleet save file: reads and writes (evidence: `fleet_hospitals.cpp`)
- Ambulance and hospitals → Hospital save file: reads and writes (evidence: `fleet_hospitals.cpp`)
- Accounts and patients → Shared records and console: uses records (evidence: `hash_tables.cpp`)
- Request queues → Shared records and console: uses helpers (evidence: `requests.cpp`)
- Trips and action log → Shared records and console: uses helpers (evidence: `trip_history.cpp`)
