72 lines
2.5 KiB
Markdown
72 lines
2.5 KiB
Markdown
# 项目修改工作流指南
|
|
|
|
> 本工作流适用于所有项目修改相关需求。每次收到修改需求时，必须严格按照以下步骤执行。
|
|
|
|
---
|
|
|
|
## 工作流步骤
|
|
|
|
### Step 0: 备份与记录时间戳
|
|
每次执行前，必须先用 Gitea 进行代码备份，并记录问题开始时间：
|
|
- 时间戳格式：`{Year}-{Mon}-{Day}-{Hour}-{Min}-{Sec}`
|
|
- 备份命令：
|
|
```bash
|
|
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`
|