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

80 lines
3.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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 全链路测试 |