80 lines
3.9 KiB
Markdown
80 lines
3.9 KiB
Markdown
# 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 全链路测试 |
|