ifixkart-admin/docs/database/schema.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

2 KiB

Complete Database Schema Specifications

All primary keys use 26-character ULID strings (VARCHAR(26)).


Core E-Commerce Tables

1. ecom_customers

CREATE TABLE ecom_customers (
    customer_id VARCHAR(26) PRIMARY KEY,
    google_id VARCHAR(128) UNIQUE NULL,
    email VARCHAR(255) NOT NULL UNIQUE,
    password_hash VARCHAR(255) NULL,
    first_name VARCHAR(100) NOT NULL,
    last_name VARCHAR(100) NOT NULL,
    phone VARCHAR(30) UNIQUE NULL,
    is_active BOOLEAN DEFAULT TRUE,
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP,
    updated_at DATETIME DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP
);

2. orders

CREATE TABLE orders (
    order_id VARCHAR(26) PRIMARY KEY,
    order_no VARCHAR(50) UNIQUE NOT NULL,
    customer_id VARCHAR(26) NULL,
    total_amount DECIMAL(10,2) NOT NULL,
    discount_amount DECIMAL(10,2) DEFAULT 0.00,
    tax_amount DECIMAL(10,2) DEFAULT 0.00,
    shipping_cost DECIMAL(10,2) DEFAULT 0.00,
    final_amount DECIMAL(10,2) NOT NULL,
    status VARCHAR(50) DEFAULT 'ORDER_CREATED',
    payment_status VARCHAR(50) DEFAULT 'PAYMENT_PENDING',
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

3. inventory_ledger

CREATE TABLE inventory_ledger (
    ledger_id VARCHAR(26) PRIMARY KEY,
    variant_id VARCHAR(26) NOT NULL,
    event_type VARCHAR(50) NOT NULL, -- RECEIPT, ONLINE_RESERVE, ONLINE_SALE_FROM_RESERVATION...
    qty INT NOT NULL,
    warehouse_id VARCHAR(26) NULL,
    store_id VARCHAR(26) NULL,
    reference_id VARCHAR(100) NULL, -- Order ID / POS Tx ID
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);

4. outbox_events

CREATE TABLE outbox_events (
    event_id VARCHAR(26) PRIMARY KEY,
    aggregate_type VARCHAR(50) NOT NULL, -- PRODUCT, ORDER, INVENTORY
    aggregate_id VARCHAR(26) NOT NULL,
    aggregate_version INT NOT NULL,
    payload JSON NOT NULL,
    status VARCHAR(20) DEFAULT 'PENDING',
    created_at DATETIME DEFAULT CURRENT_TIMESTAMP
);