From be2c1e3c81131b51ee9fba67394ae9928e41104c Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Wed, 12 Aug 2026 16:40:06 +0800 Subject: [PATCH] docs: archive tasks #3 and #5 acceptance --- ...dmin默认模块精简与UI组件复用.md | 69 +++++++++++++++++++ ...-冻结Sense与Bell-GoAdmin技术基线.md | 69 +++++++++++++++++++ wiki-docs.json | 8 +++ 3 files changed, 146 insertions(+) create mode 100644 docs/task/3-GoAdmin默认模块精简与UI组件复用.md create mode 100644 docs/task/5-冻结Sense与Bell-GoAdmin技术基线.md diff --git a/docs/task/3-GoAdmin默认模块精简与UI组件复用.md b/docs/task/3-GoAdmin默认模块精简与UI组件复用.md new file mode 100644 index 0000000..3d179c2 --- /dev/null +++ b/docs/task/3-GoAdmin默认模块精简与UI组件复用.md @@ -0,0 +1,69 @@ + +generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) +wiki_page: Task-3-GoAdmin默认模块精简与UI组件复用 +wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-3-GoAdmin%E9%BB%98%E8%AE%A4%E6%A8%A1%E5%9D%97%E7%B2%BE%E7%AE%80%E4%B8%8EUI%E7%BB%84%E4%BB%B6%E5%A4%8D%E7%94%A8.- +wiki_revision: 184eb46c074967590361b45e0eeb001eafbc84f2 +synchronized_at: 2026-08-12T08:38:41Z + + +# 3 GoAdmin 默认模块精简与 UI 组件复用 + +- 类型：需求 +- 所属 Epic：无 +- 所属 MVP / 版本：流程初始化 +- 状态：已完成 +- 日期：2026-08-12 +- 验收日期：2026-08-12 +- 验收结果：用户明确验收通过 +- Gitea 工单：https://git.ilapage.cn/ila/yovision/issues/3 +- Pull Request：https://git.ilapage.cn/ila/yovision/pulls/4 +- Wiki 页面：Task-3-GoAdmin默认模块精简与UI组件复用 +- Wiki revision：见本地镜像头 + +## 背景与目标 + +为 Sense、Bell 使用 go-admin/go-admin-ui 建立统一的最小化和组件复用规则，避免默认菜单、路由、权限与接口造成产品噪音，同时避免重复组件和视觉交互割裂。 + +## 最终方案 + +1. Sense、Bell 均遵循“最小可见、最小启用”；快速交付优先使用配置、菜单权限和路由开关隐藏无关能力。 +2. 涉及权限或安全时同时关闭前端入口和后端访问；永久删除默认模块必须单独建单并核对依赖、数据库、权限和升级影响。 +3. 新页面优先复用现有布局、表格、表单、弹窗、上传、权限控制和请求封装。 +4. 新组件只在现有组件无法满足明确业务需求时建立，并保持颜色、字号、间距、反馈、命名和目录结构一致。 +5. 局部页面不得擅自改变公共组件全局行为；全局或跨产品影响升级为独立/协同工单。 +6. UI 验收检查无多余入口、无失效入口、无重复实现且视觉交互一致。 + +与建单方案无差异。 + +## 修改文件 + +- `AGENTS.md`：增加 GoAdmin 精简、复用和变更边界。 +- `Sense/AGENTS.md`、`Bell/AGENTS.md`：增加产品侧可执行约束。 +- `dev_scripts/check_harness.py`：增加规则门禁。 +- `tests/test_harness_docs.py`：增加回归测试。 +- `docs/01-workflow.md`：同步 Wiki 长期流程文档。 + +## 验收结果 + +| 验收标准 | 结果 | +|---|---| +| 根规则明确隐藏、禁用、删除边界与组件复用原则 | 通过 | +| Sense、Bell 子项目规则包含可执行约束 | 通过 | +| 全局公共组件改动和永久删除需单独建单 | 通过 | +| Harness 能检测关键规则丢失 | 通过 | +| Wiki 与镜像一致 | 通过 | +| 用户明确验收 | 通过（2026-08-12） | + +## 测试 + +- `python dev_scripts/check_harness.py --strict`：通过。 +- `python -m unittest discover -s tests -v`：28 项全部通过。 +- `python -m compileall -q dev_scripts tests`：通过。 +- `python dev_scripts/sync_wiki_docs.py --check`：通过。 +- `git diff --check`：通过。 +- **未验证部分**：规则实施时 Sense、Bell 尚无实际业务页面，未执行浏览器视觉验收或真实默认模块隐藏；后续页面工单按本规则验收。 + +## 相关提交 + +- `6ff12e6` docs: define go-admin UI reuse rules (#3) +- `2285fb0` Merge pull request #4: GoAdmin UI 精简与复用规则 diff --git a/docs/task/5-冻结Sense与Bell-GoAdmin技术基线.md b/docs/task/5-冻结Sense与Bell-GoAdmin技术基线.md new file mode 100644 index 0000000..872e2ca --- /dev/null +++ b/docs/task/5-冻结Sense与Bell-GoAdmin技术基线.md @@ -0,0 +1,69 @@ + +generated: true (请先修改 Gitea Wiki，禁止直接编辑本文件) +wiki_page: Task-5-冻结Sense与Bell-GoAdmin技术基线 +wiki_url: https://git.ilapage.cn/ila/yovision/wiki/Task-5-%E5%86%BB%E7%BB%93Sense%E4%B8%8EBell-GoAdmin%E6%8A%80%E6%9C%AF%E5%9F%BA%E7%BA%BF.- +wiki_revision: a5fc02e96d04200e5c51f9313634b50c4e5218c6 +synchronized_at: 2026-08-12T08:38:44Z + + +# 5 冻结 Sense 与 Bell GoAdmin 技术基线 + +- 类型：需求 +- 所属 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 技术基线 diff --git a/wiki-docs.json b/wiki-docs.json index ac296de..b62855a 100644 --- a/wiki-docs.json +++ b/wiki-docs.json @@ -75,6 +75,14 @@ { "page": "Task-1-三项目并行建单与协同工单顺序", "path": "docs/task/1-三项目并行建单与协同工单顺序.md" + }, + { + "page": "Task-3-GoAdmin默认模块精简与UI组件复用", + "path": "docs/task/3-GoAdmin默认模块精简与UI组件复用.md" + }, + { + "page": "Task-5-冻结Sense与Bell-GoAdmin技术基线", + "path": "docs/task/5-冻结Sense与Bell-GoAdmin技术基线.md" } ] }