4. 聚合根概念详解：定义、生命周期与唯一标识

聚合根（Aggregate Root）是领域驱动设计中最重要的战术模式之一。在 BFF 架构中，聚合根决定了前端与后端之间的数据边界、事务边界和一致性边界。理解聚合根的本质，是设计高质量 BFF 接口的前提。

4.1 聚合根的定义

聚合根是聚合（Aggregate）的入口点和所有权边界。一个聚合由一组领域对象（实体和值对象）组成，聚合根是其中唯一允许外部对象引用的实体。外部对象只能通过聚合根的方法来访问或修改聚合内部的任何元素。

在 BFF 架构中，聚合根通常对应一个聚合端点（Aggregate Endpoint），例如：

// BFF 聚合端点示例：订单聚合
// 外部只能通过 OrderAggregate 访问订单及其行项
public class OrderAggregate {
    private OrderId id;
    private OrderStatus status;
    private List<OrderLineItem> items;
    private Money totalAmount;

    // 聚合根方法：添加行项
    public void addItem(ProductId productId, int quantity, Money price) {
        // 业务规则：只能向待支付状态的订单添加行项
        if (this.status != OrderStatus.PENDING) {
            throw new DomainException("只能向待支付订单添加商品");
        }
        OrderLineItem item = new OrderLineItem(productId, quantity, price);
        this.items.add(item);
        this.recalculateTotal();
    }

    // 聚合根方法：提交订单
    public void submit() {
        if (this.items.isEmpty()) {
            throw new DomainException("订单必须包含至少一个商品");
        }
        this.status = OrderStatus.SUBMITTED;
    }

    private void recalculateTotal() {
        this.totalAmount = this.items.stream()
            .map(OrderLineItem::getSubtotal)
            .reduce(Money.ZERO, Money::add);
    }
}

4.2 聚合根的生命周期

聚合根的生命周期描述了聚合从创建到销毁的完整过程。在 BFF 架构中，理解聚合根的生命周期有助于设计合理的缓存策略、并发控制和数据同步机制。

聚合根的生命周期通常包含以下阶段：

1. 创建阶段：通过工厂方法或构造函数创建聚合根实例，生成唯一标识，初始化内部状态。
2. 活跃阶段：聚合根处于可修改状态，外部通过聚合根方法执行业务操作，内部实体和值对象随之变化。
3. 提交/完成阶段：聚合根状态锁定，不再允许修改，仅提供查询能力。
4. 归档/删除阶段：聚合根进入只读归档状态，或根据数据保留策略被物理删除。

4.3 聚合根的唯一标识

聚合根的唯一标识（Identity）是区分不同聚合实例的核心属性。在 BFF 架构中，唯一标识的设计直接影响接口的 RESTful 风格、缓存键设计和分布式一致性。

4.3.1 标识生成策略对比

4.3.2 标识在 BFF 中的使用模式

在 BFF 架构中，聚合根的唯一标识通常以以下方式暴露给前端：

// BFF 聚合端点 URL 设计
// 使用聚合根标识作为路径参数
GET    /api/v1/orders/{orderId}          // 获取订单聚合
POST   /api/v1/orders                    // 创建订单聚合（服务端生成标识）
PUT    /api/v1/orders/{orderId}/items    // 修改订单聚合内部

// 标识在响应中的表示
{
  "orderId": "ord_20240315_a1b2c3d4",    // 聚合根唯一标识
  "status": "PENDING",
  "items": [
    {
      "itemId": "item_001",              // 内部实体标识（仅在聚合内唯一）
      "productId": "prod_789",
      "quantity": 2
    }
  ],
  "totalAmount": {
    "value": 199.98,
    "currency": "CNY"
  }
}

4.3.3 标识与缓存键设计

聚合根标识是 BFF 缓存系统的核心键组成部分。合理的缓存键设计能提升缓存命中率并降低缓存失效的复杂度：

// BFF 缓存键设计模式
// 模式：{聚合类型}:{聚合根标识}:{版本号}
// 示例
String cacheKey = "order:" + orderId + ":v" + orderVersion;

// 缓存失效策略
// 当聚合根状态变更时，递增版本号，使旧缓存自动失效
public void updateOrder(OrderId orderId, UpdateCommand cmd) {
    OrderAggregate order = cacheService.get(cacheKey);
    order.apply(cmd);
    order.incrementVersion();  // 版本号递增
    cacheService.put(cacheKey, order);
}

4.4 聚合根设计检查清单

在 BFF 架构中设计聚合根时，建议使用以下检查清单进行验证：

• 边界完整性：聚合根是否包含了所有需要保持一致的内部实体和值对象？
• 唯一标识性：聚合根是否拥有全局唯一的标识？标识生成策略是否满足分布式场景？
• 生命周期完整性：聚合根的生命周期状态是否完整覆盖了业务场景？状态转换是否受业务规则约束？
• 外部访问控制：外部是否只能通过聚合根的方法访问内部对象？内部实体的标识是否对外隐藏？
• 事务边界：聚合根内部的操作是否在一个事务内完成？跨聚合的操作是否通过领域事件异步处理？
• 缓存友好性：聚合根的标识是否适合作为缓存键？缓存失效策略是否清晰？