Become a sponsor
6.2 角色管理
概述
角色（gin_role，租户级）是权限与数据范围的载体：向上关联用户（gin_user_role），向下关联菜单权限节点（gin_role_menu）。角色上配置的数据范围档位决定行级可见性。
功能清单
| 接口 | 说明 |
|---|---|
| Page / List / Detail | 标准查询 |
| Add / Update / Delete / BatchDelete | 标准维护 |
| MenuList | 获取菜单树（供权限勾选界面渲染） |
| SavePermission | 保存角色的菜单权限勾选（事务内重建 gin_role_menu） |
特色机制
- 数据范围档位（data_scope）：1 全部 / 2 本部门及以下 / 3 本部门 / 4 仅本人；多角色用户取最宽松
- 权限保存：SavePermission 为典型手写方法——事务内重建关联表，非标准五方法能表达
- 授权缓存联动：权限变更后，用户权限缓存（300 秒）到期或重新登录后生效
权限链路中的位置
text
角色勾选菜单节点 → gin_role_menu → LoadIdentity 装配权限集合 → Authz 校验管理界面
system/role：列表 + 编辑 + 权限树勾选（MenuList 渲染）+ 数据范围选择。