命令
命令表达一次改变聚合状态的业务意图。应用先定义载荷和目标聚合，再选择应用内 CommandGateway、聚合 HTTP 路由或全局命令门面发送，并只等待调用方真正需要的完成阶段。
命令从业务意图开始，以持久事实和可观察的完成信号连接下游协作。
快速入口
| 目标 | 入口 |
|---|---|
| 定义并发送命令 | 先读定义命令，再读发送命令 |
| 服务间调用 | 使用 API Client 调用全局命令门面 |
| 选择完成阶段 | 阅读完成语义 |
| 定位超时、重复请求与下游失败 | 阅读失败与幂等 |
应用使用
- 用定义命令确定载荷、目标聚合和处理函数。
- 用发送命令在本地 Gateway、聚合路由与全局门面之间选择。
- 跨服务调用时使用 API Client，并接受它当前只返回最终结果的能力边界。
- 用完成语义选择满足响应合同的最早阶段。
这条阅读轨回答“应用怎样调用”，不展开 Dispatcher、Filter、WaitState 或 notifier 的实现。
工作原理
需要解释运行时时，先读命令处理管线，再读命令等待运行时与命令传输和路由。它们负责 Gateway 到聚合处理、事件追加和阶段信号的时序；应用页面只引用这些结果，不复制内部状态机。
故障处理回到失败与幂等，按 commandId、requestId、聚合身份、stage 与错误码收集证据。