# lisovyi3441/logistics-crm architecture

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

- Interactive diagram: https://gitdiagram.com/lisovyi3441/logistics-crm
- Repository: https://github.com/lisovyi3441/logistics-crm

## Overview

This is a multi-tenant freight-management CRM. Its core workflow lets company users create and track freight orders, calculate pricing and routing, assign fleet capacity, and generate transport documents; managers also administer companies, users, and tariffs. Laravel controllers and actions provide the backend, with Vue/Inertia pages as the user interface. The README documents real-time updates, RBAC, GIS, and queued document generation. Some subsystem links rely on README descriptions because their implementation files were not excerpted; those relationships are cited as documented rather than source-inspected.

Main entry points: [`app/Http/Controllers/OrderController.php`](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Controllers/OrderController.php) (Order Controller), [`app/Actions/Orders/CreateOrderAction.php`](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Actions/Orders/CreateOrderAction.php) (Create Order), [`resources/js/pages/orders`](https://github.com/lisovyi3441/logistics-crm/tree/main/resources/js/pages/orders) (Order Pages), [`app/Http/Controllers`](https://github.com/lisovyi3441/logistics-crm/tree/main/app/Http/Controllers) (Company And User Admin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_orders["Order Operations"]
  node_order_controller["Order Controller"]
  node_create_action["Create Order"]
  node_status_action["Change Status"]
  node_order_data[("Order Records<br/>[Order.php]")]
  node_order_resource["Order Resource<br/>[OrderResource.php]"]
end

subgraph group_pricing["Pricing And Routing"]
  node_pricing_pipeline["Pricing Pipeline"]
  node_pricing_stages["Pricing Steps"]
  node_routing_service["Route Calculation"]
end

subgraph group_fleet["Fleet And Documents"]
  node_truck_controller["Truck Management"]
  node_assign_action["Assign Truck"]
  node_fleet_data[("Fleet Records<br/>[Truck.php]")]
  node_document_controller["Order Documents"]
  node_document_job["Document Generation"]
end

subgraph group_admin["Administration And Analytics"]
  node_admin_controllers["Company And User Admin"]
  node_dashboard["Dashboard Analytics"]
  node_tenancy_models[("Company And User Records<br/>[Company.php]")]
end

subgraph group_experience["Web Experience"]
  node_order_ui["Order Pages"]
  node_websocket["Live Updates<br/>[echo.ts]"]
  node_inertia_pages["Vue Inertia UI"]
end

node_users(("Company Users"))
node_osrm{{"OSRM Service"}}
node_document_store[("Object Storage")]
node_reverb{{"Reverb Server"}}

node_users -->|"use orders"| node_order_ui
node_order_ui -->|"submit requests"| node_order_controller
node_order_controller -->|"executes creation"| node_create_action
node_order_controller -->|"executes status change"| node_status_action
node_order_controller -->|"executes assignment"| node_assign_action
node_create_action -->|"creates order"| node_order_data
node_create_action -->|"calculates price"| node_pricing_pipeline
node_pricing_pipeline -->|"runs stages"| node_pricing_stages
node_create_action -->|"requests route"| node_routing_service
node_routing_service -->|"queries route"| node_osrm
node_order_controller -->|"serializes orders"| node_order_resource
node_assign_action -->|"assigns truck"| node_fleet_data
node_truck_controller -.->|"manages fleet"| node_fleet_data
node_document_controller -.->|"queues generation"| node_document_job
node_document_job -.->|"stores PDFs"| node_document_store
node_admin_controllers -->|"manages records"| node_tenancy_models
node_dashboard -->|"reads orders"| node_order_data
node_admin_controllers -.->|"renders pages"| node_inertia_pages
node_order_controller -->|"returns order props"| node_order_ui
node_websocket -.->|"connects updates"| node_reverb
node_reverb -.->|"notifies changes"| node_order_ui

click node_order_ui "https://github.com/lisovyi3441/logistics-crm/tree/main/resources/js/pages/orders"
click node_order_controller "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Controllers/OrderController.php"
click node_create_action "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Actions/Orders/CreateOrderAction.php"
click node_status_action "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Actions/Orders/ChangeOrderStatusAction.php"
click node_order_data "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Models/Order.php"
click node_order_resource "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Resources/OrderResource.php"
click node_pricing_pipeline "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Logistics/Cargo/PricingPipeline.php"
click node_pricing_stages "https://github.com/lisovyi3441/logistics-crm/tree/main/app/Logistics/Cargo/Pipes"
click node_routing_service "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Services/Routing/OsrmRoutingService.php"
click node_truck_controller "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Controllers/TruckController.php"
click node_assign_action "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Actions/Orders/AssignTruckAction.php"
click node_fleet_data "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Models/Truck.php"
click node_document_controller "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Controllers/OrderDocumentController.php"
click node_document_job "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Jobs/GenerateDocumentJob.php"
click node_admin_controllers "https://github.com/lisovyi3441/logistics-crm/tree/main/app/Http/Controllers"
click node_dashboard "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Services/DashboardService.php"
click node_tenancy_models "https://github.com/lisovyi3441/logistics-crm/blob/main/app/Models/Company.php"
click node_websocket "https://github.com/lisovyi3441/logistics-crm/blob/main/resources/js/echo.ts"
click node_inertia_pages "https://github.com/lisovyi3441/logistics-crm/tree/main/resources/js/pages"

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_order_controller,node_create_action,node_status_action,node_order_data,node_order_resource,node_users toneBlue
class node_pricing_pipeline,node_pricing_stages,node_routing_service,node_document_store toneAmber
class node_truck_controller,node_assign_action,node_fleet_data,node_document_controller,node_document_job,node_reverb toneMint
class node_admin_controllers,node_dashboard,node_tenancy_models toneRose
class node_order_ui,node_websocket,node_inertia_pages,node_osrm toneIndigo
```

## Components

### Order Operations

- [Order Controller](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Controllers/OrderController.php): `app/Http/Controllers/OrderController.php`
- [Create Order](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Actions/Orders/CreateOrderAction.php): `app/Actions/Orders/CreateOrderAction.php`
- [Change Status](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Actions/Orders/ChangeOrderStatusAction.php): `app/Actions/Orders/ChangeOrderStatusAction.php`
- [Order Records](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Models/Order.php): `app/Models/Order.php`
- [Order Resource](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Resources/OrderResource.php): `app/Http/Resources/OrderResource.php`

### Pricing And Routing

- [Pricing Pipeline](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Logistics/Cargo/PricingPipeline.php): `app/Logistics/Cargo/PricingPipeline.php`
- [Pricing Steps](https://github.com/lisovyi3441/logistics-crm/tree/main/app/Logistics/Cargo/Pipes): `app/Logistics/Cargo/Pipes`
- [Route Calculation](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Services/Routing/OsrmRoutingService.php): `app/Services/Routing/OsrmRoutingService.php`

### Fleet And Documents

- [Truck Management](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Controllers/TruckController.php): `app/Http/Controllers/TruckController.php`
- [Assign Truck](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Actions/Orders/AssignTruckAction.php): `app/Actions/Orders/AssignTruckAction.php`
- [Fleet Records](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Models/Truck.php): `app/Models/Truck.php`
- [Order Documents](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Http/Controllers/OrderDocumentController.php): `app/Http/Controllers/OrderDocumentController.php`
- [Document Generation](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Jobs/GenerateDocumentJob.php): `app/Jobs/GenerateDocumentJob.php`

### Administration And Analytics

- [Company And User Admin](https://github.com/lisovyi3441/logistics-crm/tree/main/app/Http/Controllers): `app/Http/Controllers`
- [Dashboard Analytics](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Services/DashboardService.php): `app/Services/DashboardService.php`
- [Company And User Records](https://github.com/lisovyi3441/logistics-crm/blob/main/app/Models/Company.php): `app/Models/Company.php`

### Web Experience

- [Order Pages](https://github.com/lisovyi3441/logistics-crm/tree/main/resources/js/pages/orders): `resources/js/pages/orders`
- [Live Updates](https://github.com/lisovyi3441/logistics-crm/blob/main/resources/js/echo.ts): `resources/js/echo.ts`
- [Vue Inertia UI](https://github.com/lisovyi3441/logistics-crm/tree/main/resources/js/pages): `resources/js/pages`

### Other components

- **Company Users**
- **OSRM Service**
- **Object Storage**
- **Reverb Server**

## Connections

- Company Users → Order Pages: use orders (evidence: `README.md`)
- Order Pages → Order Controller: submit requests (evidence: `README.md`)
- Order Controller → Create Order: executes creation (evidence: `app/Http/Controllers/OrderController.php`)
- Order Controller → Change Status: executes status change (evidence: `app/Http/Controllers/OrderController.php`)
- Order Controller → Assign Truck: executes assignment (evidence: `app/Http/Controllers/OrderController.php`)
- Create Order → Order Records: creates order (evidence: `app/Actions/Orders/CreateOrderAction.php`)
- Create Order → Pricing Pipeline: calculates price (evidence: `app/Actions/Orders/CreateOrderAction.php`)
- Pricing Pipeline → Pricing Steps: runs stages (evidence: `app/Logistics/Cargo/PricingPipeline.php`)
- Create Order → Route Calculation: requests route (evidence: `app/Actions/Orders/CreateOrderAction.php`)
- Route Calculation → OSRM Service: queries route (evidence: `README.md`)
- Order Controller → Order Resource: serializes orders (evidence: `app/Http/Controllers/OrderController.php`)
- Assign Truck → Fleet Records: assigns truck (evidence: `app/Actions/Orders/AssignTruckAction.php`)
- Truck Management → Fleet Records: manages fleet
- Order Documents → Document Generation: queues generation (evidence: `README.md`)
- Document Generation → Object Storage: stores PDFs (evidence: `README.md`)
- Company And User Admin → Company And User Records: manages records (evidence: `app/Http/Controllers/UserController.php`)
- Dashboard Analytics → Order Records: reads orders (evidence: `app/Services/DashboardService.php`)
- Company And User Admin → Vue Inertia UI: renders pages (evidence: `README.md`)
- Order Controller → Order Pages: returns order props (evidence: `app/Http/Controllers/OrderController.php`)
- Live Updates → Reverb Server: connects updates (evidence: `README.md`)
- Reverb Server → Order Pages: notifies changes (evidence: `README.md`)
