增加 dev/main 审核门禁与 GoAdmin 派生规则

2026-08-14 09:05:28 +08:00
parent d32f00a86b
commit 2bb60b7907
1 changed files with 33 additions and 7 deletions
@@ -233,14 +233,19 @@ python dev_scripts/new_task_archive.py 123 "修复登录超时"

 ## go-admin / go-admin-ui 开发约束

-Sense、Bell 使用 go-admin 和 go-admin-ui 时，采用以下统一流程：
+Sense、Bell 使用 go-admin 和 go-admin-ui 时，采用以下统一流程。“基于 GoAdmin”必须是源码派生，不得解释为仅参考技术栈、目录、页面风格或交互：

-1. 先列出产品实际需要的菜单、路由、权限和接口，只呈现必要能力，框架演示页和无关管理模块不进入产品导航。
-2. 快速交付阶段优先使用配置、菜单权限或路由开关隐藏模块。隐藏只代表用户看不到入口；涉及权限或安全时，还必须禁用对应后端访问能力并验证直接请求不可用。
-3. 永久删除默认模块必须单独建立清理工单，核对代码依赖、数据库对象、权限记录、构建、框架升级和回退方式，不能混入普通业务页面工单。
-4. 新页面先盘点并复用已有布局、表格、表单、弹窗、上传、权限控制和请求封装。只有现有组件无法满足明确需求时才新增组件，并在工单记录复用缺口。
-5. 新组件沿用所属产品现有的颜色、字号、间距、状态反馈、交互方式、命名和目录结构，不建立独立于整体界面的视觉体系。
-6. 单页需求不得直接改变底层公共组件的全局行为。确需全局修改时单独建单，列出受影响页面、兼容方式和回归测试；同时影响 Sense、Bell 时按协同工单处理。
+1. 初始化时从 `goadmin-baseline.json` 指定的 go-admin、go-admin-ui 完整 commit 导入/派生产品源码，保留 MIT 许可证、版权和来源清单；不得以自建 `net/http`、自建认证/RBAC 或仅使用 Vue + Element Plus 替代上游骨架。
+2. 实施工单开始前必须核对冻结 go-admin-doc，并在工单证据中记录参考的文档主题或文件；文档只解释上游用法，不改变本项目需求事实源。
+
+在满足上述来源门禁后：
+
+3. 先列出产品实际需要的菜单、路由、权限和接口，只呈现必要能力，框架演示页和无关管理模块不进入产品导航。
+4. 快速交付阶段优先使用配置、菜单权限或路由开关隐藏模块。隐藏只代表用户看不到入口；涉及权限或安全时，还必须禁用对应后端访问能力并验证直接请求不可用。
+5. 永久删除默认模块必须单独建立清理工单，核对代码依赖、数据库对象、权限记录、构建、框架升级和回退方式，不能混入普通业务页面工单。
+6. 新页面先盘点并复用已有布局、表格、表单、弹窗、上传、权限控制和请求封装。只有现有组件无法满足明确需求时才新增组件，并在工单记录复用缺口。
+7. 新组件沿用所属产品现有的颜色、字号、间距、状态反馈、交互方式、命名和目录结构，不建立独立于整体界面的视觉体系。
+8. 单页需求不得直接改变底层公共组件的全局行为。确需全局修改时单独建单，列出受影响页面、兼容方式和回归测试；同时影响 Sense、Bell 时按协同工单处理。

 验收至少检查：没有多余入口、没有可见但不可用的失效入口、没有重复实现已有组件，且新增页面与同类页面的视觉和交互一致。

@@ -250,3 +255,24 @@ Sense、Bell 使用 go-admin 和 go-admin-ui 时，采用以下统一流程：
 - 禁用：前端入口与后端访问能力均不可用，适用于权限、安全或明确停用的能力。
 - 删除：清理代码、依赖、数据对象和权限记录，风险较高，必须由独立清理工单实施。

+
+
+## 分支模型与审核门禁
+
+```text
+explore（旧实现只读快照）
+
+dev
+├── feature/<issue>-sense-...
+├── feature/<issue>-brain-...
+├── feature/<issue>-bell-...
+└── coordination/<issue>-...
+        │
+        └── PR + 测试 → dev → 用户明确审核 → main
+```
+
+- `explore` 仅供对照、迁移和回退，不继续开发。
+- `main` 只接收用户明确审核通过的 `dev` 结果；禁止直接在 `main` 修改、提交或推送。
+- 新任务分支必须从当前 `dev` 创建，实施完成后 PR 目标为 `dev`。
+- Agent 的“待验收”不等于允许进入 `main`；只有用户明确审核/验收通过才可执行 `dev → main`。
+- 紧急修复也必须建单并取得用户对分支与合并路径的明确授权，不默认绕过 `dev`。