# 商城数据库部署与测试完整指南

## 📋 部署前检查清单

### 1. 环境要求
- PostgreSQL 13+ 或 Supabase 项目
- 具有数据库创建权限的账户
- 已安装必要扩展的权限

### 2. 必要扩展
```sql
-- 在执行任何脚本前，确保这些扩展已安装
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
CREATE EXTENSION IF NOT EXISTS "pgcrypto";
```

### 3. 现有表检查
如果您的项目中已有 `ak_users` 表，请确保：
- `auth_id` 字段类型为 `uuid`（不是 `text`）
- 表结构包含必要的字段：`id`, `username`, `email`, `phone`, `auth_id`, `avatar_url`, `gender`, `created_at`

## 🚀 部署步骤

### 步骤 1: 验证环境
```bash
# 执行验证脚本
psql -d your_database -f validation_test.sql
```

### 步骤 2: 创建完整数据库结构
```bash
# 执行主数据库脚本
psql -d your_database -f complete_mall_database.sql
```

### 步骤 3: 插入模拟数据
```bash
# 执行模拟数据脚本
psql -d your_database -f mock_data_insert.sql
```

### 步骤 4: 验证部署结果
```bash
# 再次执行验证脚本确认
psql -d your_database -f validation_test.sql
```

## 🔧 Supabase 部署

### 在 Supabase Dashboard 中部署

1. **登录 Supabase Dashboard**
   - 打开 [supabase.com](https://supabase.com)
   - 选择您的项目

2. **SQL Editor 部署**
   ```sql
   -- 1. 首先安装扩展
   CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
   CREATE EXTENSION IF NOT EXISTS "pgcrypto";
   
   -- 2. 复制粘贴 complete_mall_database.sql 内容并执行
   -- 3. 复制粘贴 mock_data_insert.sql 内容并执行
   ```

3. **验证 RLS 策略**
   - 在 Authentication > Policies 中查看策略
   - 确认所有 `ml_*` 表都有相应的 RLS 策略

## 📊 部署验证

### 数据完整性检查
```sql
-- 检查所有主要表的数据量
SELECT 
    'ak_users' as table_name, COUNT(*) as record_count 
FROM public.ak_users
UNION ALL
SELECT 'ml_user_profiles', COUNT(*) FROM public.ml_user_profiles
UNION ALL
SELECT 'ml_merchants', COUNT(*) FROM public.ml_merchants
UNION ALL
SELECT 'ml_categories', COUNT(*) FROM public.ml_categories
UNION ALL
SELECT 'ml_products', COUNT(*) FROM public.ml_products
UNION ALL
SELECT 'ml_orders', COUNT(*) FROM public.ml_orders
UNION ALL
SELECT 'ml_reviews', COUNT(*) FROM public.ml_reviews
ORDER BY table_name;
```

### 权限验证
```sql
-- 检查 RLS 是否正确启用
SELECT 
    schemaname,
    tablename,
    rowsecurity
FROM pg_tables 
WHERE tablename LIKE 'ml_%'
ORDER BY tablename;
```

### 功能测试
```sql
-- 测试用户认证相关查询
SELECT 
    u.username,
    up.real_name,
    up.gender
FROM public.ak_users u
LEFT JOIN public.ml_user_profiles up ON u.id = up.user_id
WHERE u.username IN ('customer1', 'merchant1')
LIMIT 5;

-- 测试商品数据
SELECT 
    p.name,
    p.price,
    c.name as category,
    m.name as merchant
FROM public.ml_products p
JOIN public.ml_categories c ON p.category_id = c.id
JOIN public.ml_merchants m ON p.merchant_id = m.id
LIMIT 5;
```

## ⚠️ 常见问题解决

### 问题 1: UUID 扩展未安装
```
ERROR: function uuid_generate_v4() does not exist
```
**解决方案:**
```sql
CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
```

### 问题 2: auth_id 类型不匹配
```
ERROR: column "auth_id" is of type uuid but expression is of type text
```
**解决方案:**
确保 `ak_users` 表中 `auth_id` 字段类型为 `uuid`：
```sql
-- 检查当前类型
SELECT column_name, data_type 
FROM information_schema.columns 
WHERE table_name = 'ak_users' AND column_name = 'auth_id';

-- 如果是 text 类型，需要转换
ALTER TABLE public.ak_users 
ALTER COLUMN auth_id TYPE uuid 
USING auth_id::uuid;
```

### 问题 3: RLS 策略创建失败
```
ERROR: policy "xxx" for table "yyy" already exists
```
**解决方案:**
```sql
-- 删除现有策略后重新创建
DROP POLICY IF EXISTS policy_name ON table_name;
```

### 问题 4: 权限不足
```
ERROR: permission denied for relation ak_users
```
**解决方案:**
确保当前用户具有足够权限，或在 Supabase 中使用 Service Role Key。

## 📈 性能优化建议

### 1. 索引检查
```sql
-- 查看重要表的索引
SELECT 
    tablename,
    indexname,
    indexdef
FROM pg_indexes 
WHERE tablename LIKE 'ml_%'
ORDER BY tablename, indexname;
```

### 2. 查询优化
- 商品列表查询使用 `ml_products_search_idx` 索引
- 订单查询使用 `ml_orders_user_status_idx` 索引
- 用户行为分析使用 `ml_user_behavior_user_time_idx` 索引

### 3. 监控要点
- 订单表增长速度
- 用户行为日志大小
- 图片存储用量

## 🔄 数据维护

### 定期清理
```sql
-- 清理过期的购物车项目（30天前）
DELETE FROM public.ml_shopping_cart 
WHERE created_at < NOW() - INTERVAL '30 days';

-- 清理过期的优惠券
UPDATE public.ml_coupons 
SET status = 'expired' 
WHERE end_date < NOW() AND status = 'active';
```

### 备份建议
- 每日备份核心业务表：`ml_orders`, `ml_order_items`, `ml_products`
- 每周全量备份
- 重要操作前手动备份

## 📞 技术支持

如果在部署过程中遇到问题，请检查：
1. PostgreSQL 版本兼容性
2. 扩展安装权限
3. 表结构完整性
4. RLS 策略语法

部署成功后，您的商城数据库将包含：
- ✅ 18 个核心业务表
- ✅ 完整的 RLS 安全策略
- ✅ 优化的索引结构
- ✅ 丰富的模拟测试数据
- ✅ 业务触发器和函数