规范 go-admin 默认模块精简与 UI 组件复用 #3

Closed
opened 2026-08-12 08:44:45 +08:00 by ila · 2 comments
Owner

基本信息

  • 类型:需求
  • 任务类型:协同
  • 主项目:根级
  • 主 agent:Codex
  • 所属 Epic:无
  • 所属 MVP / 版本:流程初始化
  • 阶段:实施

依赖与并行

  • 前置工单:无
  • 是否允许与前置工单并行:是
  • 原因:仅调整开发规则、长期文档和自动门禁,不依赖产品代码。

子项目影响

  • 仅影响的子项目 / 交付单元:Sense、Bell
  • 是否跨子项目:是(统一规则),但不修改共享产品接口或契约
  • 是否修改共享接口或契约:否;唯一事实来源:不适用
  • write_paths:AGENTS.md、Sense/AGENTS.md、Bell/AGENTS.md、dev_scripts/check_harness.py、tests/test_harness_docs.py、Gitea Wiki Development-Workflow 及其 docs/01-workflow.md 镜像
  • 各子项目需要执行的验证:Harness 严格检查、单元测试、Wiki 镜像一致性检查

协同接口

不适用。本工单不修改 contracts/、API、数据库或运行时集成。

原始需求

  • 来源:用户对话
  • 提出时间:2026-08-12
  • 关键原话或脱敏摘要:使用 go-admin 和 go-admin-ui 时尽量减少或隐藏不必要默认模块;新增页面优先复用已有组件,新增组件需保持整体风格一致。用户确认按建议建工单并实施。

要解决什么

为 Sense、Bell 使用 go-admin/go-admin-ui 建立统一的最小化和组件复用规则,避免默认菜单、路由、权限、接口造成产品噪音,也避免重复造组件或产生视觉交互割裂。

做什么 / 不做什么

  • 做:定义隐藏、禁用、删除的决策边界;规定配置/菜单权限/路由开关优先;规定页面复用与新组件一致性;增加验收要求和自动门禁;同步 Wiki 长期流程文档。
  • 不做:本工单不删除或修改任何实际默认模块,不重构 go-admin/go-admin-ui,不新增业务页面或 UI 组件。

已确认方案

  1. 不需要的默认模块采用最小可见、最小启用原则。
  2. 快速交付阶段优先通过配置、菜单权限和路由开关隐藏;涉及授权或安全时前后端一并禁用;永久删除必须另建清理工单并核对依赖、数据库、权限和升级影响。
  3. 新页面优先复用已有布局、表格、表单、弹窗、上传、权限和请求封装。
  4. 只有现有组件无法满足明确需求时新增组件,并保持颜色、字号、间距、交互反馈、命名和目录结构一致。
  5. 不为局部页面随意修改底层公共组件;产生全局或跨产品影响时另建协调工单。
  6. 验收检查无多余入口、无失效入口、无重复组件、视觉交互一致。

预计修改文件见 write_paths。

需求变化记录

无。

文档影响

  • 更新其他 Wiki 页面:Development-Workflow

交付文档影响

  • 无交付文档影响,原因:仅约束内部开发方式,不改变客户可见功能。

验收标准

  • 根规则明确默认模块隐藏/禁用/删除边界与组件复用原则。
  • Sense、Bell 子项目规则包含可执行的 go-admin/go-admin-ui 约束。
  • 明确全局公共组件改动和永久删除必须单独建单。
  • Harness 能检测关键规则丢失。
  • Wiki 长期文档与本地镜像一致。
  • 自动测试通过。

验证方式

  • python dev_scripts/check_harness.py --strict
  • python -m unittest discover -s tests -v
  • python -m compileall -q dev_scripts tests
  • python dev_scripts/sync_wiki_docs.py --check
  • git diff --check

风险和回退

风险低,仅修改开发规则和检查;若规则造成误判,可回退对应提交。实际模块删除、权限变化和业务 UI 修改不在本工单范围内。

## 基本信息 - 类型:需求 - 任务类型:协同 - 主项目:根级 - 主 agent:Codex - 所属 Epic:无 - 所属 MVP / 版本:流程初始化 - 阶段:实施 ## 依赖与并行 - 前置工单:无 - 是否允许与前置工单并行:是 - 原因:仅调整开发规则、长期文档和自动门禁,不依赖产品代码。 ## 子项目影响 - 仅影响的子项目 / 交付单元:Sense、Bell - 是否跨子项目:是(统一规则),但不修改共享产品接口或契约 - 是否修改共享接口或契约:否;唯一事实来源:不适用 - write_paths:`AGENTS.md`、`Sense/AGENTS.md`、`Bell/AGENTS.md`、`dev_scripts/check_harness.py`、`tests/test_harness_docs.py`、Gitea Wiki `Development-Workflow` 及其 `docs/01-workflow.md` 镜像 - 各子项目需要执行的验证:Harness 严格检查、单元测试、Wiki 镜像一致性检查 ## 协同接口 不适用。本工单不修改 `contracts/`、API、数据库或运行时集成。 ## 原始需求 - 来源:用户对话 - 提出时间:2026-08-12 - 关键原话或脱敏摘要:使用 go-admin 和 go-admin-ui 时尽量减少或隐藏不必要默认模块;新增页面优先复用已有组件,新增组件需保持整体风格一致。用户确认按建议建工单并实施。 ## 要解决什么 为 Sense、Bell 使用 go-admin/go-admin-ui 建立统一的最小化和组件复用规则,避免默认菜单、路由、权限、接口造成产品噪音,也避免重复造组件或产生视觉交互割裂。 ## 做什么 / 不做什么 - 做:定义隐藏、禁用、删除的决策边界;规定配置/菜单权限/路由开关优先;规定页面复用与新组件一致性;增加验收要求和自动门禁;同步 Wiki 长期流程文档。 - 不做:本工单不删除或修改任何实际默认模块,不重构 go-admin/go-admin-ui,不新增业务页面或 UI 组件。 ## 已确认方案 1. 不需要的默认模块采用最小可见、最小启用原则。 2. 快速交付阶段优先通过配置、菜单权限和路由开关隐藏;涉及授权或安全时前后端一并禁用;永久删除必须另建清理工单并核对依赖、数据库、权限和升级影响。 3. 新页面优先复用已有布局、表格、表单、弹窗、上传、权限和请求封装。 4. 只有现有组件无法满足明确需求时新增组件,并保持颜色、字号、间距、交互反馈、命名和目录结构一致。 5. 不为局部页面随意修改底层公共组件;产生全局或跨产品影响时另建协调工单。 6. 验收检查无多余入口、无失效入口、无重复组件、视觉交互一致。 预计修改文件见 `write_paths`。 ## 需求变化记录 无。 ## 文档影响 - [x] 更新其他 Wiki 页面:`Development-Workflow` ## 交付文档影响 - [x] 无交付文档影响,原因:仅约束内部开发方式,不改变客户可见功能。 ## 验收标准 - [ ] 根规则明确默认模块隐藏/禁用/删除边界与组件复用原则。 - [ ] Sense、Bell 子项目规则包含可执行的 go-admin/go-admin-ui 约束。 - [ ] 明确全局公共组件改动和永久删除必须单独建单。 - [ ] Harness 能检测关键规则丢失。 - [ ] Wiki 长期文档与本地镜像一致。 - [ ] 自动测试通过。 ## 验证方式 - `python dev_scripts/check_harness.py --strict` - `python -m unittest discover -s tests -v` - `python -m compileall -q dev_scripts tests` - `python dev_scripts/sync_wiki_docs.py --check` - `git diff --check` ## 风险和回退 风险低,仅修改开发规则和检查;若规则造成误判,可回退对应提交。实际模块删除、权限变化和业务 UI 修改不在本工单范围内。
Author
Owner

状态:待验收

实现已完成并推送。

  • 实现提交:6ff12e6
  • Pull Request:#4
  • Wiki 页面:Development-Workflow
  • Wiki revision:44720127496ee08289db439268708d6314705faf
  • 修改范围:根 AGENTS.md、Sense/Bell 子项目规则、Harness、测试和 Wiki 镜像
  • 严格 Harness:通过
  • 单元测试:28 项全部通过
  • Python 编译检查:通过
  • Wiki 镜像一致性:通过
  • Git 差异检查:通过

未验证部分:Sense、Bell 尚无实际业务页面,本工单只固化规则与门禁,未执行浏览器视觉验收或真实默认模块隐藏;后续页面工单按本规则验收。

等待用户验收;验收前不合并 PR、不关闭工单。

## 状态:待验收 实现已完成并推送。 - 实现提交:`6ff12e6` - Pull Request:https://git.ilapage.cn/ila/yovision/pulls/4 - Wiki 页面:`Development-Workflow` - Wiki revision:`44720127496ee08289db439268708d6314705faf` - 修改范围:根 `AGENTS.md`、Sense/Bell 子项目规则、Harness、测试和 Wiki 镜像 - 严格 Harness:通过 - 单元测试:28 项全部通过 - Python 编译检查:通过 - Wiki 镜像一致性:通过 - Git 差异检查:通过 **未验证部分**:Sense、Bell 尚无实际业务页面,本工单只固化规则与门禁,未执行浏览器视觉验收或真实默认模块隐藏;后续页面工单按本规则验收。 等待用户验收;验收前不合并 PR、不关闭工单。
Author
Owner

验收完成(2026-08-12)

  • 用户已明确验收通过。
  • PR #4 已按依赖顺序合并到 main。
  • 验收归档 Wiki:Task-3-GoAdmin默认模块精简与UI组件复用
  • Wiki revision:184eb46c0749(短哈希)
  • 本地镜像归档提交:be2c1e3
  • 工单状态:已完成。
## 验收完成(2026-08-12) - 用户已明确验收通过。 - PR #4 已按依赖顺序合并到 main。 - 验收归档 Wiki:`Task-3-GoAdmin默认模块精简与UI组件复用` - Wiki revision:`184eb46c0749`(短哈希) - 本地镜像归档提交:`be2c1e3` - 工单状态:已完成。
ila closed this issue 2026-08-12 16:40:32 +08:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: ila/yovision#3