# ✅ 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 策略生效 - [ ] 触发器正常工作 --- ## 📝 迁移记录 ### 迁移信息 - **迁移日期**: ___________ - **源项目路径**: ___________ - **目标项目路径**: ___________ - **迁移人员**: ___________ ### 迁移问题记录 | 问题描述 | 解决方案 | 状态 | | -------- | -------- | ---- | | | | | | | | | ### 待处理事项 - [ ] - [ ] - [ ] --- ## ✅ 迁移完成确认 - [ ] 所有文件已迁移 - [ ] 所有依赖已处理 - [ ] 数据库已配置 - [ ] 代码已适配 - [ ] 测试已通过 - [ ] 文档已更新 **迁移完成签名**: ___________ **完成日期**: ___________