用户组管理
用户组管理提供用户组的完整 CRUD 操作,以及用户组-角色的分配管理。用户组是 RBAC 模型中的中间层,通过"用户→组→角色→权限"链路简化权限管理。
功能说明
- 用户组分页查询
- 用户组新增 / 修改 / 删除(支持批量)
- 用户组详情查看
- 用户组角色分配
- 数据导出(Excel)
- 导入模板下载
- 数据导入(Excel)
API 接口
所有接口均需要 sys:group:* 权限。
| 方法 | 路径 | 权限标识 | 说明 |
|---|---|---|---|
| GET | /api/v1/sys/group/page | sys:group:page | 获取用户组分页 |
| POST | /api/v1/sys/group/create | sys:group:create | 添加用户组 |
| POST | /api/v1/sys/group/modify | sys:group:modify | 编辑用户组 |
| POST | /api/v1/sys/group/remove | sys:group:remove | 删除用户组 |
| GET | /api/v1/sys/group/detail | sys:group:detail | 获取用户组详情 |
| GET | /api/v1/sys/group/export | sys:group:export | 导出用户组数据 |
| GET | /api/v1/sys/group/template | sys:group:template | 下载导入模板 |
| POST | /api/v1/sys/group/import | sys:group:import | 导入用户组数据 |
| POST | /api/v1/sys/group/grant-role | sys:group:grant-role | 分配用户组角色 |
| GET | /api/v1/sys/group/own-roles | sys:group:own-roles | 获取用户组已分配的角色 ID 列表 |
数据模型
sys_group
| 字段 | 类型 | 说明 |
|---|---|---|
| id | VARCHAR(32) | 主键(雪花ID) |
| name | VARCHAR(64) | 用户组名称 |
| code | VARCHAR(64) | 用户组编码 |
| status | VARCHAR(16) | 状态 |
| sort_code | INT | 排序 |
ral_group_role
| 字段 | 类型 | 说明 |
|---|---|---|
| id | VARCHAR(32) | 主键 |
| group_id | VARCHAR(32) | 用户组 ID |
| role_id | VARCHAR(32) | 角色 ID |
| scope | VARCHAR(32) | 数据范围覆盖 |
| custom_scope_group_ids | TEXT | 自定义数据范围组织 ID |
RBAC 链路中的用户组
用户组在权限模型中的作用:
用户 ──→ 用户组 ──→ 角色 ──→ 权限通过将用户分配到用户组,再将角色分配给用户组,可以批量管理用户的权限。一个用户可以属于多个用户组,每个用户组可以关联多个角色。