PoC 3.3: Stores Branch (Catalogue Management & Portfolio)

Functional Objective: Covers the central Catalogue Management System (CMS) governing 10,000+ SKUs across 7 distinct categories (GS Group I Toiletries, Group II Household, Group III General; LIF Group IV/V/VI Liquor & Food; AFD Group VII Vehicles & White Goods). Manages Bank Guarantee (BG) coverage limits, Label Registration (LR) state excise permits, shelf-life monitoring, one-to-one replacements, and product discontinuation with automatic debit notes.

---

🎥 PoC Video Demonstration

Master Catalogue (CMS), BG Limit Tracking & Product Lifecycle

Demonstrates 7-category index derivation, automated Bank Guarantee exposure checks, State LR excise tagging, and product discontinuation debit notes.

---

📋 Core Functional Capabilities

• 7-Category Hierarchy: Generic Code grouping (with HSN mapping) and automated Index Number generation across GS1-3, LIF4-6, and AFD-7.
• Bank Guarantee (BG) Guardrails: Dynamic BG limit calculation against open purchase orders; automatic ordering locks if order value exceeds BG coverage.
• Liquor Label Registration (LR): Multi-state LR permit tracking (source state distillery to destination depot), excise duty and local cess auto-calculation.
• Lifecycle & Discontinuation: 4 discontinuation triggers (annual sales <2%, voluntary supplier withdrawal, customer quality complaints via MRU, 3 consecutive delivery failures) triggering automated liquidation and F&A debit notes.

---

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

Item, ItemGroup, PriceList, ItemPrice, BankGuarantee, PriceRevisionRequest, Permit, VarianceThreshold

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.