Demo 3.7: Institutional Retail Outlets (Air-Gapped POS & Edge Indenting)

Functional Objective: Covers the ~4,500 Institutional Retail Outlets (IROs) operating in field, remote, and urban locations. Features Provisional Demand (PD) indenting to Regional Distribution Centers, offline-first POS billing on embedded business-local (.deb) terminals, Enterprise Employee / Beneficiary Smart Card & Quota Ledger validation, statutory public concession calculations, ESC/POS thermal printing, and cryptographically signed (Ed25519) background outbox sync with MeghRaj Cloud.

🎥 Video Walkthrough & Feature Tour

Air-Gapped IRO Offline POS Billing & Asymmetric Outbox Sync

Demonstrates 100% offline POS cashier checkout, smart card quota enforcement, statutory public concession discount, thermal printing, and seamless background sync upon network reconnection.

📋 Core Functional Capabilities

Provisional Demand (PD) Cycle: Indent submission (1st–3rd of month) based on historical off-take and available IRO budget.
Offline-First POS Checkout: Local cashier PIN login, item barcode scanning, grade-based quota enforcement (regulated commodities units and grocery limits), and instant invoice generation with 0ms network latency.
Public Concession & GST: Automated statutory public concession rebate computation and enterprise profit margin deductions compliant with ministerial regulations.
Zero-Secret Asymmetric Sync: Transactions signed locally with device Ed25519 private key; relayed to MeghRaj cloud via outbox micro-batches without exposing cloud DB credentials on disk.

🏗️ 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

Outlet, Sovereign CustomerOrder, SalesInvoice, DeliveryConfirmation, Member, MasterDataProjection, StockOutboxEntry

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 (mapped directly from end-to-end test automation):

Register military beneficiary with: Smart Card ID & entitlement quota
Submit Retail Outlets monthly: replenishment indent to parent distribution center
Create retail CustomerOrder for: beneficiary pick-up
POS cashier authenticates offline: edge terminal
Scan beneficiary Enterprise Employee Smart Card: verify quota and rank
Confirm delivery receipt in: DeliveryConfirmation
Verify offline transaction queue: in StockOutboxEntry
Reconnect network: verify outbox relays to cloud and clears