airport-wiki/concepts/aodb/adr/ADR-007 查询与订阅分离.md

ADR-007 查询与订阅分离

状态

Accepted

背景

将 GraphQL Subscription 或查询层直接作为事实流会混淆读取和事件分发语义。

决策

对外查询接口和事件订阅接口分离设计。

原因

• 查询和事件分发的稳定性、回放、限流语义不同。
• 便于明确外部消费者的消费契约。
• 降低把查询接口误当权威事件骨干的风险。

后果

• 需要独立设计事件订阅网关或分发适配层。
• API 文档要分别描述查询和订阅契约。