From a5fc02e96d04200e5c51f9313634b50c4e5218c6 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Wed, 12 Aug 2026 16:37:26 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E5=AE=8C=E6=88=90=E4=BB=BB=E5=8A=A1=20?= =?UTF-8?q?#5=20=E9=AA=8C=E6=94=B6=E5=BD=92=E6=A1=A3?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- ...n%E6%8A%80%E6%9C%AF%E5%9F%BA%E7%BA%BF.-.md | 53 +++++++++++++------ 1 file changed, 36 insertions(+), 17 deletions(-) diff --git a/Task-5-%E5%86%BB%E7%BB%93Sense%E4%B8%8EBell-GoAdmin%E6%8A%80%E6%9C%AF%E5%9F%BA%E7%BA%BF.-.md b/Task-5-%E5%86%BB%E7%BB%93Sense%E4%B8%8EBell-GoAdmin%E6%8A%80%E6%9C%AF%E5%9F%BA%E7%BA%BF.-.md index dd2cf99..1003c2e 100644 --- a/Task-5-%E5%86%BB%E7%BB%93Sense%E4%B8%8EBell-GoAdmin%E6%8A%80%E6%9C%AF%E5%9F%BA%E7%BA%BF.-.md +++ b/Task-5-%E5%86%BB%E7%BB%93Sense%E4%B8%8EBell-GoAdmin%E6%8A%80%E6%9C%AF%E5%9F%BA%E7%BA%BF.-.md @@ -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 技术基线 \ No newline at end of file