- 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
935 B
935 B
Order Lifecycle & State Machine
Order State Transition Rules
Managed via OrderRouter.py.
stateDiagram-v2
[*] --> ORDER_CREATED
ORDER_CREATED --> PAYMENT_PENDING
PAYMENT_PENDING --> PAYMENT_AUTHORIZED
PAYMENT_AUTHORIZED --> PAYMENT_CAPTURED
PAYMENT_CAPTURED --> ORDER_CONFIRMED
ORDER_CONFIRMED --> PROCESSING
PROCESSING --> PACKED
PACKED --> SHIPPED
SHIPPED --> DELIVERED
PAYMENT_PENDING --> PAYMENT_FAILED
PAYMENT_PENDING --> PAYMENT_EXPIRED
ORDER_CONFIRMED --> CANCELLED
DELIVERED --> RETURNED
Order Status Audit Trail
Every state change creates an append-only audit entry in order_status_history:
INSERT INTO order_status_history (id, order_id, previous_status, new_status, changed_by, reason, created_at)
VALUES ('his_01J8X9', 'ord_01J8X9', 'PAYMENT_PENDING', 'ORDER_CONFIRMED', 'SYSTEM', 'Razorpay Webhook ACK', NOW());