租户管理
NOLUX 采用多租户架构，每个租户拥有独立的数据 Schema 和资源配额。本指南面向平台管理员和租户管理员，介绍租户的创建、管理和生命周期维护。
概述
租户（Tenant）是 NOLUX 中最顶层的数据隔离单元。每个品牌方或代运营公司通常对应一个租户，其下的所有用户、数据和配置完全隔离。
创建租户
通过管理后台创建
- 登录超级管理员账号
- 进入 管理 → 租户管理
- 点击 「新建租户」
- 填写租户信息：
| 字段 | 说明 | 必填 |
|---|---|---|
| 租户名称 | 公司或品牌名称 | 是 |
| 租户标识（slug） | 唯一英文标识，用于 Schema 命名 | 是 |
| 联系人 | 主要联系人姓名 | 是 |
| 联系邮箱 | 用于接收系统通知 | 是 |
| 订阅方案 | Starter / Growth / Enterprise / Custom | 是 |
| 备注 | 内部备注信息 | 否 |
- 点击 「确认创建」
通过 API 创建
bash
POST /api/v1/admin/tenants
Content-Type: application/json
Authorization: Bearer {super_admin_token}
{
"name": "品牌示例",
"slug": "brand-example",
"contact_name": "张三",
"contact_email": "zhangsan@example.com",
"subscription_tier": "growth"
}Schema 自动创建
租户创建成功后，系统自动执行以下流程：
创建租户记录（public.tenants）
│
▼
创建 PostgreSQL Schema（tenant_{slug}）
│
▼
执行数据库迁移（创建业务表）
│
▼
初始化默认配置（AI 模型、通知设置等）
│
▼
创建租户管理员账号
│
▼
发送激活邮件注意
Schema 创建是同步操作，通常在 2-5 秒内完成。如果迁移脚本较多，可能需要更长时间。创建过程中请勿重复提交。
租户生命周期
租户具有以下状态流转：
pending（待激活）→ active（活跃）→ suspended（暂停）→ terminated（终止）
│ │
└──── suspended（暂停）──── active（恢复）│
▼
deleted（删除）状态说明
| 状态 | 说明 | 数据访问 |
|---|---|---|
pending | 刚创建，等待激活 | 不可访问 |
active | 正常使用中 | 完全访问 |
suspended | 欠费或违规暂停 | 只读，不可新增 |
terminated | 主动终止服务 | 不可访问 |
deleted | 数据已清理 | 不存在 |
暂停租户
当租户出现以下情况时，可暂停其服务：
- 订阅到期未续费（系统自动暂停，宽限期 7 天）
- 违反使用条款
- 租户主动申请暂停
暂停期间，租户用户可登录查看数据，但无法执行任何写入操作。
终止与数据清理
租户终止后，数据保留 30 天。超过保留期后：
- 导出租户数据备份（自动上传至 OSS）
- 删除租户 Schema 及所有表
- 清理 Redis 中的缓存数据
- 将租户记录标记为
deleted
不可逆操作
数据清理操作不可逆。请确保在终止前已完成必要的数据导出。
订阅管理
查看当前订阅
进入 管理 → 租户详情 → 订阅信息，可查看：
- 当前订阅方案和到期时间
- 资源使用量（连接器数、API 调用量、AI Token 消耗）
- 账单历史
升级 / 降级
- 进入租户详情页
- 点击 「变更方案」
- 选择目标方案
- 确认变更
升降级规则
- 升级：立即生效，按剩余天数差价补费
- 降级：下个计费周期生效，当前周期保留高级功能
- 降级限制：如果当前使用量超过低级方案配额，需先清理多余资源
租户配额监控
在租户列表页面，可以快速查看各租户的资源使用情况：
| 指标 | 说明 |
|---|---|
| 连接器数 | 已创建 / 配额上限 |
| 活跃用户数 | 30 天内登录用户 / 用户上限 |
| API 调用量 | 当日调用次数 / 日配额 |
| AI Token | 本月消耗 / 月配额 |
| 存储空间 | 已使用 / 分配上限 |
批量操作
超级管理员可对多个租户执行批量操作：
- 批量暂停：选中多个租户一键暂停
- 批量导出：导出租户列表为 CSV
- 批量续费提醒：向即将到期的租户发送续费通知