diff --git a/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.-.md b/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.-.md index 8544046..a8c2bc1 100644 --- a/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.-.md +++ b/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.-.md @@ -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 精简与复用规则 \ No newline at end of file