Skip to content

租户列表 ​

一句话:启凌智搭是多租户 SaaS 架构——一个平台同时服务多家互不可见的「租户」。本页是租户的总台账:建租户、改额度、停用/启用、看过期时间,都在这里。

谁能看到本页

租户管理属于「平台运营」能力。演示环境里 admin(超管)与 docadmin(租户管理员)的侧边栏都有「系统管理 → 租户管理」;套餐受限租户(如 aoteman@test)能否看到,取决于它的套餐勾没勾这两个菜单——见租户套餐的视角对照。

功能在哪 ​

  • 菜单路径:系统管理 → 租户管理 → 租户列表
  • 地址栏路由:/system/tenant/list

租户列表全貌(超管视角)

界面认识 ​

区域作用常用操作
查询区按 租户名 / 联系人 / 联系手机 / 租户状态 / 创建时间 过滤输入后点「搜索」;点「重置」清空
工具条整页级动作「新增」建租户;「导出」下载 Excel;勾选行后「批量删除」
列表一户一行看 套餐 / 账号额度 / 过期时间 / 绑定域名 / 状态;行内「编辑」「删除」
分页右下角改每页条数、翻页

列表各列含义:

列含义
租户编号租户唯一 ID。1 是系统租户(平台自身),不可改不可删
租户名登录页「租户名称」要填的就是它
租户套餐决定该租户登录后能看到哪些菜单;0 表示系统租户不受套餐限制
账号额度该租户最多能建多少个用户,超了会报配额错误
过期时间到期后该租户所有人登录报「租户已过期」
绑定域名允许用哪些域名访问该租户(回车逐个添加)
租户状态开启 / 关闭。关闭后登录报「租户已被禁用」

常用操作 ​

新建一个租户 ​

  1. 点工具条「新增」,弹出租户表单;
  2. 填「租户名」(登录页要填的名字,全平台唯一);
  3. 选「租户套餐」——先想清楚这家租户需要哪些菜单,套餐里没勾的菜单登录后看不见(见租户套餐);
  4. 填「联系人」「联系手机」;
  5. 填「用户名称」「用户密码」——这两个字段只在新增时出现,平台会用它俩自动创建该租户的第一个管理员账号;
  6. 填「账号额度」「过期时间」,确认「租户状态」为开启,点「确定」。

新增租户表单(超管视角)

结果:列表多出一行;新租户的管理员可以用「租户名 + 用户名称 + 用户密码」在登录页登录,登录后看到的就是这家租户自己的数据。

账号额度是硬上限

租户内用户数达到额度后再建用户,会报:创建用户失败,原因:超过租户最大租户配额({})!。要加人就回本页「编辑」把额度调大。

编辑租户 ​

  1. 行内点「编辑」;
  2. 改 套餐 / 额度 / 过期时间 / 域名 / 状态 等;
  3. 点「确定」。

结果:改套餐后,该租户用户下次登录即按新套餐显示菜单;把状态改成「关闭」,该租户所有人立刻登录不了,报 名字为【{}】的租户已被禁用。

系统租户(编号 1)不能改

对编号 1 的行点编辑/删除会被后端拒绝:系统租户不能进行修改、删除等操作!。它是平台自身的租户,删了平台就没了。

删除 / 批量删除 ​

  1. 单删:行内点「删除」,确认;
  2. 批量:勾选多行 → 工具条「批量删除」→ 确认。

结果:租户及其数据被标记删除,该租户所有人立即无法登录(报 租户不存在)。

删除不可恢复

删除租户会连带其下用户、组织、业务数据一起失效。演示环境请只删自己建的测试租户。

导出台账 ​

点工具条「导出」,按当前查询条件生成 Excel 下载(无弹窗,直接下文件,见通用操作约定)。

字段说明 ​

字段必填取值 / 校验说明
租户名是全平台唯一重名报 名字为【{}】的租户已存在
租户套餐是下拉选租户套餐决定可见菜单范围
联系人是文本运营联系用
联系手机是手机号运营联系用
用户名称是(仅新增)该租户内唯一自动创建的首个管理员账号
用户密码是(仅新增)文本首个管理员的初始密码
账号额度是整数用户数上限
过期时间是日期时间到期报 名字为【{}】的租户已过期
绑定域名否回车逐个添加域名重复报 域名为【{}】的租户已存在
租户状态是开启 / 关闭关闭即停用整家租户

视角对照 ​

视角看到什么
超管 admin全部租户:系统租户「启凌智搭」+ 演示租户「test」
租户管理员 docadmin同页同数据(租户管理菜单对其开放),可代运营操作
套餐受限租户 aoteman@test套餐勾了「租户管理」才看得到;没勾则侧边栏无入口、直达路由 403

租户间数据天然隔离

aoteman@test 登录后,用户列表里只有 test 租户自己的 1 条用户——哪怕它看得到「租户列表」菜单,也看不到别家租户的数据行。隔离由后端按租户 ID 强制过滤,不靠界面隐藏。

进阶 ​

  • 租户套餐:租户「能看到哪些菜单」的开关面板;
  • 用户管理:在某个租户内建用户,受本页「账号额度」约束;
  • 通用操作约定:查询/导出/批量删除的通用手法。

常见问题 ​

Q:登录时报「租户不存在」? A:登录页「租户名称」填错。要填本页「租户名」列的原文(区分全半角与空格),例如 启凌智搭、test。

Q:报「名字为【test】的租户已被禁用」? A:该租户的「租户状态」被改成关闭。回本页行内「编辑」把状态改回「开启」。

Q:报「名字为【test】的租户已过期」? A:「过期时间」早于当前时间。编辑租户把过期时间往后调。

Q:新建租户时为什么没有「用户名称/用户密码」? A:这两个字段只在新增时出现,编辑时不显示——管理员账号只在创建租户那一刻生成。

Q:改了套餐,租户用户界面没变? A:菜单在登录时加载。让该租户用户退出重新登录即生效。