- 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
67 lines
2 KiB
Markdown
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
|
|
);
|
|
```
|