From 2bb60b79073439babfda05140ce813d197de81d9 Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Fri, 14 Aug 2026 09:05:28 +0800 Subject: [PATCH] =?UTF-8?q?=E5=A2=9E=E5=8A=A0=20dev/main=20=E5=AE=A1?= =?UTF-8?q?=E6=A0=B8=E9=97=A8=E7=A6=81=E4=B8=8E=20GoAdmin=20=E6=B4=BE?= =?UTF-8?q?=E7=94=9F=E8=A7=84=E5=88=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Development-Workflow.-.md | 40 ++++++++++++++++++++++++++++++++------- 1 file changed, 33 insertions(+), 7 deletions(-) diff --git a/Development-Workflow.-.md b/Development-Workflow.-.md index ffcca38..1a7f93b 100644 --- a/Development-Workflow.-.md +++ b/Development-Workflow.-.md @@ -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/-sense-... +├── feature/-brain-... +├── feature/-bell-... +└── coordination/-... + │ + └── PR + 测试 → dev → 用户明确审核 → main +``` + +- `explore` 仅供对照、迁移和回退，不继续开发。 +- `main` 只接收用户明确审核通过的 `dev` 结果；禁止直接在 `main` 修改、提交或推送。 +- 新任务分支必须从当前 `dev` 创建，实施完成后 PR 目标为 `dev`。 +- Agent 的“待验收”不等于允许进入 `main`；只有用户明确审核/验收通过才可执行 `dev → main`。 +- 紧急修复也必须建单并取得用户对分支与合并路径的明确授权，不默认绕过 `dev`。