# Complete Database Schema Specifications All primary keys use 26-character **ULID** strings (`VARCHAR(26)`). --- ## Core E-Commerce Tables ### 1. `ecom_customers` ```sql 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` ```sql 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` ```sql 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` ```sql 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 ); ```