核心概念
本页只统一术语并指向权威页面。实现步骤、运行时状态机和完整示例由对应能力页负责。
text
命令载荷
→ CommandMessage 信封
→ 聚合决策
→ DomainEventStream 中的领域事件载荷
→ 溯源聚合状态
→ 投影 / Saga / 其他处理器术语摘要
| 术语 | 在 Wow 中的稳定含义 | 主要工件 |
|---|---|---|
| 限界上下文 | 拥有聚合定义与业务语言的命名边界 | @BoundedContext |
| 聚合 | 由上下文、聚合名、租户和 ID 标识的一致性边界 | NamedAggregate、AggregateId |
| 命令 | 请求改变状态的祈使式载荷 | 数据类/对象、@CreateAggregate、@CommandRoute |
| 命令消息 | 携带命令、身份、请求、版本、Header 与路由元数据的运行时信封 | CommandMessage<C> |
| 命令聚合根 | 校验不变量并返回事件的领域对象 | @AggregateRoot、@OnCommand |
| 状态聚合根 | 只通过溯源事件重建的状态对象 | @OnSourcing |
| 领域事件 | 不可变的业务事实载荷 | 数据类/对象；显式元数据使用 @Event |
| 领域事件信封 | 增加聚合、命令、序列、修订和时间元数据的运行时事件 | DomainEvent<T> |
| 事件流 | 一次聚合命令产生的有序事件批次 | DomainEventStream |
| 事件存储 | 追加和加载聚合事件流的权威历史合同 | EventStore |
| 快照 | 加速聚合恢复的可替换派生检查点 | SnapshotStore |
| 等待阶段 | 调用方选择的命令完成定义 | SENT、PROCESSED、SNAPSHOT、PROJECTED 等 |
| 投影 | 消费事件并维护读模型的处理器 | @ProjectionProcessor、@OnEvent |
| Saga | 消费事件并发送后续命令的跨聚合协调器 | @StatelessSaga、@OnEvent |
| 事件补偿 | 对失败事件处理工作的可观察记录、调度与重试 | 补偿记录、RetrySpec |
关键边界
- 命令处理函数根据当前状态做决定并返回事件；状态只由确定、无副作用的溯源函数改变。
- EventStore 中已追加的事件流是权威历史；快照和投影是可重建的派生数据。
SENT、PROCESSED、SNAPSHOT与函数级下游阶段证明不同边界，不能相互替代。- Processor 承载普通副作用，Saga 发送跨聚合后续命令，事件补偿重试失败函数；业务反向动作仍由领域命令表达。
- 投影完成不自动证明查询可见；需要用户可见结果时，应执行真实查询验证。
权威阅读入口
| 能力 | 权威页面 |
|---|---|
| 领域边界、历史与恢复 | 领域模型、聚合与不变量、事件溯源、事件演进、快照、聚合生命周期 |
| 命令定义、调用与结果 | 命令、定义命令、发送命令、API Client、完成语义、失败与幂等 |
| 命令运行时原理 | 命令处理管线、命令等待运行时、命令传输与路由 |
| 事件处理与跨聚合协作 | 事件与协作、事件处理器、Saga、事件补偿、事件分发管线 |
| 读模型与查询 | 投影、查询、数据权限 |