3.9 KiB
3.9 KiB
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.tsSYS_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 全链路测试 |