1. 领域驱动设计基础：DDD 核心概念

领域驱动设计（Domain-Driven Design，DDD）是一种将业务领域作为软件设计核心的建模方法。在《Go 报表环境回放领域边界》课程中，DDD 是构建高内聚、低耦合报表回放系统的理论基础。本节将系统梳理 DDD 的四大核心构造块：实体、值对象、聚合与聚合根、领域事件。

1.1 核心概念总览

DDD 通过以下构造块将复杂的业务逻辑映射到代码模型：

1.2 实体与值对象

实体和值对象是 DDD 中最基础的两种领域对象，它们的区别直接决定了建模方式：

• 实体（Entity）：拥有唯一标识（如 ReportID），即使其他属性全部相同，两个实体也不相等。实体的状态可以随时间变化，例如报表的状态从“生成中”变为“已完成”。
• 值对象（Value Object）：没有标识，完全由属性值定义相等性。值对象一旦创建就不可变，修改即替换。例如 ReportFilter（报表过滤条件）就是一个典型的值对象。

Go 代码示例：实体 vs 值对象

// 实体：Report 拥有唯一标识 ReportID
type ReportID string

type Report struct {
    ID        ReportID
    Name      string
    Status    ReportStatus
    CreatedAt time.Time
}

// 值对象：TimeRange 完全由 Start 和 End 定义
type TimeRange struct {
    Start time.Time
    End   time.Time
}

func (tr TimeRange) Duration() time.Duration {
    return tr.End.Sub(tr.Start)
}

// 值对象不可变，修改时返回新实例
func (tr TimeRange) WithNewEnd(newEnd time.Time) TimeRange {
    return TimeRange{Start: tr.Start, End: newEnd}
}

1.3 聚合与聚合根

聚合是 DDD 中维护数据一致性的核心机制。一个聚合包含一组实体和值对象，外部只能通过聚合根访问聚合内部的对象。

聚合设计三原则

1. 一致性边界：聚合内部的所有变更必须在一次事务中完成，保证业务不变量不被破坏。
2. 聚合根唯一入口：外部对象只能持有聚合根的引用，不能直接获取内部实体。
3. 小聚合优先：聚合应尽量小，只包含必须保持一致的属性，避免性能瓶颈。

Go 代码示例：报表聚合

// 聚合根：ReportAggregate
type ReportAggregate struct {
    report   *Report          // 聚合根实体
    sections []ReportSection  // 内部实体列表
    filter   ReportFilter     // 值对象
}

// 外部只能通过聚合根的方法操作
func (ra *ReportAggregate) AddSection(name string, content []byte) error {
    if ra.report.Status != ReportStatusDraft {
        return ErrReportNotDraft
    }
    section := ReportSection{
        ID:      generateSectionID(),
        Name:    name,
        Content: content,
    }
    ra.sections = append(ra.sections, section)
    return nil
}

// 获取只读快照，不暴露内部引用
func (ra *ReportAggregate) Snapshot() ReportSnapshot {
    return ReportSnapshot{
        ReportID: ra.report.ID,
        Status:   ra.report.Status,
        Sections: copySections(ra.sections),
    }
}

1.4 领域事件

领域事件用于记录聚合内部发生的、对业务有意义的过往事实。在 Go 报表回放系统中，领域事件是实现事件溯源和系统间解耦的关键。

领域事件的特征

• 不可变：事件一旦发布，其内容不可更改。
• 携带上下文：包含事件发生的时间、触发聚合的 ID、以及相关业务数据。
• 命名使用过去时：如 ReportGenerated、ReplayStarted。

Go 代码示例：领域事件定义与发布

// 领域事件接口
type DomainEvent interface {
    EventName() string
    OccurredAt() time.Time
}

// 具体事件：报表生成完成
type ReportGenerated struct {
    ReportID   ReportID
    GeneratedAt time.Time
    TotalSections int
}

func (e ReportGenerated) EventName() string {
    return "report.generated.v1"
}

func (e ReportGenerated) OccurredAt() time.Time {
    return e.GeneratedAt
}

// 聚合根中发布事件
func (ra *ReportAggregate) Generate() ([]DomainEvent, error) {
    if ra.report.Status != ReportStatusDraft {
        return nil, ErrInvalidStatus
    }
    ra.report.Status = ReportStatusCompleted
    ra.report.CompletedAt = time.Now()

    event := ReportGenerated{
        ReportID:      ra.report.ID,
        GeneratedAt:   ra.report.CompletedAt,
        TotalSections: len(ra.sections),
    }
    return []DomainEvent{event}, nil
}

1.5 DDD 核心构造块关系图

下图展示了实体、值对象、聚合、聚合根和领域事件之间的协作关系：

1.6 领域事件驱动流程

在报表回放系统中，领域事件不仅用于记录，还驱动着跨聚合的业务流程。下图展示了事件如何串联报表生成与回放启动两个聚合：

1.7 本章小结