docs: 完成任务 #16 归档
@@ -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)
|
||||
|
||||
Reference in New Issue
Block a user