ifixkart-admin/docs/commerce/orders.md
Adithiyan bbd3a3e959 feat: initial commit — full platform snapshot
- 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
2026-10-13 12:59:47 +05:30

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());