docs: 完成任务 #16 归档

ila
2026-08-16 19:53:47 +08:00
parent 4057efd441
commit 7234d17b95
@@ -1,42 +1,60 @@
# 16 DevHarness 后续升级与基线记录
- 类型:需求 / 缺陷 / 重构
- 所属 Epic:#
- 所属 MVP / 版本:#
- 状态:待验收 / 已完成
- 类型:流程文档
- 状态:待验收
- 日期:2026-08-16
- Gitea 工单:http://ilaer.eicp.net:8418/opc/dev_harness/issues/16
- Wiki 页面:Task-16-DevHarness-后续升级与基线记录
- Wiki revision:见本地镜像头
- 本地镜像:按 #14 规则不自动导出
## 背景与目标
<!-- 原来有什么问题,这次达到什么结果。 -->
已有项目接入后,需要从明确的旧 DevHarness 基线安全升级到新基线,并保留目标项目自己的业务、安全和文档事实。每个采用 DevHarness 的业务项目必须记录来源仓库和当前基线完整提交哈希。
## 最终方案
<!-- 说明实际实现。与建单方案不同之处必须写清原因。 -->
- Project-Profile 新增“DevHarness 来源与基线”,记录来源仓库、当前基线提交、接入或升级日期和项目适配说明。
- 基线是 DevHarness 上游提交,不是业务项目自己的提交;禁止使用“最新版本”等动态描述。
- Existing-Project-Adoption-Guide 新增“后续升级”,规定基线比较、差异分类、目标项目建单、最小合并、Wiki-first、验证和验收更新记录。
- 来源不一致、基线不存在、目标提交不明确或项目规则冲突时停止并等待确认。
- 不增加自动升级脚本,不复制 DevHarness 工单、任务归档或项目事实。
## 修改文件
- `<文件>`:<改动说明>
- `docs/00-project-profile.md`:来源与基线记录要求。
- `docs/08-existing-project-adoption.md`:升级步骤、停止条件和可复制指令。
- `dev_scripts/check_harness.py`:新增章节的严格结构检查。
- `tests/test_harness_docs.py`:新增章节校验测试。
## 验收结果
| 验收标准 | 结果 |
|---|---|
| | 通过 / 未通过 |
| 接入指南包含“后续升级”及完整步骤 | 通过 |
| 每个业务项目必须记录来源仓库和完整基线提交 | 通过 |
| 明确差异分类、保护边界和停止条件 | 通过 |
| 未增加自动升级脚本或新流程框架 | 通过 |
| Wiki 与核心镜像一致 | 通过 |
| 严格检查和单元测试通过 | 通过 |
| 工单保持待验收 | 通过 |
## 测试
- 执行命令:`<命令>`
- 结果:
- **未验证部分**:<!-- 必填;没有就写“无”。 -->
- `python dev_scripts/check_harness.py --strict`:通过。
- `python -m unittest discover -s tests -v`:34 项全部通过。
- `python dev_scripts/sync_wiki_docs.py --check`:13 个核心页面全部一致。
- 人工检查:可从旧基线定位比较范围,分类采用、改写、冲突和不采用项,并明确验收后确认新基线。
- **未验证部分**:未在具体业务项目执行真实升级;本任务只定义和校验流程文档。
## Wiki 证据
- Project-Profile revision:`16456d6ed083197759d553b1033e3e5c8a6b8932`
- Existing-Project-Adoption-Guide revision:`2ef3d7cd26874f652e9bfab2a5c2f6c8273ab7ac`
## 遗留问题
<!-- 没有就删除本节。 -->
无。
## 相关提交
- `<提交哈希>` <提交说明>
- `947a068` docs: add DevHarness upgrade baseline guidance (#16)