# adhish-krishna/big-data-project architecture

> Architecture diagram of the GitHub repository adhish-krishna/big-data-project, 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/adhish-krishna/big-data-project
- Repository: https://github.com/adhish-krishna/big-data-project

## Overview

Smart Fleet & Rental Tracking is a React/Express IoT fleet and rental platform backed by MongoDB for vehicle, telemetry, and contract records, and Neo4j for hub networks and rental relationships. Users inspect live fleet and diagnostics, plan route-aware rentals, explore the graph, and review analytics. The frontend API service mediates page requests to Express; controllers own domain operations and invoke persistence or graph services. README capabilities are included where source excerpts were unavailable; those documented links are identified as such.

Main entry points: [`frontend/src/App.tsx`](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/App.tsx) (Application shell), [`backend/src/server.ts`](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/server.ts) (Express API), [`frontend/src/services/api.ts`](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/services/api.ts) (Frontend API client), [`backend/src/controllers/fleetController.ts`](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/fleetController.ts) (Fleet operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Fleet interface"]
  node_app["Application shell<br/>[App.tsx]"]
  node_fleetmap["Fleet map<br/>[FleetMapPage.tsx]"]
  node_drawer["Vehicle diagnostics<br/>[VehicleDrawer.tsx]"]
  node_rentalpage["Rental planner"]
  node_graphpage["Graph explorer<br/>[Neo4jGraphPage.tsx]"]
  node_analyticspage["Analytics dashboard"]
  node_api["Frontend API client<br/>[api.ts]"]
end

subgraph group_api["API and workflows"]
  node_server["Express API<br/>[server.ts]"]
  node_fleet["Fleet operations<br/>[fleetController.ts]"]
  node_rentals["Rental operations"]
  node_graph["Graph operations<br/>[graphController.ts]"]
  node_analytics["Analytics aggregation"]
end

subgraph group_data["Persistence and graph"]
  node_vehiclemodel[("Vehicle records<br/>[Vehicle.ts]")]
  node_telemetrymodel[("Telemetry records<br/>[Telemetry.ts]")]
  node_rentalmodel[("Rental records<br/>[Rental.ts]")]
  node_graphservice["Neo4j graph service"]
  node_dbconfig["Database connections<br/>[database.ts]"]
end

subgraph group_telemetry["IoT telemetry"]
  node_telemetryctrl["Telemetry controls"]
  node_simulator["Telemetry simulator"]
end

node_user(("Fleet operator"))
node_mongodb[("MongoDB")]
node_neo4j[("Neo4j")]

node_user -->|"uses"| node_app
node_app -->|"renders"| node_fleetmap
node_app -->|"renders"| node_rentalpage
node_app -->|"renders"| node_graphpage
node_app -->|"renders"| node_analyticspage
node_app -->|"renders"| node_drawer
node_app -->|"requests data"| node_api
node_fleetmap -.->|"loads fleet"| node_api
node_drawer -.->|"loads diagnostics"| node_api
node_rentalpage -->|"books rentals"| node_api
node_graphpage -->|"loads graph"| node_api
node_analyticspage -->|"loads metrics"| node_api
node_api -->|"calls HTTP API"| node_server
node_server -->|"routes fleet"| node_fleet
node_server -->|"routes rentals"| node_rentals
node_server -->|"routes graph"| node_graph
node_server -->|"routes telemetry"| node_telemetryctrl
node_server -->|"routes analytics"| node_analytics
node_fleet -->|"reads vehicles"| node_vehiclemodel
node_fleet -->|"reads history"| node_telemetrymodel
node_fleet -->|"looks up hubs"| node_graphservice
node_rentals -->|"checks availability"| node_vehiclemodel
node_rentals -->|"stores contracts"| node_rentalmodel
node_rentals -->|"plans and syncs"| node_graphservice
node_graph -->|"requests graph data"| node_graphservice
node_analytics -->|"aggregates fleet"| node_vehiclemodel
node_analytics -->|"aggregates alerts"| node_telemetrymodel
node_analytics -->|"aggregates revenue"| node_rentalmodel
node_telemetryctrl -->|"controls simulation"| node_simulator
node_server -->|"starts simulation"| node_simulator
node_simulator -->|"updates vehicles"| node_vehiclemodel
node_simulator -->|"records samples"| node_telemetrymodel
node_graphservice -->|"runs Cypher"| node_dbconfig
node_dbconfig -->|"connects"| node_mongodb
node_dbconfig -->|"queries"| node_neo4j

click node_app "https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/App.tsx"
click node_fleetmap "https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/FleetMapPage.tsx"
click node_drawer "https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/components/VehicleDrawer.tsx"
click node_rentalpage "https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/RentalPlannerPage.tsx"
click node_graphpage "https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/Neo4jGraphPage.tsx"
click node_analyticspage "https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/AnalyticsDashboardPage.tsx"
click node_api "https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/services/api.ts"
click node_server "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/server.ts"
click node_fleet "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/fleetController.ts"
click node_rentals "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/rentalController.ts"
click node_graph "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/graphController.ts"
click node_analytics "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/analyticsController.ts"
click node_telemetryctrl "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/telemetryController.ts"
click node_simulator "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/services/telemetrySimulatorService.ts"
click node_vehiclemodel "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/models/Vehicle.ts"
click node_telemetrymodel "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/models/Telemetry.ts"
click node_rentalmodel "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/models/Rental.ts"
click node_graphservice "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/services/neo4jGraphService.ts"
click node_dbconfig "https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/config/database.ts"

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_app,node_fleetmap,node_drawer,node_rentalpage,node_graphpage,node_analyticspage,node_api toneBlue
class node_server,node_fleet,node_rentals,node_graph,node_analytics,node_mongodb,node_neo4j toneAmber
class node_vehiclemodel,node_telemetrymodel,node_rentalmodel,node_graphservice,node_dbconfig toneMint
class node_telemetryctrl,node_simulator toneRose
class node_user toneIndigo
```

## Components

### Fleet interface

- [Application shell](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Fleet map](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/FleetMapPage.tsx): `frontend/src/pages/FleetMapPage.tsx`
- [Vehicle diagnostics](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/components/VehicleDrawer.tsx): `frontend/src/components/VehicleDrawer.tsx`
- [Rental planner](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/RentalPlannerPage.tsx): `frontend/src/pages/RentalPlannerPage.tsx`
- [Graph explorer](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/Neo4jGraphPage.tsx): `frontend/src/pages/Neo4jGraphPage.tsx`
- [Analytics dashboard](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/pages/AnalyticsDashboardPage.tsx): `frontend/src/pages/AnalyticsDashboardPage.tsx`
- [Frontend API client](https://github.com/adhish-krishna/big-data-project/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`

### API and workflows

- [Express API](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/server.ts): `backend/src/server.ts`
- [Fleet operations](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/fleetController.ts): `backend/src/controllers/fleetController.ts`
- [Rental operations](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/rentalController.ts): `backend/src/controllers/rentalController.ts`
- [Graph operations](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/graphController.ts): `backend/src/controllers/graphController.ts`
- [Analytics aggregation](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/analyticsController.ts): `backend/src/controllers/analyticsController.ts`

### Persistence and graph

- [Vehicle records](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/models/Vehicle.ts): `backend/src/models/Vehicle.ts`
- [Telemetry records](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/models/Telemetry.ts): `backend/src/models/Telemetry.ts`
- [Rental records](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/models/Rental.ts): `backend/src/models/Rental.ts`
- [Neo4j graph service](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/services/neo4jGraphService.ts): `backend/src/services/neo4jGraphService.ts`
- [Database connections](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/config/database.ts): `backend/src/config/database.ts`

### IoT telemetry

- [Telemetry controls](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/controllers/telemetryController.ts): `backend/src/controllers/telemetryController.ts`
- [Telemetry simulator](https://github.com/adhish-krishna/big-data-project/blob/main/backend/src/services/telemetrySimulatorService.ts): `backend/src/services/telemetrySimulatorService.ts`

### Other components

- **Fleet operator**
- **MongoDB**
- **Neo4j**

## Connections

- Fleet operator → Application shell: uses (evidence: `README.md`)
- Application shell → Fleet map: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Rental planner: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Graph explorer: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Analytics dashboard: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Vehicle diagnostics: renders (evidence: `frontend/src/App.tsx`)
- Application shell → Frontend API client: requests data (evidence: `frontend/src/App.tsx`)
- Fleet map → Frontend API client: loads fleet (evidence: `README.md`)
- Vehicle diagnostics → Frontend API client: loads diagnostics (evidence: `README.md`)
- Rental planner → Frontend API client: books rentals (evidence: `frontend/src/services/api.ts`)
- Graph explorer → Frontend API client: loads graph (evidence: `frontend/src/services/api.ts`)
- Analytics dashboard → Frontend API client: loads metrics (evidence: `frontend/src/services/api.ts`)
- Frontend API client → Express API: calls HTTP API (evidence: `frontend/src/services/api.ts`)
- Express API → Fleet operations: routes fleet (evidence: `backend/src/server.ts`)
- Express API → Rental operations: routes rentals (evidence: `backend/src/server.ts`)
- Express API → Graph operations: routes graph (evidence: `backend/src/server.ts`)
- Express API → Telemetry controls: routes telemetry (evidence: `backend/src/server.ts`)
- Express API → Analytics aggregation: routes analytics (evidence: `backend/src/server.ts`)
- Fleet operations → Vehicle records: reads vehicles (evidence: `backend/src/controllers/fleetController.ts`)
- Fleet operations → Telemetry records: reads history (evidence: `backend/src/controllers/fleetController.ts`)
- Fleet operations → Neo4j graph service: looks up hubs (evidence: `backend/src/controllers/fleetController.ts`)
- Rental operations → Vehicle records: checks availability (evidence: `backend/src/controllers/rentalController.ts`)
- Rental operations → Rental records: stores contracts (evidence: `backend/src/controllers/rentalController.ts`)
- Rental operations → Neo4j graph service: plans and syncs (evidence: `backend/src/controllers/rentalController.ts`)
- Graph operations → Neo4j graph service: requests graph data (evidence: `backend/src/controllers/graphController.ts`)
- Analytics aggregation → Vehicle records: aggregates fleet (evidence: `backend/src/controllers/analyticsController.ts`)
- Analytics aggregation → Telemetry records: aggregates alerts (evidence: `backend/src/controllers/analyticsController.ts`)
- Analytics aggregation → Rental records: aggregates revenue (evidence: `backend/src/controllers/analyticsController.ts`)
- Telemetry controls → Telemetry simulator: controls simulation (evidence: `backend/src/controllers/telemetryController.ts`)
- Express API → Telemetry simulator: starts simulation (evidence: `backend/src/server.ts`)
- Telemetry simulator → Vehicle records: updates vehicles (evidence: `backend/src/services/telemetrySimulatorService.ts`)
- Telemetry simulator → Telemetry records: records samples (evidence: `backend/src/services/telemetrySimulatorService.ts`)
- Neo4j graph service → Database connections: runs Cypher (evidence: `backend/src/services/neo4jGraphService.ts`)
- Database connections → MongoDB: connects (evidence: `backend/src/config/database.ts`)
- Database connections → Neo4j: queries (evidence: `backend/src/config/database.ts`)
