架构与系统设计 / 系统课时
数据范围类型
数据范围类型
本课建立多租户系统常用的数据范围模型,明确全部、组织、组织及下级、自定义和本人五种范围的含义、计算方式与适用边界,避免权限正确但查询结果越界。
学习目标
- 区分五种数据范围及其适用场景
- 理解权限与数据范围的组合关系
- 为查询过滤和角色配置建立统一判定规则
五种数据范围
数据范围回答的是“已经允许执行某个动作后,可以处理哪些记录”。它不能替代接口权限,两者应组合判断:接口权限决定能不能进入功能,数据范围决定进入后能看到或修改多少数据。
| 类型 | 可访问数据 | 典型场景 |
|---|---|---|
| 全部 | 当前租户内的全部业务数据 | 租户管理员、总部审计 |
| 组织 | 当前所属组织的数据 | 门店负责人、部门主管 |
| 组织及下级 | 当前组织与所有子组织的数据 | 区域经理、事业部负责人 |
| 自定义 | 角色明确关联的一组组织 | 跨区域运营、专项团队 |
| 本人 | 当前用户创建、负责或归属的数据 | 销售、客服、普通员工 |
“全部”必须限定在当前租户内,不能跨租户放大。“本人”也必须明确业务口径,例如按 created_by、owner_id 或 assignee_id 过滤,不能在不同模块中随意切换含义。
范围计算规则
建议把数据范围定义为固定枚举,由角色配置引用,而不是在接口中散落字符串判断。下面是片段示例,依赖项目已有角色与组织模型。
package com.example.saas.security;
public enum DataScopeType {
ALL,
ORG,
ORG_AND_CHILDREN,
CUSTOM,
SELF
}生效行为应保持一致:ALL 不追加组织条件但仍保留租户条件;ORG 使用当前组织编号;ORG_AND_CHILDREN 展开组织树;CUSTOM 读取角色绑定的组织集合;SELF 使用当前用户编号过滤。
当用户拥有多个角色时,应先确定合并策略。多数查询场景采用并集,即取覆盖范围更大的结果;高风险写操作可以采用更严格策略,要求接口权限、数据范围和业务状态同时满足。无论选择哪种策略,都必须在全系统保持一致。
边界与组合策略
组织及下级范围依赖可靠的组织树。计算子组织时应避免只做字符串模糊匹配,优先使用闭包表、路径字段、递归查询或缓存后的组织编号集合,并确保组织变更后及时失效缓存。
自定义范围需要处理空集合。角色未绑定任何组织时,应返回空结果,而不是退化为全部数据。本人范围同样不能省略租户条件,否则相同用户编号在不同租户中可能产生越权。
接口权限与数据范围可理解为交集:只有同时满足“允许执行动作”和“记录位于可访问范围内”,操作才成立。对于修改、删除等写操作,除了查询时过滤,还应在更新条件中再次带上租户与范围条件,防止先查后改期间出现越界。
本课总结
- 数据范围控制记录边界,必须与接口权限同时生效
- 五种范围都应先限定当前租户,再计算组织、自定义或本人条件
- 多角色合并、空自定义范围和组织树变更必须制定统一规则
下一课预告
下一课将把数据范围落到查询实现中,统一生成租户、组织与本人条件,并处理多角色合并和越权更新校验。