docs: 完成任务 #5 验收归档
+36
-17
@@ -1,42 +1,61 @@
|
||||
# 5 冻结Sense与Bell GoAdmin技术基线
|
||||
# 5 冻结 Sense 与 Bell GoAdmin 技术基线
|
||||
|
||||
- 类型:需求 / 缺陷 / 重构
|
||||
- 所属 Epic:#
|
||||
- 所属 MVP / 版本:#
|
||||
- 状态:待验收 / 已完成
|
||||
- 类型:需求
|
||||
- 所属 Epic:无
|
||||
- 所属 MVP / 版本:技术基线
|
||||
- 状态:已完成
|
||||
- 日期:2026-08-12
|
||||
- 验收日期:2026-08-12
|
||||
- 验收结果:用户明确验收通过
|
||||
- Gitea 工单:https://git.ilapage.cn/ila/yovision/issues/5
|
||||
- Pull Request:https://git.ilapage.cn/ila/yovision/pulls/6
|
||||
- Wiki 页面:Task-5-冻结Sense与Bell-GoAdmin技术基线
|
||||
- Wiki revision:见本地镜像头
|
||||
|
||||
## 背景与目标
|
||||
|
||||
<!-- 原来有什么问题,这次达到什么结果。 -->
|
||||
把 Sense、Bell 共用的 GoAdmin 上游、工具链和本机只读参考源从口头约定固化为可复现、可检查的正式基线,避免两个产品从不同提交或运行时起步。
|
||||
|
||||
## 最终方案
|
||||
|
||||
<!-- 说明实际实现。与建单方案不同之处必须写清原因。 -->
|
||||
1. 根级 `goadmin-baseline.json` 是机器可读事实来源,远端 URL 与完整 commit 是可复现标识。
|
||||
2. go-admin 固定为 `f06540883b41d03782bb6b2c4150f298f328c6b6`,要求 Go 1.26.5。
|
||||
3. go-admin-ui 固定为 `67d393d713877572fab0b897296a4c1d525fc81d`,要求 Node.js 22.22.1、pnpm 9.15.1。
|
||||
4. go-admin-doc 固定为 `424855aacf6905f3fde860c3331385cb25529a0d`,仅用于理解框架用法。
|
||||
5. `D:\github\goadmin` 下三个仓库只读参考;产品代码必须分别进入 Sense、Bell。
|
||||
6. 派生上游代码保留 MIT 许可证与来源;任一上游或工具链升级必须建立 Sense/Bell 协同工单。
|
||||
7. Sense、Bell 从同一基线独立构建、发布,不形成隐藏共享实现。
|
||||
|
||||
与建单方案无差异。#5 原为叠加 PR;用户验收后先合并 #3/PR #4,再把 PR #6 调整到 `main` 并合并。
|
||||
|
||||
## 修改文件
|
||||
|
||||
- `<文件>`:<改动说明>
|
||||
- `goadmin-baseline.json`:记录上游和工具链精确版本、来源与许可证。
|
||||
- `AGENTS.md`、`Sense/AGENTS.md`、`Bell/AGENTS.md`:固化只读参考、派生、升级与构建规则。
|
||||
- `dev_scripts/check_harness.py`、`tests/test_harness_docs.py`:增加机器可读基线门禁和回归测试。
|
||||
- `docs/00-project-profile.md`、`docs/04-local-development-and-verification.md`:同步 Wiki 长期文档。
|
||||
|
||||
## 验收结果
|
||||
|
||||
| 验收标准 | 结果 |
|
||||
|---|---|
|
||||
| | 通过 / 未通过 |
|
||||
| 清单记录精确上游 commit、远端、分支、许可证和运行时版本 | 通过 |
|
||||
| 根及 Sense/Bell 规则明确只读参考、禁止原地开发和升级流程 | 通过 |
|
||||
| Wiki 说明固定版本、复现方式和环境要求 | 通过 |
|
||||
| commit 与 package version/tag 边界明确 | 通过 |
|
||||
| Harness 与测试覆盖关键字段 | 通过 |
|
||||
| 用户明确验收 | 通过(2026-08-12) |
|
||||
|
||||
## 测试
|
||||
|
||||
- 执行命令:`<命令>`
|
||||
- 结果:
|
||||
- **未验证部分**:<!-- 必填;没有就写“无”。 -->
|
||||
|
||||
## 遗留问题
|
||||
|
||||
<!-- 没有就删除本节。 -->
|
||||
- `python dev_scripts/check_harness.py --strict`:通过。
|
||||
- `python -m unittest discover -s tests -v`:31 项全部通过。
|
||||
- `python -m compileall -q dev_scripts tests`:通过。
|
||||
- `python dev_scripts/sync_wiki_docs.py --check`:通过。
|
||||
- `git diff --check`:通过。
|
||||
- **未验证部分**:#5 本身未初始化产品代码,因此未执行产品构建。验收后已在仓库外隔离准备并校验 Go 1.26.5;Node.js 22.22.1 可用,pnpm 9.15.1 可通过 Corepack 精确调用,供 #21 使用。
|
||||
|
||||
## 相关提交
|
||||
|
||||
- `<提交哈希>` <提交说明>
|
||||
- `7dac434` docs: freeze GoAdmin technical baseline (#5)
|
||||
- `8486d90` Merge pull request #6: 冻结 GoAdmin 技术基线
|
||||
Reference in New Issue
Block a user