Files
eip4-platform/docs/P1/F2-10系统管理写报告.md
2026-06-12 01:31:11 +08:00

3.9 KiB
Raw Blame History

F2-10 系统管理写操作 + 三维权限分配 完成报告

端点清单

platform-auth(AdminUserController)

方法 路径 说明
POST /api/admin/users/create 新建用户,初始密码 MD5("110")
POST /api/admin/users/{id}/update 编辑用户姓名(密码字段忽略)
POST /api/admin/users/{id}/toggle-state 停用(state=2)/启用(state=1),禁止停用 admin

platform-metadata(AdminWriteController)

方法 路径 说明
POST /api/admin/usergroups/create 新建用户组(名称唯一)
POST /api/admin/usergroups/{id}/update 编辑用户组名称/描述
POST /api/admin/usergroups/{id}/delete 物理删除 + 级联清关系表
POST /api/admin/usergroups/{id}/add-user 用户组加成员(幂等)
POST /api/admin/usergroups/{id}/remove-user 用户组减成员
POST /api/admin/usergroups/{id}/add-role 用户组加角色(幂等)
POST /api/admin/usergroups/{id}/remove-role 用户组减角色
POST /api/admin/roles/{id}/set-menus 角色菜单整存(差量 INSERT/DELETE,事务)

403 策略

所有写端点均调用 requireAdmin():检查当前 UserSession 的 userId='ADMIN' 或对应 account='admin',否则抛 ResponseStatusException(FORBIDDEN)。未登录同样返回 403。

三维权限分配页设计

  • 模板 ID:sys-admin-assign
  • 入库方式:docs/sql/F2-10_sys_admin_assign_upsert.sql(ON CONFLICT 幂等,已在 eip4dev + eip4m0 两库执行,version=2)
  • 前端入口:src/api/menu.ts SYS_ADMIN_ROOT 追加第 5 项

三栏布局(amis grid md=4+4+4):

  • 左栏:用户组列表(CRUD + 选中触发中栏刷新)
  • 中栏:该组的角色列表 + 该组的成员列表(双 service,sendOn 联动)
  • 右栏:选中角色的菜单权限树(input-tree,整存 set-menus)

附件:bug 修复记录

AdminController.buildMenuChildren 原逻辑递归时 rootMatch 要求叶子节点的 menuroot 字段非空,但数据库中叶子的 menuroot=null,导致 /api/admin/menu-all 返回的目录节点 childCount=0, children=[]。修复方式:当 parentId 非空(即查询子节点层)时跳过 rootMatch 检查,仅凭 parentId 定位。

闭环证据

全链路 E2E(手工 curl 验证)

1. 新建组: status=0 用户组新建成功
2. psql 建角色: INSERT 0 1
3. ceshi 加入组: status=0 成员添加成功
4. 角色加入组: status=0 角色关联成功
5. 叶子菜单 TEST_MENU_ID=b6d6be5a-6585-4f74-8378-121d36a4b0d1
6. 分配菜单: status=0 {'inserted':1,'deleted':0,'total':1}
7. 菜单可见: True ✓
8. 停用 ceshi: status=0;停用后登录 success=False ✓
9. 启用 ceshi: status=0;启用后登录 success=True ✓
10. 删除组: status=0 用户组删除成功
11. 清理后菜单消失: True ✓
403 负例: HTTP 403 ✓

Java 单元测试

  • platform-auth:16 passed(EngineContextIsolation + JwtService + SecurityProfile)
  • platform-metadata:142 passed,含 AdminWriteControllerTest 14 条(新增)

Playwright E2E

41 passed (38.1s),含:

  • sysadmin-write.spec.ts:3 个新测试全绿
    • F2-10 权限分配全链路(建组→加用户→角色→菜单→验可见→停用→重启→清理)
    • F2-10 角色菜单整存幂等
    • F2-10 非 admin 账号调用 createUsergroup → 403
  • schema-samples.spec.ts:27 个样本渲染全绿
  • 其他既有测试全部保持绿色

提交哈希

仓库 哈希 描述
eip4-platform afb9245 F2-10: 用户账号写端点(建用户/改密/停用启用)
eip4-platform 03067bb F2-10: 用户组/角色-菜单写端点 + 三维权限分配页 + menu-all 叶子层修复
eip4-web 70a0d92 F2-10: 分配页菜单入口 + sysadmin-write E2E 全链路测试