架构与系统设计 / 系统课时

数据范围类型

数据范围类型

本课建立多租户系统常用的数据范围模型,明确全部、组织、组织及下级、自定义和本人五种范围的含义、计算方式与适用边界,避免权限正确但查询结果越界。

学习目标

  • 区分五种数据范围及其适用场景
  • 理解权限与数据范围的组合关系
  • 为查询过滤和角色配置建立统一判定规则

五种数据范围

数据范围回答的是“已经允许执行某个动作后,可以处理哪些记录”。它不能替代接口权限,两者应组合判断:接口权限决定能不能进入功能,数据范围决定进入后能看到或修改多少数据。

类型 可访问数据 典型场景
全部 当前租户内的全部业务数据 租户管理员、总部审计
组织 当前所属组织的数据 门店负责人、部门主管
组织及下级 当前组织与所有子组织的数据 区域经理、事业部负责人
自定义 角色明确关联的一组组织 跨区域运营、专项团队
本人 当前用户创建、负责或归属的数据 销售、客服、普通员工

“全部”必须限定在当前租户内,不能跨租户放大。“本人”也必须明确业务口径,例如按 created_by、owner_id 或 assignee_id 过滤,不能在不同模块中随意切换含义。

范围计算规则

建议把数据范围定义为固定枚举,由角色配置引用,而不是在接口中散落字符串判断。下面是片段示例,依赖项目已有角色与组织模型。

java
package com.example.saas.security;

public enum DataScopeType {
    ALL,
    ORG,
    ORG_AND_CHILDREN,
    CUSTOM,
    SELF
}

生效行为应保持一致:ALL 不追加组织条件但仍保留租户条件;ORG 使用当前组织编号;ORG_AND_CHILDREN 展开组织树;CUSTOM 读取角色绑定的组织集合;SELF 使用当前用户编号过滤。

当用户拥有多个角色时,应先确定合并策略。多数查询场景采用并集,即取覆盖范围更大的结果;高风险写操作可以采用更严格策略,要求接口权限、数据范围和业务状态同时满足。无论选择哪种策略,都必须在全系统保持一致。

边界与组合策略

组织及下级范围依赖可靠的组织树。计算子组织时应避免只做字符串模糊匹配,优先使用闭包表、路径字段、递归查询或缓存后的组织编号集合,并确保组织变更后及时失效缓存。

自定义范围需要处理空集合。角色未绑定任何组织时,应返回空结果,而不是退化为全部数据。本人范围同样不能省略租户条件,否则相同用户编号在不同租户中可能产生越权。

接口权限与数据范围可理解为交集:只有同时满足“允许执行动作”和“记录位于可访问范围内”,操作才成立。对于修改、删除等写操作,除了查询时过滤,还应在更新条件中再次带上租户与范围条件,防止先查后改期间出现越界。

本课总结

  • 数据范围控制记录边界,必须与接口权限同时生效
  • 五种范围都应先限定当前租户,再计算组织、自定义或本人条件
  • 多角色合并、空自定义范围和组织树变更必须制定统一规则

下一课预告

下一课将把数据范围落到查询实现中,统一生成租户、组织与本人条件,并处理多角色合并和越权更新校验。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

数据范围类型

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通