后端业务模块、SaaS 多租户与 RBAC 权限

⋯

快速回顾

项目 内容
业务模块 农机资产、作业任务、维保管理、成本管理、经营分析
SaaS 结构 平台 → 租户 → 一层经营单元,场站用于进一步限定业务范围;共享数据库与业务表
账号归属 平台、租户两类账号和工作台;普通账号固定归属一个租户、一个成员关系
RBAC 模型 成员组合多个角色,角色定义动作;六个只读模板及租户自定义角色
角色授权 每条授权绑定经营范围、范围内全部或本人相关、生效及到期时间
范围合并 同一动作的完整授权取并集,所需多个动作的范围取交集,空授权拒绝
认证与撤权 JWT 绑定用户及会话;后端解析当前授权,成员停用撤销会话
查询与写入 统一 SQL 范围过滤;写入再检查状态、人员关系及并发约束
授权治理 负责人维护自定义角色、全部角色授权和自审策略;普通管理员按权限维护普通账号
异步与 Agent 跨执行边界重建上下文,重新解析发起人当前授权,复用业务 Service

职责与实现概述

农机运营围绕资产、作业、维保和成本展开,经营分析需要汇总这些模块的有效记录。后端使用 Spring Boot、MyBatis 和 MySQL 实现接口、状态流转与统计查询,通过业务 Service 向普通接口和智能体工具提供统一的业务能力。

平台公共资料与租户业务分开管理,租户内部按经营单元和场站组织业务。平台账号承担租户开通和公共目录维护,租户账号固定归属本租户,业务数据采用共享数据库和应用层范围隔离。

授权采用 RBAC,将动作、经营范围、本人关系和有效期绑定为一条完整授权。同一动作的多条授权取并集,多动作共同要求的范围取交集,既支持成员跨经营单元承担不同职责,也保留各条授权原有的数据条件。统一范围条件覆盖列表、详情、统计、导出与写入,负责人统一维护角色和授权,普通账号管理与授权分配分别控制。

Spring Security 与 JWT 建立用户及会话身份,角色和范围按当前持久化记录解析。后台任务和 Agent 跨执行边界重新建立发起人上下文,执行时复核授权与业务状态,使成员停用、授权到期和资源变化在各类入口下按相同规则生效。

业务划分

后端业务模块怎么划分?

面试回答

后端按农机运营流程划分为资产、作业、维保、成本和经营分析模块。平台目录维护公共标准机型,资产模块维护租户的具体设备;作业模块管理任务和资源安排,维保模块处理维修保养流转,成本模块管理单据与审核,经营分析按统一时间和授权范围汇总数据。

接口层由 Controller 接收请求,Service 组织业务和校验,MyBatis 完成持久化。跨模块通过公开 Service 协作,比如调度时检查设备状态、已有任务和维保占用,不直接改其他模块的表。这样普通接口和 Agent 都能复用同一套权限、状态流转和资源规则,模型提出方案后仍由后端判断能否执行。

实现细节

模块职责与主要规则见表。资产档案关联标准机型,统计按有效业务记录和时间口径汇总;跨模块调用统一经过目标模块的业务状态与数据范围检查。

模块 主要职责 需要处理的规则
农机资产 关联公共标准机型,维护租户具体设备档案 资产归属、经营范围、生命周期及可调度状态
作业任务 实际作业录入或提前安排、执行计量、质量验收及返工 资源可用性、占用冲突、指定人员、轮次计量与冻结证据
维保管理 登记保养周期与到期提醒、统一维保工单、检查与复机验收 可选安排窗口、指定验收人、处理期间的设备使用限制
成本管理 成本单据、明细、提交与审核 汇总与明细分权、自审策略、单据状态
经营分析 汇总作业、维保和成本数据 动作授权、经营范围、有效记录和时间口径

租户与权限设计

SaaS 多租户结构怎么设计?

面试回答

平台面向多个农机经营组织提供同一套业务能力,以组织作为租户,采用共享数据库和共享业务表,通过租户字段与后端授权隔离数据。平台下面是租户,租户内部有一层经营单元,并可以将授权进一步限定到场站;小租户使用默认经营单元。

账号分为平台账号和租户账号,分别进入对应工作台。普通账号固定归属一个租户和一个成员关系,不提供跨租户业务切换。平台维护公共机型、作物、作业类型和知识,租户管理自己的成员、资产及业务记录。平台普通业务与助手入口不读取租户业务明细,租户内部再通过角色动作和经营范围控制访问。专用 AI 诊断入口可审计读取已保存的跨租户会话与活动,用于运行排查;当前租户业务查询和任务控制仍由租户授权入口处理。

实现细节

SaaS 结构承载租户开通、公共目录、成员管理和业务隔离;RBAC 决定租户内部的业务动作与数据范围。场站授权只覆盖目标场站,不扩大为父经营单元或其他场站。

数据对象 结构与约束
tenants 保存租户资料、负责人、默认经营单元、自审策略及治理版本
accounts 保存平台/租户身份、单租户归属、启停状态和授权版本;成员视图直接来自账号,成员 ID 使用账号 ID
tenant_role_grants 账号的角色授权,独立保存经营范围、本人关系和生效/到期时间
organization_places 保存经营单元和场站,授权可以指定经营单元或场站
平台目录与租户业务表 公共标准机型、知识与组织具体资产、作业、维保、成本分开管理

共享表便于复用表结构、迁移流程和统计逻辑,平台通过统一授权解析与 SQL 范围片段完成租户隔离,多个组织共享数据库资源。按租户独立建库适用于需要独立资源与恢复能力的场景,同时需要分别管理建库、迁移和连接。项目围绕共享表方案,把隔离规则落实到各类查询和写入路径。

例如租户 A 有东区和西区两个经营单元,成员 U 固定属于 A,可以获得东区的农机管理授权及西区的本人相关作业授权。U 在本租户内按每条授权访问业务,不能通过请求参数把账号切换到租户 B。

Spring Security、JWT 和业务权限分别做什么?

面试回答

JWT 绑定稳定用户 ID 和登录会话 ID,Spring Security 校验令牌并建立认证上下文,每次请求还会检查会话是否有效。角色和范围由后端根据当前账号、租户、成员及有效授权解析,业务 Service 再检查动作权限、资源范围和业务状态。

这样成员停用、角色修改或授权到期后,后续请求会按当前权限处理。停用成员还会撤销登录会话,退出撤销当前会话,修改密码撤销全部会话。租户身份来自服务端当前账号记录,请求、模型和工具参数都不能指定另一租户来取得权限。

实现细节

用户会话令牌的 subject 是用户 ID,sid 关联 account_sessions,令牌不携带长期角色或数据范围。认证过滤器检查当前有效会话并加载账号,授权解析继续检查账号启用、租户未删除、有效成员身份和各条角色授权的生效、到期时间。

授权事实只在同一身份、同一经营单元筛选、同一线程的同步只读请求或一次只读工具尝试内复用。进入事务、变更上下文或跨异步边界时重新读取;知识、附件和向量记忆的外部调用之后也重新核权。敏感写入锁定租户治理行并核对当前授权与版本,经营单元筛选只在已有范围上追加限制。

环节 职责 后续校验
Spring Security / JWT 校验签名、有效期和会话,建立当前账号身份 解析当前业务授权
成员与角色授权 检查有效成员、角色动作及授权有效期 计算资源范围及本人关系
资源与状态 核对归属、数据范围和当前业务状态 写入时按需附加预期状态并检查影响行数

面试回答

RBAC 通过角色组织业务动作权限,成员通过角色授权获得相应能力。角色定义能做什么,例如读取资产、执行作业或审核成本;每条角色授权独立绑定全组织或指定经营单元、场站,以及范围内全部或本人相关的数据方式和有效期,限定这项能力能够作用于哪些记录。

成员可以组合多个角色,平台提供六个只读模板,租户可以复制为自定义角色。比如作业机手执行自己被指派的任务,农机主管管理授权范围内的资源;成本汇总、明细和审核分别授权,拥有汇总读取权不会自动得到财务明细。最终操作还要通过业务状态和指定人员检查,不能只看角色名称。

实现细节

角色不继承,成员不直接挂个人权限;角色权限来自后端定义的动作目录,目录同时定义依赖及敏感标识。创建角色时显式提交依赖权限,拒绝未知权限、通配符及平台权限。

模型或表 保存内容 作用
PermissionCatalog 动作代码、依赖、敏感标识及模板定义 例如 asset.read、task.execute、cost.document.review
tenant_roles / tenant_role_permissions 租户角色及其动作权限 定义角色能做什么
tenant_role_grants 成员、角色、全组织标识、本人相关、生效及到期时间 保存一条完整的角色授权
tenant_role_grant_scopes 授权关联的经营单元或场站 指定该条授权的经营范围

六个模板为租户管理员、农机主管、作业机手、维修人员、成本经办和成本审核。模板只读,自定义角色只在本租户生效,已分配的角色须先解除或替换全部授权才能删除。

“本人相关”按业务对象分别解释:资产是登记给本人的设备;任务是本人执行、验收或允许读取的关联返工档案;工单是本人处理或验收;成本单是本人创建或当前提交轮次由本人提交。任务指派只提供完成任务所需的关联信息,不自动扩大完整资产或成本读取权。

维保技术处理与单价、金额独立授权,农机主管默认可看成本汇总,财务明细和审核属于敏感能力。动作、经营范围、本人关系和状态规则分别检查。

资源状态如何校验?

面试回答

资源状态校验放在业务 Service 中,与权限检查分别执行。比如处理维保工单,先确认用户具有对应动作权限、工单在授权范围内,再判断当前状态是否允许处理。进入验收环节还要检查是否为该工单指定的验收人,负责人或管理员不能仅凭管理身份代替验收。

对于可能发生并发变化的操作,更新语句带上预期状态并检查影响行数。其他请求已推进状态时,本次更新返回状态变化结果;满足预期条件时才推进业务。这样把状态校验落实到实际写入,处理校验与更新之间的并发变化。

实现细节

状态条件与资源 ID、组织范围共同进入需要保护的更新语句。更新影响零行时,结合资源与状态检查返回具体原因;权限检查确定可操作范围,状态检查确定当前能否流转。

并发控制按业务对象选择条件:单条记录流转使用预期状态,同一状态下的字段修改通过版本号识别旧版本更新,跨任务调度则在资源与时间范围上保护“查占用并写安排”的整体过程。后者需协调同一资源的并发请求,取得资源锁后重新核对时间占用,再写入安排。

查询、写入与执行边界

怎么防止跨租户查询和越权修改?

面试回答

租户由当前有效账号及成员关系确定,后端按具体业务动作解析授权,将租户、经营范围和本人关系共同应用到查询条件。MyBatis 使用统一范围片段,覆盖列表、分页总数、详情、统计、选择器和导出,空授权直接拒绝;写入在业务事务中再次校验当前权限、状态与版本。

新增记录的租户由服务端上下文确定,经营单元、场站和关联资源要处于本次动作允许的范围。关联选项只返回完成当前用例所需的标识和名称,不自动开放完整详情。批量操作逐项核对,附件和历史结果在读取时重新检查当前权限;Agent 和后台任务也通过同一业务 Service 执行。

实现细节

AuthorizationService 检查当前主体和有效授权,DataScopeService 为所需动作构造授权组,MyBatis 的 AuthorizationScope.filter 将其转成组织条件、组间 AND 和组内 OR;没有范围时追加 AND 1=0。授权组内的经营范围与本人关系始终一起判断。

资产表为 machinery_units,作业表为 operation_jobs。资产查询以固定 Mapper 片段绑定字段与本人关系:

<include refid="com.amms.tenant.dao.AuthorizationScope.filter">
    <property name="scope" value="scope" />
    <property name="organization" value="a.organization_id" />
    <property name="unit" value="a.operating_unit_id" />
    <property name="site" value="a.site_id" />
    <property name="related" value="a.operator_id=#{authScope.userId}" />
</include>

字段表达式来自源码中的固定映射,身份与范围值使用参数绑定,客户端不能传入 SQL、表名或字段名。任务读取的本人关系包含执行人、验收人及允许读取的关联返工档案,不能统一简化为“创建人是自己”。

经营单元筛选作为独立 AND 组附加到授权组后面。只有某场站权限的成员筛选整个经营单元时,结果仍限定在原场站,不会获得其他场站数据。

创建任务的校验次序是:确认当前主体及动作权限 → 校验目标经营范围和关联资源 → 核对执行成员当前能力与范围 → 检查业务状态及冲突 → 写入。需要选择设备但不具备完整资产读取权时,使用专用关联选项返回必要信息,不把选择器转换成资产详情入口。

批量操作先按授权条件读取全部目标,再与去重后的请求 ID 集合核对。要求原子完成的批量更新遇到越权项时整批拒绝;支持逐项处理的接口分别返回成功、不可操作或失败结果,并且只修改已授权项。返回信息不泄露范围外资源的业务明细。

报告、导出和审计还要检查内容权限。成本汇总不携带单据明细,维保技术资料裁剪金额字段;历史分析无法按当前经营范围或费用权限安全裁剪时,拒绝正文或下载。业务导出按当前权限即时分批查询、直接返回,不创建独立导出任务或 OSS 成品;输出前先验证读取及导出权限。

租户范围如何贯穿异步任务和 Agent?

面试回答

创建任务时会保存发起人、租户和目标资源,后台运行跨执行边界重新加载当前有效主体,建立执行上下文,再按实际动作解析当前授权。消息负责触发任务,消息里的身份、角色或模型参数不能授予权限;业务 Service 缺少执行上下文时直接拒绝。

Agent 先提出工具和参数,执行器检查准入,业务 Service 检查动作、经营范围、本人关系和状态。任务创建后成员停用、授权到期或范围收缩,都按执行时的当前事实处理。人工确认只表达对方案的同意,不能扩大业务权限;历史结果再次展示或下载,也要核对当前权限能否覆盖原证据范围。

实现细节

普通请求由认证过滤器建立 RequestContext,后台和 Agent 通过 RequestContext.background 与受管理执行器建立发起人和租户上下文,再按动作重新解析授权。RabbitMQ 消费者按消息 ID 读取数据库任务,核对组织及主体后执行,不采用消息中保存的旧角色作为当前授权。

RequestContextHolder.runWith / callWith 在 finally 恢复原上下文,HTTP 过滤器结束时清理,避免线程复用串入另一任务的身份与组织。主体失效或范围不满足时拒绝业务动作;权限基础设施暂时故障进入可恢复失败处理,不能直接当成永久撤权,也不能换用管理员身份继续。

对已冻结的分析或报告,当前授权必须覆盖原证据涉及的各组经营范围及本人关系。仅能读取原结果的一部分且无法安全裁剪时,要求重新调查,不直接返回完整历史成品。执行写入前仍核对确认版本、设备状态和资源冲突。

内部 Agent 与对外 MCP 都由 Backend 解析当前用户和组织范围。MCP 额外受到客户端逐项同意能力及八项固定只读工具约束,可读取授权知识和业务汇总;Agent 的草案与写入另经冻结审批或有效委托。两类入口使用独立令牌与能力契约。

授权合并与治理

面试回答

同一个动作可以由多条角色授权提供,这些完整授权取并集;一个操作同时需要多个动作时,各动作允许的数据范围取交集。每条授权的经营范围和本人关系作为整体判断,因此成员在不同范围下可以具有不同的数据访问方式。

比如同一个成员能读取东区本人相关资产,也能读取西区全部资产,结果集合就是“东区本人”与“西区全部”的并集。如果导出还需要导出权限,就同时满足读取和导出的范围;任一动作缺少授权时拒绝操作。合并后的 SQL 保留完整授权条件,准确表达每项能力在各经营范围中的适用方式。

实现细节

设 E、W 表示东区与西区,self 表示本人相关:

asset.read 的授权组:
    (E AND self) OR W

asset.export 的授权组:
    E

导出时同时满足读取与导出:
    ((E AND self) OR W) AND E
    = E AND self

DataScopeService.ScopeSnapshot 保存 List<List<RoleGrant>>,每个内层列表是一项动作的完整授权并集,外层列表按 AND 计算;动作依赖也形成独立授权组。SQL 将每条授权渲染为 (经营范围 AND 本人关系),再组内 OR、组间 AND。不能先将所有单元、场站提取成一个 IN 集合,再把某条“范围内全部”条件套到整个集合上。

场站授权不会向父经营单元扩大;经营单元授权可覆盖所属场站。缺少动作、没有有效授权、空组或缺失范围都拒绝访问,不将空范围解释为全组织。

面试回答

每个租户有一名负责人,身份与普通业务角色分开保存。负责人统一管理自定义角色、全部角色授权和成本自审策略;普通管理员按动作权限维护普通账号,创建账号时不附带角色,也不能接管负责人或敏感账号。

角色与授权修改在事务中锁定租户治理行,重新检查负责人身份、当前版本和范围,写入前后变化及审计。负责人必须保留全组织租户管理员授权,停用、删除或解除归属前先交接。平台可以通过专用流程恢复负责人,恢复操作记录原因和前后责任人。

实现细节

主体或操作 规则
租户负责人 维护自定义角色、全部成员角色授权和成本自审设置,保留有效的全组织租户管理员授权
普通管理员 按权限维护普通账号,角色定义及授权修改由负责人完成
敏感账号 按角色实际包含的敏感动作判断,普通管理员不能接管负责人或敏感账号
自定义角色修改 模板只读;动作及依赖由 PermissionCatalog 校验;旧版本更新冲突,记录前后变化
成员授权修改 账号 ID 是成员标识;提交授权版本,修改已有授权通过移除后新增,保留项须与当前值一致
负责人交接 同租户有效成员,校验本人密码,原负责人保留其他授权
平台恢复 专用入口核对有效平台身份,记录原因和前后负责人,不代入租户办理业务

tenants 保存负责人、默认经营单元、自审策略及治理版本,accounts.authorization_version 保护成员授权更新;角色及范围分别落在 tenant_roles、tenant_role_permissions、tenant_role_grants 和 tenant_role_grant_scopes。

治理行加锁后复核身份与版本,业务变更和审计一起提交。成员授权替换会撤销其已有登录会话和 MCP 授权;角色动作变化在后续访问时重新解析。成本自审默认关闭,同时有经办和审核角色的成员也不能批准或驳回本人创建、当前由本人提交的单据;负责人显式开启后,仍须具备相应动作与数据范围。

权限验证

如何验证多租户隔离和数据权限正确?

面试回答

权限测试覆盖租户、动作、经营范围、本人关系和有效期。测试数据包含两个租户及各自成员,同一租户内配置经营单元、场站和不同角色授权,核对列表、分页总数、统计、详情、写入与导出的范围一致,既验证合法操作成功,也验证伪造租户或资源参数不能越权。

重点测试多角色并集是否保留每条本人条件、多动作交集是否生效、场站权限是否被父级筛选扩大,以及授权到期和成员停用是否及时生效。管理员测试还要覆盖角色或授权修改被拒绝、创建账号不能附带角色,以及负责人和敏感账号保护。异步任务在执行前重新撤权,历史报告在下载前收缩权限,最终核对返回内容、实际写入和审计记录。

实现细节

用例 预期结果
租户 A 账号访问租户 B 的详情、附件或修改接口 不返回私有内容,不发生写入;请求参数不能切换租户
平台身份请求租户资产和工单 平台治理身份不能取得租户业务明细
同租户多个角色分别覆盖东区本人、西区全部 只返回东区本人及西区全部,不扩大为东区全部
读取与导出动作的范围不同 只导出两项动作交集内的数据
只授权一个场站,再筛选其父经营单元 不扩大到同单元的其他场站
缺少授权、空授权或授权尚未生效/已到期 拒绝对应动作或不返回记录,不降级为全组织
任务指派成员请求完整资产或成本详情 仍按资产、成本的独立动作与范围判断
同一范围下比较列表、计数、统计及导出 SQL 口径一致,范围过滤发生在分页和聚合前
新建记录伪造组织或关联外组织资产 服务端组织赋值,非法关联拒绝
批量 ID 混合可操作项与越权项 按接口原子或逐项语义处理,不越权写入
普通管理员修改角色、成员授权,或接管负责人及敏感账号 拒绝变更,原授权和账号事实保持
两个页面同时修改同一成员授权 旧版本提交冲突,不覆盖最新授权
成员停用后持旧 JWT 访问,或 Worker 随后执行 会话撤销,后台当前授权复核失败,不创建业务记录
报告生成后费用权限或经营范围收缩 不能安全裁剪的正文或下载被拒绝
同一线程先后处理组织 A、B 的任务 B 的查询与写入不带入 A 的上下文
MCP 请求跨租户资源、未同意能力或超出当前用户范围 拒绝调用,不返回受限数据
平台读取跨租户 AI 诊断 仅专用入口可读取已保存历史,读取写审计,不能查询当前业务或控制任务

SQL 回归通过 Testcontainers 使用隔离 MySQL 和合成数据,覆盖完整授权的并集、动作交集、本人条件、场站隔离、空范围,以及列表、统计和选择器的结果。验证同时核对具体记录集合、聚合值与实际写入,确认范围条件在各条访问路径中的效果一致。

易混点与回答检查

角色决定业务动作,每条授权同时限定经营范围、本人关系和有效期;负责人身份、普通账号管理权限与实际业务验收资格分别判断。

复盘手记

搜索笔记

输入关键词,搜索所有主题与问答。