Skip to main content

ADR-004: Workflow State in PostgreSQL with Outbox Pattern

  • Status: Accepted
  • Date: 2026-02-07

Context​

Workflows require durable state, idempotency, and reliable event emission.

Decision​

Store workflow state in PostgreSQL and use the outbox pattern for durable event emission to the event bus.

Consequences​

  • Ensures state and event consistency.
  • Requires a background dispatcher for outbox records.
  • Adds schema and operational complexity but improves correctness.