# 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 全链路测试 |