3. 支付订单模型设计：订单核心字段定义、订单状态机设计、订单生命周期管理

支付订单模型是聚合支付系统的核心数据实体，它承载了交易流转的全部信息。一个设计良好的订单模型，需要同时满足业务可扩展性、状态可追溯性以及生命周期可管理性。本节将从核心字段、状态机与生命周期三个维度展开。

3.1 订单核心字段定义

支付订单字段可划分为基础信息、金额与币种、渠道与路由、时间与状态、安全与扩展五大类。以下为聚合支付场景下的核心字段清单：

3.2 支付订单状态机设计

状态机是订单模型的行为骨架。聚合支付场景下，订单状态需要覆盖创建、支付中、成功、失败、退款等核心节点，并处理超时、撤销等边界情况。

以下为推荐的状态机定义：

以下 SVG 展示了核心状态流转路径：

3.3 订单生命周期管理

订单生命周期管理关注订单从创建到终态的全过程治理，包括超时处理、幂等保障、对账闭环与数据归档。

3.3.1 生命周期阶段划分

• 创建阶段：接收商户下单请求，校验签名与参数，生成订单号，状态置为待支付。
• 支付阶段：调用渠道接口，处理异步通知，更新状态为支付中/成功/失败。
• 完成阶段：支付成功触发后续业务（如分账、发货），订单进入终态。
• 售后阶段：退款流程独立运行，但关联原订单生命周期。
• 归档阶段：终态订单超过保留期后，迁移至历史表或冷存储。

3.3.2 超时与补偿机制

3.3.3 生命周期状态迁移图

以下 SVG 展示了订单从创建到归档的完整生命周期路径：

3.3.4 代码示例：订单状态变更接口

以下为订单状态变更的核心逻辑片段，包含状态校验与持久化：

// 订单状态变更方法
public boolean updateOrderStatus(String orderId, int fromStatus, int toStatus) {
    // 1. 校验状态机规则
    if (!stateMachine.isValidTransition(fromStatus, toStatus)) {
        log.warn("非法状态转换: {} -> {}", fromStatus, toStatus);
        return false;
    }
    // 2. 乐观锁更新，防止并发
    String sql = "UPDATE payment_order SET order_status = ?, version = version + 1 " +
                 "WHERE order_id = ? AND order_status = ? AND version = ?";
    int rows = jdbcTemplate.update(sql, toStatus, orderId, fromStatus, currentVersion);
    if (rows == 0) {
        log.error("订单状态更新失败，可能已被其他线程修改: {}", orderId);
        return false;
    }
    // 3. 记录状态变更日志
    insertStatusLog(orderId, fromStatus, toStatus);
    return true;
}