REVOXELSEG_DICOM/工程分析/实现方案-2026-05-24-10-09-37.md

实现方案-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 服务可访问。