How sridharan-777/logitrack-premium-logistics-shipment-platform works
LogiTrack is a role-authorized logistics platform. Customers book and track shipments; staff and administrators manage shipment operations, users, fleet, and business workflows; workers update assigned deliveries. The React app presents these role-specific workspaces and calls the Express API, which applies authorization and persists operational records in MongoDB. A separate protected phone-GPS service supports live location sharing. The README documents multimodal route estimates and operational capabilities; unsampled UI and backend details are represented only at the subsystem level where their paths are known.
Main entry points: App.jsx Role-based app · server.js Express API · client.js API client · notificationRoutes.js Notifications and tickets
Components 32
Web application
- Role-based app
frontend/src/App.jsx - Shipment booking
frontend/src/components/BookingFlow.jsx - Shipment views
frontend/src/components/ShipmentsListView.jsx - Staff and worker workspaces
frontend/src/components/StaffWorkspaceView.jsx - Fleet and route views
frontend/src/components/LiveFleetTracking.jsx - Fleet finance views
frontend/src/components/AdminFuelTrackerView.jsx - Support and notifications
frontend/src/components/SupportView.jsx - Sign-in and registration
frontend/src/components/AuthViews.jsx - API client
frontend/src/api/client.js
Identity and access
- Authentication routes
backend/src/routes/authRoutes.js - Authentication logic
backend/src/controllers/authController.js - JWT and role guard
backend/src/middleware/authMiddleware.js - User administration
backend/src/controllers/userController.js - User records
backend/src/models/User.js
Logistics operations
- Express API
backend/server.js - Shipment routes
backend/src/routes/shipmentRoutes.js - Shipment operations
backend/src/controllers/shipmentController.js - Shipment records
backend/src/models/Shipment.js - Vehicle operations
backend/src/controllers/vehicleController.js - Vehicle records
backend/src/models/Vehicle.js - Fuel logs
backend/src/models/FuelLog.js - Notifications and tickets
backend/src/routes/notificationRoutes.js - Notification records
backend/src/models/Notification.js - Support ticket records
backend/src/models/Ticket.js
Live tracking
- Phone GPS viewer
frontend/src/components/LiveFleetTracking.jsx - Protected GPS service
backend/src/services/trackingService.js - Mongo GPS service
backend/src/services/mongoTrackingService.js - Tracked vehicles
backend/src/models/TrackedVehicle.js
Other components
- Customer
- Staff and admin
- Delivery worker
- MongoDB
Connections 39
- Customer → Role-based app: uses
README.md - Staff and admin → Role-based app: uses
README.md - Delivery worker → Role-based app: uses
README.md - Role-based app → Sign-in and registration: shows
frontend/src/App.jsx - Role-based app → Shipment booking: opens
frontend/src/App.jsx - Role-based app → Shipment views: shows
frontend/src/App.jsx - Role-based app → Staff and worker workspaces: shows
frontend/src/App.jsx - Role-based app → Fleet and route views: shows
frontend/src/App.jsx - Role-based app → Support and notifications: shows
frontend/src/App.jsx - Role-based app → Fleet finance views: shows
frontend/src/App.jsx - Sign-in and registration → API client: authenticates via
frontend/src/components/AuthViews.jsx - Role-based app → API client: requests data
frontend/src/App.jsx - API client → Express API: calls API
frontend/src/api/client.js - Express API → Authentication routes: mounts
backend/server.js - Express API → Shipment routes: mounts
backend/server.js - Express API → Notifications and tickets: mounts
backend/server.js - Express API → Protected GPS service: mounts
backend/server.js - Express API → Mongo GPS service: mounts optionally
backend/server.js - Authentication routes → Authentication logic: routes to
backend/src/routes/authRoutes.js - Authentication routes → JWT and role guard: protects
backend/src/routes/authRoutes.js - Authentication logic → User records: reads and writes
backend/src/controllers/authController.js - Authentication logic → User records: issues identity for
backend/src/controllers/authController.js - Shipment routes → JWT and role guard: protects
backend/src/routes/shipmentRoutes.js - Shipment routes → Shipment operations: routes to
backend/src/routes/shipmentRoutes.js - Shipment operations → Shipment records: reads and writes
backend/src/controllers/shipmentController.js - Shipment operations → User records: populates users
backend/src/controllers/shipmentController.js - User administration → User records: reads and writes
backend/src/controllers/userController.js - Notifications and tickets → JWT and role guard: protects
backend/src/routes/notificationRoutes.js - Notifications and tickets → Notification records: reads and writes
backend/src/routes/notificationRoutes.js - Notifications and tickets → Support ticket records: reads and writes
backend/src/routes/notificationRoutes.js - Vehicle operations → Vehicle records: reads and writes
backend/src/controllers/vehicleController.js - Vehicle operations → Fuel logs: reads and writes
backend/src/controllers/vehicleController.js - Fleet and route views → API client: requests fleet data
- Fleet finance views → API client: requests operations data
- Phone GPS viewer → Protected GPS service: shares and views GPS
README.md - Protected GPS service → Tracked vehicles: persists tracking
- Mongo GPS service → Tracked vehicles: reads and writes
backend/src/services/mongoTrackingService.js - Express API → MongoDB: connects
backend/server.js - Tracked vehicles → MongoDB: stores in