The orders service currently stores mutable order rows and emits best-effort webhooks. Auditors need a complete history of state transitions, and support must be able to reconstruct an order at a prior point in time.
Sign in to save downloads to your library and vote.
Preview
Orders architecture decision context
The orders service currently stores mutable order rows and emits best-effort webhooks. Auditors need a complete history of state transitions, and support must be able to reconstruct an order at a prior point in time.
Options discussed:
- Keep the current model and add an append-only audit table.
- Adopt event sourcing for orders and build read projections.
- Use database change-data capture as the audit history.
Event sourcing improves traceability and replay, but adds projection rebuilds, event versioning, eventual consistency, and operational complexity. The team has event-stream experience, but the reporting service expects synchronous reads. The decision applies only to the orders bounded context.
Ingestion metadata
- Source catalog
- agent-skills
- Repository
- addyosmani/agent-skills · main
- File path
- evals/fixtures/documentation-and-adrs/decision-context.md
- Last refreshed
- 10/24/2026, 3:00:12 AM (5h ago)
- Refresh schedule
- Daily · 03:00 UTC
- Dedupe status
- Unique · deduped by (source, url)