多租户宿主里,「一家子公司能看什么」通常不是一道判断,而是三层叠加:租户负责数据隔离,功能套餐负责功能边界,角色负责租户内部的分工。本文说明 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_复合码,避免留下永远命中不了的孤儿行。 - 勾了子模块时自动回填祖先模块,保证子模块在侧栏里仍有分组可挂。
仍被租户绑定的套餐不能停用、不能删除,先把租户解绑,避免一次误操作抽空某家子公司的全部功能。
三个生效面
套餐一旦绑定,在三个层面同时收口:
- 菜单与路由:
AuthProvider.BuildMenus与BasePage的路由守卫共用PermissionRules.Evaluate,套餐外的页面既不出现在侧栏,直接输入 URL 也进不去。 - 服务端接口:
ServiceGuard在超管短路之前检查[ServiceRoles(Menu = ...)]声明的菜单是否落在套餐内,绕过页面直接 POST 同样被拒。 - 按钮与栏位:
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 群