2. 支付订单聚合模型设计：订单聚合根的定义、订单项实体、支付凭证值对象的设计原则

在支付领域驱动设计（DDD）中，聚合（Aggregate）是保证数据一致性与事务边界的最小单元。支付订单聚合模型的设计直接决定了后续OpenAPI接口的粒度、参数结构以及测试用例的覆盖范围。本节将围绕订单聚合根、订单项实体和支付凭证值对象三个核心概念，阐述其设计原则与建模要点。

2.1 订单聚合根的定义与设计原则

聚合根（Aggregate Root）是聚合中唯一能被外部引用的对象，所有对聚合内部对象的访问都必须通过聚合根。在支付订单上下文中，订单聚合根承担着整个支付流程的入口与状态机控制器的角色。

2.1.1 聚合根的核心职责

• 全局唯一标识：每个订单聚合根拥有一个全局唯一的订单ID（如 orderId），作为外部系统（商户、网关、清算）引用的唯一凭证。
• 状态机管理：维护订单生命周期状态（待支付、支付中、已支付、支付失败、已退款等），并确保状态转换的合法性。
• 事务边界：聚合根内部的所有变更（订单项、支付凭证、金额计算）必须在同一个事务中完成，保证最终一致性。
• 版本控制：引入乐观锁（如 version 字段）防止并发更新导致的数据覆盖。

2.1.2 聚合根的设计原则

2.2 订单项实体的建模

订单项（OrderItem）是订单聚合内的实体，拥有自己的本地标识（itemId），但该标识仅在聚合内唯一。订单项描述了用户购买的具体商品或服务，是金额计算与分账的最小单元。

2.2.1 订单项的核心属性

• 商品标识：productId（外部商品ID）与 skuId（库存单位ID）。
• 数量与单价：quantity、unitPrice（以分为单位，避免浮点精度问题）。
• 金额快照：subtotal（小计金额）、discountAmount（优惠分摊）、taxAmount（税费）。
• 分账信息：settlementRate（分账比例）或 settlementTarget（分账方ID）。

2.2.2 订单项的设计原则

// 订单项实体示例（Java伪代码）
public class OrderItem {
    private String itemId;          // 聚合内唯一
    private String productId;       // 外部商品ID
    private String skuId;           // 库存单位ID
    private int quantity;           // 数量
    private long unitPrice;         // 单价（分）
    private long subtotal;          // 小计（分）
    private long discountAmount;    // 优惠分摊（分）

    // 构造器：创建时即完成金额计算
    public OrderItem(String productId, String skuId, int quantity, long unitPrice) {
        this.productId = productId;
        this.skuId = skuId;
        this.quantity = quantity;
        this.unitPrice = unitPrice;
        this.subtotal = quantity * unitPrice;
        this.discountAmount = 0;
    }

    // 不允许setter，只提供getter
    public long getSubtotal() { return subtotal; }
    public long getDiscountAmount() { return discountAmount; }
}

2.3 支付凭证值对象的设计原则

支付凭证（PaymentVoucher）是订单聚合内的值对象，没有全局标识，其相等性由所有属性值决定。支付凭证记录了支付交易的凭证信息，包括支付渠道、交易流水号、支付金额、支付时间等。

2.3.1 值对象的核心特征

• 不可变性：一旦创建，支付凭证的属性不可修改；如需变更，只能整体替换。
• 无标识：不拥有独立的ID，其身份由属性组合决定。
• 自包含验证：在构造时完成所有业务规则校验（如金额匹配、渠道有效性）。

2.3.2 支付凭证的属性设计

2.4 聚合模型整体结构图

下图展示了支付订单聚合模型中聚合根、实体与值对象之间的层级关系与交互边界：

2.5 设计原则总结