多租户与功能套餐

用「租户 + 套餐 + 角色」三层收口:套餐决定买到了哪些功能,角色决定租户内部谁用其中哪些。

最后更新

多租户宿主里,「一家子公司能看什么」通常不是一道判断,而是三层叠加:租户负责数据隔离,功能套餐负责功能边界,角色负责租户内部的分工。本文说明 Known.Admin 提供的后两层口径。

三层各管什么

层 载体 回答的问题
租户 SysTenant / CompNo 这条数据属于哪家子公司
功能套餐 SysPermPackage + SysPermPackageItem 这家子公司买到了哪些模块
角色 SysRole / SysRoleModule 租户内部谁能用其中哪些

最终可见菜单 = 套餐允许的模块 ∩ 角色授权。套餐是上限,角色只能在上限内继续收紧;租户自己的超级管理员同样越不出套餐。

开启多租户

多租户是代码级开关,不放进系统设置:

Config.MultiTenant = true;

开启后,SysTenant 接管两件事:

  • 数据分桶:业务行的 CompNo 与 UserInfo.CompNo 对齐,框架按租户过滤。
  • 独立库路由:租户置 Isolated 并登记 DatabaseType / ConnectionString 后,框架在解析出该租户时把连接整体切到它的专属库(只切连接,不建库、不迁表)。

租户编码 Code 是分桶键,建好后不可修改。

功能套餐

套餐在「功能套餐」页维护,只勾模块级键(SysModule.Id 或 [Menu] 显示名),不细分按钮与栏位——那些属于角色层。一个租户最多绑定一个套餐;SysTenant.PackageId 留空即不限制。

public class SysTenant : EntityBase
{
    public string Code { get; set; }       // 租户编码 = CompNo
    public string PackageId { get; set; }  // 功能套餐;留空 = 不限制
    // ...
}

保存套餐时服务端会做两件事:

  • 丢弃目录里不存在的键与 b_ / c_ / t_ 复合码,避免留下永远命中不了的孤儿行。
  • 勾了子模块时自动回填祖先模块,保证子模块在侧栏里仍有分组可挂。

仍被租户绑定的套餐不能停用、不能删除,先把租户解绑,避免一次误操作抽空某家子公司的全部功能。

三个生效面

套餐一旦绑定,在三个层面同时收口:

  1. 菜单与路由:AuthProvider.BuildMenus 与 BasePage 的路由守卫共用 PermissionRules.Evaluate,套餐外的页面既不出现在侧栏,直接输入 URL 也进不去。
  2. 服务端接口:ServiceGuard 在超管短路之前检查 [ServiceRoles(Menu = ...)] 声明的菜单是否落在套餐内,绕过页面直接 POST 同样被拒。
  3. 按钮与栏位:b_ / c_ / t_ 复合码按模块键前缀归属套餐;模块在套餐外时,其按钮与栏位一并拒绝。

WebAssembly 宿主的时间窗:浏览器端插件是后台懒装配的,授权钩子要等 Known.Admin 装完才挂上。在这之前(约数秒)整页刷新落在套餐外页面时,路由守卫读不到授权快照,只能按框架默认放行;侧栏也会先出全集、装完后再收窄。这段窗口不影响数据安全——服务端 ServiceGuard 不依赖浏览器装配,套餐外接口始终拒绝。要求首屏即严格门禁的宿主请用 Blazor Server/Desktop(插件注册期即时装配)。

运行期 Schema 拼出的导航(SchemaRegistry.Menu 的面包屑树与「运行时模型」实体兜底)没有可标注的菜单特性、也不进可授权目录,角色层够不着它们;但套餐是功能上限,受套餐约束的账号会经 AuthProvider.SchemaMenuAccessPolicy 按标题裁掉套餐外的叶子,侧栏因此不会漏出「商品中心」这类示例页。需要把运行期页完整纳入授权体系的,请在「模块管理」登记成模块行——它会作为普通模块进入目录、绑定与拦截;单靠 Schema 导航的页面不承诺 URL 直达门禁。

进程级套餐快照

独立库租户的连接会切到自己的库,SysTenant / SysPermPackage* 未必在那里存在。因此套餐不做「每次登录现查」,而是由 PermPackageRegistry 在启动、租户变更、套餐变更后整表重灌为进程级快照:

租户编码 → PackageGrant { PackageId, PackageName, ModuleCodes }

PermissionService 取快照时按 UserInfo.CompNo 解析;平台账号(Config.IsPlatformUser)不参与套餐收口。

失败回退

  • 租户未绑定套餐 → 不限制,回到原有的角色白名单口径。
  • 套餐已删除或已停用 → 按「未绑定」处理,宁可退回角色白名单,也不因配置残缺把租户整个锁死。
  • 用户不受任何套餐约束时,原有行为完全不变。

验收要点

  • 用租户超级管理员登录,套餐外的模块仍不可见、不可直达。
  • 角色勾了套餐外的模块 → 仍然看不到;套餐内但角色没勾 → 也看不到。
  • 解绑套餐后,该租户恢复为「角色授权决定可见菜单」。
微信公众号二维码 扫码关注公众号
QQ 交流群二维码 扫码加入 QQ 群