# wearewarp/warp-tools architecture

> Architecture diagram of the GitHub repository wearewarp/warp-tools, 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/wearewarp/warp-tools
- Repository: https://github.com/wearewarp/warp-tools

## Overview

Warp Tools is a collection of standalone logistics systems and single-purpose micro-tools, rather than one application. Operators use the systems to manage freight operations, finances, compliance, and customer visibility; the micro-tools support focused calculations and document parsing. The README also describes the systems as a combined platform sharing operational data. Source excerpts confirm representative database-backed workflows and freight parsing, but do not establish runtime connections between the separate apps; those are therefore not drawn.

Main entry points: [`apps/carrier-management/src/app/api/carriers/route.ts`](https://github.com/wearewarp/warp-tools/blob/main/apps/carrier-management/src/app/api/carriers/route.ts) (Carrier Management), [`apps/load-dispatch/src/app/api/loads/route.ts`](https://github.com/wearewarp/warp-tools/blob/main/apps/load-dispatch/src/app/api/loads/route.ts) (Load Dispatch), [`apps/dock-scheduler/src/app/api/appointments/route.ts`](https://github.com/wearewarp/warp-tools/blob/main/apps/dock-scheduler/src/app/api/appointments/route.ts) (Dock Scheduler), [`apps/document-vault/src/app/api/documents/route.ts`](https://github.com/wearewarp/warp-tools/blob/main/apps/document-vault/src/app/api/documents/route.ts) (Document Vault)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_freight_ops["Freight Operations"]
  node_carrier_management["Carrier Management<br/>[route.ts]"]
  node_dispatch["Load Dispatch<br/>[route.ts]"]
  node_dock_scheduler["Dock Scheduler<br/>[route.ts]"]
  node_document_vault["Document Vault<br/>[route.ts]"]
  node_shipment_management["Shipment Management<br/>[route.ts]"]
end

subgraph group_finance["Finance And Rates"]
  node_invoice_tracker["Invoice Tracker<br/>[route.ts]"]
  node_driver_settlements["Driver Settlements<br/>[route.ts]"]
  node_rate_management["Rate Management<br/>[route.ts]"]
end

subgraph group_fleet_customer["Fleet And Customers"]
  node_fleet_maintenance["Fleet Maintenance<br/>[route.ts]"]
  node_customer_portal["Customer Portal<br/>[route.ts]"]
end

subgraph group_microtools["Micro-Tools"]
  node_ifta["IFTA Calculator<br/>[page.tsx]"]
  node_detention["Detention Calculator<br/>[page.tsx]"]
  node_margin["Margin Calculator<br/>[page.tsx]"]
  node_deadhead["Deadhead Calculator<br/>[page.tsx]"]
  node_ratecon["Rate Con Generator"]
  node_load_profitability["Load Profitability<br/>[page.tsx]"]
  node_settlement_calculator["Settlement Calculator<br/>[page.tsx]"]
  node_freight_parser["Freight Parser<br/>[route.ts]"]
end

node_operator(("Logistics Operator"))

node_operator -->|"manage carriers"| node_carrier_management
node_operator -->|"dispatch loads"| node_dispatch
node_operator -->|"schedule appointments"| node_dock_scheduler
node_operator -->|"manage documents"| node_document_vault
node_operator -->|"manage shipments"| node_shipment_management
node_operator -->|"track invoices"| node_invoice_tracker
node_operator -->|"settle drivers"| node_driver_settlements
node_operator -->|"manage rates"| node_rate_management
node_operator -->|"maintain fleet"| node_fleet_maintenance
node_operator -->|"serve customers"| node_customer_portal
node_operator -->|"calculate fuel tax"| node_ifta
node_operator -->|"calculate detention"| node_detention
node_operator -->|"analyze margin"| node_margin
node_operator -->|"estimate deadhead"| node_deadhead
node_operator -->|"generate confirmations"| node_ratecon
node_operator -->|"analyze profitability"| node_load_profitability
node_operator -->|"calculate settlements"| node_settlement_calculator
node_operator -->|"parse freight"| node_freight_parser

click node_carrier_management "https://github.com/wearewarp/warp-tools/blob/main/apps/carrier-management/src/app/api/carriers/route.ts"
click node_dispatch "https://github.com/wearewarp/warp-tools/blob/main/apps/load-dispatch/src/app/api/loads/route.ts"
click node_dock_scheduler "https://github.com/wearewarp/warp-tools/blob/main/apps/dock-scheduler/src/app/api/appointments/route.ts"
click node_document_vault "https://github.com/wearewarp/warp-tools/blob/main/apps/document-vault/src/app/api/documents/route.ts"
click node_shipment_management "https://github.com/wearewarp/warp-tools/blob/main/apps/shipment-management/src/app/api/shipments/route.ts"
click node_invoice_tracker "https://github.com/wearewarp/warp-tools/blob/main/apps/invoice-tracker/src/app/api/invoices/route.ts"
click node_driver_settlements "https://github.com/wearewarp/warp-tools/blob/main/apps/driver-settlements/src/app/api/settlements/route.ts"
click node_rate_management "https://github.com/wearewarp/warp-tools/blob/main/apps/rate-management/src/app/api/lanes/route.ts"
click node_fleet_maintenance "https://github.com/wearewarp/warp-tools/blob/main/apps/fleet-maintenance/src/app/api/dashboard/route.ts"
click node_customer_portal "https://github.com/wearewarp/warp-tools/blob/main/apps/customer-portal/src/app/api/admin/shipments/route.ts"
click node_ifta "https://github.com/wearewarp/warp-tools/blob/main/apps/ifta-calculator/src/app/page.tsx"
click node_detention "https://github.com/wearewarp/warp-tools/blob/main/apps/detention-calculator/src/app/page.tsx"
click node_margin "https://github.com/wearewarp/warp-tools/blob/main/apps/margin-calculator/src/app/page.tsx"
click node_deadhead "https://github.com/wearewarp/warp-tools/blob/main/apps/deadhead-calculator/src/app/page.tsx"
click node_ratecon "https://github.com/wearewarp/warp-tools/blob/main/apps/rate-con-generator/src/components/TemplateManager.tsx"
click node_load_profitability "https://github.com/wearewarp/warp-tools/blob/main/apps/load-profitability/src/app/page.tsx"
click node_settlement_calculator "https://github.com/wearewarp/warp-tools/blob/main/apps/settlement-calculator/src/app/page.tsx"
click node_freight_parser "https://github.com/wearewarp/warp-tools/blob/main/apps/freight-parser/src/app/api/parse/route.ts"

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_carrier_management,node_dispatch,node_dock_scheduler,node_document_vault,node_shipment_management toneBlue
class node_invoice_tracker,node_driver_settlements,node_rate_management toneAmber
class node_fleet_maintenance,node_customer_portal toneMint
class node_ifta,node_detention,node_margin,node_deadhead,node_ratecon,node_load_profitability,node_settlement_calculator,node_freight_parser toneRose
class node_operator toneIndigo
```

## Components

### Freight Operations

- [Carrier Management](https://github.com/wearewarp/warp-tools/blob/main/apps/carrier-management/src/app/api/carriers/route.ts): `apps/carrier-management/src/app/api/carriers/route.ts`
- [Load Dispatch](https://github.com/wearewarp/warp-tools/blob/main/apps/load-dispatch/src/app/api/loads/route.ts): `apps/load-dispatch/src/app/api/loads/route.ts`
- [Dock Scheduler](https://github.com/wearewarp/warp-tools/blob/main/apps/dock-scheduler/src/app/api/appointments/route.ts): `apps/dock-scheduler/src/app/api/appointments/route.ts`
- [Document Vault](https://github.com/wearewarp/warp-tools/blob/main/apps/document-vault/src/app/api/documents/route.ts): `apps/document-vault/src/app/api/documents/route.ts`
- [Shipment Management](https://github.com/wearewarp/warp-tools/blob/main/apps/shipment-management/src/app/api/shipments/route.ts): `apps/shipment-management/src/app/api/shipments/route.ts`

### Finance And Rates

- [Invoice Tracker](https://github.com/wearewarp/warp-tools/blob/main/apps/invoice-tracker/src/app/api/invoices/route.ts): `apps/invoice-tracker/src/app/api/invoices/route.ts`
- [Driver Settlements](https://github.com/wearewarp/warp-tools/blob/main/apps/driver-settlements/src/app/api/settlements/route.ts): `apps/driver-settlements/src/app/api/settlements/route.ts`
- [Rate Management](https://github.com/wearewarp/warp-tools/blob/main/apps/rate-management/src/app/api/lanes/route.ts): `apps/rate-management/src/app/api/lanes/route.ts`

### Fleet And Customers

- [Fleet Maintenance](https://github.com/wearewarp/warp-tools/blob/main/apps/fleet-maintenance/src/app/api/dashboard/route.ts): `apps/fleet-maintenance/src/app/api/dashboard/route.ts`
- [Customer Portal](https://github.com/wearewarp/warp-tools/blob/main/apps/customer-portal/src/app/api/admin/shipments/route.ts): `apps/customer-portal/src/app/api/admin/shipments/route.ts`

### Micro-Tools

- [IFTA Calculator](https://github.com/wearewarp/warp-tools/blob/main/apps/ifta-calculator/src/app/page.tsx): `apps/ifta-calculator/src/app/page.tsx`
- [Detention Calculator](https://github.com/wearewarp/warp-tools/blob/main/apps/detention-calculator/src/app/page.tsx): `apps/detention-calculator/src/app/page.tsx`
- [Margin Calculator](https://github.com/wearewarp/warp-tools/blob/main/apps/margin-calculator/src/app/page.tsx): `apps/margin-calculator/src/app/page.tsx`
- [Deadhead Calculator](https://github.com/wearewarp/warp-tools/blob/main/apps/deadhead-calculator/src/app/page.tsx): `apps/deadhead-calculator/src/app/page.tsx`
- [Rate Con Generator](https://github.com/wearewarp/warp-tools/blob/main/apps/rate-con-generator/src/components/TemplateManager.tsx): `apps/rate-con-generator/src/components/TemplateManager.tsx`
- [Load Profitability](https://github.com/wearewarp/warp-tools/blob/main/apps/load-profitability/src/app/page.tsx): `apps/load-profitability/src/app/page.tsx`
- [Settlement Calculator](https://github.com/wearewarp/warp-tools/blob/main/apps/settlement-calculator/src/app/page.tsx): `apps/settlement-calculator/src/app/page.tsx`
- [Freight Parser](https://github.com/wearewarp/warp-tools/blob/main/apps/freight-parser/src/app/api/parse/route.ts): `apps/freight-parser/src/app/api/parse/route.ts`

### Other components

- **Logistics Operator**

## Connections

- Logistics Operator → Carrier Management: manage carriers (evidence: `README.md`)
- Logistics Operator → Load Dispatch: dispatch loads (evidence: `README.md`)
- Logistics Operator → Dock Scheduler: schedule appointments (evidence: `README.md`)
- Logistics Operator → Document Vault: manage documents (evidence: `README.md`)
- Logistics Operator → Shipment Management: manage shipments (evidence: `README.md`)
- Logistics Operator → Invoice Tracker: track invoices (evidence: `README.md`)
- Logistics Operator → Driver Settlements: settle drivers (evidence: `README.md`)
- Logistics Operator → Rate Management: manage rates (evidence: `README.md`)
- Logistics Operator → Fleet Maintenance: maintain fleet (evidence: `README.md`)
- Logistics Operator → Customer Portal: serve customers (evidence: `README.md`)
- Logistics Operator → IFTA Calculator: calculate fuel tax (evidence: `README.md`)
- Logistics Operator → Detention Calculator: calculate detention (evidence: `README.md`)
- Logistics Operator → Margin Calculator: analyze margin (evidence: `README.md`)
- Logistics Operator → Deadhead Calculator: estimate deadhead (evidence: `README.md`)
- Logistics Operator → Rate Con Generator: generate confirmations (evidence: `README.md`)
- Logistics Operator → Load Profitability: analyze profitability (evidence: `README.md`)
- Logistics Operator → Settlement Calculator: calculate settlements (evidence: `README.md`)
- Logistics Operator → Freight Parser: parse freight (evidence: `README.md`)
