主题
权限查询与分配
SYS-PERM-02 | 模块
system| 回答「当前用户有没有这个权限」,并支持按角色增量分配菜单。
1. 使用角色与场景
角色:管理员、终端用户
- 前端登录后拉取可访问菜单与按钮
- 角色编辑页回显已勾选菜单
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| GET | /system/permission/list-role-menus | system:permission:assign-role-menu | PermissionController#L35 | |
| POST | /system/permission/assign-role-menu | system:permission:assign-role-menu | 赋予角色菜单 | PermissionController#L41 |
| POST | /system/permission/assign-role-data-scope | system:permission:assign-role-data-scope | 赋予角色数据权限 | PermissionController#L53 |
| GET | /system/permission/list-user-roles | system:permission:assign-user-role | PermissionController#L63 | |
| POST | /system/permission/assign-user-role | system:permission:assign-user-role | PermissionController#L70 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/permission/PermissionController.java#L35 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/permission/RoleMenuDO.java |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/permission/MenuDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_role_menu | RoleMenuDO |
system_menu | MenuDO |
5. 机制与配置
- 权限判断走角色→菜单→权限标识链路,结果按用户缓存
- 超级管理员短路放行
6. 常见问题与排查
- 缓存未失效时前端看到的权限与后端实际判断可能不一致
7. 关联
- 需求原件:01-03-角色权限
- 相关卡片:SYS-ROLE-01
- 相关卡片:SYS-PERM-01