Dashboard Executive Summary
Export Plan

Freight ERP SaaS Platform

SECTION 01

Executive Summary

Vision Statement

To build a global freight ERP that democratizes enterprise-class supply chain orchestration. Enabling operators to run road, air, ocean, rail, and courier logistics on a single double-entry financial ledger.

Mission Statement

To eliminate global supply chain fragmentation by providing a unified SaaS ecosystem that bridges shippers, freight forwarders, carriers, agents, customs brokers, and customers.

Business Goals

  • Scale Readiness: Out-of-the-box infrastructure capable of supporting over 10,000 corporate tenants and 500 million shipment records per year.
  • Operations Automation: Automate 90% of repeatable tasks (e.g., manifest generation, automated tariff lookups, and invoice matching) using decoupled rule engines.
  • Global Expansion & Fiscalization: Compliance with multi-region accounting rules, customs networks (C-TPAT, AEO, NCTS), and secure fiscal setups.

Competitive Advantages

Unified Multi-Modal Ledger

Unlike siloed software, a single container or master waybill tracking file spans sea, air, rail, and road tracking states sequentially on one transactional timeline.

Enterprise Financial Subledger

True double-entry subledger tracking that handles multi-currency transactions, automatic exchange rate freezes, and accounting validations natively.

SECTION 02

Product Scope

The ERP platform comprises high-performing modular core components running on a resilient messaging bus.

Core Architecture Modules

Multi-Modal Operations Engine

Handles the creation of operations sheets, House and Master Bills of Lading, airway bills, customs status alerts, and multi-leg consolidation routing.

Warehouse WMS

Advanced cross-dock control, warehouse inventory management, bin placement optimization, barcode tracking, and digital packing list reconciliation.

Module Communication Map

graph TD CRM[CRM & Tariffs] -->|Convert Quote| Book[Operations Booking] Book -->|Create Bill of Lading| Cargo[Warehouse WMS] Book -->|Route & Dispatch| Fleet[Fleet Management] Book -->|Auto Charge Lines| Fin[Financial Subledger] style CRM fill:#1E293B,stroke:#3B82F6,stroke-width:2px,color:#fff style Book fill:#1E293B,stroke:#10B981,stroke-width:2px,color:#fff style Cargo fill:#1E293B,stroke:#F59E0B,stroke-width:2px,color:#fff style Fleet fill:#1E293B,stroke:#8B5CF6,stroke-width:2px,color:#fff style Fin fill:#1E293B,stroke:#EF4444,stroke-width:2px,color:#fff
SECTION 03

User Types & RBAC

Strict tenant-isolated Role-Based Access Control (RBAC) governing data reads and mutation triggers.

SECTION 04

Business Workflows

SECTION 05

Functional Requirements

SECTION 06

Non-Functional Requirements

SECTION 07

System Architecture

SECTION 08

Database Planning

SECTION 09

API Standards

SECTION 10

UI & UX Standards

SECTION 11

Security Standards

SECTION 12

Coding Standards

SECTION 13

Development Roadmap

SECTION 14

Future AI Modules

SECTION 15

Deployment Strategy

SECTION 16

Commercial Strategy

ARCHITECTURE 01

Overall System Layers

ARCHITECTURE 02

Module & Reusability

ARCHITECTURE 03

Tenancy Stratagem

ARCHITECTURE 04

Security Architecture

ARCHITECTURE 05

Laravel Directory Specs

ARCHITECTURE 06

Database Strategy

ARCHITECTURE 07

API Architecture

ARCHITECTURE 08

Queues & Dispatchers

ARCHITECTURE 09

Storage & S3 Policies

ARCHITECTURE 10

AI Pipeline Integration

ARCHITECTURE 11

Performance Caching

ARCHITECTURE 12

Deploy & Cloud Topo

ARCHITECTURE 13

Git Flow & Standards

DATABASE DESIGN 01

Database Principles

Operational design rules governing structure formatting, indexing bounds, and keys formatting.

DATABASE DESIGN 02

Domain Entities Map

DATABASE DESIGN 03

Entity Relationships

DATABASE DESIGN 04

Data Tenancy Boundaries

DATABASE DESIGN 05

Indexing Strategy Matrix

DATABASE DESIGN 06

Data Lifecycle Rules

DATABASE DESIGN 07

Performance Partitions

DATABASE DESIGN 08

Security & PII Crypt

DATABASE DESIGN 09

Future Extensibility

DESIGN SYSTEM 01

Design Philosophy

Visual identity standards optimized for density, visual speed, and professional analytics.

High density layout

Compact, borderless grid containers and tight layout cells maximize visible data on active screen canvasses.

Minimal Decor

Excludes soft gradient shapes and heavy border drops. Contrast states indicate warnings and focus parameters.

DESIGN SYSTEM 02

Color Tokens

#0B0F19

Dark App BG

#F8FAFC

Light App BG

#3B82F6

Primary Accent

#10B981

Secondary Action

DESIGN SYSTEM 03

Typography Scale

Display headers use **Outfit** display fonts, while interface labels use **Inter** sans-serif profiles.

H1 Banner Display: 36px / 2.25rem (Outfit Bold)
H2 Section Title: 24px / 1.5rem (Outfit Bold)
H3 Card Heading:  18px / 1.125rem (Inter Semi-Bold)
Body Copy text:   14px / 0.875rem (Inter Regular)
Mono Ledger Data: 13px / 0.8125rem (Fira Code Regular)
DESIGN SYSTEM 04

Layout & Grid

Uniform structural dimensions coordinate workspaces layouts.

  • Sidebar Specs: Width is fixed to 280px, collapsing to a compact 72px menu on tablet boundaries.
  • 8px Grid Increments: Visual margins, card borders, gap spacing values align to 8px multiples.
DESIGN SYSTEM 05

Component Library

Form Fields

Standard input fields are set to a 36px height with 6px rounded edges, including visible state check borders.

Slide-out Drawers

Right-aligned drawers display nested records logs and details without forcing secondary page loads.

Visual Timelines

Vertical progress trails map shipping milestone changes using live colors states indications.

DESIGN SYSTEM 06

Dashboard Layouts

Three distinct layouts optimize display density based on targeted roles.

Executive BI

Renders revenue trends, gross cost distribution area graphs, and aggregate financial tables.

Operational Dispatch

Focuses on milestones warnings, customs checks delays, and fleet tracking map visuals.

Driver Mobile UI

Emphasizes oversized buttons, delivery checklists, and single-click camera capture panels.

DESIGN SYSTEM 07

Form Integrity

  • Inline Checks: Form inputs validate constraints dynamically when focus moves.
  • Autosave Indicators: Header notices show active save states (Saving... / Saved).
DESIGN SYSTEM 08

Grid Table System

  • Pin Headers: Tables keep column headers visible during vertical scrolls.
  • Floating Action Bar: Selecting checkboxes calls a bottom action tray (e.g. Print Labels, Dispatch).
DESIGN SYSTEM 09

Mobile Touch UX

Standards enforcing at least a 44px by 44px touch area for mobile layouts, paired with network status bars.

DESIGN SYSTEM 10

Access Guidelines

Full keyboard accessibility (via Tab controls) and ARIA semantic tags on all elements.

DESIGN SYSTEM 11

Interaction States

Skeleton mock outlines shim dynamic data loads, while destructive updates require reference code confirmations.

DESIGN SYSTEM 12

Icon Guidelines

Consistent deployment of the Lucide icon library with fixed stroke weights (1.75px) and size categories.

DESIGN SYSTEM 13

Charts & Vis

Area graphs and trend indicators display operational growth details.

DESIGN SYSTEM 14

Cartography Maps

Dynamic geofences and path lines trace vehicle speeds and scheduled routing stops.

DESIGN SYSTEM 15

AI Interface Mock

+------------------------------------------------------+
| AI Assistant Sidebar                                 |
|------------------------------------------------------|
| Prompt: "Auto-extract fields from lading-09.pdf."   |
| [OCR Split View Grid]                                |
| Extracted Origin: NYC   <==> Original: "New York"   |
| [ Commit Fields ] [ Decline Selection ]              |
+------------------------------------------------------+

DOCUMENT OUTLINE

METADATA

Version 1.0.0
Status Approved
Author Chief Arch Team