How mohammedsaji/passage-logistics-systems works
Axle Logistics is a role-secured logistics operations platform. Users sign in and work through REST-backed screens to provision accounts and workforce, configure transport operators and vehicles, and create, assign, track, and reassign shipments with status history. The graph emphasizes documented shipment orchestration and sampled account/workforce dependencies; the README documents the broader API, roles, and PostgreSQL architecture. Unsampled controllers, security wiring, and domain services are represented only where README or indexed service references support them.
Main entry points: logistics REST controllers · ShipmentService.java Shipment orchestration · OperatorService.java Transport operators · AccountService.java Accounts
Components 20
Identity & access
- JWT and RBAC
src/main/java/com/app/logistics/auth - Accounts
src/main/java/com/app/logistics/account/service/AccountService.java - Authenticated identity
src/main/java/com/app/logistics/auth/authUtils/AuthDetails.java
Transport operations
- Transport operators
src/main/java/com/app/logistics/operator/service/OperatorService.java - Managers
src/main/java/com/app/logistics/manager/service/ManagerService.java - Employees
src/main/java/com/app/logistics/employee/service - Drivers
src/main/java/com/app/logistics/driver/service/DriverService.java - Vehicles
src/main/java/com/app/logistics/vehicle/service/VehicleService.java
Shipment lifecycle
- Cargo
src/main/java/com/app/logistics/cargo/service - Customers
src/main/java/com/app/logistics/customer/service - Shipment orchestration
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - Status and tracking
src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java
API & persistence
- Role-specific UI
src/main/resources/static/js - REST controllers
src/main/java/com/app/logistics - Account records
src/main/java/com/app/logistics/account/entity/Account.java - Shipment records
src/main/java/com/app/logistics/shipment/entity/Shipment.java - Status log records
src/main/java/com/app/logistics/shipmentStatusLog/entity/ShipmentStatusLog.java - PostgreSQL
- Email delivery
src/main/java/com/app/logistics/common/utils/Messenger.java
Other components
- Browser users
Connections 29
- Browser users → Role-specific UI: uses
- Role-specific UI → REST controllers: requests REST
- REST controllers → JWT and RBAC: secures routes
src/main/java/com/app/logistics/manager/service/ManagerService.java - REST controllers → Accounts: handles account actions
src/main/java/com/app/logistics/manager/service/ManagerService.java - Accounts → Account records: reads and writes
src/main/java/com/app/logistics/account/service/AccountService.java - JWT and RBAC → Authenticated identity: establishes identity
src/main/java/com/app/logistics/auth/authUtils/AuthService.java - Accounts → Authenticated identity: creates identity context
src/main/java/com/app/logistics/account/service/AccountService.java - REST controllers → Transport operators: handles transport setup
src/main/java/com/app/logistics/manager/service/ManagerService.java - REST controllers → Managers: handles workforce
src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java - REST controllers → Employees: handles workforce
src/main/java/com/app/logistics/employee/controller/EmployeeController.java - REST controllers → Drivers: handles workforce
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - REST controllers → Vehicles: handles inventory
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - Drivers → Accounts: saves linked account
src/main/java/com/app/logistics/driver/service/DriverService.java - Managers → Accounts: saves linked account
src/main/java/com/app/logistics/manager/service/ManagerService.java - Drivers → Transport operators: fetches operator
src/main/java/com/app/logistics/driver/service/DriverService.java - Managers → Transport operators: uses operator service
src/main/java/com/app/logistics/manager/service/ManagerService.java - Vehicles → Transport operators: fetches operator
src/main/java/com/app/logistics/vehicle/service/VehicleService.java - Transport operators → Managers: looks up manager
src/main/java/com/app/logistics/operator/service/OperatorService.java - REST controllers → Shipment orchestration: handles lifecycle
src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java - Shipment orchestration → Cargo: uses cargo service
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - Shipment orchestration → Customers: uses customer service
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - Shipment orchestration → Drivers: uses driver service
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - Shipment orchestration → Transport operators: uses operator service
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - Shipment orchestration → Status and tracking: coordinates status
src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java - Status and tracking → Shipment orchestration: fetches shipment
src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java - Shipment orchestration → Shipment records: persists shipment
src/main/java/com/app/logistics/shipment/service/ShipmentService.java - Status and tracking → Status log records: persists status history
src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java - REST controllers → PostgreSQL: stores application data
- Shipment orchestration → Email delivery: sends notifications
src/main/java/com/app/logistics/shipment/service/ShipmentService.java