From de39b6a62635619c240fcbb68d2d94d76e95b38c Mon Sep 17 00:00:00 2001 From: ila <2+ila@noreply.git.ilapage.cn> Date: Wed, 26 Aug 2026 22:47:50 +0800 Subject: [PATCH] =?UTF-8?q?docs:=20=E8=AE=B0=E5=BD=95=E7=AE=A1=E7=90=86?= =?UTF-8?q?=E7=AB=AF=E7=B3=BB=E7=BB=9F=E7=AE=A1=E7=90=86=E5=AE=9E=E7=8E=B0?= =?UTF-8?q?=E4=B8=8E=E9=AA=8C=E8=AF=81=20(#67=20#68=20#69)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- Common-Changes.-.md | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/Common-Changes.-.md b/Common-Changes.-.md index e307705..6b2aecd 100644 --- a/Common-Changes.-.md +++ b/Common-Changes.-.md @@ -106,3 +106,13 @@ python dev_scripts/harness.py check --strict - 改变已确认原型的结构、流程、状态、权限或异常处理； - 真实上游测试可能反复消耗额度； - 无法判断风险或同一位置两次仍无根因。 + + +## 修改管理端系统模块 + +1. 导航名称、分组、路径或组件变化先修改版本化 migration，并保持 up/down 可验证；不要在运行时使用 AutoMigrate 或手工改共享库。 +2. 新系统页面必须同时核对 `sys_menu`、`sys_api`、`sys_menu_api_rule`、`sys_role_menu` 和 `sys_casbin_rule`。动态组件写为相对 `src/views` 的路径，不带 `@/views`、前导斜杠或 `.vue`。 +3. 菜单、接口和登录日志保持只读。需要新增写能力时必须另建工单并重新做权限、安全和 UI 设计，不得只恢复旧 API 模块中的函数。 +4. 管理员状态和角色保护必须在 service 层保留；修改时同时覆盖当前管理员、最后管理员、内置角色改名/停用/删除。 +5. 最小验证包括 Admin Go 全量测试、Admin UI lint/单测/生产构建、系统管理 Playwright E2E，以及 migration 静态测试。涉及 migration 时追加隔离 MySQL up/down/up。 +