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