架构与系统设计 / 系统课时

停用冻结与恢复

停用冻结与恢复

租户生命周期不能只用“启用/禁用”两个状态表示。本课将把停用、冻结、过期、恢复和注销拆成可执行的业务规则,并给出统一校验与恢复验收方法,避免不同服务各自判断而产生权限和数据不一致。

学习目标

  • 区分停用、冻结、过期、恢复和注销的业务语义
  • 建立状态、访问能力与后台任务之间的行为矩阵
  • 实现统一状态校验,并完成恢复后的验收检查

先定义状态语义

停用通常来自租户主动暂停使用,冻结多由风控、欠费或违规触发,过期表示订阅或合同到期。三者都可能限制访问,但触发原因、允许操作和恢复条件不同,不能合并成一个模糊的 DISABLED。

注销是不可逆流程的入口,不应被当作普通禁用状态。租户进入注销流程后,系统应先停止新增业务,再执行数据导出、保留和清理,最终才进入不可恢复状态。

租户状态及转换条件

建立业务行为矩阵

同一个状态需要同时约束登录、接口调用、定时任务和数据修改。建议由租户中心维护统一矩阵,网关和业务服务只消费判定结果。

状态 登录与查询 新增或交易 后台任务 恢复条件
ACTIVE 允许 允许 正常执行 无
SUSPENDED 允许管理员登录 禁止新增 可保留只读任务 租户主动恢复
FROZEN 仅允许申诉入口 全部拒绝 暂停资金和通知任务 风控审核通过
EXPIRED 允许查看账单 禁止新增 仅执行到期提醒 完成续费
CANCELLING 仅允许导出与查看进度 禁止新增 执行导出和清理任务 可在保留期内撤销
CANCELLED 禁止 禁止 全部停止 不可恢复

状态变更必须记录操作者、原因、来源和时间。对冻结、恢复、注销等高风险操作,还应保存审批单号或事件编号,便于审计和故障回溯。

实现统一状态校验

下面示例把访问能力封装为统一策略,避免控制器、任务和消息消费者重复编写状态判断。示例可直接使用 javac TenantStateDemo.java && java TenantStateDemo 运行。

java
public class TenantStateDemo {

    enum TenantStatus {
        ACTIVE, SUSPENDED, FROZEN, EXPIRED, CANCELLING, CANCELLED
    }

    static boolean canCreateBusiness(TenantStatus status) {
        // 只有正常状态允许创建订单、用户或配置。
        return status == TenantStatus.ACTIVE;
    }

    static boolean canReadData(TenantStatus status) {
        // 注销完成后不再提供任何在线访问。
        return status != TenantStatus.CANCELLED;
    }

    public static void main(String[] args) {
        for (TenantStatus status : TenantStatus.values()) {
            System.out.printf(
                "%s create=%s read=%s%n",
                status,
                canCreateBusiness(status),
                canReadData(status)
            );
        }
    }
}

预期输出:

text
ACTIVE create=true read=true
SUSPENDED create=false read=true
FROZEN create=false read=true
EXPIRED create=false read=true
CANCELLING create=false read=true
CANCELLED create=false read=false

真实项目中应把策略结果缓存到网关或权限组件,但状态变更后必须立即失效缓存。关键写操作还要在业务服务内再次校验,不能只依赖网关拦截。

恢复流程与验收

恢复不是简单把状态改回 ACTIVE。系统应先验证触发原因已经解除,例如欠费已补缴、风控审批已通过或订阅已续费,再执行状态变更和资源恢复。

恢复完成后至少检查三项:登录令牌是否重新可用,租户级缓存和限流配置是否刷新,暂停的定时任务和消息消费是否按规则恢复。资金类任务应从安全检查点继续,禁止盲目重跑整个批次。

Tips:恢复接口应设计成幂等操作。重复提交同一恢复请求时,系统应返回当前状态,而不是重复触发通知、任务补偿或资源初始化。

本课总结

  • 停用、冻结、过期和注销的触发原因、允许行为与恢复条件必须分别建模
  • 状态判断应由统一策略提供,并在网关与核心业务服务中双重校验
  • 恢复需要完成原因核验、缓存刷新、任务恢复和审计记录,而不是只修改一个字段

下一课预告

下一课将进入租户数据导出与注销流程,重点处理导出范围、数据保留期、逻辑删除和最终物理清理之间的衔接。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

停用冻结与恢复

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通