Skip to content

租户管理 ​

SYS-TENANT-01 | 模块 system | 在同一套部署里隔离多个客户的数据,是 SaaS 化的基础。

1. 使用角色与场景 ​

角色:平台管理员、租户管理员

  • 新客户开通租户并指定域名
  • 租户到期后禁用登录

2. 接口与权限点 ​

方法路径权限点摘要代码行
GET/system/tenant/get-id-by-name—使用租户名,获得租户编号TenantController#L44
GET/system/tenant/simple-list—获取租户精简信息列表TenantController#L54
GET/system/tenant/get-by-website—使用域名,获得租户信息TenantController#L64
POST/system/tenant/createsystem:tenant:create创建租户TenantController#L78
PUT/system/tenant/updatesystem:tenant:update更新租户TenantController#L85
DELETE/system/tenant/deletesystem:tenant:delete删除租户TenantController#L93
DELETE/system/tenant/delete-listsystem:tenant:delete批量删除租户TenantController#L102
GET/system/tenant/getsystem:tenant:query获得租户TenantController#L111
GET/system/tenant/pagesystem:tenant:query获得租户分页TenantController#L120
GET/system/tenant/export-excelsystem:tenant:export导出租户 ExcelTenantController#L128

3. 代码定位 ​

层位置
Controllermodules/system/src/main/java/com/pmforge/module/system/controller/admin/tenant/TenantController.java#L44
DOmodules/system/src/main/java/com/pmforge/module/system/dal/dataobject/tenant/TenantDO.java

4. 数据表 ​

表DO
system_tenantTenantDO

5. 机制与配置 ​

  • 租户上下文由过滤器建立,MyBatis 拦截器自动补 tenant_id
  • 租户状态无效时阻断登录

6. 常见问题与排查 ​

  • 漏加 @TenantIgnore 的系统表会被错误追加租户条件
  • 定时任务需按租户循环执行

7. 关联 ​