Openblocks 工作区成员与分组管理:角色权限与团队协作实战指南

原创2026-10-11 20:00:431,618 阅读
文章标签:低代码后端前端开发工具

Openblocks 工作区成员与分组管理:角色权限与团队协作实战指南

导读

在 Openblocks 中,工作区(Workspace)的成员与分组是组织权限体系的基石:通过将成员划分到不同分组,再为分组与成员分配角色,即可联动控制应用(App)、模块(Module)、导航(Navigation)、文件夹、查询库与数据源等资源的使用与管理权限。阅读本文后,你将掌握成员邀请、工作区角色(Admin / Member)、内置 Developers 开发组,以及自定义分组的创建与角色分配等完整实操能力,并理解其背后的前后端实现原理。

从「设置」进入成员与分组管理

所有成员与分组相关配置都聚合在 Openblocks 首页的 Settings(设置) 中。在前端源码中,该页面由 settingHome.tsx 渲染,其路由常量为 /setting/permission(见 routesURL.ts),进入后默认展示成员与分组列表页 PermissionSetting(见 settingHome.tsx)。

成员与分组的管理界面核心组件位于 client/packages/openblocks/src/pages/setting/permission 目录下:

管理工作区成员

内置的两个默认分组

打开 Members(成员) 页签,可以看到两个默认分组:

  • All members(全体成员):包含工作区中的全部成员,向工作区邀请新成员实质上就是向该分组添加成员;
  • Developers(开发组):具备创建资源权限的开发人员分组,后文会详细展开。

在前端实现中,「All members」是一个逻辑上的系统分组,通过 allUsersGroup 字段标识,列表页会将其从可编辑分组中过滤出来单独展示(见 permissionList.tsx)。后端 Group.java 也通过 isAllUsersGroup() 与 isDevGroup() 区分这两类系统分组。

邀请新成员加入工作区

  1. 在 Members 页签打开 All members 分组;
  2. 点击 Invite members(邀请成员);
  3. 复制弹出的邀请链接,发送给受邀用户;
  4. 受邀用户点击链接即可加入工作区。

除分组页内的入口外,Openblocks 首页左下角也提供了 Invite members 快捷入口。

前端实现中,邀请弹窗由 inviteDialog.tsx 承担:打开弹窗时调用 InviteApi.getInvite({ orgId }) 生成邀请码,随后通过 genInviteLink 拼接完整链接并支持一键复制(复制内容为 "{userName} invites you to join the workspace..." 形式的邀请文案)。对应的 API 定义为 inviteApi.ts 中的 POST /v1/invitation、GET /v1/invitation/{invitationId} 与 GET /v1/invitation/{invitationId}/invite(接受邀请)。

后端 InvitationApiService.java 在用户点击邀请链接后执行 inviteToOrg 加入工作区,并自动切换当前工作区;若用户已在其他工作区,则会返回「已在组织中(ALREADY_IN_ORGANIZATION)」错误。

注意:邀请新成员的权限仅限工作区 管理员(admins) 与 开发组成员 使用。对应地,前端仅在 currentOrgAdmin(currentUser) 为真时显示邀请按钮(见 orgUsersPermission.tsx)。

工作区角色与权限

每个工作区成员可被设置为 Admin(管理员) 或 Member(普通成员) 两种角色,其权限对比如下:

角色 工作区与分组级权限
Admin 工作区:修改工作区信息(名称、Logo 等);删除工作区;管理工作区成员并设置其角色;查看工作区成员。
分组:创建分组;删除分组;管理分组成员并设置其角色。
Member 无(仅能使用或访问其有权访问的资源)。

角色在前后端的取值保持一致:前端 orgConstants.ts 定义了 ADMIN_ROLE = "admin" 与 MEMBER_ROLE = "member",后端 MemberRole.java 则是同名的 MEMBER("member") / ADMIN("admin") 枚举。前端角色说明文案(如 "Own all resources and can manage groups.")定义在 en.ts 的 memberSettings 命名空间中。

需要特别说明的两点:

  • 工作区创建者自动获得管理员权限;
  • 关于应用、模块与数据源等更细粒度的资源权限,请参阅 permissions-for-resources.md。

在成员列表页 orgUsersPermission.tsx 中,管理员可以通过角色下拉框为成员切换 Admin / Member 角色,对应后端接口为 PUT /v1/organizations/{orgId}/role(见 orgApi.ts)。后端在 OrgApiServiceImpl.java 中会先校验调用者是否为工作区管理员(checkVisitorAdminRole),再执行角色变更;同时,将成员提升为管理员会触发开发者数量配额检查(checkDeveloperCount,见 OrgApiServiceImpl.java)。

管理分组

基于分组的管理方式,可以帮助你将来自不同职能部门(如研发、运营、财务)的成员组织起来,再配合资源分享功能实现按组的权限授予。在 Members 页签即可创建分组。

Developers 开发组

Openblocks 默认创建 Developers(开发组),且该分组不可删除,工作区管理员可以向其中添加成员。开发组成员的权限包括:

  • 创建新资源:应用(apps)、模块(modules)、导航(navigations)、文件夹(folders)与数据源(data sources);
  • 管理查询库(query library)。

从源码结构看,Developers 组在后端由 Group 的 type 字段标识(SystemGroups.DEV = "dev",见 SystemGroups.java),isDevGroup() 与 isSystemGroup() 共同决定了它是不可删除的系统分组(见 Group.java)。前端列表页也据此为开发组显示 lock(锁定)标识并隐藏删除与重命名操作(见 permissionList.tsx)。

「开发者具备创建应用和数据源等资源的能力」这一提示文案 devGroupTip 同样定义在 en.ts。前端 permissionUtils.ts 的 currentOrgAdminOrDev(user) 即用于判断「工作区管理员或开发组成员」,该判断贯穿资源创建入口的权限校验。

创建分组并添加成员

  1. 在 Members 页签点击 + Create group(创建分组),新分组默认命名为 "New group N"(自动递增去重,见 permissionList.tsx);
  2. 分组创建者自动成为该分组的 组管理员(group admin);
  3. 组管理员进入分组详情后,点击 Add members(添加成员),即可从工作区成员中选择并加入分组。

后端创建分组的入口是 GroupApiService.java:仅工作区管理员(OrgMember::isAdmin)可以创建,并会执行最大分组数配额检查(checkMaxGroupCount)。添加成员则调用 addGroupMember,其中对开发组额外执行开发者数量上限检查(GroupApiService.java)。对应的前端 API 封装为 orgApi.ts 中的 POST /v1/groups 与 POST /v1/groups/{groupId}/addMember。

分组角色与权限

每个分组内的成员同样拥有 Admin(组管理员) 或 Member(普通成员) 两种角色:

角色 权限
Admin 修改分组名称;删除分组;管理分组成员并设置其角色;查看分组成员。
Member 查看分组成员。

前端的分组成员管理页 groupUsersPermission.tsx 通过角色下拉框调用 updateUserGroupRoleAction 切换角色,对应 PUT /v1/groups/{groupId}/role;同时提供「移出分组(Remove from group)」与「退出分组(Exit Group)」操作。后端 GroupApiService.java 定义了 hasManagePermission(组管理员或工作区管理员)与 hasReadPermission(组有效成员或工作区管理员)两档权限,分别控制管理操作与查看操作。

另外两个后端约束也值得注意:

  • 最后一个组管理员不能退出分组(CANNOT_LEAVE_GROUP,见 GroupApiService.java),对应前端提示 "The last administrator cannot exit";
  • 不能移除自己(CANNOT_REMOVE_MYSELF,见 GroupApiService.java)。

补充:分组与资源权限的联动

分组本身不直接授予资源权限,而是作为权限授予的「集合单元」被复用在各种资源的分享/访问控制中:

  • 在应用、模块、导航的 Share 面板中,可以一次性选择「成员和分组」并为其分配 Viewer / Editor / Owner 角色;
  • 在数据源的 Access Control 中,同样可以添加「成员或分组」并授予 Can use / Can manage 角色;
  • 文件夹的创建、重命名、删除等操作仅限工作区管理员与开发组成员。

关于这些资源级权限角色的完整对比与配置步骤,请阅读 permissions-for-resources.md。

小结

Openblocks 的成员与分组体系由两套正交的维度构成:工作区维度(Admin / Member,决定整体管理能力)与分组维度(组内 Admin / Member,决定组内管理能力),而系统内置的 All members 与 Developers 两个分组则分别承担「全员归属」与「资源创建能力」两大职能。理解了这些角色与权限的边界,再结合资源分享中的角色授予,即可为团队搭建一套清晰、可审计的协作与权限体系。

登录后查看全文
openblocks