docs: add go-admin module and component reuse rules (#3)

ila
2026-08-12 08:46:29 +08:00
parent 8feb5cc67b
commit 4472012749
+20
@@ -230,3 +230,23 @@ python dev_scripts/new_task_archive.py 123 "修复登录超时"
| 测试结果与未验证内容 | 是 | 任务归档 | 镜像 |
| 提交哈希 | 是 | 任务归档 | 镜像 |
| 与具体代码版本绑定的说明 | 可链接 | 提供入口 | 是 |
## go-admin / go-admin-ui 开发约束
Sense、Bell 使用 go-admin 和 go-admin-ui 时,采用以下统一流程:
1. 先列出产品实际需要的菜单、路由、权限和接口,只呈现必要能力,框架演示页和无关管理模块不进入产品导航。
2. 快速交付阶段优先使用配置、菜单权限或路由开关隐藏模块。隐藏只代表用户看不到入口;涉及权限或安全时,还必须禁用对应后端访问能力并验证直接请求不可用。
3. 永久删除默认模块必须单独建立清理工单,核对代码依赖、数据库对象、权限记录、构建、框架升级和回退方式,不能混入普通业务页面工单。
4. 新页面先盘点并复用已有布局、表格、表单、弹窗、上传、权限控制和请求封装。只有现有组件无法满足明确需求时才新增组件,并在工单记录复用缺口。
5. 新组件沿用所属产品现有的颜色、字号、间距、状态反馈、交互方式、命名和目录结构,不建立独立于整体界面的视觉体系。
6. 单页需求不得直接改变底层公共组件的全局行为。确需全局修改时单独建单,列出受影响页面、兼容方式和回归测试;同时影响 Sense、Bell 时按协同工单处理。
验收至少检查:没有多余入口、没有可见但不可用的失效入口、没有重复实现已有组件,且新增页面与同类页面的视觉和交互一致。
这里的三个处理级别必须明确区分:
- 隐藏:保留代码与能力,只移除普通用户入口,便于快速交付和以后恢复。
- 禁用:前端入口与后端访问能力均不可用,适用于权限、安全或明确停用的能力。
- 删除:清理代码、依赖、数据对象和权限记录,风险较高,必须由独立清理工单实施。