- Backend: FastAPI app with all models, services, schemas, routes - Admin Panel: Next.js dashboard with all modules (CRM, POS, repairs, warranties, billing, notifications, etc.) - Ecommerce: storefront (submodule) + product catalog - AI Agents: .agents/ skill library for Antigravity IDE - Docs: architecture, billing, notification gateway markdown - Submodules: Backend/OpenWA, Ecommerce/File 2/storefront
592 B
592 B
ADR-010: Immutable Inventory Ledger & Stock Buckets
Context
Multi-channel selling (online storefront + physical POS counters) risks double-deduction and overselling.
Decision
Stock balances are computed from an append-only inventory_ledger table using explicit transition events (RECEIPT, ONLINE_RESERVE, ONLINE_SALE_FROM_RESERVATION, DIRECT_ONLINE_SALE, POS_ALLOCATION, POS_SALE_FROM_ALLOCATION, DIRECT_POS_SALE, RETURN, DAMAGE). Real-time available stock follows:
\text{Available} = \text{Physical} - \text{Reserved} - \text{POSAllocated} - \text{Damaged}