角色权限

角色权限用于控制用户可以看到哪些菜单、操作哪些功能。

权限模型

OARS 的权限分为四层，判断顺序为登录身份 → 基础账号能力 → RBAC 功能权限 → 数据范围。

基础账号能力：所有登录用户天然拥有，包括进入工作台、查看个人消息、维护个人资料等。这些不属于角色授权范围，角色页面会过滤掉这些基础入口。

本人能力：只能操作当前登录用户自己的数据（个人资料、密码、签名）。

RBAC 功能权限：通过角色分配菜单可见性和按钮操作权限。这是管理员日常配置的主要内容。

数据范围：在拥有功能权限后，进一步限制可查看的业务数据（本人、本部门、本部门及下级、全部）。在角色编辑页配置，详见下文。

配置步骤

1. 进入菜单管理（/sys/menu），维护可授权的菜单和按钮
2. 菜单类型分为目录、菜单、内嵌页面、外链和按钮五种
3. 按钮项必须设置权限标识
4. 进入角色管理（/role），创建或编辑角色
5. 在角色编辑页面点击授权，打开菜单树勾选权限
6. 保存后，如果修改的是当前登录用户所属角色，前端会自动刷新权限；修改其他角色时提示相关用户重新登录后生效

高影响操作应通过按钮权限单独授权，例如删除、发布、导出、批量操作、代码生成、发送系统消息和代发流程。只勾选页面菜单不代表自动拥有这些操作能力。

数据范围

在角色管理（/role）新增或编辑角色时，「数据范围」下拉框控制该角色能看到哪些人的业务数据：

数据范围	可见记录
仅本人	只有自己创建或办理的记录
本部门	与自己同部门（含兼职部门）的成员的记录
本部门及下级	本部门及其所有下级部门成员的记录
全部	不限制（默认值）

生效范围：流程实例管理列表、流程任务管理列表、表单数据列表、大屏项目列表。用户有多个角色时，取最宽的那一个。系统自动生成、没有创建人的记录始终可见，避免定时任务或初始化数据被隐藏。

页面上会显示「数据范围：xxx」的标签，用户看到列表不全时能自己判断原因，不用先来问管理员。

老系统升级后所有角色默认「全部」，可见范围与升级前一致；需要收窄时再逐个角色调整。改完后本人刷新页面即可生效，其他用户需重新登录。

基础账号能力说明

以下功能不需要配置角色授权，所有登录用户自带：

• 工作台（/workspace）
• 个人主页（/mine）
• 消息中心（/message）
• 个人消息相关操作（查看、标记已读、删除）

角色授权页面已过滤这些入口，避免管理员误删。

角色管理入口

• 角色列表：/role
• 菜单管理：/sys/menu

菜单配置注意

• 目录用于分组；菜单对应可打开的页面；按钮只控制操作权限，不出现在侧栏路由中。
• 隐藏页面（表单数据、文档编辑器、实例详情等）应挂在根目录下，不要挂到「表单模板」「文档中心」等已经能打开页面的菜单下面；否则用户点侧栏入口可能跳到第一个子页面。
• 业务表单 / 流程 / 大屏挂载到侧栏时，父级选目录，不要选带页面的菜单；内嵌页和外链也不能作父级。可挂载：表单数据页、单流程统计/实例列表、已发布大屏播放页。系统预置入口（如大屏设计器列表、待办）请用拖拽调整位置，不要再挂一次。
• 表单数据权限：给角色勾选某个表单的数据菜单后，即可查看列表和详情，不必再勾「查看」。新增、编辑、提交、归档要勾同一菜单下的对应按钮；删除、导入、导出也要单独勾选。角色树里还有隐藏目录「表单数据操作」，勾选后可操作所有已挂载表单的对应动作（超级管理员默认已有，不用按表单再勾一遍）。
• 同一表单或能力再次挂载会移动菜单位置，不会重复创建；表单发布后会自动同步按钮定义，但不会自动授给角色。若同步产生新增或停用的按钮，系统会向发布人发送站内消息提醒补授权。也可在菜单管理或表单绑定中使用「同步表单按钮权限」，再到角色授权中勾选。
• 平台内置菜单（表单模板、流程中心、文档中心等）不可删除；路径、组件、类型和权限标识不可修改，可调整标题、图标、排序与父级。
• 菜单管理支持拖拽排序与跨目录移动。已挂载能力可在菜单树中定位；表单绑定弹窗与角色授权页均可跳转到对应菜单。
• 手动「同步表单按钮权限」与表单发布一样，若有新增或停用的按钮会向操作人发送站内消息。

说明

• 角色权限只控制「能不能进入某功能」，不等于可以查看全部数据。列表和详情页还受到数据权限范围的限制。
• 管理员角色应只分配给少数需要管理系统配置的人员。
• 「操作日志」「登录日志」只应授给需要排查变更的管理员，不要授给普通业务角色。
• 「服务监控」含主机、JVM、磁盘等运行画像，只应授给运维角色，不要随系统配置整包勾给业务管理员。

注意事项

• 修改当前登录用户所属角色时，前端通常会自动刷新权限。
• 修改其他用户所属角色后，需对方重新登录后生效。
• 按钮若未填权限标识，角色树中无法有效授权该操作。

常见问题

授权保存了，对方菜单没变？
确认用户已绑定该角色，并让对方重新登录；若改的是自己的角色，可刷新页面或重新进入系统。

为什么有些菜单在授权树里勾不到？
工作台、个人主页、消息中心等属于基础账号能力，已从角色授权中过滤。

功能能进但列表是空的或看不到别人的数据？ 看列表上方的「数据范围」标签。如果显示「仅本人」或「本部门」，说明是角色数据范围限制，去角色管理里放宽该角色的数据范围，而不是加菜单。

给了表单数据菜单，页面上却没有查看、打印等按钮？
有数据菜单即可查看。若仍没有新增、编辑、删除，请在同一菜单下勾选对应按钮，或在「表单数据操作」中勾选全局能力。