主题
角色管理
SYS-ROLE-01 | 模块
system| 把权限打包成角色,实现「按岗位授权」而不是「按人授权」。
1. 使用角色与场景
角色:管理员
- 为财务、项目经理分别建角色并勾选菜单
- 给角色批量分配用户
2. 接口与权限点
| 方法 | 路径 | 权限点 | 摘要 | 代码行 |
|---|---|---|---|---|
| POST | /system/role/create | system:role:create | 创建角色 | RoleController#L42 |
| PUT | /system/role/update | system:role:update | 修改角色 | RoleController#L49 |
| DELETE | /system/role/delete | system:role:delete | 删除角色 | RoleController#L57 |
| DELETE | /system/role/delete-list | system:role:delete | 批量删除角色 | RoleController#L66 |
| GET | /system/role/get | system:role:query | 获得角色信息 | RoleController#L75 |
| GET | /system/role/page | system:role:query | 获得角色分页 | RoleController#L83 |
| GET | /system/role/list-all-simple | — | 获取角色精简信息列表 | RoleController#L91 |
| GET | /system/role/simple-list | — | 获取角色精简信息列表 | RoleController#L91 |
| GET | /system/role/export-excel | system:role:export | 导出角色 Excel | RoleController#L99 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/permission/RoleController.java#L42 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/permission/RoleDO.java |
| 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/UserRoleDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_role | RoleDO |
system_role_menu | RoleMenuDO |
system_user_role | UserRoleDO |
5. 机制与配置
- 角色-菜单为多对多;权限判断时取角色集合再校验菜单
- 超管角色绕过权限校验
6. 常见问题与排查
- 改完权限要清缓存,否则用户仍按旧权限放行
7. 关联
- 需求原件:01-03-角色权限
- 相关卡片:SYS-PERM-01
- 相关卡片:SYS-PERM-02