3. 领域驱动设计(DDD)核心概念：实体、值对象、聚合、领域事件

领域驱动设计（DDD）提供了一套用于构建复杂业务软件的战术模式。在 Go 语言中，这些模式帮助我们明确领域边界、封装业务规则，并生成可测试、可演化的 API 契约。本章聚焦于四个最核心的构造块：实体（Entity）、值对象（Value Object）、聚合（Aggregate）和领域事件（Domain Event）。

3.1 实体（Entity）：具有唯一标识的领域对象

实体是领域模型中具有连续性和身份的对象。即使其属性随时间变化，只要标识不变，它仍然是同一个对象。在 Go 中，实体通常通过一个不可变的 ID 字段来区分。

// 实体：用户
type User struct {
    ID        string    // 唯一标识，不可变
    Name      string    // 可变属性
    Email     string    // 可变属性
    CreatedAt time.Time
}

// 通过 ID 判断相等性
func (u User) SameIdentityAs(other User) bool {
    return u.ID == other.ID
}

3.2 值对象（Value Object）：描述性、不可变、无标识

值对象用于描述实体的属性或特征，本身没有独立标识。两个值对象如果所有属性都相同，则视为相等。值对象必须是不可变的，修改即替换。

// 值对象：地址
type Address struct {
    Street   string
    City     string
    ZipCode  string
}

// 不可变：返回新实例
func (a Address) WithStreet(newStreet string) Address {
    return Address{
        Street:   newStreet,
        City:     a.City,
        ZipCode:  a.ZipCode,
    }
}

// 值相等性
func (a Address) Equals(other Address) bool {
    return a.Street == other.Street &&
        a.City == other.City &&
        a.ZipCode == other.ZipCode
}

3.3 聚合（Aggregate）：一致性边界与事务单元

聚合是一组相关实体和值对象的一致性边界。聚合根（Aggregate Root）是外部访问聚合内对象的唯一入口。聚合保证边界内的业务规则始终一致，是事务的原子单元。

// 聚合根：Order
type Order struct {
    ID              string
    Items           []OrderItem
    ShippingAddress Address
    Payment         Payment
    Total           Money
    Status          OrderStatus
}

// 业务方法：添加订单项（保证一致性）
func (o *Order) AddItem(productID string, qty int, price Money) error {
    if o.Status != OrderStatusPending {
        return ErrOrderNotModifiable
    }
    item := OrderItem{
        ItemID:    uuid.New().String(),
        ProductID: productID,
        Quantity:  qty,
        Price:     price,
    }
    o.Items = append(o.Items, item)
    o.recalculateTotal() // 内部重新计算总额
    return nil
}

// 私有方法：重新计算总额
func (o *Order) recalculateTotal() {
    var total float64
    for _, item := range o.Items {
        total += item.Price.Amount * float64(item.Quantity)
    }
    o.Total = Money{Amount: total, Currency: "CNY"}
}

3.4 领域事件（Domain Event）：记录已发生的业务事实

领域事件表示领域中已经发生的、对业务有意义的事件。它是聚合之间解耦通信的核心手段，也是事件溯源和 CQRS 的基础。领域事件通常以过去时态命名，且不可变。

// 领域事件：订单已支付
type OrderPaidEvent struct {
    EventID   string    // 事件唯一标识
    OrderID   string    // 关联聚合根 ID
    PaidAt    time.Time // 事件发生时间
    Amount    Money     // 支付金额（值对象）
    PaymentID string    // 支付记录 ID
}

// 事件发布接口
type EventPublisher interface {
    Publish(event interface{}) error
}

// 在聚合根中发布事件
func (o *Order) MarkAsPaid(paymentID string, paidAt time.Time) error {
    if o.Status != OrderStatusPending {
        return ErrInvalidOrderStatus
    }
    o.Status = OrderStatusPaid
    o.Payment = Payment{PaymentID: paymentID, Status: PaymentStatusSuccess}

    // 发布领域事件
    event := OrderPaidEvent{
        EventID:   uuid.New().String(),
        OrderID:   o.ID,
        PaidAt:    paidAt,
        Amount:    o.Total,
        PaymentID: paymentID,
    }
    o.addDomainEvent(event) // 将事件暂存到聚合内，事务提交时统一发布
    return nil
}

3.5 四者关系与 API 契约映射