gongxiangp2/.kiro/specs/source-code-recovery/tasks.md

# 实施计划：从正式系统恢复源码

## 概述

**重要发现**: 
- 生产容器使用 Next.js standalone 模式部署，只包含编译后的代码
- **2.2.0版本的TypeScript源码已丢失**
- 服务器上只有1.0.0版本的旧源码

**恢复策略**: 
1. ✅ 从生产容器提取编译后的代码（已完成）
2. **反编译编译后的JavaScript代码，恢复TypeScript源码**
3. 对比本地1.0.0源码，补充缺失部分
4. 重建完整的2.2.0版本源码
5. 在影子系统测试验证
6. 部署到生产系统

本计划描述了从编译代码反编译恢复源码、构建验证、部署测试的完整步骤。

## 任务

- [x] 1. 连接正式系统并提取编译后的代码（只读操作）
  - ✅ 已确认：生产容器只有编译后的代码（.next目录）
  - ✅ 已下载：编译后的API代码（nextjs-api-compiled.tar.gz）
  - ✅ 已下载：完整的.next构建目录（nextjs-full-build.tar.gz）
  - ✅ 已下载：生产配置文件（package.json等）
  - 📋 结论：**必须通过反编译恢复源码**
  - _需求: 1.1, 1.2, 1.3, 1.4_

- [ ] 2. 反编译JavaScript代码恢复TypeScript源码
  - [ ] 2.1 分析编译后的代码结构
    - 查看 nextjs-build/.next/server/app 目录结构
    - 识别所有API路由文件
    - 识别所有页面组件文件
    - 列出需要反编译的文件清单
    - _需求: 2.1_
  
  - [ ] 2.2 反编译API路由代码
    - 反编译 app/api/materials/route.js → route.ts
    - 反编译 app/api/materials/stats/route.js → route.ts
    - 反编译 app/api/materials/download/route.js → route.ts
    - 反编译 app/api/materials/upload/route.js → route.ts
    - 反编译 app/api/categories/route.js → route.ts
    - 反编译其他API路由文件
    - _需求: 2.1, 2.2_
  
  - [ ] 2.3 反编译页面组件代码
    - 反编译 app/page.js → page.tsx
    - 反编译 app/profile/page.js → page.tsx
    - 反编译 app/admin/page.js → page.tsx
    - 反编译 app/edit/[id]/page.js → page.tsx
    - 反编译其他页面文件
    - _需求: 2.1, 2.2_
  
  - [ ] 2.4 反编译工具库代码
    - 从编译代码中提取 lib/prisma.ts
    - 从编译代码中提取 lib/s3.ts
    - 从编译代码中提取其他lib文件
    - _需求: 2.1, 2.2_
  
  - [ ] 2.5 对比本地1.0.0源码
    - 对比反编译代码与本地代码的差异
    - 识别新增的功能和文件
    - 识别修改的逻辑
    - 生成差异报告
    - _需求: 2.3_
  
  - [ ] 2.6 补充缺失的源码文件
    - 从本地1.0.0复制未改动的文件
    - 合并反编译代码和本地代码
    - 补充类型定义文件
    - 补充配置文件
    - _需求: 2.3_
  
  - [ ] 2.7 重建完整的项目结构
    - 创建完整的 app/ 目录结构
    - 创建完整的 components/ 目录
    - 创建完整的 lib/ 目录
    - 创建完整的 prisma/ 目录
    - 确保所有import路径正确
    - _需求: 2.4_

- [ ] 3. 检查点 - 审查反编译结果
  - 确认所有关键文件都已反编译
  - 确认代码逻辑完整
  - 询问用户是否继续构建

- [ ] 4. 验证环境配置（关键步骤！）
  - [ ] 4.1 检查 `.env` 文件
    - ⚠️ **必须确认**以下配置：
      - `DATABASE_URL` 包含 `lobechat_stage`（不是 `lobechat`）
      - `REDIS_PORT=6380`（不是 `6379`）
      - `NEXTAUTH_URL` 指向影子系统端口 5320
    - _需求: 4.1, 4.3_
  
  - [ ] 4.2 检查部署脚本
    - 确认 `deploy-local-build.ps1` 存在
    - 确认使用 `-Target shadow` 参数会操作影子系统容器
    - _需求: 4.1, 4.3_

- [ ] 5. 验证文件完整性
  - [ ] 5.1 检查关键 API 路由
    - 验证 app/api/materials/route.ts 存在
    - 验证 app/api/materials/download/route.ts 存在
    - 验证 app/api/materials/favorite/route.ts 存在
    - 验证 app/api/user/materials/route.ts 存在
    - 验证 app/api/admin/users/route.ts 存在
    - _需求: 3.1_
  
  - [ ] 5.2 检查关键页面组件
    - 验证 app/page.tsx 存在
    - 验证 app/profile/page.tsx 存在
    - 验证 app/admin/page.tsx 存在
    - 验证 app/edit/[id]/page.tsx 存在
    - _需求: 3.2_
  
  - [ ] 5.3 检查工具库文件
    - 验证 lib/prisma.ts 存在
    - 验证 lib/s3.ts 存在
    - 验证 lib/chunk-upload.ts 存在
    - 验证 lib/image-processor.ts 存在
    - 验证 lib/video-processor.ts 存在
    - _需求: 3.3_
  
  - [ ] 5.4 生成功能完整性报告
    - 列出所有已验证的文件
    - 标注缺失的文件（如有）
    - _需求: 3.4_

- [ ] 6. 检查点 - 审查完整性报告
  - 确认所有关键文件都已恢复
  - 询问用户是否继续构建

- [ ] 7. 安装依赖并构建项目
  - [ ] 7.1 安装 npm 依赖
    - 执行 `npm install`
    - 检查是否有依赖安装错误
    - _需求: 5.1_
  
  - [ ] 7.2 执行项目构建
    - 执行 `npm run build`
    - 监控构建过程
    - _需求: 5.2_
  
  - [ ] 7.3 处理构建错误（如有）
    - 查看构建日志
    - 识别错误原因
    - 修复错误并重新构建
    - _需求: 5.3_
  
  - [ ] 7.4 验证构建输出
    - 检查 .next 目录是否存在
    - 检查 .next/server 目录是否包含必要文件
    - 检查 .next/static 目录是否包含静态资源
    - _需求: 5.4_

- [ ] 8. 检查点 - 确认构建成功并验证环境配置
  - 确认构建无错误
  - ⚠️ **关键检查**: 打开 `.env` 文件，逐行验证：
    - [ ] `DATABASE_URL` 包含 `lobechat_stage`
    - [ ] `REDIS_PORT=6380`
    - [ ] `NEXTAUTH_URL` 包含端口 `5320`
    - [ ] 没有任何配置指向正式系统
  - 询问用户确认环境配置正确后再继续部署

- [ ] 9. 部署到影子系统（严格验证环境隔离）
  - [ ] 9.1 部署前最终检查
    - ⚠️ **停止！先完成以下检查**：
    - [ ] 确认 `deploy-local-build.ps1` 脚本存在
    - [ ] 打开脚本，确认 `-Target shadow` 参数会：
      - 操作容器 `youyidian-3d-material-shadow`（不是 `youyidian-3d-material`）
      - 使用端口 `5320`（不是 `4320`）
      - 使用数据库 `lobechat_stage`（不是 `lobechat`）
    - [ ] 确认 `.env` 文件配置正确（再次检查）
    - _需求: 6.1, 6.2_
  
  - [ ] 9.2 执行部署脚本
    - 运行 `.\deploy-local-build.ps1 -Target shadow`
    - 监控部署过程，注意任何错误信息
    - ⚠️ 如果看到任何关于正式系统的提示，**立即停止**
    - _需求: 6.1, 6.2_
  
  - [ ] 9.3 验证容器状态
    - 检查影子系统容器 `youyidian-3d-material-shadow` 是否正在运行
    - 检查容器日志是否有错误
    - ⚠️ **同时检查**正式系统容器 `youyidian-3d-material` 状态，确认未受影响
    - _需求: 6.3_
  
  - [ ] 9.4 验证网络访问
    - 使用浏览器访问 http://192.168.58.20:5320
    - 确认页面能够正常加载
    - ⚠️ **不要访问** http://192.168.58.20:4320（正式系统）
    - _需求: 6.4_
  
  - [ ] 9.5 验证数据库连接
    - 在影子系统上执行一个简单操作（如查看素材列表）
    - 通过数据库工具连接 `lobechat_stage`，确认有新的操作记录
    - ⚠️ **同时检查** `lobechat` 数据库，确认没有新的记录（证明影子系统没有连接到正式数据库）
    - _需求: 6.3_

- [ ] 10. 功能测试 - 用户认证
  - [ ] 10.1 测试钉钉登录
    - 点击钉钉登录按钮
    - 完成钉钉授权流程
    - 验证登录成功
    - _需求: 7.1_
  
  - [ ] 10.2 测试邮箱登录
    - 使用测试账号登录
    - 验证登录成功
    - _需求: 7.1_

- [ ] 11. 功能测试 - 素材管理
  - [ ] 11.1 测试素材浏览
    - 访问首页
    - 验证瀑布流布局正常显示
    - 验证素材卡片信息完整
    - _需求: 7.2_
  
  - [ ] 11.2 测试素材筛选
    - 测试按素材类型筛选
    - 测试按使用店铺筛选
    - 测试按场景类别筛选
    - 测试按产品类别筛选
    - 测试按月份筛选
    - _需求: 7.3_
  
  - [ ] 11.3 测试搜索功能
    - 在搜索框输入关键词
    - 验证防抖处理（输入后500ms才触发搜索）
    - 验证搜索结果正确
    - _需求: 7.4_
  
  - [ ] 11.4 测试滚动位置保存
    - 滚动到页面中间位置
    - 点击某个素材进入详情页
    - 返回首页
    - 验证滚动位置保持不变
    - _需求: 7.5_
  
  - [ ] 11.5 测试素材上传
    - 点击上传按钮
    - 选择素材类型
    - 上传文件
    - 验证上传成功
    - _需求: 7.2_
  
  - [ ] 11.6 测试素材下载
    - 点击下载按钮
    - 验证下载开始
    - 验证下载完成
    - _需求: 7.2_
  
  - [ ] 11.7 测试模特类素材下载
    - 找到一个模特类素材
    - 点击下载按钮
    - 验证自动打包成 ZIP 文件
    - 验证 ZIP 文件包含所有图片
    - _需求: 7.6_
  
  - [ ] 11.8 测试素材编辑
    - 点击编辑按钮
    - 修改素材信息
    - 保存修改
    - 验证修改成功
    - _需求: 7.2_
  
  - [ ] 11.9 测试点赞功能
    - 点击点赞按钮
    - 验证点赞数增加
    - 再次点击取消点赞
    - 验证点赞数减少
    - _需求: 7.2_
  
  - [ ] 11.10 测试收藏功能
    - 点击收藏按钮
    - 验证收藏成功提示
    - 在个人中心查看收藏列表
    - 验证素材已收藏
    - _需求: 7.2_

- [ ] 12. 功能测试 - 管理员功能
  - [ ] 12.1 测试用户管理
    - 访问管理员页面
    - 查看用户列表
    - 测试用户搜索
    - 测试权限管理
    - _需求: 7.7_
  
  - [ ] 12.2 测试素材管理
    - 查看所有素材列表
    - 测试素材编辑
    - 测试素材删除（软删除）
    - _需求: 7.7_
  
  - [ ] 12.3 测试回收站
    - 查看回收站
    - 测试恢复素材
    - 测试永久删除
    - _需求: 7.7_
  
  - [ ] 12.4 测试分类管理
    - 测试使用店铺管理
    - 测试场景类别管理
    - 测试平台分类管理
    - 测试产品类别管理
    - _需求: 7.7_

- [ ] 13. 功能测试 - 辅助功能
  - [ ] 13.1 测试排行榜
    - 打开排行榜面板
    - 查看下载榜
    - 查看上传榜
    - 查看点赞榜
    - 测试拖动功能
    - _需求: 7.7_
  
  - [ ] 13.2 测试 AI 聊天
    - 打开 AI 聊天窗口
    - 发送测试消息
    - 验证 AI 回复
    - _需求: 7.7_
  
  - [ ] 13.3 测试网络诊断
    - 打开网络诊断弹窗
    - 执行下载测速
    - 执行上传测速
    - 查看诊断结果
    - _需求: 7.7_

- [ ] 14. 检查点 - 审查测试结果并验证正式系统未受影响
  - 汇总所有测试结果
  - 识别失败的测试项
  - ⚠️ **关键验证**: 
    - [ ] 访问正式系统 http://192.168.58.20:4320，确认正常运行
    - [ ] 检查正式系统数据库 `lobechat`，确认没有测试数据
    - [ ] 检查正式系统容器日志，确认没有异常
  - 询问用户是否需要修复失败的测试项

- [ ] 15. 生成测试报告
  - [ ] 15.1 创建功能测试报告
    - 列出所有测试项
    - 标注通过/失败状态
    - 记录测试时间
    - _需求: 7.1-7.7_
  
  - [ ] 15.2 对比正式系统和影子系统
    - 列出功能差异
    - 分析差异原因
    - 提出修复建议
    - _需求: 7.1-7.7_

- [ ] 16. 更新文档
  - [ ] 16.1 更新功能恢复进度文档
    - 记录恢复的文件列表
    - 记录测试结果
    - 更新完成状态
    - _需求: 8.1, 8.4_
  
  - [ ] 16.2 记录问题和解决方案
    - 记录遇到的问题
    - 记录解决方案
    - 提供参考链接
    - _需求: 8.2_
  
  - [ ] 16.3 更新部署文档
    - 更新部署步骤
    - 更新配置说明
    - 更新注意事项
    - _需求: 8.3_

- [ ] 17. 最终检查点
  - 确认所有功能已恢复
  - 确认所有测试已通过
  - 确认文档已更新
  - 询问用户是否可以部署到正式系统

- [ ] 18. （可选）修复已知BUG
  - ⚠️ **注意**: 此任务仅在源码恢复完成后，如果需要修复BUG时执行
  - [ ] 18.1 修复统计API（如需要）
    - 文件: `app/api/materials/stats/route.ts`
    - 问题: 统计可能包含软删除数据
    - 修复: 添加 `where: { deletedAt: null }` 过滤
    - _需求: 可选_
  
  - [ ] 18.2 修复分页API（如需要）
    - 文件: `app/api/materials/route.ts`
    - 问题: 分页逻辑可能有问题
    - 修复: 确认 skip 和 take 参数正确应用
    - _需求: 可选_
  
  - [ ] 18.3 修复分类统计（如需要）
    - 文件: `app/api/categories/route.ts`
    - 问题: 分类统计可能包含软删除数据
    - 修复: 添加 `deletedAt: null` 过滤
    - _需求: 可选_

## ⚠️ 重要注意事项

### 🔴 环境隔离 - 绝对不能混淆！

**正式系统配置（端口 4320）：**
- 数据库：`lobechat`（192.168.58.20:5432）
- Redis：端口 `6379`
- 容器名：`youyidian-3d-material`
- 文件存储：容器内 `/app/uploads`
- S3存储：`https://s3.yydd.ai/gongxiangpan`（生产数据）

**影子系统配置（端口 5320）：**
- 数据库：`lobechat_stage`（192.168.58.20:5432）
- Redis：端口 `6380`
- 容器名：`youyidian-3d-material-shadow`
- 文件存储：容器内 `/app/uploads`（独立目录）
- S3存储：`https://s3.yydd.ai/gongxiangpan`（可能共享，但要注意文件前缀）

### 🚨 关键操作规则

1. **只读访问正式系统**: 
   - 只从正式系统**读取**源码文件
   - 绝对不要修改正式系统的任何文件
   - 绝对不要在正式系统容器内执行写操作

2. **环境变量检查**:
   - 提取源码后，**必须**检查 `.env` 文件
   - **必须**确认数据库连接指向 `lobechat_stage`
   - **必须**确认 Redis 端口是 `6380`
   - **绝对不要**使用正式系统的 `.env` 配置

3. **数据库隔离**:
   - 影子系统**只能**连接 `lobechat_stage` 数据库
   - 部署前**必须**验证数据库配置
   - 如果连接错误，**立即停止**部署

4. **文件存储隔离**:
   - 影子系统的 uploads 目录与正式系统完全独立
   - 不要挂载正式系统的 uploads 目录
   - S3 存储如果共享，要注意文件命名避免冲突

5. **部署验证**:
   - 部署到影子系统前，**必须**检查 `deploy-local-build.ps1` 脚本
   - **必须**确认使用 `-Target shadow` 参数
   - **必须**确认脚本不会影响正式系统容器

6. **测试隔离**:
   - 所有测试**只在**影子系统（5320端口）进行
   - 测试数据**只写入** `lobechat_stage` 数据库
   - 绝对不要在正式系统上进行任何测试操作

### 📋 部署前检查清单

在执行任务 9（部署到影子系统）之前，**必须**完成以下检查：

- [ ] 确认 `.env` 文件中 `DATABASE_URL` 包含 `lobechat_stage`
- [ ] 确认 `.env` 文件中 `REDIS_PORT=6380`
- [ ] 确认 `deploy-local-build.ps1` 使用 `-Target shadow` 参数
- [ ] 确认部署脚本不会操作 `youyidian-3d-material` 容器
- [ ] 确认部署脚本只操作 `youyidian-3d-material-shadow` 容器
- [ ] 确认 Docker Compose 配置（如有）使用正确的端口和数据库

### 🛡️ 安全措施

1. **备份**: 虽然只读访问正式系统，但建议先备份正式系统数据库
2. **监控**: 部署后监控正式系统，确认没有受到影响
3. **回滚**: 如果影子系统出现问题，可以快速停止容器，不影响正式系统

## 预计时间

- 任务 1: 提取编译代码 - ✅ 已完成
- 任务 2: 反编译恢复源码 - **120 分钟**（核心任务）
- 任务 3-4: 环境配置和验证 - 20 分钟
- 任务 5-6: 文件完整性验证 - 20 分钟
- 任务 7-8: 构建验证 - 15 分钟
- 任务 9: 部署到影子系统 - 20 分钟
- 任务 10-13: 功能测试 - 60 分钟
- 任务 14-17: 报告和文档 - 25 分钟

**总计**: 约 **4.5 小时**（反编译是最耗时的部分）