38 lines
1.2 KiB
Markdown
38 lines
1.2 KiB
Markdown
# 6.7 租户管理
|
|
|
|
:::tip 概述
|
|
租户（gin_tenant，平台级表）管理 SaaS 侧的租户生命周期：开户、启停、有效期、租户管理员账号与成员视图。租户状态在登录与请求链路两处被校验。
|
|
:::
|
|
|
|
## 功能清单
|
|
|
|
| 接口 | 说明 |
|
|
|---|---|
|
|
| Page / List / Detail | 标准查询 |
|
|
| Add | 开户（手写：建租户 + 初始化归属，超管操作） |
|
|
| Update | 修改租户信息 |
|
|
| Status | 启停租户（禁用后该租户全部用户无法登录/请求被拒） |
|
|
| Delete / BatchDelete | 软删除（平台级操作，慎用） |
|
|
| Account | 租户管理员账号管理 |
|
|
| Users | 租户成员列表（按租户过滤） |
|
|
|
|
## 租户状态的执行点
|
|
|
|
| 执行点 | 行为 |
|
|
|---|---|
|
|
| 登录（Login 第 4 步） | 租户禁用/过期 → 拒绝登录（摘要缓存 60 秒） |
|
|
| 请求（Tenant 中间件） | 进行中被禁用/过期 → 请求被拒 |
|
|
|
|
## 数据归属
|
|
|
|
- 租户级 9 张表写侧自动补 tenant_id；超管新增未显式指定时取 `tenant.defaultId`
|
|
- 平台级（tenantID=0）超管可见全部租户数据，用于管理与稽核
|
|
|
|
## 管理界面
|
|
|
|
`system/tenant`：列表 + 开户 + 启停 + 成员查看 + 管理员账号维护。
|
|
|
|
## 相关
|
|
|
|
- [5.9 多租户隔离](/zh/core/tenant.html)
|