medical-mall/mall_sql/docs/MIGRATION_CHECKLIST.md

# ✅ doc_mall 项目迁移检查清单

## 📋 文件迁移清单

### 1. 文档和数据库脚本 (`doc_mall/`)

#### 核心文档
- [ ] `README.md` - 文档索引
- [ ] `TECHNICAL_IMPLEMENTATION.md` - 技术实现拆解
- [ ] `MODULE_ANALYSIS.md` - 模块深度分析
- [ ] `FRONTEND_BACKEND_DEBUGGING.md` - 前后端联调指南
- [ ] `user_reuse_summary.md` - 用户表复用方案
- [ ] `migration_complete_report.md` - 迁移完成报告
- [ ] `README_subscription_consumer.md` - 订阅功能说明
- [ ] `裂变红包.md` - 红包功能文档
- [ ] `MIGRATION_GUIDE.md` - 迁移指南（本文档）
- [ ] `MIGRATION_CHECKLIST.md` - 迁移清单（本文件）

#### SQL 脚本
- [ ] `create_mall_subscription_tables.sql` - 订阅表创建脚本
- [ ] `subscription_guard_trigger.sql` - 订阅触发器
- [ ] `subscription_rls_policies.sql` - 订阅RLS策略

#### 分析文档目录 (`analysis/`)
- [ ] `analysis/user_compatibility_analysis.md` - 用户兼容性分析

#### 数据库目录 (`database/`)
- [ ] `database/complete_mall_database.sql` - 完整数据库（推荐）
- [ ] `database/database_creation_report.md` - 数据库创建报告
- [ ] `database/database_syntax_fix_report.md` - 语法修正报告
- [ ] `database/type_error_fix_report.md` - 类型错误修正报告
- [ ] `database/seo_optimization_report.md` - SEO优化报告
- [ ] `database/seo_optimization_guide.md` - SEO优化指南
- [ ] `database/user_compatibility_implementation.sql` - 用户兼容性实施脚本
- [ ] `database/product_database.sql` - 商品数据库设计
- [ ] `database/mock_data_insert.sql` - 模拟数据插入脚本
- [ ] `database/mock_data_documentation.md` - 模拟数据说明
- [ ] `database/deployment_guide.md` - 快速部署指南
- [ ] `database/validation_test.sql` - 数据库验证测试脚本
- [ ] `database/complete_deployment_guide.md` - 完整部署与测试指南
- [ ] `database/database_creation_report.md` - 数据库创建报告
- [ ] `database/[其他SQL文件]` - 其他数据库脚本

#### 报告目录 (`reports/`)
- [ ] `reports/system_generation_report.md` - 系统生成报告
- [ ] `reports/detail_pages_report.md` - 详情页生成报告
- [ ] `reports/profile_pages_report.md` - 个人中心页面报告

---

### 2. 前端页面代码 (`pages/mall/`)

#### 管理端页面 (`admin/`)
- [ ] `admin/index.uvue` - 管理端首页
- [ ] `admin/profile.uvue` - 管理端个人中心
- [ ] `admin/user-detail.uvue` - 用户详情
- [ ] `admin/subscription/plan-management.uvue` - 订阅方案管理
- [ ] `admin/subscription/user-subscriptions.uvue` - 用户订阅管理

#### 数据分析端页面 (`analytics/`)
- [ ] `analytics/index.uvue` - 数据分析首页
- [ ] `analytics/profile.uvue` - 数据分析个人中心
- [ ] `analytics/report-detail.uvue` - 报表详情

#### 消费者端页面 (`consumer/`)
- [ ] `consumer/index.uvue` - 消费者首页
- [ ] `consumer/product-detail.uvue` - 商品详情
- [ ] `consumer/order-detail.uvue` - 订单详情
- [ ] `consumer/profile.uvue` - 消费者个人中心
- [ ] `consumer/subscription/plan-list.uvue` - 订阅方案列表
- [ ] `consumer/subscription/plan-detail.uvue` - 订阅方案详情
- [ ] `consumer/subscription/subscribe-checkout.uvue` - 订阅确认
- [ ] `consumer/subscription/my-subscriptions.uvue` - 我的订阅
- [ ] `consumer/subscription/README.md` - 订阅功能说明

#### 配送端页面 (`delivery/`)
- [ ] `delivery/index.uvue` - 配送端首页
- [ ] `delivery/order-detail.uvue` - 配送订单详情
- [ ] `delivery/profile.uvue` - 配送员个人中心

#### 商家端页面 (`merchant/`)
- [ ] `merchant/index.uvue` - 商家端首页
- [ ] `merchant/product-detail.uvue` - 商品管理详情
- [ ] `merchant/profile.uvue` - 商家个人中心

#### 客服端页面 (`service/`)
- [ ] `service/index.uvue` - 客服工作台首页
- [ ] `service/profile.uvue` - 客服个人中心
- [ ] `service/ticket-detail.uvue` - 工单详情

#### NFC 功能页面 (`nfc/`) - 可选
- [ ] `nfc/admin/index.uvue`
- [ ] `nfc/librarian/index.uvue`
- [ ] `nfc/merchant/pos-cashier.uvue`
- [ ] `nfc/parent/index.uvue`
- [ ] `nfc/security/index.uvue`
- [ ] `nfc/student/index.uvue`
- [ ] `nfc/student/nfc-pay.uvue`
- [ ] `nfc/teacher/index.uvue`

#### 配置文件
- [ ] `mall.md` - 业务需求文档
- [ ] `nfc.md` - NFC功能文档
- [ ] `nfc-modules-guide.md` - NFC模块指南
- [ ] `pages-config.json` - 主要页面路由配置
- [ ] `pages-admin.json` - 管理端路由配置
- [ ] `pages-librarian.json` - 图书管理员路由配置
- [ ] `pages-merchant.json` - 商家路由配置
- [ ] `pages-parent.json` - 家长路由配置
- [ ] `pages-security.json` - 安全员路由配置
- [ ] `pages-student.json` - 学生路由配置
- [ ] `pages-teacher.json` - 教师路由配置

---

### 3. 类型定义文件

- [ ] `types/mall-types.uts` - 商城系统完整类型定义（**必须迁移**）

---

### 4. 依赖文件（可选，根据实际情况）

#### Supabase 客户端封装
- [ ] `components/supadb/aksupainstance.uts` - Supabase实例
- [ ] `components/supadb/aksupa.uts` - Supabase客户端封装
- [ ] `components/supadb/aksuparealtime.uts` - 实时订阅封装
- [ ] `components/supadb/[其他相关文件]` - 其他Supabase相关文件

#### 工具函数（根据实际引用）
- [ ] 检查 `pages/mall/` 中所有 `@/utils/` 的引用
- [ ] 迁移需要的工具函数文件

---

## 🔗 依赖关系检查

### 数据库依赖
- [ ] 确定用户表处理方案（独立表/复用表/API服务）
- [ ] 更新相关外键引用（如需要）
- [ ] 配置 Supabase 项目连接信息

### 代码依赖
- [ ] 检查所有 `@/types/mall-types.uts` 引用（应已迁移）
- [ ] 检查所有 `@/components/supadb` 引用
- [ ] 检查所有 `@/utils/` 引用
- [ ] 更新导入路径（如需要）

### 配置文件依赖
- [ ] Supabase 项目 URL 和 API Key
- [ ] 环境变量配置
- [ ] 路由配置（pages-config.json 等）

---

## 🗄️ 数据库迁移步骤

### 环境准备
- [ ] 创建新的 Supabase 项目（或确定使用现有项目）
- [ ] 获取 Supabase 项目 URL 和 API Key
- [ ] 准备 PostgreSQL 客户端工具（如需要）

### 数据库脚本执行
- [ ] 执行 `database/complete_mall_database.sql` - 创建完整数据库结构
- [ ] 执行 `subscription_rls_policies.sql` - 订阅RLS策略
- [ ] 执行 `subscription_guard_trigger.sql` - 订阅触发器
- [ ] 执行 `database/mock_data_insert.sql` - 插入测试数据（可选）
- [ ] 执行 `database/validation_test.sql` - 验证数据库状态

### 数据库验证
- [ ] 验证所有表已创建
- [ ] 验证 RLS 策略已生效
- [ ] 验证触发器已创建
- [ ] 验证索引已创建
- [ ] 测试数据查询功能

---

## 🔧 代码适配检查

### 路径更新
- [ ] 检查所有文件中的 `@/types/mall-types` 导入路径
- [ ] 检查所有文件中的 `@/components/supadb` 导入路径
- [ ] 检查所有文件中的 `@/utils/` 导入路径
- [ ] 更新为正确的相对路径或配置别名

### 配置更新
- [ ] 更新 Supabase 客户端初始化配置
- [ ] 更新环境变量配置
- [ ] 更新路由配置文件（如需要）

### 文档更新
- [ ] 更新文档中的路径引用
- [ ] 更新文档中的配置说明

---

## 🧪 测试验证

### 编译测试
- [ ] 项目可以正常编译
- [ ] 无类型错误
- [ ] 无导入路径错误

### 运行时测试
- [ ] 应用可以正常启动
- [ ] Supabase 连接正常
- [ ] 页面可以正常加载

### 功能测试
- [ ] 用户认证功能正常
- [ ] 商品浏览功能正常
- [ ] 订单创建功能正常
- [ ] 权限控制正常（RLS）

### 数据库测试
- [ ] CRUD 操作正常
- [ ] RLS 策略生效
- [ ] 触发器正常工作

---

## 📝 迁移记录

### 迁移信息
- **迁移日期**: ___________
- **源项目路径**: ___________
- **目标项目路径**: ___________
- **迁移人员**: ___________

### 迁移问题记录
| 问题描述 | 解决方案 | 状态 |
| -------- | -------- | ---- |
|          |          |      |
|          |          |      |

### 待处理事项
- [ ] 
- [ ] 
- [ ] 

---

## ✅ 迁移完成确认

- [ ] 所有文件已迁移
- [ ] 所有依赖已处理
- [ ] 数据库已配置
- [ ] 代码已适配
- [ ] 测试已通过
- [ ] 文档已更新

**迁移完成签名**: ___________
**完成日期**: ___________