PoC 3.4: Depot Operations (Inward, Binning & High-Speed Ledger)

Functional Objective: Covers high-throughput operations across the 34 Area Depots. Features Purchase Order receipt, Advanced Shipping Notice (ASN) matching, Gate Inward, Quality Inspection (CFC testing), 2D barcode scanning, multi-zone bin allocation, Monthly Stock Taking Catalogue (MSTC) reconciliation, inter-depot stock transfers, and sub-millisecond stock balance ledger debit/credit using TigerBeetle.

---

🎥 PoC Video Demonstration

Depot Inward Goods Receipt (GRN), Binning & TigerBeetle Stock Ledger

Demonstrates barcode scan inward, automated 3-way GRN match, bin storage allocation, URC dispatch notes, and instant TigerBeetle balance updates.

---

📋 Core Functional Capabilities

• Inward Gate & GRN: Scan-based receipt against supplier ASN/PO, batch/expiry verification, damaged/breakage logging, and automated Goods Receipt Note generation.
• Storage & Bin Put-away: Rule-based put-away into temperature-controlled zones, high-rack bins, and bonded liquor lockups.
• TigerBeetle Double-Entry Stock Movement: Inward credits depot stock account and debits supplier clearing account at 100k+ transfers/sec without database row-locks.
• Monthly Stock Taking (MSTC): Automated month-end physical stock reconciliation, denial analysis, and reporting to Regional Managers and CSD HO.

---

🏗️ Technical Architecture & DocType Mapping

In Business M and Framework M, this domain is powered by native, metadata-driven DocTypes, async controllers, and distributed ledger adapters:

Active Business M DocTypes

Warehouse, Zone, Bin, PurchaseReceipt, StockEntry, StockVariance, MonthlyStockSummary, StockTake, SerialNo, DeliveryNote

graph LR
    User["Stakeholder Portal / Desk"] --> Gateway["API Gateway"]
    Gateway --> Controller["Domain Controller & RBAC"]
    Controller --> DB[("PostgreSQL / RLS Master")]
    Controller --> Relay["Outbox Relay Worker"]
    Relay --> TB[("TigerBeetle Immutable Ledger")]

---

🧪 Verifiable Test Script (Human Review Flow)

Follow these steps in the running Business M instance to replicate the live PoC demonstration:

1. Access Domain Desk: Log into the web desk or local POS at the designated endpoint for this role.
2. Execute Transaction Flow: Follow the standard maker-checker workflow to create and submit the source document.
3. Verify Audit Trail & Ledger: Inspect the generated transfer ID, status transitions, and read-model balances.
4. Inspect Air-Gapped Sync (if applicable): Ensure zero cloud secrets on disk and verify cryptographic signing.