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 策略生效
• 触发器正常工作

---

📝 迁移记录

迁移信息

• 迁移日期: ___________
• 源项目路径: ___________
• 目标项目路径: ___________
• 迁移人员: ___________

迁移问题记录

问题描述	解决方案	状态

待处理事项

---

✅ 迁移完成确认

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

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