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

67 lines
2 KiB
Markdown

# 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
);
```