用户与角色

「用户与角色」面向集群管理员，用于管理当前集群的组织架构、用户账号以及集群级角色权限。

入口路径：左侧菜单 集群管理 > 用户与角色，页面路由 /admin/org。

页面菜单

页面	路由	说明
集群用户	/admin/org/dept	集群用户与部门管理
集群角色	/admin/org/rbac	集群角色与权限管理
角色权限	/admin/org/rbac/permission/:roleUUID	为角色分配菜单/API 权限

集群用户

查看组织架构

1. 进入 集群管理 > 用户与角色 > 集群用户。
2. 切换到「组织架构」页签，以树形表格展示部门层级结构。
3. 点击行前的展开/折叠图标，查看子部门。
4. 部门行内会展示已关联成员标签。

管理部门

1. 在「组织架构」页签中点击「新增部门」。
2. 填写部门名称、选择上级部门，创建部门节点。
3. 点击部门行内「编辑」修改部门信息，或点击「删除」删除部门（有成员时需先移除）。
4. 点击「配置成员」，为部门添加或移除成员用户。

查看用户列表

1. 切换到「用户列表」页签。
2. 列表展示：ID、用户名、姓名、用户来源、组织架构、拥有角色、工作空间、项目、状态（启用/禁用/待激活）。
3. 使用顶部筛选栏按关键词搜索。

创建/编辑用户

1. 点击「新增用户」，填写用户名、姓名、密码、部门、角色等。
2. 或在行内点击「编辑」，修改用户信息；编辑时可配置工作空间与关联项目。
3. 点击「保存」。

集群角色

查看角色

1. 进入 集群管理 > 用户与角色 > 集群角色。
2. 列表展示：角色 ID、名称（ename）、别名（name）、角色分类（集群角色/工作空间角色/项目角色）。
3. 使用顶部筛选栏按名称、分类查询。

创建角色

1. 点击「新增角色」。
2. 填写名称（ename）、别名（name）、角色分类；系统会分别查重并即时提示重复。
3. 点击「创建」。

配置权限

1. 在角色列表行内点击「配置权限」。
2. 在菜单权限树中勾选可访问的菜单。
3. 在 API 权限树中勾选可调用的接口方法。
4. 勾选多行后点击「批量修改权限」，快速设置查询/新增/修改/删除权限。
5. 点击「保存」。

管理插件权限

1. 在角色列表行内点击「管理插件」。
2. 勾选该角色可访问的前端页面。
3. 点击「保存」。

管理角色成员

1. 在角色列表行内点击「成员管理」。
2. 添加或移除该角色的用户。
3. 点击「确定」。

复制/删除角色

• 复制角色：基于现有角色的权限快速创建新角色。
• 删除角色：系统定义角色隐藏删除按钮，不可删除；只读角色禁用编辑并给出提示。

常见问题

Q：集群用户和平台用户有什么区别？ A：平台用户由「平台管理 > 平台与成员」维护，是平台级账号；集群用户是当前集群可见的用户视图，权限受集群角色控制。

Q：角色名称和别名都提示重复怎么办？ A：请换一个英文名称（ename）或展示名称（name），系统会分别校验唯一性。

Q：为什么某个菜单对某角色不可见？ A：请到「配置权限」中检查该角色是否勾选了对应菜单；同时检查用户是否被分配了该角色。