领域驱动设计（DDD）核心概念

领域驱动设计（Domain-Driven Design，DDD）由 Eric Evans 在其经典著作中提出，是一套应对复杂业务建模的软件方法论。其核心在于：将业务领域的知识深度融入软件模型，而非让技术实现主导架构。本章将逐一拆解 DDD 的五大核心构造块：实体、值对象、聚合、领域事件与限界上下文，并揭示它们如何在 NestJS 限流熔断场景中协同落地。

1. 实体（Entity）

实体是具有唯一标识且生命周期持续变化的对象。两个实体即便所有属性相同，只要标识不同，就是不同的对象。在限流熔断场景中，RateLimiter 实例、CircuitBreaker 实例都是典型的实体——每个实例拥有唯一的名称或 ID，其状态（如令牌桶余量、熔断开关）随时间推移而改变。

2. 值对象（Value Object）

值对象通过属性值来定义自身，没有唯一标识，且通常是不可变的。两个值对象如果所有属性相同，则视为相等。在限流熔断领域，RateLimitConfig（包含窗口大小、最大请求数）、CircuitBreakerPolicy（包含失败阈值、超时时间）都是典型的值对象。

• 不可变性：一旦创建，属性不可修改；需要变更时创建新实例。
• 无标识：比较基于所有字段的相等性，而非 ID。
• 自包含行为：可封装校验逻辑，如 isValid()、withIncreasedThreshold()。

// 值对象示例：限流配置
export class RateLimitConfig {
  constructor(
    public readonly windowMs: number,
    public readonly maxRequests: number,
  ) {
    if (windowMs <= 0 || maxRequests <= 0) {
      throw new Error('Invalid rate limit configuration');
    }
  }

  equals(other: RateLimitConfig): boolean {
    return this.windowMs === other.windowMs
        && this.maxRequests === other.maxRequests;
  }
}

3. 聚合（Aggregate）

聚合是一组相关实体和值对象的集群，对外暴露一个聚合根作为唯一访问入口。聚合保证内部数据的一致性，所有外部操作必须通过聚合根进行。在限流熔断场景中，CircuitBreaker 聚合包含：

• 聚合根：CircuitBreaker 实体（唯一标识 + 状态）
• 内部实体：FailureRecord（记录每次失败调用）
• 值对象：CircuitBreakerPolicy（阈值、超时配置）

4. 领域事件（Domain Event）

领域事件是领域中发生的、业务人员关心的、具有业务意义的事件。它记录了“已经发生的事情”，通常以过去时态命名。在限流熔断场景中，关键领域事件包括：

// 领域事件定义
export class CircuitBreakerOpenedEvent {
  constructor(
    public readonly breakerId: string,
    public readonly failureCount: number,
    public readonly openedAt: Date = new Date(),
  ) {}
}

// 聚合根中发布事件
export class CircuitBreaker {
  private events: DomainEvent[] = [];

  recordFailure(): void {
    this.failureCount++;
    if (this.failureCount >= this.policy.failureThreshold) {
      this.state = CircuitState.OPEN;
      this.events.push(
        new CircuitBreakerOpenedEvent(this.id, this.failureCount)
      );
    }
  }

  pullEvents(): DomainEvent[] {
    const events = [...this.events];
    this.events = [];
    return events;
  }
}

5. 限界上下文（Bounded Context）

限界上下文是 DDD 中最关键的战术模式之一。它定义了模型、术语和业务规则的明确边界。每个限界上下文内部有统一的语言（Ubiquitous Language），上下文之间通过上下文映射（Context Map）进行集成。

在限流熔断课程中，我们识别出三个核心限界上下文：

• 限流上下文（Rate Limiting Context）：负责令牌桶/滑动窗口算法、配额管理、客户端速率控制。术语：令牌、窗口、配额、节流。
• 熔断上下文（Circuit Breaking Context）：负责熔断状态机、失败计数、半开试探、健康检测。术语：熔断器、阈值、半开、恢复。
• 监控上下文（Monitoring Context）：负责事件收集、指标聚合、告警触发、可视化。术语：指标、事件流、告警规则、仪表盘。

概念对比速查表