4. 订单聚合建模（一）：订单实体设计、订单状态机与订单行项目值对象

在支付订单系统中，订单（Order）是核心聚合根，承载着交易的生命周期与业务约束。本章聚焦于订单实体的属性设计、状态机流转规则以及订单行项目（Order Line Item）的值对象建模，为后续的聚合边界划分与仓储实现奠定基础。

4.1 订单实体设计

订单实体具有全局唯一标识（OrderId），其属性分为核心业务属性与审计/扩展属性两类。以下表格列出了订单实体的关键字段及其领域含义：

4.2 订单状态机（待支付、已支付、已取消、已退款）

订单状态机是订单聚合的核心行为规则。它定义了订单从创建到终态（已取消或已退款）的合法流转路径。以下是四种核心状态及其转换规则：

• 待支付（PENDING_PAYMENT）：订单创建后的初始状态。允许执行支付操作或取消操作。
• 已支付（PAID）：支付成功后进入的状态。允许执行退款操作，不允许再次支付或取消。
• 已取消（CANCELLED）：在待支付状态下取消订单后的终态。不允许任何后续操作。
• 已退款（REFUNDED）：在已支付状态下执行退款后的终态。不允许再次退款或恢复支付。

4.3 订单行项目值对象

订单行项目（OrderLineItem）在领域中被建模为值对象（Value Object），因为它没有独立的生命周期，完全从属于订单聚合根。行项目的相等性由其所有属性共同决定，而非通过ID标识。

行项目值对象包含以下属性：

4.4 领域方法示例

以下代码展示了订单聚合根中状态变更方法的典型实现，体现了封装不变条件的DDD原则：

public class Order : AggregateRoot<OrderId>
{
    private List<OrderLineItem> _orderLineItems;
    public IReadOnlyList<OrderLineItem> OrderLineItems => _orderLineItems.AsReadOnly();

    public OrderStatus Status { get; private set; }
    public Money TotalAmount { get; private set; }

    public void Pay()
    {
        if (Status != OrderStatus.PENDING_PAYMENT)
            throw new DomainException("只有待支付订单可以支付");

        Status = OrderStatus.PAID;
        // 触发领域事件：OrderPaidDomainEvent
    }

    public void Cancel()
    {
        if (Status != OrderStatus.PENDING_PAYMENT)
            throw new DomainException("只有待支付订单可以取消");

        Status = OrderStatus.CANCELLED;
    }

    public void Refund()
    {
        if (Status != OrderStatus.PAID)
            throw new DomainException("只有已支付订单可以退款");

        Status = OrderStatus.REFUNDED;
    }
}