Skip to content

Decisions

Architecture Decision Records

The architecture decision log.

Decisions retain their original dates and statuses. These summaries describe the choices and trade-offs in light of the current code. Superseded decisions remain in the log. The former hosting and observability provider records were retired during reorganization; they remain available in Git history.

Decision Date Status
0001 - Rewrite as services 2025-12-25 Superseded in part by ADR 0005; the rewrite and service boundaries remain.
0002 - Go for services 2026-01-04 Accepted; refined by ADR 0005.
0003 - NATS for service communication 2026-05-23 Accepted.
0004 - MySQL for durable state 2026-05-23 Accepted.
0005 - Elixir for Twitch ingress 2026-05-23 Accepted; supersedes ADR 0001 in part.
0006 - Data service ownership 2026-06-09 Accepted.
0007 - Cache and write-behind 2026-06-09 Accepted.
0008 - Shared read projection 2026-06-09 Accepted.
0009 - Transactions owns giveaway awards 2026-09-15 Accepted and implemented; fulfillment paths have separate gates.
0010 - Kit owns the public variable inventory 2026-09-18 Accepted and implemented.

To add a decision, run bun run adr:new "Short title" from web/docs/, then add its translation in fr/adr/ with the same number and filename. Reserve ADRs for choices that are costly to reverse, non-obvious and involve a real trade-off.