docs: 记录管理端系统管理实现与验证 (#67 #68 #69)

2026-08-26 22:47:50 +08:00
parent 24b997f29b
commit de39b6a626
1 changed files with 10 additions and 0 deletions
@@ -106,3 +106,13 @@ python dev_scripts/harness.py check --strict
 - 改变已确认原型的结构、流程、状态、权限或异常处理；
 - 真实上游测试可能反复消耗额度；
 - 无法判断风险或同一位置两次仍无根因。
+
+<!-- issues-67-69-common-changes:start -->
+## 修改管理端系统模块
+
+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。
+<!-- issues-67-69-common-changes:end -->