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

升级降级与到期

升级降级与到期

本课建立套餐生命周期规则:升级何时生效、降级何时执行、到期后如何进入宽限期,以及宽限结束后怎样安全回收能力,避免账单状态与实际权限不一致。

学习目标

  • 区分升级、降级、到期和宽限期的生效时机
  • 设计可重复执行的订阅状态转换
  • 明确能力回收、数据保留与恢复规则

先定义状态与时间点

订阅至少需要记录当前套餐、待生效套餐、当前周期开始时间、周期结束时间、宽限截止时间和状态。常用状态包括生效中、宽限中、已到期和已取消。

升级通常立即生效,因为用户已经购买更高能力;降级通常在当前计费周期结束时生效,避免用户提前失去已付费权益。到期未续费时先进入宽限期,宽限结束后再回收受限能力。

套餐订阅状态转换图

状态转换必须由明确事件驱动,例如支付成功、周期结束、宽限结束或管理员取消。不要仅根据当前时间在每次请求中临时推断状态,否则同一订阅可能在不同服务中得到不同结论。

制定升级与降级规则

升级需要同时更新套餐、额度快照和账单信息。若采用按比例补差价,还要记录本次周期剩余时长和补差金额;即使计费失败,也不能先开放高阶能力。

降级只记录待生效套餐,不立即覆盖当前套餐。周期结束任务先结算旧周期,再切换套餐并生成新额度。若当前资源已超过降级后的额度,应禁止新增资源,但不要直接删除现有数据。

场景 生效时间 推荐处理
升级 支付成功后立即 切换套餐并刷新额度
降级 当前周期结束 保存待生效套餐,期末切换
到期未续费 周期结束 进入宽限期,限制高风险操作
宽限结束 宽限截止时间 进入已到期并回收能力

实现可重复的状态转换

下面的完整 Java 示例演示立即升级、预约降级、周期结束进入宽限期,以及宽限期结束后到期。每个方法先检查当前状态,使定时任务重复执行时不会重复转换。

java
import java.time.LocalDate;

public class SubscriptionLifecycleDemo {

    enum Plan {
        BASIC, PRO
    }

    enum Status {
        ACTIVE, GRACE, EXPIRED
    }

    static class Subscription {
        Plan currentPlan;
        Plan pendingPlan;
        Status status;
        LocalDate periodEnd;
        LocalDate graceEnd;

        Subscription(Plan currentPlan, LocalDate periodEnd) {
            this.currentPlan = currentPlan;
            this.periodEnd = periodEnd;
            this.status = Status.ACTIVE;
        }

        void upgrade(Plan targetPlan) {
            if (status != Status.ACTIVE) {
                throw new IllegalStateException("inactive subscription");
            }
            currentPlan = targetPlan;
            pendingPlan = null;
        }

        void scheduleDowngrade(Plan targetPlan) {
            if (status != Status.ACTIVE) {
                throw new IllegalStateException("inactive subscription");
            }
            pendingPlan = targetPlan;
        }

        void onPeriodEnd(LocalDate today) {
            if (status != Status.ACTIVE || today.isBefore(periodEnd)) {
                return;
            }

            // 先应用已预约的降级,再进入宽限期等待续费
            if (pendingPlan != null) {
                currentPlan = pendingPlan;
                pendingPlan = null;
            }
            status = Status.GRACE;
            graceEnd = periodEnd.plusDays(7);
        }

        void onGraceEnd(LocalDate today) {
            if (status == Status.GRACE && !today.isBefore(graceEnd)) {
                status = Status.EXPIRED;
            }
        }
    }

    public static void main(String[] args) {
        Subscription subscription =
                new Subscription(Plan.BASIC, LocalDate.of(2026, 8, 31));

        subscription.upgrade(Plan.PRO);
        subscription.scheduleDowngrade(Plan.BASIC);
        subscription.onPeriodEnd(LocalDate.of(2026, 8, 31));
        subscription.onPeriodEnd(LocalDate.of(2026, 8, 31));
        subscription.onGraceEnd(LocalDate.of(2026, 9, 7));

        System.out.println(subscription.currentPlan);
        System.out.println(subscription.status);
    }
}

预期输出:

text
BASIC
EXPIRED

示例中的日期是固定演示值。生产环境应使用数据库事务锁定订阅记录,并通过事件表或消息队列通知权限、配额和计费服务;事件必须携带订阅版本号,消费者只处理比本地版本更新的事件。

设计到期后的能力回收

进入宽限期后,可以保留登录、查看和导出能力,同时限制创建、扩容或高成本操作。进入已到期状态后,再关闭核心写操作和外部调用,但仍应保留数据一段明确时间。

能力回收应采用“拒绝新增、保留已有、允许恢复”的原则。用户续费后,系统恢复套餐和额度即可,不应依赖人工重新创建资源。需要永久删除数据时,必须由独立的数据保留策略执行,不能把套餐到期直接等同于删除。

Tips:权限判断应读取统一的订阅能力快照,而不是由各业务服务分别解释套餐名称。

保证账单与权限一致

升级、续费等操作应以支付成功事件作为最终生效依据。若支付回调重复到达,系统必须根据业务订单号和订阅版本保证幂等;若权限刷新失败,则通过重试或补偿任务继续同步。

验收时要覆盖立即升级、预约降级、降级前取消、到期进入宽限、宽限内续费、宽限结束、重复任务执行和资源超额八类场景。动态订单号、时间和事件 ID 可使用 <ID>、<TIME> 表示,实际值可能不同。

本课总结

  • 升级通常支付成功后立即生效,降级通常在当前周期结束时生效
  • 到期应先进入宽限期,再按明确策略回收能力并保留可恢复的数据
  • 状态转换、账单更新和能力刷新都必须支持幂等与补偿

下一课预告

下一课将把套餐生命周期与租户侧的功能开关、资源校验和运营管理流程连接起来,完成订阅能力的统一落地。

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

目录与阅读设置

阅读设置

17

记录一个想法

升级降级与到期

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

登录哪都通