# divyansh-rajput526/bus_tracker architecture

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

- Interactive diagram: https://gitdiagram.com/divyansh-rajput526/bus_tracker
- Repository: https://github.com/divyansh-rajput526/bus_tracker

## Overview

This is a live fleet-tracking product: driver GPS reports enter an Axum backend, are validated and persisted, and a React/Leaflet client polls and presents vehicle status, routes, stops, speed, and ETA. A separate admin portal manages fleet records and device pairing. The README supplies the end-to-end API and feature relationships; sampled source confirms backend-to-database calls and frontend presentation/helper use. The Flutter Dart application source is absent from this tree, so its runtime behavior is shown only as a documented external-facing driver app, not inferred from native platform scaffolding.

Main entry points: [`bus_tracker_frontend/src/App.jsx`](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/App.jsx) (Live Map UI), [`bus_tracker_backend/src/db.rs`](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/db.rs) (PostgreSQL Store), [`bus_tracker_backend/src/main.rs`](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs) (Location API), [`bus_tracker_frontend/src/AdminDashboard.jsx`](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/AdminDashboard.jsx) (Admin Portal)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_driver["Driver Telemetry"]
  node_driver_app(("Driver App"))
end

subgraph group_backend["Tracking Backend"]
  node_telemetry_api["Location API<br/>[main.rs]"]
  node_domain_validation["Fix Validation<br/>[main.rs]"]
  node_db[("PostgreSQL Store<br/>[db.rs]")]
  node_location_api["Active Locations API<br/>[main.rs]"]
  node_routes_api["Routes API<br/>[main.rs]"]
  node_admin_api["Admin API<br/>[main.rs]"]
  node_device_claim["Device Claim API<br/>[main.rs]"]
end

subgraph group_web["Live Map"]
  node_web_entry["Web App Entry<br/>[main.jsx]"]
  node_live_map["Live Map UI<br/>[App.jsx]"]
  node_vehicle_display["Speed and ETA"]
end

subgraph group_admin["Fleet Admin"]
  node_admin_ui["Admin Portal<br/>[AdminDashboard.jsx]"]
  node_admin_client["Admin API Client<br/>[adminApi.js]"]
  node_admin_format["Admin Presentation"]
end

node_web_user(("Passenger / Dispatcher"))
node_map_tiles["OSM Tiles"]

node_driver_app -.->|"posts GPS"| node_telemetry_api
node_telemetry_api -->|"validates fixes"| node_domain_validation
node_telemetry_api -->|"writes updates"| node_db
node_location_api -.->|"reads locations"| node_db
node_routes_api -.->|"reads routes"| node_db
node_admin_api -->|"manages fleet"| node_db
node_device_claim -.->|"claims pairing"| node_db
node_web_entry -->|"renders"| node_live_map
node_web_user -.->|"views fleet"| node_live_map
node_live_map -.->|"polls locations"| node_location_api
node_live_map -.->|"loads routes"| node_routes_api
node_live_map -->|"uses calculations"| node_vehicle_display
node_live_map -.->|"renders map"| node_map_tiles
node_web_user -.->|"manages fleet"| node_admin_ui
node_admin_ui -->|"calls"| node_admin_client
node_admin_ui -->|"formats display"| node_admin_format
node_admin_client -.->|"requests management"| node_admin_api
node_driver_app -.->|"claims credential"| node_device_claim

click node_telemetry_api "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs"
click node_domain_validation "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs"
click node_db "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/db.rs"
click node_location_api "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs"
click node_routes_api "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs"
click node_admin_api "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs"
click node_device_claim "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs"
click node_web_entry "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/main.jsx"
click node_live_map "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/App.jsx"
click node_vehicle_display "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/vehiclePresentation.js"
click node_admin_ui "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/AdminDashboard.jsx"
click node_admin_client "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/adminApi.js"
click node_admin_format "https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/adminPresentation.js"

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_driver_app toneBlue
class node_telemetry_api,node_domain_validation,node_db,node_location_api,node_routes_api,node_admin_api,node_device_claim toneAmber
class node_web_entry,node_live_map,node_vehicle_display toneMint
class node_admin_ui,node_admin_client,node_admin_format toneRose
class node_web_user,node_map_tiles toneIndigo
```

## Components

### Driver Telemetry

- **Driver App**

### Tracking Backend

- [Location API](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs): `bus_tracker_backend/src/main.rs`
- [Fix Validation](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs): `bus_tracker_backend/src/main.rs`
- [PostgreSQL Store](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/db.rs): `bus_tracker_backend/src/db.rs`
- [Active Locations API](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs): `bus_tracker_backend/src/main.rs`
- [Routes API](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs): `bus_tracker_backend/src/main.rs`
- [Admin API](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs): `bus_tracker_backend/src/main.rs`
- [Device Claim API](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_backend/src/main.rs): `bus_tracker_backend/src/main.rs`

### Live Map

- [Web App Entry](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/main.jsx): `bus_tracker_frontend/src/main.jsx`
- [Live Map UI](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/App.jsx): `bus_tracker_frontend/src/App.jsx`
- [Speed and ETA](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/vehiclePresentation.js): `bus_tracker_frontend/src/vehiclePresentation.js`

### Fleet Admin

- [Admin Portal](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/AdminDashboard.jsx): `bus_tracker_frontend/src/AdminDashboard.jsx`
- [Admin API Client](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/adminApi.js): `bus_tracker_frontend/src/adminApi.js`
- [Admin Presentation](https://github.com/divyansh-rajput526/bus_tracker/blob/main/bus_tracker_frontend/src/adminPresentation.js): `bus_tracker_frontend/src/adminPresentation.js`

### Other components

- **Passenger / Dispatcher**
- **OSM Tiles**

## Connections

- Driver App → Location API: posts GPS
- Location API → Fix Validation: validates fixes (evidence: `bus_tracker_backend/src/main.rs`)
- Location API → PostgreSQL Store: writes updates (evidence: `bus_tracker_backend/src/main.rs`)
- Active Locations API → PostgreSQL Store: reads locations (evidence: `bus_tracker_backend/src/main.rs`)
- Routes API → PostgreSQL Store: reads routes (evidence: `bus_tracker_backend/src/main.rs`)
- Admin API → PostgreSQL Store: manages fleet (evidence: `bus_tracker_backend/src/main.rs`)
- Device Claim API → PostgreSQL Store: claims pairing (evidence: `bus_tracker_backend/src/main.rs`)
- Web App Entry → Live Map UI: renders (evidence: `bus_tracker_frontend/src/main.jsx`)
- Passenger / Dispatcher → Live Map UI: views fleet
- Live Map UI → Active Locations API: polls locations
- Live Map UI → Routes API: loads routes
- Live Map UI → Speed and ETA: uses calculations (evidence: `bus_tracker_frontend/src/App.jsx`)
- Live Map UI → OSM Tiles: renders map
- Passenger / Dispatcher → Admin Portal: manages fleet
- Admin Portal → Admin API Client: calls (evidence: `bus_tracker_frontend/src/AdminDashboard.jsx`)
- Admin Portal → Admin Presentation: formats display (evidence: `bus_tracker_frontend/src/AdminDashboard.jsx`)
- Admin API Client → Admin API: requests management
- Driver App → Device Claim API: claims credential
