# 00 概览：商城数据库总体设计

## 目标与定位

本数据库设计面向 **PostgreSQL + Supabase** 的电商/订阅混合业务，核心目标：

- **统一用户体系复用**：复用 `public.ak_users`，商城域只做扩展（`ml_` 前缀）。
- **安全优先（Supabase 直连友好）**：使用 RLS（Row Level Security）+ `auth.uid()` 做行级数据隔离。
- **对外访问友好（SEO / URL）**：核心表同时提供 `UUID id`（内部主键）与 `SERIAL cid`（对外可读 ID），配合 `slug` 与 SEO 函数。
- **数据库承载关键一致性**：触发器/函数/约束实现 `updated_at` 自动维护、默认地址唯一、库存汇总、订单状态时间戳与销量累计等。
- **快速迭代与可扩展**：大量使用 `JSONB` 承载可变结构（属性、媒体、地址快照、适用范围、订阅 features/metadata 等）。

## SQL 资料来源

- 迁移/建库主脚本：
  - `doc_mall/database/mall_migration.sql`（偏幂等、增量迁移）
  - `doc_mall/database/complete_mall_database.sql`（偏一次性完整初始化，包含更多视图/函数/RLS/SEO）
- 订阅模块：`doc_mall/create_mall_subscription_tables.sql`
- 检查/测试脚本：`mall_sql/tests/mall_database_check.sql` 等

## 术语

- **SPU**：商品主表（本库对应 `ml_products`）
- **SKU**：商品规格明细（本库对应 `ml_product_skus`）
- **RLS**：Row Level Security（行级安全策略）

## 一句话总结

- **Supabase 优先**（RLS + `auth.uid()`）
- **快速迭代优先**（JSONB + 配置化）
- **数据库保证关键一致性**（触发器/函数/约束/视图）
- **对外可读与 SEO 友好**（`UUID id` + `SERIAL cid` + `slug`）