docs: 完成任务 #3 验收归档

2026-08-12 16:35:37 +08:00
parent 5f768b6527
commit 184eb46c07
1 changed files with 36 additions and 17 deletions
@@ -1,42 +1,61 @@
-# 3 GoAdmin默认模块精简与UI组件复用
+# 3 GoAdmin 默认模块精简与 UI 组件复用

- 类型：需求 / 缺陷 / 重构
- 所属 Epic：#
- 所属 MVP / 版本：#
- 状态：待验收 / 已完成
+- 类型：需求
+- 所属 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 精简与复用规则