65 lines
2.9 KiB
Markdown
65 lines
2.9 KiB
Markdown
# 需求分析 - 2026-04-28-22-55-15
|
||
|
||
## 需求来源
|
||
- 提出时间: 2026-04-28-22-55-15
|
||
- 需求类型: 工程管理 / 流程建设
|
||
|
||
## 原始需求描述
|
||
用户要求建立一套完整的代码编纂工作流，后续所有项目修改相关需求都必须按照此工作流执行。具体要求如下：
|
||
|
||
1. 每次执行前记录问题开始时间 `{Year}-{Mon}-{Day}-{Hour}-{Min}-{Sec}`
|
||
2. 阅读或创建 `./工程分析` 文件夹，存放工程整体分析
|
||
3. 每次需求整理写入 `./工程分析/需求分析-{timestamp}.md`
|
||
4. 每次实现方案写入 `./工程分析/实现方案-{timestamp}.md`（需人工审核确认）
|
||
5. 每次测试方案写入 `./工程分析/测试方案-{timestamp}.md`（需人工审核确认）
|
||
6. 执行前阅读 `./工程分析/经验记录.md` 防止犯错；执行后在经验记录中按 A/B/C/D 四段式记录关键问题
|
||
7. 最终执行后对文档使用 gitea 进行备份 commit（含时间戳和修改简述），并提醒用户
|
||
8. 重新部署本项目
|
||
|
||
Gitea 备份方式：
|
||
- 仓库地址: `http://192.168.31.5:5002/admin/Seg_Server.git`
|
||
- 推送到 main 分支
|
||
|
||
## 需求拆解
|
||
|
||
### 需求 1: 创建工作流主文档
|
||
- **详细描述**: 编写 `代码编纂工作流.md`，定义完整的 10 阶段流程及各阶段规范
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: `./工程分析/代码编纂工作流.md`
|
||
- **验收标准**: 文档包含所有阶段定义、模板、检查表和特殊情况处理
|
||
|
||
### 需求 2: 创建项目整体分析文档
|
||
- **详细描述**: 编写 `项目整体分析.md`，汇总项目技术栈、目录结构、API、已知问题等
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: `./工程分析/项目整体分析.md`
|
||
- **验收标准**: 文档能完整反映当前项目状态，便于快速理解项目
|
||
|
||
### 需求 3: 创建经验记录文档
|
||
- **详细描述**: 创建 `经验记录.md` 初始版本，定义四段式记录格式
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: `./工程分析/经验记录.md`
|
||
- **验收标准**: 文档包含格式规范和初始经验条目
|
||
|
||
### 需求 4: Gitea 备份提交
|
||
- **详细描述**: 将所有新增的工作流文档提交到 gitea 仓库
|
||
- **优先级**: P0-阻塞
|
||
- **影响范围**: Git 仓库
|
||
- **验收标准**: 成功 push 到 `http://192.168.31.5:5002/admin/Seg_Server.git` 的 main 分支
|
||
|
||
### 需求 5: 重新部署项目
|
||
- **详细描述**: 确保项目构建和运行正常
|
||
- **优先级**: P1-高
|
||
- **影响范围**: 项目运行状态
|
||
- **验收标准**: `npm run build` 成功，服务可正常启动
|
||
|
||
## 约束条件
|
||
- 文档全部使用中文
|
||
- commit 格式需包含时间戳和修改简述
|
||
- 不修改现有业务代码（纯流程建设）
|
||
|
||
## 风险评估
|
||
| 风险点 | 影响 | 缓解措施 |
|
||
|--------|------|----------|
|
||
| gitea 远程仓库不可达 | 高 | 提前测试连通性 |
|
||
| .gitignore 遗漏工程分析文档 | 中 | 确认文档未被排除 |
|