1. 领域边界概念

1.1 什么是领域边界

领域边界（Domain Boundary）是软件架构中用于划分业务逻辑范围、职责归属与数据一致性的逻辑或物理界线。它定义了“什么属于这个子域，什么不属于”，是微服务拆分与 API 设计的首要决策依据。

领域边界并非单纯的技术分层，而是从业务语义出发，将高内聚、低耦合的业务能力聚合为一个独立的自治单元。每个边界内部拥有完整的领域模型、业务规则与数据主权，对外仅通过契约（Contract）进行交互。

1.2 领域边界在微服务中的重要性

微服务架构的核心挑战不在于技术选型，而在于如何正确划分服务边界。错误的边界划分会导致服务间过度耦合、分布式事务泛滥、数据一致性难以保障，最终使微服务退化为“分布式单体”。

1.3 领域边界与限界上下文的关系

限界上下文（Bounded Context）是领域驱动设计（DDD）中的核心战术模式，它定义了领域模型的适用范围与语义边界。领域边界与限界上下文之间存在紧密的映射关系：一个限界上下文对应一个领域边界。

在 DDD 战略设计中，限界上下文通过以下机制保障领域边界的完整性：

• 统一语言（Ubiquitous Language）：每个限界上下文内部使用统一的术语体系，避免一词多义或多词一义。
• 上下文映射（Context Map）：显式描述限界上下文之间的关系，如合作关系（Partnership）、共享内核（Shared Kernel）、防腐层（Anti-Corruption Layer）等。
• 领域事件（Domain Event）：跨上下文通信的标准方式，确保数据最终一致性与业务可追溯性。

1.4 限界上下文之间的协作模式

当多个限界上下文需要交互时，DDD 提供了多种上下文映射模式，每种模式对应不同的领域边界关系：

1.5 领域边界在 OpenAPI 设计中的体现

OpenAPI 规范作为 API 契约的标准描述语言，天然适合表达领域边界。以下是在 OpenAPI 中体现领域边界的关键实践：

• 独立 API 文档：每个限界上下文拥有独立的 openapi.yaml 文件，包含该上下文的所有端点、模型、参数。
• 语义化路径：路径命名反映业务实体与操作，如 /orders/{orderId}/items 而非 /getOrderItems。
• 模型隔离：不同上下文的模型即使名称相同（如 User），也应在各自文档中独立定义，避免跨上下文引用。
• 版本策略：每个上下文独立版本化，版本号反映该上下文的契约变更，而非全局版本。

# 订单上下文 API 文档片段
openapi: 3.1.0
info:
  title: 订单服务 API
  version: 2.1.0
  description: 订单限界上下文对外提供的 API 契约
paths:
  /orders:
    post:
      summary: 创建订单
      operationId: createOrder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateOrderRequest'
      responses:
        '201':
          description: 订单创建成功
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Order'
components:
  schemas:
    Order:
      type: object
      properties:
        orderId:
          type: string
        status:
          type: string
          enum: [pending, confirmed, shipped, delivered]
        items:
          type: array
          items:
            $ref: '#/components/schemas/OrderItem'
    OrderItem:
      type: object
      properties:
        productId:
          type: string
        quantity:
          type: integer
        price:
          type: number