62 lines
2.4 KiB
Markdown
62 lines
2.4 KiB
Markdown
# 实现方案-2026-05-24-10-09-37
|
|
|
|
## 实现方案文档路径
|
|
|
|
`工程分析/实现方案-2026-05-24-10-09-37.md`
|
|
|
|
## 修改目标
|
|
|
|
- 精简 `工程分析/` 中历史 `需求分析-*`、`实现方案-*`、`测试方案-*` 等流水文档。
|
|
- 保留核心工程约束、整体分析、经验记录和本次流程记录。
|
|
- 更新工作流，明确历史三件套不再作为长期堆积物，长期经验以 `经验记录.md` 为准。
|
|
|
|
## 涉及路径
|
|
|
|
- `工程分析/代码编纂工作流.md`
|
|
- `工程分析/需求分析-2026-05-24-10-09-37.md`
|
|
- `工程分析/实现方案-2026-05-24-10-09-37.md`
|
|
- `工程分析/测试方案-2026-05-24-10-09-37.md`
|
|
- `工程分析/经验记录.md`
|
|
- 历史 `工程分析/需求分析-*.md`
|
|
- 历史 `工程分析/实现方案-*.md`
|
|
- 历史 `工程分析/测试方案-*.md`
|
|
- `工程分析/系统功能描述-2026-05-23-00-32-26.md`
|
|
|
|
## 技术路线
|
|
|
|
1. 按既有工作流创建本次三件套文档。
|
|
2. 更新 `代码编纂工作流.md`，加入工程分析目录精简策略。
|
|
3. 删除历史三件套和一次性说明文档，保留核心文档、本次三件套和经验记录。
|
|
4. 追加经验记录，记录本次目录治理策略。
|
|
5. 做静态检查、构建检查和部署验证。
|
|
|
|
## 执行步骤
|
|
|
|
1. 记录开始时间并阅读工作流、整体分析、经验记录。
|
|
2. 写入本次需求分析、实现方案和测试方案。
|
|
3. 再次确认已读 `经验记录.md`。
|
|
4. 执行历史文档删除，只保留核心文件与本次三件套。
|
|
5. 更新工作流中的精简策略。
|
|
6. 执行 `npm run lint` 和 `npm run build`。
|
|
7. 沿用或重启 `tmux` 服务并验证本机与公网入口。
|
|
8. 暂存本次文档治理变更，提交并推送 Gitea。
|
|
|
|
## 兼容性与回滚方案
|
|
|
|
- 删除的历史文档仍可通过 Git 历史恢复。
|
|
- 若后续需要某次详细需求，可按 commit 或文件名从历史版本查找。
|
|
- 本次不修改业务源码，程序回滚风险低。
|
|
|
|
## 预计文件变更
|
|
|
|
- 删除大量历史 `需求分析-*`、`实现方案-*`、`测试方案-*` 文档。
|
|
- 删除一次性的 `系统功能描述-2026-05-23-00-32-26.md`。
|
|
- 新增本次三件套。
|
|
- 更新 `代码编纂工作流.md` 与 `经验记录.md`。
|
|
|
|
## 提交与部署策略
|
|
|
|
- 提交信息：`2026-05-24-10-09-37 精简工程分析文档`。
|
|
- 提交范围限定为 `工程分析/` 文档治理变更。
|
|
- 部署验证沿用项目约定：`npm run build` 后确认当前 `tmux`/frpc 服务可访问。
|