部门用户应用范围契约说明

构建时间2026-06-26 20:10:33（Asia/Shanghai）来源项目中间件文档 / 中间件后端来源仓../cl-midserver-2026来源提交号69b951a07311e75887b57e0400d888f89dd72cac

查看文档来源信息

• 来源目录：addons/sys_base/docs
• 来源文件：契约说明/部门用户应用范围契约说明.md

## 契约用途 - 适用范围：部门管理、用户管理、部门应用范围和部门校区范围。 - 当前正式版本：2026-04-22。

当前正式口径

• 部门页负责组织树、部门基础信息、部门应用范围和部门校区范围。
• 用户页负责账号资料、角色绑定、部门成员关系和部门管理员状态。
• 部门应用范围与部门校区范围通过独立接口维护。
• 部门树主数据范围优先按账号的系统超管身份和部门管理员关系判定，不直接跟随角色上下文切换。

关键字段

字段名	含义
organizationId	部门主键 ID
sysUserIDS	批量操作的用户 ID 列表
isAdmin	是否为部门管理员
appUUIDs	部门可访问应用 UUID 列表
areaIds	部门可访问校区 ID 列表

运行规则

1. 系统超级管理员账号拥有全量部门树和全量部门写权限，不区分当前运行上下文。
2. 非系统超管且为部门管理员时，可见范围与可写范围都是“当前部门 + 当前部门下级部门树”。
3. 非系统超管且只是普通部门用户时，可见范围与可写范围都按“当前部门下级部门树”判定。
4. 删除部门前必须先处理下级部门和部门成员。
5. 用户调动、移除、设为管理员都必须基于当前可管理范围执行。
6. 部门应用范围与校区范围变更后，运行态菜单与页面权限应重新计算。

2026-04-24 联调补充口径

1. admin 作为系统超级管理员账号，在 role 上下文和 super_admin 上下文下访问部门树接口时，均返回同一棵全量部门树。
2. 部门树显示范围与部门写权限已统一改为同一套组织范围规则，不再出现“系统超管切到普通角色后部门树被缩成普通树”的旧行为。