From 44720127496ee08289db439268708d6314705faf Mon Sep 17 00:00:00 2001
From: ila <2+ila@noreply.git.ilapage.cn>
Date: Wed, 12 Aug 2026 08:46:29 +0800
Subject: [PATCH] docs: add go-admin module and component reuse rules (#3)

---
 Development-Workflow.-.md | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)

diff --git a/Development-Workflow.-.md b/Development-Workflow.-.md
index 3383c25..ffcca38 100644
--- a/Development-Workflow.-.md
+++ b/Development-Workflow.-.md
@@ -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 时按协同工单处理。
+
+验收至少检查：没有多余入口、没有可见但不可用的失效入口、没有重复实现已有组件，且新增页面与同类页面的视觉和交互一致。
+
+这里的三个处理级别必须明确区分：
+
+- 隐藏：保留代码与能力，只移除普通用户入口，便于快速交付和以后恢复。
+- 禁用：前端入口与后端访问能力均不可用，适用于权限、安全或明确停用的能力。
+- 删除：清理代码、依赖、数据对象和权限记录，风险较高，必须由独立清理工单实施。
+