# 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)