DataDrivenAlex's picture
Add Transactional Outbox Reliability Lab
fbcc709 verified
Raw History Blame Contribute Delete
1.52 kB
"""Deterministic teaching simulator for dual-write delivery strategies."""
from dataclasses import dataclass
@dataclass(frozen=True)
class Result:
order_saved: bool
event_recorded: bool
event_delivered: bool
duplicate_events: int
lost_events: int
recovery: str
explanation: str
def simulate(strategy: str, crash_at: str = "none", retry: bool = True) -> Result:
"""Simulate a DB write + publish at one crash boundary."""
if strategy not in {"dual_write", "transactional_outbox"}: raise ValueError("strategy must be dual_write or transactional_outbox")
if crash_at not in {"none", "after_db", "after_publish"}: raise ValueError("unsupported crash boundary")
outbox = strategy == "transactional_outbox"
if crash_at == "after_db":
if outbox: return Result(True, True, False, 0, 0, "relay retry" if retry else "pending outbox", "Order and event intent committed atomically; a later relay can deliver the pending event.")
return Result(True, False, False, 0, 1, "no recovery", "Order committed before a crash; separate publish never ran, so its event is lost.")
if crash_at == "after_publish" and outbox:
return Result(True, True, True, 1 if retry else 0, 0, "idempotency key suppresses duplicate" if retry else "none", "Crash after broker acknowledgement can cause redelivery; consumers need idempotency to suppress duplicates.")
return Result(True, outbox, True, 0, 0, "none", "Order and event delivery completed in this simulated run.")