2. 实体（Entity）建模：实体的定义、唯一标识、Go中实体的结构体设计与值对象区分

2.1 实体的核心定义

在领域驱动设计中，实体（Entity） 是具有唯一标识且在其生命周期中状态可变的领域对象。实体的本质特征不是其属性值，而是其身份的连续性。即使两个实体的所有属性完全相同，只要标识不同，它们就是不同的对象。

2.2 唯一标识的设计策略

唯一标识是实体的基石。在 Go 语言中，常见的标识类型选择如下：

• UUID / ULID： 分布式系统首选，无需中心化生成，推荐使用 github.com/google/uuid 或 github.com/oklog/ulid/v2。
• 自增整数： 适合单体应用或内部系统，由数据库生成，但不利于分布式迁移。
• 业务主键： 如身份证号、车牌号，但业务规则可能变化，耦合度高。
• 组合标识： 如 TenantID + OrderNumber，用于多租户场景。

2.3 Go 中实体的结构体设计

在 Go 中，实体通常定义为结构体，并将唯一标识作为不可导出的字段或通过接口约束。以下是标准设计模式：

// 定义标识类型
type UserID string

// 实体结构体
type User struct {
    id       UserID      // 不可导出，防止外部直接修改
    name     string
    email    string
    status   UserStatus
    version  int         // 乐观锁版本号
}

// 构造函数：确保实体创建时必带 ID
func NewUser(id UserID, name string, email string) (*User, error) {
    if id == "" {
        return nil, errors.New("user id must not be empty")
    }
    if name == "" {
        return nil, errors.New("user name must not be empty")
    }
    return &User{
        id:     id,
        name:   name,
        email:  email,
        status: UserStatusActive,
    }, nil
}

// 只读访问器
func (u *User) ID() UserID        { return u.id }
func (u *User) Name() string      { return u.name }
func (u *User) Email() string     { return u.email }
func (u *User) Status() UserStatus { return u.status }

// 业务行为：封装状态变更逻辑
func (u *User) ChangeEmail(newEmail string) error {
    if !strings.Contains(newEmail, "@") {
        return errors.New("invalid email format")
    }
    u.email = newEmail
    return nil
}

func (u *User) Deactivate() {
    u.status = UserStatusInactive
}

2.4 实体与值对象的区分

值对象（Value Object）是 DDD 中另一个核心概念，与实体形成互补。区分两者的核心标准是：是否拥有唯一标识 以及 是否可变。

在 Go 中，值对象通常设计为不可变结构体，不暴露 Setter，且实现 Equals() 方法：

// 值对象：地址
type Address struct {
    province string
    city     string
    district string
    detail   string
}

// 构造函数：值对象必须通过构造函数完整创建
func NewAddress(province, city, district, detail string) Address {
    return Address{
        province: province,
        city:     city,
        district: district,
        detail:   detail,
    }
}

// 值对象相等性比较
func (a Address) Equals(other Address) bool {
    return a.province == other.province &&
        a.city == other.city &&
        a.district == other.district &&
        a.detail == other.detail
}

// 值对象不可变：不提供 Setter，需要变更时返回新实例
func (a Address) WithDetail(newDetail string) Address {
    return Address{
        province: a.province,
        city:     a.city,
        district: a.district,
        detail:   newDetail,
    }
}

2.5 实体与值对象的协作关系

下图展示了实体与值对象在领域模型中的典型协作模式：

2.6 实战决策矩阵

在建模过程中，使用以下矩阵快速判断一个概念应设计为实体还是值对象：