冻结 Sense/Bell GoAdmin 上游与工具链技术基线 #5

Closed
opened 2026-08-12 09:24:22 +08:00 by ila · 2 comments
Owner

基本信息

  • 类型:需求
  • 任务类型:协同
  • 主项目:根级
  • 主 agent:Codex
  • 所属 Epic:无
  • 所属 MVP / 版本:技术基线
  • 阶段:实施

依赖与并行

  • 前置工单:#3(仅合并顺序;实施与评审可并行)
  • 是否允许与前置工单并行:是
  • 原因:上游事实冻结可并行实施;由于 #3 已先更新同一组 Agent 规则和全局 Wiki,#5 使用堆叠 PR,必须先合并 #3/PR #4,再将 #5 PR 目标调整为 main。

子项目影响

  • 仅影响的子项目 / 交付单元:Sense、Bell
  • 是否跨子项目:是
  • 是否修改共享接口或契约:否;唯一事实来源:根级机器可读技术基线清单
  • write_paths:AGENTS.md、Sense/AGENTS.md、Bell/AGENTS.md、技术基线清单、dev_scripts/check_harness.py、tests/test_harness_docs.py、Wiki Project-Profile、Wiki Local-Development-and-Verification 及其镜像
  • 各子项目需要执行的验证:基线清单解析、Harness 严格检查、单元测试、Wiki 镜像一致性检查

协同接口

  • 生产者:根级技术基线
  • 消费者:Sense、Bell 骨架与后续升级工单
  • 契约/共享事实源:根级机器可读技术基线清单
  • 兼容策略:发布新版本
  • 被阻塞或需要适配的工单:后续 Sense/Bell 骨架工单
  • 集成顺序:先冻结并验证基线,再初始化两个产品骨架

原始需求

  • 来源:用户对话
  • 提出时间:2026-08-12
  • 关键原话或脱敏摘要:确认是否已固定 Go、go-admin、go-admin-ui 等版本,以及是否写明参考本机 D:\github\goadmin 下的 go-admin、go-admin-ui 和文档项目;用户要求建工单并实施。

要解决什么

把 Sense/Bell 共用的 GoAdmin 上游、工具链和只读参考源从口头约定变成可复现、可检查的正式基线,避免两个产品从不同提交或运行时开始。

做什么 / 不做什么

  • 做:记录三个上游仓库的远端、分支、commit、描述版本、许可证和本机只读参考路径;冻结 Go、Node、pnpm;明确 commit 优先于未同步的 package version/tag;更新 Wiki 和 Agent 规则;增加自动门禁。
  • 不做:不复制或修改 D:\github\goadmin,不初始化 Sense/Bell 产品代码,不升级上游,不声称当前 Go 环境已能构建要求 Go 1.26.5 的后端。

已确认方案

  • D:\github\goadmin 只作为本机只读参考位置,不是团队可复现标识;远端 URL + commit 是正式基线。
  • go-admin:f06540883b41d03782bb6b2c4150f298f328c6b6(v2.2.0-25-gf065408),要求 Go 1.26.5。
  • go-admin-ui:67d393d713877572fab0b897296a4c1d525fc81d(v2.0.9-170-g67d393d),Node 22.22.1,pnpm 9.15.1;package version 2.0.9 仅为上游元数据,不代替 commit。
  • go-admin-doc:424855aacf6905f3fde860c3331385cb25529a0d,仅作框架用法参考。
  • 三个仓库均为 MIT;复制上游代码时必须保留许可证和版权声明。
  • Sense、Bell 从同一冻结基线独立初始化、构建和发布;升级另建协同工单并回归两个产品。

文档影响

  • 更新项目档案或本地开发与验证
  • 更新其他 Wiki 页面:Project-Profile、Local-Development-and-Verification

交付文档影响

  • 无交付文档影响,原因:内部开发技术基线,不改变客户操作。

验收标准

  • 机器可读清单记录精确上游 commit、远端、分支、许可证和运行时版本。
  • 根及 Sense/Bell 规则明确只读参考源、禁止原地开发和升级流程。
  • Wiki 说明固定版本、复现方式和当前环境缺口。
  • 不把 tag/package version 误写成唯一基线。
  • Harness 和测试覆盖基线关键字段。
  • Wiki 镜像一致且自动验证通过。

验证方式

  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • python -m compileall -q dev_scripts tests
  • python dev_scripts/sync_wiki_docs.py --check
  • git diff --check

风险和回退

当前本机 Go 1.23.0 低于冻结上游要求的 Go 1.26.5,后端构建未验证;Sense/Bell 骨架实施前必须安装隔离的正确工具链。回退时撤销本工单提交,不修改三个只读参考仓库。

## 基本信息 - 类型:需求 - 任务类型:协同 - 主项目:根级 - 主 agent:Codex - 所属 Epic:无 - 所属 MVP / 版本:技术基线 - 阶段:实施 ## 依赖与并行 - 前置工单:#3(仅合并顺序;实施与评审可并行) - 是否允许与前置工单并行:是 - 原因:上游事实冻结可并行实施;由于 #3 已先更新同一组 Agent 规则和全局 Wiki,#5 使用堆叠 PR,必须先合并 #3/PR #4,再将 #5 PR 目标调整为 `main`。 ## 子项目影响 - 仅影响的子项目 / 交付单元:Sense、Bell - 是否跨子项目:是 - 是否修改共享接口或契约:否;唯一事实来源:根级机器可读技术基线清单 - write_paths:`AGENTS.md`、`Sense/AGENTS.md`、`Bell/AGENTS.md`、技术基线清单、`dev_scripts/check_harness.py`、`tests/test_harness_docs.py`、Wiki `Project-Profile`、Wiki `Local-Development-and-Verification` 及其镜像 - 各子项目需要执行的验证:基线清单解析、Harness 严格检查、单元测试、Wiki 镜像一致性检查 ## 协同接口 - 生产者:根级技术基线 - 消费者:Sense、Bell 骨架与后续升级工单 - 契约/共享事实源:根级机器可读技术基线清单 - 兼容策略:发布新版本 - 被阻塞或需要适配的工单:后续 Sense/Bell 骨架工单 - 集成顺序:先冻结并验证基线,再初始化两个产品骨架 ## 原始需求 - 来源:用户对话 - 提出时间:2026-08-12 - 关键原话或脱敏摘要:确认是否已固定 Go、go-admin、go-admin-ui 等版本,以及是否写明参考本机 `D:\github\goadmin` 下的 go-admin、go-admin-ui 和文档项目;用户要求建工单并实施。 ## 要解决什么 把 Sense/Bell 共用的 GoAdmin 上游、工具链和只读参考源从口头约定变成可复现、可检查的正式基线,避免两个产品从不同提交或运行时开始。 ## 做什么 / 不做什么 - 做:记录三个上游仓库的远端、分支、commit、描述版本、许可证和本机只读参考路径;冻结 Go、Node、pnpm;明确 commit 优先于未同步的 package version/tag;更新 Wiki 和 Agent 规则;增加自动门禁。 - 不做:不复制或修改 `D:\github\goadmin`,不初始化 Sense/Bell 产品代码,不升级上游,不声称当前 Go 环境已能构建要求 Go 1.26.5 的后端。 ## 已确认方案 - `D:\github\goadmin` 只作为本机只读参考位置,不是团队可复现标识;远端 URL + commit 是正式基线。 - go-admin:`f06540883b41d03782bb6b2c4150f298f328c6b6`(`v2.2.0-25-gf065408`),要求 Go 1.26.5。 - go-admin-ui:`67d393d713877572fab0b897296a4c1d525fc81d`(`v2.0.9-170-g67d393d`),Node 22.22.1,pnpm 9.15.1;package version 2.0.9 仅为上游元数据,不代替 commit。 - go-admin-doc:`424855aacf6905f3fde860c3331385cb25529a0d`,仅作框架用法参考。 - 三个仓库均为 MIT;复制上游代码时必须保留许可证和版权声明。 - Sense、Bell 从同一冻结基线独立初始化、构建和发布;升级另建协同工单并回归两个产品。 ## 文档影响 - [x] 更新项目档案或本地开发与验证 - [x] 更新其他 Wiki 页面:`Project-Profile`、`Local-Development-and-Verification` ## 交付文档影响 - [x] 无交付文档影响,原因:内部开发技术基线,不改变客户操作。 ## 验收标准 - [ ] 机器可读清单记录精确上游 commit、远端、分支、许可证和运行时版本。 - [ ] 根及 Sense/Bell 规则明确只读参考源、禁止原地开发和升级流程。 - [ ] Wiki 说明固定版本、复现方式和当前环境缺口。 - [ ] 不把 tag/package version 误写成唯一基线。 - [ ] Harness 和测试覆盖基线关键字段。 - [ ] Wiki 镜像一致且自动验证通过。 ## 验证方式 - `python dev_scripts/check_harness.py --strict` - `python -m unittest discover -s tests -v` - `python -m compileall -q dev_scripts tests` - `python dev_scripts/sync_wiki_docs.py --check` - `git diff --check` ## 风险和回退 当前本机 Go 1.23.0 低于冻结上游要求的 Go 1.26.5,后端构建未验证;Sense/Bell 骨架实施前必须安装隔离的正确工具链。回退时撤销本工单提交,不修改三个只读参考仓库。
Author
Owner

状态:待验收

技术基线已冻结并推送。

  • 实现提交:7dac434
  • Pull Request:#6
  • PR 类型:堆叠 PR,当前目标为 #3 分支;先合并 PR #4,再调整本 PR 到 main
  • Wiki Project-Profile revision:5561227400539f0a3ba7713be16c171feb811fcb
  • Wiki Local-Development-and-Verification revision:1eb27d082ebf892343c9a5eed6f9363363234903
  • 严格 Harness:通过
  • 单元测试:31 项全部通过
  • Python 编译检查:通过
  • Wiki 镜像一致性:通过

未验证部分:本机 Go 1.23.0 不满足冻结的 Go 1.26.5;pnpm 尚未安装,因此未执行 go-admin 后端和 go-admin-ui 前端构建。本工单没有初始化产品代码。

等待用户验收;验收前不合并 PR、不关闭工单。

## 状态:待验收 技术基线已冻结并推送。 - 实现提交:`7dac434` - Pull Request:https://git.ilapage.cn/ila/yovision/pulls/6 - PR 类型:堆叠 PR,当前目标为 #3 分支;先合并 PR #4,再调整本 PR 到 `main` - Wiki `Project-Profile` revision:`5561227400539f0a3ba7713be16c171feb811fcb` - Wiki `Local-Development-and-Verification` revision:`1eb27d082ebf892343c9a5eed6f9363363234903` - 严格 Harness:通过 - 单元测试:31 项全部通过 - Python 编译检查:通过 - Wiki 镜像一致性:通过 **未验证部分**:本机 Go 1.23.0 不满足冻结的 Go 1.26.5;pnpm 尚未安装,因此未执行 go-admin 后端和 go-admin-ui 前端构建。本工单没有初始化产品代码。 等待用户验收;验收前不合并 PR、不关闭工单。
Author
Owner

验收完成(2026-08-12)

  • 用户已明确验收通过。
  • PR #6 已按依赖顺序合并到 main。
  • 验收归档 Wiki:Task-5-冻结Sense与Bell-GoAdmin技术基线
  • Wiki revision:a5fc02e96d04(短哈希)
  • 本地镜像归档提交:be2c1e3
  • 工单状态:已完成。
## 验收完成(2026-08-12) - 用户已明确验收通过。 - PR #6 已按依赖顺序合并到 main。 - 验收归档 Wiki:`Task-5-冻结Sense与Bell-GoAdmin技术基线` - Wiki revision:`a5fc02e96d04`(短哈希) - 本地镜像归档提交:`be2c1e3` - 工单状态:已完成。
ila closed this issue 2026-08-12 16:40:35 +08:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ila/yovision#5