docs: archive tasks #3 and #5 acceptance

2026-08-12 16:40:14 +08:00
parent 8486d90001
commit be2c1e3c81
3 changed files with 146 additions and 0 deletions
@@ -0,0 +1,69 @@
+<!-- gitea-wiki-mirror:start -->
+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
+<!-- gitea-wiki-mirror:end -->
+
+# 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 精简与复用规则
@@ -0,0 +1,69 @@
+<!-- gitea-wiki-mirror:start -->
+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
+<!-- gitea-wiki-mirror:end -->
+
+# 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 技术基线
@@ -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"
    }
  ]
 }