主题
租户管理
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/create | system:tenant:create | 创建租户 | TenantController#L78 |
| PUT | /system/tenant/update | system:tenant:update | 更新租户 | TenantController#L85 |
| DELETE | /system/tenant/delete | system:tenant:delete | 删除租户 | TenantController#L93 |
| DELETE | /system/tenant/delete-list | system:tenant:delete | 批量删除租户 | TenantController#L102 |
| GET | /system/tenant/get | system:tenant:query | 获得租户 | TenantController#L111 |
| GET | /system/tenant/page | system:tenant:query | 获得租户分页 | TenantController#L120 |
| GET | /system/tenant/export-excel | system:tenant:export | 导出租户 Excel | TenantController#L128 |
3. 代码定位
| 层 | 位置 |
|---|---|
| Controller | modules/system/src/main/java/com/pmforge/module/system/controller/admin/tenant/TenantController.java#L44 |
| DO | modules/system/src/main/java/com/pmforge/module/system/dal/dataobject/tenant/TenantDO.java |
4. 数据表
| 表 | DO |
|---|---|
system_tenant | TenantDO |
5. 机制与配置
- 租户上下文由过滤器建立,MyBatis 拦截器自动补 tenant_id
- 租户状态无效时阻断登录
6. 常见问题与排查
- 漏加 @TenantIgnore 的系统表会被错误追加租户条件
- 定时任务需按租户循环执行
7. 关联
- 需求原件:01-05-租户管理
- 相关卡片:SYS-TENANT-02