Architecture Decision Records
Documenta ogni decisione di architettura con contesto

Gli ADR in Archyl sono collegati direttamente agli elementi C4.

Vedi i prezzi
app.archyl.com

Aurora Commerce

Platform team

Project

Systems

Storefront
Checkout
Payments
Fulfilment
AL

Ada Lovelace

Architect

Aurora Commerce/Decisions/ADR-017
Search the architecture…K
New ADR
ALMDKS
AI

Decision records

23
AllAcceptedProposedSuperseded
017

Enforce rate limiting at the API gateway

ProposedOct 143
016

Idempotency keys on payment operations

ProposedOct 92
015

Split payments out of Checkout

AcceptedSep 304
014

PostgreSQL as the single source of truth

AcceptedSep 125
013

Event bus for order side effects

AcceptedAug 283
012

Synchronous fraud check on checkout

SupersededAug 22
011

Per-team ownership of containers

AcceptedJul 196
ADR-017·Updated Oct 14 by Ada Lovelace

Enforce rate limiting at the API gateway

ProposedDeciders
ALMDKS
Oct 14, 2026

Context

Checkout API and Payments API each throttle requests in-process, with different limits. Bursts during the October sale exhausted the Payments pool while the gateway stayed idle.

Decision

All throttling moves to the API Gateway. Services stop implementing their own limiters; limits are declared per route in gateway/limits.yaml.

Consequences

One place to tune limits and observe rejections. The gateway becomes a hard dependency of every public route, so it runs with three replicas minimum.

Linked elements

API GatewayContainer
Checkout APIAPI
RateLimiterComponent

Discussion

MD

Marc Dubois 2h

Agreed. @Kenji Sato can we set the default to 600 req/min per client?

👍 4🚀 2👀 1
Il problema

Problemi che conosci fin troppo bene

Queste difficoltà si accumulano nel tempo. Più a lungo restano irrisolte, più costano in tempo di sviluppo e affidabilità.

Le decisioni si perdono su Slack

Decisioni critiche prese in thread Slack e call.

Nessun collegamento decisioni-architettura

Gli ADR nei wiki sono scollegati dai diagrammi.

Le decisioni passate vengono ridiscusse

Senza registri accessibili, i nuovi membri rifanno decisioni.

Come funziona

Operativo in pochi passaggi

1

Crea un ADR

Documenta decisione, contesto e opzioni.

2

Collega a elementi C4

Connetti l'ADR ai sistemi e componenti.

3

Naviga decisioni per elemento

Clicca su un elemento C4 per vedere gli ADR.

4

Interroga ADR con IA

Usa il server MCP per chiedere sulle decisioni.

Funzionalità

Tutto ciò che questa funzionalità fa per te

ADR collegati a C4

Ogni ADR connesso agli elementi che influenza.

Tracciamento ciclo di vita

Segui lo stato: proposto, accettato, deprecato.

Cronologia ricercabile

Trova decisioni per parola chiave o data.

Decisioni interrogabili via IA

Strumenti MCP per consultare ADR.

Casi d'uso

Dove la usano i team

01

Selezione tecnologica

Documenta perché hai scelto specifici database o framework.

02

Decisioni di sicurezza

Registra decisioni critiche di sicurezza.

03

Piani di migrazione

Documenta decisioni di migrazione.

Piano gratuito per sempre

Dai a ogni decisione un posto permanente

ADR strutturati collegati a elementi C4.

  • Nessuna carta di credito
  • Configurazione in cinque minuti
  • I lettori sono sempre gratuiti

Architecture Decision Records (ADR) - Documenta il perche

Collega le decisioni di architettura direttamente agli elementi C4. Traccia il perche di ogni scelta architetturale con ADR strutturati.

Architecture Decision Records

Documenta ogni decisione di architettura con contesto

Gli ADR in Archyl sono collegati direttamente agli elementi C4.

Architecture Decision Records (ADR) | Archyl

Collega ADR agli elementi C4 per decisioni tracciabili.

architecture decision records, strumento ADR

Le decisioni si perdono su Slack

Decisioni critiche prese in thread Slack e call.

Nessun collegamento decisioni-architettura

Gli ADR nei wiki sono scollegati dai diagrammi.

Le decisioni passate vengono ridiscusse

Senza registri accessibili, i nuovi membri rifanno decisioni.

Documenta decisione, contesto e opzioni.

Collega a elementi C4

Connetti l'ADR ai sistemi e componenti.

Naviga decisioni per elemento

Clicca su un elemento C4 per vedere gli ADR.

Usa il server MCP per chiedere sulle decisioni.

Ogni ADR connesso agli elementi che influenza.

Tracciamento ciclo di vita

Segui lo stato: proposto, accettato, deprecato.

Cronologia ricercabile

Trova decisioni per parola chiave o data.

Decisioni interrogabili via IA

Strumenti MCP per consultare ADR.

Selezione tecnologica

Documenta perché hai scelto specifici database o framework.

Decisioni di sicurezza

Registra decisioni critiche di sicurezza.

Documenta decisioni di migrazione.

Dai a ogni decisione un posto permanente

ADR strutturati collegati a elementi C4.