distributed-systems-architecture

# Distributed Systems Architecture ## 职责 从系统级边界统一设计一致性、交付、顺序、幂等、重试、补偿、分区与背压。backend 负责领域流程，SRE 负责运行恢复，data 负责持久化；本 Skill 负责跨节点/跨服务语义。 ## DistributedSystemsArchitectureGate | 字段 | 要求 | |---|---| | consistencyModel | strong/eventual/causal/session 等选择、读写可见性和可接受陈旧窗口 | | deliverySemantics | at-most-once / at-least-once / effectively-once，禁止无证据承诺 exactly-once | | orderingPolicy | global/partition/key ordering、乱序窗口、重放规则 | | idempotencyModel | key、scope、TTL、结果缓存、并发重复和副作用边界 | | retryBudget | retryable 分类、backoff/jitter、总预算、deadline 与 retry storm 防护 | | compensationPlan | transaction/outbox/saga/补偿动作、不可补偿边界和人工恢复 | | partitionFailureMatrix | timeout、partial failure、lease loss、split brain、clock skew、dependency outage | | backpressurePlan | producer/consumer 速率、队列上限、drop/reject/degrade、dead letter 与恢复 | | durableBatchOrchestration | 数据源耗尽、持久 cursor/checkpoint、批次节奏、多 Worker 原子聚合、durable completion、Coordinator/callback 崩溃恢复 | ## 执行流程 1. 列出节点、服务、存储、broker 和外部系统的信任/失败边界。 2. 冻结业务不变量与可接受一致性，而不是先选中间件。 3. 为每条写路径定义 delivery/order/idempotency/retry/compensation。 4. 为 lease/lock/single-active 定义丢失资格后的 fail-safe，禁止继续副作用。 5. 建立正常、重复、乱序、延迟、丢失、分区、恢复与重放矩阵。 6. 将可观测字段绑定 request/event/idempotency/trace/attempt/partition。 7. 把验证映射到 unit/integration/failure-injection/load/recovery replay。 ## DurableBatchOrchestrationProbe 队列、批处理、导入导出或 fan-out/fan-in 流程声称“完整 run”时，必须验证： 1. 数据源是否分页/流式推进至可证明耗尽，并持久化 cursor/checkpoint。 2. 批次节奏、并发和背压是否有界，重试后不会重复扩大副作用。 3. 多 Worker 的 accepted/completed/failed 计数与聚合状态是否原子、幂等...