How adhish-krishna/big-data-project works
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: App.tsx Application shell · server.ts Express API · api.ts Frontend API client · fleetController.ts Fleet operations
Components 22
Fleet interface
- Application shell
frontend/src/App.tsx - Fleet map
frontend/src/pages/FleetMapPage.tsx - Vehicle diagnostics
frontend/src/components/VehicleDrawer.tsx - Rental planner
frontend/src/pages/RentalPlannerPage.tsx - Graph explorer
frontend/src/pages/Neo4jGraphPage.tsx - Analytics dashboard
frontend/src/pages/AnalyticsDashboardPage.tsx - Frontend API client
frontend/src/services/api.ts
API and workflows
- Express API
backend/src/server.ts - Fleet operations
backend/src/controllers/fleetController.ts - Rental operations
backend/src/controllers/rentalController.ts - Graph operations
backend/src/controllers/graphController.ts - Analytics aggregation
backend/src/controllers/analyticsController.ts
Persistence and graph
- Vehicle records
backend/src/models/Vehicle.ts - Telemetry records
backend/src/models/Telemetry.ts - Rental records
backend/src/models/Rental.ts - Neo4j graph service
backend/src/services/neo4jGraphService.ts - Database connections
backend/src/config/database.ts
IoT telemetry
- Telemetry controls
backend/src/controllers/telemetryController.ts - Telemetry simulator
backend/src/services/telemetrySimulatorService.ts
Other components
- Fleet operator
- MongoDB
- Neo4j
Connections 35
- Fleet operator → Application shell: uses
README.md - Application shell → Fleet map: renders
frontend/src/App.tsx - Application shell → Rental planner: renders
frontend/src/App.tsx - Application shell → Graph explorer: renders
frontend/src/App.tsx - Application shell → Analytics dashboard: renders
frontend/src/App.tsx - Application shell → Vehicle diagnostics: renders
frontend/src/App.tsx - Application shell → Frontend API client: requests data
frontend/src/App.tsx - Fleet map → Frontend API client: loads fleet
README.md - Vehicle diagnostics → Frontend API client: loads diagnostics
README.md - Rental planner → Frontend API client: books rentals
frontend/src/services/api.ts - Graph explorer → Frontend API client: loads graph
frontend/src/services/api.ts - Analytics dashboard → Frontend API client: loads metrics
frontend/src/services/api.ts - Frontend API client → Express API: calls HTTP API
frontend/src/services/api.ts - Express API → Fleet operations: routes fleet
backend/src/server.ts - Express API → Rental operations: routes rentals
backend/src/server.ts - Express API → Graph operations: routes graph
backend/src/server.ts - Express API → Telemetry controls: routes telemetry
backend/src/server.ts - Express API → Analytics aggregation: routes analytics
backend/src/server.ts - Fleet operations → Vehicle records: reads vehicles
backend/src/controllers/fleetController.ts - Fleet operations → Telemetry records: reads history
backend/src/controllers/fleetController.ts - Fleet operations → Neo4j graph service: looks up hubs
backend/src/controllers/fleetController.ts - Rental operations → Vehicle records: checks availability
backend/src/controllers/rentalController.ts - Rental operations → Rental records: stores contracts
backend/src/controllers/rentalController.ts - Rental operations → Neo4j graph service: plans and syncs
backend/src/controllers/rentalController.ts - Graph operations → Neo4j graph service: requests graph data
backend/src/controllers/graphController.ts - Analytics aggregation → Vehicle records: aggregates fleet
backend/src/controllers/analyticsController.ts - Analytics aggregation → Telemetry records: aggregates alerts
backend/src/controllers/analyticsController.ts - Analytics aggregation → Rental records: aggregates revenue
backend/src/controllers/analyticsController.ts - Telemetry controls → Telemetry simulator: controls simulation
backend/src/controllers/telemetryController.ts - Express API → Telemetry simulator: starts simulation
backend/src/server.ts - Telemetry simulator → Vehicle records: updates vehicles
backend/src/services/telemetrySimulatorService.ts - Telemetry simulator → Telemetry records: records samples
backend/src/services/telemetrySimulatorService.ts - Neo4j graph service → Database connections: runs Cypher
backend/src/services/neo4jGraphService.ts - Database connections → MongoDB: connects
backend/src/config/database.ts - Database connections → Neo4j: queries
backend/src/config/database.ts