租户管理

01 功能介绍：租户不是部门或团队

从「平台管理 → 系统设置 → 租户管理」进入。租户是系统的数据与登录上下文边界，不因名称与某家公司相同，就自动等同于该公司的全部组织关系。部门是组织目录，业务团队用于业务成员归属，角色负责功能权限；它们都不能用租户名称替代。

本页可新建租户、单选编辑、批量启用、批量停用和批量删除，也支持只选一个租户使用批量按钮。没有导入、导出、复制租户、关联数据统计或恢复删除的入口。

列表是平台级租户清单；点击一行只是勾选，不会切换当前登录租户，也不会自动进入该租户的业务数据。

02 使用前：确认平台身份和完整对象

1. 确认当前环境与登录账号。本页接口要求超级管理员身份；只给普通角色增加租户读取或写入权限，不足以获得平台级访问。
2. 准备目标租户编码、名称和期望状态。名称用于辨认，编码用于稳定查询；编辑面板还会显示内部租户 ID。
3. 修改状态或删除前，确认该租户是否承载当前账号、其他账号和历史业务。页面没有关联数量清单，不能根据列表只有一行就认定它没有数据。
4. 若仅需查看组织人员或团队成员，应进入组织架构或团队管理；账号关系参阅用户管理。

03 查询定位：本地搜索，不按页翻找

1. 在「搜索租户编码 / 名称 / 状态」输入编码或名称片段。输入会立即过滤已加载的列表，忽略首尾空格和大小写，不需点击搜索按钮。
2. 需要按状态查找时使用原始编码：active、inactive、suspended。中文「启用」「停用」「挂起」是显示标签，不是状态搜索的专门映射。
3. 核对筛选区「共 N 个租户」与底部「显示 N 项，共 M 个租户」；N 是过滤后的数量，M 是本次加载的全列表数量。
4. 点击输入框右侧叉号或删空关键词可恢复全列表；右上角「刷新租户」重新获取列表，保留当前搜索词。

搜索是片段匹配，不是精确状态筛选。例如 active 也包含在 inactive 中，因此可能同时找到启用和停用租户。请继续核对状态列，不能直接把结果全部当作启用租户。

当前页面一次加载清单，没有分页按钮、日期范围、列排序或独立状态下拉筛选。列表默认按创建时间从新到旧返回，表中却显示「更新时间」；更新后的租户不一定自动排到第一行。

04 租户资料：选中一项，再查看编辑面板

列表字段包括编码、名称、状态和更新时间。更新时间按浏览器本地时区显示到分钟，不固定为北京时间，也不是创建时间。当前列表不显示内部 ID、配置内容或关联账号数量。

1. 点击目标行或左侧勾选框，出现「已选 1 项」操作栏。
2. 点击「编辑」，打开「编辑租户」。先核对面板说明中的租户 ID，以及只读的「租户编码」。
3. 查看「租户名称」「状态」「配置(JSON)」。这里只查看资料时，用关闭按钮退出，不点击「保存变更」。
4. 如果「编辑」不可用，先确认是否同时选了多个租户，或当前请求仍在处理中；可点击「清空选择」后重新单选。

本页没有独立的只读详情按钮；编辑入口受写入能力限制。面板使用已加载列表的资料，不是每次打开都独立查询最新详情。遇到其他管理员同时维护时，先关闭面板、刷新再核对。

05 新建与编辑：校验字段后再保存

新建租户：有维护权限时点击「新建租户」，填写「租户编码」「租户名称」，选择「状态」，核对「配置(JSON)」，最后点击「创建租户」。编码与名称会去掉首尾空格，不能为空；编码长 2–50 个字符，以小写字母或数字开头，后续可包含小写字母、数字、下划线和连字符，不能与已有编码重复。名称长度为 1–100 个字符，名称相同不等于同一租户。

新建初始状态为「启用」，配置为 {}。收到「租户创建成功」后，列表会重新加载并选中新租户；原搜索词可能将它隐藏，先清空搜索再核对编码和状态。创建租户不等于创建登录账号、分配角色或迁入原有业务数据；这些事项需分别安排。

编辑已有租户：仅选一个租户，点击「编辑」，核对对象后调整名称、状态或配置，再点击「保存变更」。编码不可修改。名称仍需满足非空与长度限制；成功后应重新打开确认保存内容，不能只看面板关闭。

配置要求：必须是合法 JSON 对象，不能填数组、普通字符串或 null；空白会按空对象 {} 处理。保存配置会替换整个对象，不是只合并改动的几个键。因此清空配置并保存会移除原配置内容，修改时需保留仍有效的键。页面不提供配置键的业务模板，不能自行添加一个键就认定获得了品牌、区域或功能权限。

编码重复、格式错误、JSON 无效或保存失败时，保留错误信息并修正对应字段；不要反复创建同一编码。页面没有版本号冲突提示或自动合并保证，其他管理员已修改过时应先刷新核对，避免用旧内容覆盖。创建和保存提交未演示。

06 状态管理：启用、停用与挂起

系统实际状态为「启用」active、「停用」inactive、「挂起」suspended。三种状态可在新建或编辑表单中选择；批量工具仅提供启用、停用，没有批量挂起。

1. 先核对选中对象及其现有状态。要批量启用，所选租户必须全部不是启用；要批量停用，必须全部不是停用。
2. 点击「批量启用」或「批量停用」，在确认框核对数量和名称，再点击「确认启用」或「确认停用」。不执行时点击「取消」。
3. 正常全部成功会出现「所选租户已启用」或「所选租户已停用」，关闭确认框、清空选择并重新加载列表；再按编码检查实际状态。
4. 若同时选了启用和停用租户，两个批量状态按钮都可能不可用；不是系统自动跳过已达目标状态的项，应先清空选择并分别处理。

单独选中挂起租户时，启用和停用均可选择。编辑表单里的状态随「保存变更」直接提交，不经过批量确认框，保存前也要核对状态。以上状态写入未演示。

已核实的密码登录会要求所属租户启用，切换租户也只接受启用目标。但停用或挂起不是统一的“立即踢出所有在线用户”：本页更新状态不撤销全部会话，也不能承诺其他登录方式、已有令牌及所有模块立刻失效。涉及紧急访问控制时，请由平台管理员核对账号、会话与相应业务入口，不以停用按钮代替全部控制措施。

07 批量操作：过滤后的可见项不等于全部已选项

本页没有跨页选择问题，但跨搜索条件的选择会保留。整行点击和行首勾选框都会切换选中状态；搜索变窄后，看不见的已选租户仍可能留在操作集合中。

1. 开始一批操作前，点击「清空选择」，再输入本批查询条件。
2. 逐行勾选，或点击表头「全选当前列表」。表头操作只添加或取消当前过滤结果中的项，不会清除过滤结果之外的已有选择。
3. 比较「已选 N 项」和当前可见行数。两者不一致时，清空搜索核对完整选择；不要直接按可见行数确认。
4. 打开确认框后核对数量。最多展示前四个租户名称，超过四个会显示「等 N 个租户」，因此名称摘要不是完整名单。
5. 「刷新租户」会保留仍在返回列表中的已选 ID，不是清空选择；确需重置时使用「清空选择」。重新进入页面则重新建立选择状态。

批量失败后不要直接重复整批提交。页面逐个发送请求，只要有一个失败就显示错误；已经成功的项不会因此自动撤销，页面也没有逐项成功/失败清单。失败时确认框和选择可能保留且列表未刷新。先关闭确认框，等待请求结束后刷新，逐一核对实际状态或记录是否仍存在，再仅处理确认未完成的项。

08 删除与保护规则：不要把可点击当成可安全删除

选择租户后可以点击「批量删除」，确认框会提示删除后无法恢复，并要求点击「确认删除」。取消只关闭确认框，不清空选择。页面没有回收站、撤销或恢复入口；不应为了测试按钮而确认删除。删除提交未演示。

当前页面和管理接口没有针对“当前登录租户”或编码为 default 的专用删除、停用保护判断，也没有“必须先停用才能删除”的已实现限制。不要期待系统在最后一步一定拦住重要租户。default 还被用作部分系统级记录的归属，不能当作普通闲置记录随意处理。

账号、角色、会话、审计和部分业务记录会引用租户，数据库引用约束可能阻止删除。页面没有展示全部依赖，也没有删除前逐项预检和数据迁移向导；即使看起来是空租户，也不能保证能够删除。

删除操作不是清空该租户所有业务数据的工具，不承诺自动迁移、级联清库或解除全部关联。遇到删除失败、关联约束或未知错误时，应记录租户 ID、编码、时间和错误，交由平台管理员核对依赖与实际结果，不通过继续批删、反复启停来绕过问题。

09 权限与隔离：平台清单和业务范围分开看

读取对应 tenant:read，创建、更新和删除对应 tenant:write；服务端还检查超级管理员身份。超级管理员在权限检查中具有特权，普通管理员即使看到了菜单，也不能据此认定能够维护全部租户。前端显示「当前账号为只读权限」只说明前端维护条件不足，不代表普通账号必然获准读取该列表。

后台业务访问通过有效租户上下文和相应表的租户隔离规则控制；普通用户不能靠修改前端筛选或跨租户标识自行扩大范围。租户管理使用平台级读取，能看到租户清单不等于所有业务页面都提供跨租户汇总。

勾选、编辑、停用与切换租户是不同动作。已接入的租户切换走单独入口，要求超管、租户切换权限和启用目标；只有一个可用租户时，顶部切换控件可能不显示。更改名称或状态不会将当前账号、部门、团队和历史记录自动搬到另一租户。

10 操作后核对：对象、状态和访问分别确认

1. 收到成功提示后，按编码重新查询，确认名称、状态和更新时间。刷新失败时可能保留旧列表，不用旧行证明保存结果。
2. 配置变更要重新打开编辑面板核对完整对象，确认没有丢失仍需要的键；具体配置效果需到实际使用它的页面验证，不能保证所有模块自动应用。
3. 状态调整后，由授权人员核对相应登录或切换路径；列表状态已变不等于现有会话都终止。
4. 对批量结果逐个核对，不将一个成功提示或一个错误提示解释成全部对象相同结果。
5. 需要追踪变更时，结合审计日志中的对象与时间。审计有自己的租户和记录范围，不能假定在当前范围看到所有租户的操作。

关闭表单并重新打开时，应再次检查字段；不要把未保存的草稿当作服务端结果，也不要依赖退出时一定出现未保存提醒。

11 常见异常处理

• 没有匹配租户：先清空搜索，再刷新并查看错误提示；本地过滤不会向服务端扩大读取范围。管理清单与“可切换租户”清单用途不同，后者只提供启用目标。
• 编辑或状态按钮禁用：核对写入能力、选中数量、所选状态及是否正在提交。编辑仅单选；批量启停要求所有项满足相应条件。
• 选中数量比可见行多：搜索保留了隐藏的选择，先清空搜索查看，再用「清空选择」建立新批次。
• 无法删除：按钮不预先检查所有依赖。保留租户 ID 与错误，请平台管理员检查关联及事务结果；不要认定停用后就一定能删。
• 状态已变但仍有人在线：状态维护没有统一撤销会话，按实际登录方式、账号和模块核对访问，不能靠继续停用来刷新会话。
• 批量未全部完成：刷新后逐个核对，仅对未完成且原因已解决的项重新操作；本页没有完整逐项回执。
• 刷新后仍有旧错误提示：刷新并不统一清除之前的提示。对比本次加载结果和请求是否成功，保留必要证据，不仅凭横幅判断最新状态。

12 常见问题