# mohammedsaji/passage-logistics-systems architecture

> Architecture diagram of the GitHub repository mohammedsaji/passage-logistics-systems, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mohammedsaji/passage-logistics-systems
- Repository: https://github.com/mohammedsaji/passage-logistics-systems

## Overview

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: [`src/main/java/com/app/logistics`](https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics) (REST controllers), [`src/main/java/com/app/logistics/shipment/service/ShipmentService.java`](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipment/service/ShipmentService.java) (Shipment orchestration), [`src/main/java/com/app/logistics/operator/service/OperatorService.java`](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/operator/service/OperatorService.java) (Transport operators), [`src/main/java/com/app/logistics/account/service/AccountService.java`](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/account/service/AccountService.java) (Accounts)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_identity["Identity &amp; access"]
  node_security["JWT and RBAC"]
  node_accounts["Accounts"]
  node_authdetails["Authenticated identity<br/>[AuthDetails.java]"]
end

subgraph group_operations["Transport operations"]
  node_operator["Transport operators"]
  node_manager["Managers"]
  node_employee["Employees"]
  node_drivers["Drivers<br/>[DriverService.java]"]
  node_vehicles["Vehicles"]
end

subgraph group_shipments["Shipment lifecycle"]
  node_cargo["Cargo"]
  node_customers["Customers"]
  node_shipment["Shipment orchestration"]
  node_tracking["Status and tracking"]
end

subgraph group_platform["API &amp; persistence"]
  node_ui["Role-specific UI"]
  node_api["REST controllers"]
  node_accountdb[("Account records<br/>[Account.java]")]
  node_shipmentdb[("Shipment records<br/>[Shipment.java]")]
  node_statusdb[("Status log records")]
  node_postgres[("PostgreSQL")]
  node_mail["Email delivery<br/>[Messenger.java]"]
end

node_browser(("Browser users"))

node_browser -->|"uses"| node_ui
node_ui -->|"requests REST"| node_api
node_api -->|"secures routes"| node_security
node_api -.->|"handles account actions"| node_accounts
node_accounts -->|"reads and writes"| node_accountdb
node_security -.->|"establishes identity"| node_authdetails
node_accounts -->|"creates identity context"| node_authdetails
node_api -.->|"handles transport setup"| node_operator
node_api -.->|"handles workforce"| node_manager
node_api -.->|"handles workforce"| node_employee
node_api -.->|"handles workforce"| node_drivers
node_api -.->|"handles inventory"| node_vehicles
node_drivers -->|"saves linked account"| node_accounts
node_manager -->|"saves linked account"| node_accounts
node_drivers -->|"fetches operator"| node_operator
node_manager -->|"uses operator service"| node_operator
node_vehicles -->|"fetches operator"| node_operator
node_operator -->|"looks up manager"| node_manager
node_api -.->|"handles lifecycle"| node_shipment
node_shipment -->|"uses cargo service"| node_cargo
node_shipment -->|"uses customer service"| node_customers
node_shipment -->|"uses driver service"| node_drivers
node_shipment -->|"uses operator service"| node_operator
node_shipment -->|"coordinates status"| node_tracking
node_tracking -->|"fetches shipment"| node_shipment
node_shipment -.->|"persists shipment"| node_shipmentdb
node_tracking -.->|"persists status history"| node_statusdb
node_api -->|"stores application data"| node_postgres
node_shipment -->|"sends notifications"| node_mail

click node_ui "https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/resources/static/js"
click node_api "https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics"
click node_security "https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/auth"
click node_accounts "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/account/service/AccountService.java"
click node_accountdb "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/account/entity/Account.java"
click node_authdetails "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/auth/authUtils/AuthDetails.java"
click node_operator "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/operator/service/OperatorService.java"
click node_manager "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/manager/service/ManagerService.java"
click node_employee "https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/employee/service"
click node_drivers "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/driver/service/DriverService.java"
click node_vehicles "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/vehicle/service/VehicleService.java"
click node_cargo "https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/cargo/service"
click node_customers "https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/customer/service"
click node_shipment "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipment/service/ShipmentService.java"
click node_tracking "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java"
click node_shipmentdb "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipment/entity/Shipment.java"
click node_statusdb "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipmentStatusLog/entity/ShipmentStatusLog.java"
click node_mail "https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/common/utils/Messenger.java"

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_security,node_accounts,node_authdetails,node_browser toneBlue
class node_operator,node_manager,node_employee,node_drivers,node_vehicles toneAmber
class node_cargo,node_customers,node_shipment,node_tracking toneMint
class node_ui,node_api,node_accountdb,node_shipmentdb,node_statusdb,node_postgres,node_mail toneRose
```

## Components

### Identity & access

- [JWT and RBAC](https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/auth): `src/main/java/com/app/logistics/auth`
- [Accounts](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/account/service/AccountService.java): `src/main/java/com/app/logistics/account/service/AccountService.java`
- [Authenticated identity](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/auth/authUtils/AuthDetails.java): `src/main/java/com/app/logistics/auth/authUtils/AuthDetails.java`

### Transport operations

- [Transport operators](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/operator/service/OperatorService.java): `src/main/java/com/app/logistics/operator/service/OperatorService.java`
- [Managers](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/manager/service/ManagerService.java): `src/main/java/com/app/logistics/manager/service/ManagerService.java`
- [Employees](https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/employee/service): `src/main/java/com/app/logistics/employee/service`
- [Drivers](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/driver/service/DriverService.java): `src/main/java/com/app/logistics/driver/service/DriverService.java`
- [Vehicles](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/vehicle/service/VehicleService.java): `src/main/java/com/app/logistics/vehicle/service/VehicleService.java`

### Shipment lifecycle

- [Cargo](https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/cargo/service): `src/main/java/com/app/logistics/cargo/service`
- [Customers](https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics/customer/service): `src/main/java/com/app/logistics/customer/service`
- [Shipment orchestration](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipment/service/ShipmentService.java): `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`
- [Status and tracking](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java): `src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java`

### API & persistence

- [Role-specific UI](https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/resources/static/js): `src/main/resources/static/js`
- [REST controllers](https://github.com/mohammedsaji/passage-logistics-systems/tree/main/src/main/java/com/app/logistics): `src/main/java/com/app/logistics`
- [Account records](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/account/entity/Account.java): `src/main/java/com/app/logistics/account/entity/Account.java`
- [Shipment records](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipment/entity/Shipment.java): `src/main/java/com/app/logistics/shipment/entity/Shipment.java`
- [Status log records](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/shipmentStatusLog/entity/ShipmentStatusLog.java): `src/main/java/com/app/logistics/shipmentStatusLog/entity/ShipmentStatusLog.java`
- **PostgreSQL**
- [Email delivery](https://github.com/mohammedsaji/passage-logistics-systems/blob/main/src/main/java/com/app/logistics/common/utils/Messenger.java): `src/main/java/com/app/logistics/common/utils/Messenger.java`

### Other components

- **Browser users**

## Connections

- Browser users → Role-specific UI: uses
- Role-specific UI → REST controllers: requests REST
- REST controllers → JWT and RBAC: secures routes (evidence: `src/main/java/com/app/logistics/manager/service/ManagerService.java`)
- REST controllers → Accounts: handles account actions (evidence: `src/main/java/com/app/logistics/manager/service/ManagerService.java`)
- Accounts → Account records: reads and writes (evidence: `src/main/java/com/app/logistics/account/service/AccountService.java`)
- JWT and RBAC → Authenticated identity: establishes identity (evidence: `src/main/java/com/app/logistics/auth/authUtils/AuthService.java`)
- Accounts → Authenticated identity: creates identity context (evidence: `src/main/java/com/app/logistics/account/service/AccountService.java`)
- REST controllers → Transport operators: handles transport setup (evidence: `src/main/java/com/app/logistics/manager/service/ManagerService.java`)
- REST controllers → Managers: handles workforce (evidence: `src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java`)
- REST controllers → Employees: handles workforce (evidence: `src/main/java/com/app/logistics/employee/controller/EmployeeController.java`)
- REST controllers → Drivers: handles workforce (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
- REST controllers → Vehicles: handles inventory (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
- Drivers → Accounts: saves linked account (evidence: `src/main/java/com/app/logistics/driver/service/DriverService.java`)
- Managers → Accounts: saves linked account (evidence: `src/main/java/com/app/logistics/manager/service/ManagerService.java`)
- Drivers → Transport operators: fetches operator (evidence: `src/main/java/com/app/logistics/driver/service/DriverService.java`)
- Managers → Transport operators: uses operator service (evidence: `src/main/java/com/app/logistics/manager/service/ManagerService.java`)
- Vehicles → Transport operators: fetches operator (evidence: `src/main/java/com/app/logistics/vehicle/service/VehicleService.java`)
- Transport operators → Managers: looks up manager (evidence: `src/main/java/com/app/logistics/operator/service/OperatorService.java`)
- REST controllers → Shipment orchestration: handles lifecycle (evidence: `src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java`)
- Shipment orchestration → Cargo: uses cargo service (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
- Shipment orchestration → Customers: uses customer service (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
- Shipment orchestration → Drivers: uses driver service (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
- Shipment orchestration → Transport operators: uses operator service (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
- Shipment orchestration → Status and tracking: coordinates status (evidence: `src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java`)
- Status and tracking → Shipment orchestration: fetches shipment (evidence: `src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java`)
- Shipment orchestration → Shipment records: persists shipment (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
- Status and tracking → Status log records: persists status history (evidence: `src/main/java/com/app/logistics/shipmentStatusLog/service/ShipmentStatusLogService.java`)
- REST controllers → PostgreSQL: stores application data
- Shipment orchestration → Email delivery: sends notifications (evidence: `src/main/java/com/app/logistics/shipment/service/ShipmentService.java`)
