Skip to content

SaaS 多租户 ​

开关 lemon.tenant.enabled(环境变量 LEMON_TENANT_ENABLED,默认 false)。关闭时只有平台租户,行为与单租户系统完全一致;开启后多个卖家共用一套部署,数据按租户隔离。

隔离方式 ​

  • 共享数据库、共享表,业务表都有 tenant_id 列,唯一约束为「原列 + tenant_id」(编码、单号、店铺 + 平台 SKU 在租户内唯一)。
  • MyBatis-Plus 的 TenantLineInnerInterceptor 给所有 SQL(包括 mapper XML 中的 JOIN、子查询、UNION)自动追加 tenant_id = 当前租户,INSERT 自动填充,业务代码不需要关心租户。
  • 平台共享的表(菜单、字典类型、定时任务、租户与套餐、用户角色等关系表)没有 tenant_id,登记在 TenantProperties.ignoreTables。
  • 当前租户在 framework/tenant/TenantContext:已登录请求按会话设置,@Async 线程自动传递,定时任务按租户逐个执行(订单同步、库存回传等都在各自租户中运行),没有租户上下文时访问租户表直接报错。

平台租户、套餐与行业模板 ​

  • 平台租户(ID 1,「柠檬科技」)管理租户和套餐;菜单、字典、参数设置、租户、服务监控、缓存监控、定时任务是平台专属功能。
  • 租户套餐限定租户可用的菜单;租户管理员的菜单随套餐同步。
  • SysFeatureCatalog 把菜单归为功能模块(基础平台、跨境电商、采购、销售记录、进销存报表、库存、仓储作业、总账、应收应付、资金费用、资产、成本核算、预算分析、智能),模块声明依赖(如跨境电商依赖库存、销售记录和应收应付)。行业模板是模块的组合:跨境电商卖家、国内电商卖家、商贸批发、全部功能。新建租户时选行业即可开通对应功能。

新租户初始化 ​

开通租户时建立根部门、租户管理员(首次登录改密码)、复制平台的内置岗位角色,再由各模块的 TenantInitializer 复制基础数据:

初始化器内容
FinTenantInitializer币种、会计科目、收支类别
WmsTenantInitializer物料分类、规格属性、价格列
SysDictTenantInitializer / SysPrintTenantInitializer业务字典(电商站点、运输方式、退货原因、收款平台等)、预置打印格式
WfTenantInitializer流程模型(未发布的草稿,审批角色换成新租户的角色)
DevTenantInitializer各平台默认佣金费率

写新代码时注意 ​

  • 新建业务表加 tenant_id BIGINT NOT NULL DEFAULT 1,唯一约束末尾加 tenant_id。
  • 不要写 INSERT ... SELECT(插件处理不完整),先查询再批量 INSERT ... VALUES;不要用 TRUNCATE。
  • 按编码等租户内唯一的值作缓存 key 时带上租户 ID。
  • OAuth 回调等匿名请求没有登录会话,靠签名的 state 携带租户(见 OAuth 授权)。
  • 新租户需要的基础数据,在本模块实现 TenantInitializer。

面向跨境电商卖家的开源 ERP · 基于 GPL-3.0 协议
联系我们:电话 17701123202 · 微信 BG7LIF · 邮箱 zmissu@163.com