4. 订单上下文（Order Context）分析

订单上下文是支付订单领域聚合建模的核心子域，承载着订单从创建到终态的全生命周期管理。本节将深入分析订单的状态流转、核心业务规则以及聚合边界划分，为后续的服务边界与通信机制设计奠定基础。

4.1 订单生命周期状态机

支付订单的状态变迁遵循严格的有限状态机（FSM）模型，每个状态转换都对应明确的业务操作与领域事件。以下是订单的核心状态定义与转换规则：

4.2 核心业务规则

订单上下文必须强制执行以下业务规则，以保证资金安全与数据一致性：

• 金额一致性规则： 订单总金额必须等于所有订单项金额之和，且不得为负数或零（除零元体验单外）。
• 支付超时规则： 待支付订单超过指定时间（如30分钟）未完成支付，系统应自动取消订单并释放库存。
• 取消前置规则： 只有处于创建或待支付状态的订单允许取消；已支付订单必须走退款流程。
• 退款金额约束： 累计退款金额不得超过订单实际支付金额，部分退款时剩余金额必须大于零。
• 幂等性规则： 同一支付请求或退款请求重复提交时，系统应返回相同结果，不产生重复扣款或重复退款。

4.3 订单聚合边界与实体划分

在订单上下文中，聚合（Aggregate）的边界划分直接影响事务一致性与性能。推荐将以下实体组织在同一个订单聚合内：

4.4 领域事件与跨上下文通信

订单上下文通过领域事件（Domain Event）与其他上下文解耦通信。关键事件包括：

• OrderCreated — 订单创建成功后发布，触发库存预留、优惠券锁定等后续流程。
• OrderPaid — 支付成功后发布，触发发货、积分赠送等流程。
• OrderCancelled — 订单取消后发布，触发库存释放、优惠券回滚。
• OrderRefunded — 退款完成后发布，触发财务对账、用户通知。

4.5 关键代码示例：订单状态变更守卫

以下代码展示了订单聚合根中状态变更的守卫逻辑，确保状态转换的合法性：

public class Order : AggregateRoot
{
    public OrderId Id { get; private set; }
    public OrderStatus Status { get; private set; }
    public Money TotalAmount { get; private set; }
    private List<OrderItem> _items;
    private List<PaymentRecord> _payments;
    private List<RefundRecord> _refunds;

    // 状态转换映射表
    private static readonly Dictionary<OrderStatus, HashSet<OrderStatus>> _allowedTransitions = 
        new()
    {
        { OrderStatus.Created, new() { OrderStatus.Pending, OrderStatus.Cancelled } },
        { OrderStatus.Pending, new() { OrderStatus.Paid, OrderStatus.Cancelled } },
        { OrderStatus.Paid, new() { OrderStatus.Refunded, OrderStatus.PartialRefund } },
        { OrderStatus.PartialRefund, new() { OrderStatus.Refunded } },
        { OrderStatus.Cancelled, new() },
        { OrderStatus.Refunded, new() }
    };

    public void TransitionTo(OrderStatus newStatus)
    {
        if (!_allowedTransitions[Status].Contains(newStatus))
            throw new DomainException($"不允许从 {Status} 转换到 {newStatus}");

        var previousStatus = Status;
        Status = newStatus;

        // 发布领域事件
        AddDomainEvent(new OrderStatusChangedEvent(Id, previousStatus, newStatus));
    }

    public void Cancel()
    {
        TransitionTo(OrderStatus.Cancelled);
        AddDomainEvent(new OrderCancelledEvent(Id));
    }

    public void MarkPaid()
    {
        TransitionTo(OrderStatus.Paid);
        AddDomainEvent(new OrderPaidEvent(Id));
    }
}