akmon/doc_mall/database/complete_deployment_guide.md

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

📋 部署前检查清单

1. 环境要求

• PostgreSQL 13+ 或 Supabase 项目
• 具有数据库创建权限的账户
• 已安装必要扩展的权限

2. 必要扩展

-- 在执行任何脚本前，确保这些扩展已安装
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: 验证环境

# 执行验证脚本
psql -d your_database -f validation_test.sql

步骤 2: 创建完整数据库结构

# 执行主数据库脚本
psql -d your_database -f complete_mall_database.sql

步骤 3: 插入模拟数据

# 执行模拟数据脚本
psql -d your_database -f mock_data_insert.sql

步骤 4: 验证部署结果

# 再次执行验证脚本确认
psql -d your_database -f validation_test.sql

🔧 Supabase 部署

在 Supabase Dashboard 中部署

1. 登录 Supabase Dashboard

   • 打开 supabase.com
   • 选择您的项目

2. SQL Editor 部署

   -- 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 策略

📊 部署验证

数据完整性检查

-- 检查所有主要表的数据量
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;

权限验证

-- 检查 RLS 是否正确启用
SELECT 
    schemaname,
    tablename,
    rowsecurity
FROM pg_tables 
WHERE tablename LIKE 'ml_%'
ORDER BY tablename;

功能测试

-- 测试用户认证相关查询
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

解决方案:

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：

-- 检查当前类型
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

解决方案:

-- 删除现有策略后重新创建
DROP POLICY IF EXISTS policy_name ON table_name;

问题 4: 权限不足

ERROR: permission denied for relation ak_users

解决方案: 确保当前用户具有足够权限，或在 Supabase 中使用 Service Role Key。

📈 性能优化建议

1. 索引检查

-- 查看重要表的索引
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. 监控要点

• 订单表增长速度
• 用户行为日志大小
• 图片存储用量

🔄 数据维护

定期清理

-- 清理过期的购物车项目（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 安全策略
• ✅ 优化的索引结构
• ✅ 丰富的模拟测试数据
• ✅ 业务触发器和函数