Mdeical_Sur_Report/工程分析/工作流指南.md

项目修改工作流指南

本工作流适用于所有项目修改相关需求。每次收到修改需求时，必须严格按照以下步骤执行。

---

工作流步骤

Step 0: 备份与记录时间戳

每次执行前，必须先用 Gitea 进行代码备份，并记录问题开始时间：

• 时间戳格式：{Year}-{Mon}-{Day}-{Hour}-{Min}-{Sec}
• 备份命令：

  git init
  git checkout -b main
  git add .
  git commit -m "backup before modification at {时间戳}"
  git remote add origin http://192.168.31.5:5002/admin/Mdeical_Sur_Report.git
  git push -u origin main
  

• 若远程已存在，则使用 git remote set-url origin http://192.168.31.5:5002/admin/Mdeical_Sur_Report.git

Step 1: 工程分析目录检查

确保 ..\工程分析 文件夹存在（已创建）。

Step 2: 需求分析文档

将用户提出的需求整理后写入：

.\工程分析\需求分析-{时间戳}.md

• 内容需包含：需求背景、功能目标、涉及页面/模块、验收标准

Step 3: 实现方案文档

基于需求分析，编写详细实现方案并写入：

.\工程分析\实现方案-{时间戳}.md

• 内容需包含：技术思路、修改文件清单、关键代码变更说明、风险点
• 写完此文档后，必须暂停并交由用户进行二次人工审核确认。未经确认不得继续。

Step 4: 测试方案文档

实现方案确认后，编写测试方案并写入：

.\工程分析\测试方案-{时间戳}.md

• 内容需包含：测试项、测试步骤、预期结果、回归验证范围
• 写完此文档后，必须暂停并交由用户进行二次人工审核确认。未经确认不得继续。

Step 5: 执行修改与经验记录

测试方案确认后，开始执行代码修改：

1. 按方案实施修改
2. 执行 npm run lint 进行类型检查
3. 如有必要，执行 npm run build 验证构建
4. 修改完成后，在以下文档中追加本次执行过程中的关键问题及解决方案：

.\工程分析\经验记录.md

• 记录格式（四段式）：
  • A. 具体问题
  • B. 产生问题原因
  • C. 解决问题方案
  • D. 后续如何避免问题

---

快捷入口

• 工程分析目录: C:\Users\Administrator\Downloads\Gemini-图文报告系统-V1.1\工程分析
• Gitea 远程地址: http://192.168.31.5:5002/admin/Mdeical_Sur_Report.git
• 类型检查命令: npm run lint
• 构建命令: npm run build