QuickStart
Sovereign Physical Distribution Platform · Cluster Node
Step-by-step tutorial to provision a test supplier cell, stage test inventory, generate an optimized dispatch route, and complete a simulated delivery.
This tutorial takes you from zero to a fully settled order-to-cash lifecycle. You will initialize an isolated test cell, register SKU inventory across multiple warehouse bins, place a sample retail order, run the automated CVRP solver, and trigger the outbox event chain.
Architecture & Performance Highlights
Zero Configuration
Pre-seeded local mock servers allow instant end-to-end testing without external cloud credentials.
Full Lifecycle Trace
Observe orders transition across all 6 roles with live WebSocket terminal output.
Ledger Verified
Every step outputs verifiable double-entry transaction debit/credit balances in the console.
Standard Operating Procedure
Authenticate and Retrieve Tenant Credentials
Generate an operational session token with super-operator privileges for the designated test cell.
curl -X POST "https://api.pegasus-logistics.io/v1/auth/session" \
-H "Content-Type: application/json" \
-d '{"apiKey": "pegasus_test_k78x92", "cell": "cell-sandbox-01"}'Seed Catalog & Allocate Warehouse Stock
Post a sample batch of Fast-Moving Consumer Goods (FMCG) items with dimensional weight and pack sizing to Warehouse Hub Alpha.
curl -X POST "https://api.pegasus-logistics.io/v1/inventory/batch-adjust" \
-H "Authorization: Bearer ${SESSION_TOKEN}" \
-H "Content-Type: application/json" \
-d '{
"warehouseId": "wh-alpha-tashkent",
"adjustments": [
{"sku": "SKU-BEV-001", "quantity": 500, "unitCents": 1200000},
{"sku": "SKU-SNK-042", "quantity": 1200, "unitCents": 450000}
]
}'Dispatch the Automated CVRP Optimizer
Cluster all pending orders for the morning shift. The solver calculates optimal vehicle-capacity loading and output turn-by-turn route manifests.
curl -X POST "https://api.pegasus-logistics.io/v1/dispatch/optimize-routes" \
-H "Authorization: Bearer ${SESSION_TOKEN}" \
-H "Content-Type: application/json" \
-d '{"warehouseId": "wh-alpha-tashkent", "algorithm": "OR_TOOLS_PARALLEL_CHEAPEST_INSERTION"}'Sandbox Ledger Safe Mode
All quickstart operations execute against synthetic currency ledgers. No real financial debiting or live bank PSP callbacks are triggered.
Keep Exploring Pegasus Architecture & Operations
Based on the invariants, physical actors, and data flows of this module, explore these recommended companion guides and operational playbooks.
Warehouse Hub Operations
Learn how warehouse managers view and edit the generated CVRP routes before locking the morning manifest.
Driver Route Execution
See how the driver receives this manifest on their mobile device and performs offline proof-of-delivery.
Double-Entry Ledger Audit
Inspect the exact accounting entries generated when this test order transitions from Pending to Paid.