Demo 3.3: Retail Governance Directorate (IRO Governance & Sanctions)

Functional Objective: Covers Retail Governance Directorate governance over 3,600+ Institutional Retail Outlets (IROs). Features formal IRO creation requests, parent distribution center dependency mapping, dual-dependency routing, IRO working capital loan processing (interlinked with F&A/Financial Concurrence/PAO), enterprise store mergers, de-mergers, suspensions, and NOC releases.

🎥 Video Walkthrough & Feature Tour

IRO Lifecycle Governance, Distribution Center Dependency & Loan Sanctions

Demonstrates IRO creation approval, automated parent distribution center linkage, loan evaluation workflow with PAO/Financial Concurrence, and NOC management.

📋 Core Functional Capabilities

IRO Creation & Allotment: Registration numbering, dependent regional distribution center assignment, automatic broadcast to regional operations manager and distribution center.
IRO Loan Workflow: Loan application validation, multi-stakeholder approval (F&A, Financial Concurrence, PAO, Retail Governance Directorate, Executive Board), and automatic stock credit line allocation.
Dependency Management: Change of dependent distribution center, dual-dependency support for remote/field units, automated NOC issuance from releasing distribution center.
Lifecycle Transitions: Workflow-driven mergers, de-mergers, temporary suspensions, and final termination with audit trails.

🏗️ 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, OutletRegistration, OutletLoan, OutletDependencyChange, OutletMerger, OutletTermination, ManagementApproval

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 new retail outlet: ‘Himalayan Forward Retail Outlet’ via OutletRegistration
Set dependent parent distribution: center and administrative zone dependency
Retail Governance Directorate approves registration: issue unique Outlet Identifier
Register and verify active: Himalayan Forward Retail Outlet in Outlet list
Submit working capital loan: application for ₹25,00,000 via OutletLoan
Distribution Center Manager records recommendation: depot_recommendation=‘Approve’
Retail Governance Directorate concurs: directorate_approval=true, amount=₹25,00,000
Financial Advisor / Pre-Audit pre-audit concurrence: finance_cleared=true, accounts_cleared=true
Executive Procurement Board sanctions loan: epb_decision=‘Approved’
Process F&A disbursement voucher: verify Outlet stock credit line of ₹25,00,000 activated