How harigovind-2006/mainproject works
AgriTrack monitors autonomous farm rovers, compares telemetry with a planned route, estimates schedule drift, and returns speed corrections; users inspect fleet state and analytics in a protected dashboard. The backend owns route/progress calculations and per-vehicle digital twins, while a browser-based rover simulator provides a visual, physics-driven telemetry source. The README documents REST/WebSocket, authentication, database, and correction capabilities; some implementation details for unsampled modules are therefore shown only at subsystem level.
Main entry points: main.js Simulator Application · page.tsx Fleet Dashboard · main.py API and WebSocket · connection_manager.py Connection Manager
Components 33
Dashboard
- Fleet Data Store
frontend/lib/useFleetStore.ts - Fleet Dashboard
frontend/app/dashboard/page.tsx - Fleet Table
frontend/app/components/FleetTable.tsx - Route Map
frontend/app/components/RouteMapSVG.tsx - Telemetry Charts
frontend/app/components/TelemetryChartSVG.tsx - Digital Twin Panel
frontend/app/components/DigitalTwinPanel.tsx - Benchmark Panel
frontend/app/components/BenchmarkPanel.tsx - Fleet Data Types
frontend/lib/types.ts
Fleet Backend
- API and WebSocket
backend/main.py - Connection Manager
backend/connection_manager.py - Vehicle Twin
backend/vehicle_twin.py - Progress and ETA
backend/progress_engine.py - Route Model
backend/route_model.py - Speed Correction
backend/speed_correction.py - Trajectory Correction
backend/trajectory_correction.py - Fleet Simulator
backend/fleet_simulator.py - Rover Client
backend/rover_client.py
Rover Simulation
- Rover Physics
rover-simulator-sandbox/src/physicsEngine.js - Simulator Application
rover-simulator-sandbox/src/main.js - Sandbox Route
rover-simulator-sandbox/src/routeManager.js - 3D Rover Model
rover-simulator-sandbox/src/roverModel.js - Field Environment
rover-simulator-sandbox/src/fieldEnvironment.js - Camera Controls
rover-simulator-sandbox/src/cameraManager.js - Simulator HUD
rover-simulator-sandbox/src/hudOverlay.js - Simulator Audio
rover-simulator-sandbox/src/audio.js - Boot Console
rover-simulator-sandbox/src/biosConsole.js - Telemetry Bridge
rover-simulator-sandbox/src/wsBridge.js
Identity and Storage
- Login and Register
frontend/app/login/page.tsx - JWT Authentication
backend/auth.py - User Store
backend/db/mongo_client.py
Other components
- Operator
- MongoDB Atlas
- Physical Rover
Connections 35
- Operator → Login and Register: signs in
- Login and Register → API and WebSocket: authenticates via REST
- API and WebSocket → JWT Authentication: validates tokens
backend/main.py - JWT Authentication → User Store: reads user records
backend/auth.py - User Store → MongoDB Atlas: uses when configured
backend/db/mongo_client.py - Operator → Fleet Dashboard: views fleet
- Fleet Dashboard → Fleet Data Store: uses fleet state
frontend/app/dashboard/page.tsx - Fleet Data Store → Fleet Data Types: uses data types
frontend/lib/useFleetStore.ts - Fleet Data Store → API and WebSocket: fetches and streams
frontend/lib/useFleetStore.ts - Fleet Dashboard → Fleet Table: renders
frontend/app/dashboard/page.tsx - Fleet Dashboard → Route Map: renders
frontend/app/dashboard/page.tsx - Fleet Dashboard → Telemetry Charts: renders
frontend/app/dashboard/page.tsx - Fleet Dashboard → Digital Twin Panel: renders
frontend/app/dashboard/page.tsx - Fleet Dashboard → Benchmark Panel: renders
frontend/app/dashboard/page.tsx - API and WebSocket → Connection Manager: routes fleet operations
backend/main.py - Connection Manager → Vehicle Twin: updates twin telemetry
backend/connection_manager.py - Vehicle Twin → Progress and ETA: computes progress
backend/vehicle_twin.py - Progress and ETA → Route Model: uses route estimates
backend/progress_engine.py - Connection Manager → Speed Correction: requests speed correction
backend/connection_manager.py - Connection Manager → Trajectory Correction: applies trajectory correction
backend/connection_manager.py - API and WebSocket → Fleet Simulator: controls simulation
backend/main.py - Fleet Simulator → Connection Manager: submits telemetry
backend/fleet_simulator.py - Physical Rover → Telemetry Bridge: provides telemetry
- Simulator Application → Telemetry Bridge: sends telemetry
rover-simulator-sandbox/src/main.js - Telemetry Bridge → API and WebSocket: streams telemetry
- API and WebSocket → Telemetry Bridge: returns corrections
- Telemetry Bridge → Rover Physics: delivers feedback
rover-simulator-sandbox/src/physicsEngine.js - Simulator Application → Rover Physics: updates simulation
rover-simulator-sandbox/src/main.js - Simulator Application → Sandbox Route: initializes route
rover-simulator-sandbox/src/main.js - Simulator Application → 3D Rover Model: creates rover model
rover-simulator-sandbox/src/main.js - Simulator Application → Field Environment: creates field
rover-simulator-sandbox/src/main.js - Simulator Application → Camera Controls: initializes camera
rover-simulator-sandbox/src/main.js - Simulator Application → Simulator HUD: initializes HUD
rover-simulator-sandbox/src/main.js - Simulator Application → Boot Console: starts boot console
rover-simulator-sandbox/src/main.js - Simulator HUD → Simulator Audio: uses audio
rover-simulator-sandbox/src/hudOverlay.js