Architecture Decision Records
Documente cada decisão de arquitetura com contexto

Os ADRs no Archyl estão vinculados diretamente aos elementos C4.

Ver preços
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
O problema

Dores que você conhece bem

Esses problemas se acumulam com o tempo. Quanto mais ficam sem solução, mais custam em tempo de engenharia e confiabilidade.

Decisões se perdem no Slack

Decisões críticas são tomadas em threads de Slack e chamadas.

Sem vínculo entre decisões e arquitetura

ADRs em wikis estão desconectados dos diagramas.

Decisões passadas são constantemente questionadas

Sem registros acessíveis, novos membros refazem decisões.

Como funciona

Funcionando em poucos passos

1

Crie um ADR no Archyl

Documente a decisão, contexto e opções consideradas.

2

Vincule a elementos C4

Conecte o ADR aos sistemas e componentes afetados.

3

Navegue decisões por elemento

Clique em qualquer elemento C4 para ver ADRs vinculados.

4

Consulte ADRs com IA

Use o servidor MCP para perguntar sobre decisões passadas.

Recursos

Tudo o que este recurso faz por você

ADRs vinculados a elementos C4

Cada ADR conectado aos elementos que afeta.

Rastreamento de ciclo de vida

Acompanhe o status: proposto, aceito, deprecado, substituído.

Histórico pesquisável

Encontre decisões por palavra-chave, elemento ou data.

Decisões consultáveis por IA

Ferramentas MCP permitem que assistentes consultem ADRs.

Casos de uso

Onde os times o usam

01

Seleção de tecnologia

Documente por que escolheu bancos de dados e frameworks específicos.

02

Decisões de segurança

Registre decisões críticas de segurança.

03

Planos de migração

Documente decisões de migração.

Plano gratuito para sempre

Dê a cada decisão de arquitetura um lar permanente

ADRs estruturados vinculados a elementos C4.

  • Sem cartão de crédito
  • Configuração em cinco minutos
  • Leitores são sempre gratuitos

Architecture Decision Records (ADR) - Documente o porque

Vincule decisoes de arquitetura diretamente a elementos C4. Rastreie o porque de cada escolha arquitetural com ADRs estruturados.

Architecture Decision Records

Documente cada decisão de arquitetura com contexto

Os ADRs no Archyl estão vinculados diretamente aos elementos C4.

Architecture Decision Records (ADR) | Archyl

Vincule ADRs a elementos C4 para decisões traçáveis.

architecture decision records, ferramenta ADR, documentação decisões arquitetura

Decisões se perdem no Slack

Decisões críticas são tomadas em threads de Slack e chamadas.

Sem vínculo entre decisões e arquitetura

ADRs em wikis estão desconectados dos diagramas.

Decisões passadas são constantemente questionadas

Sem registros acessíveis, novos membros refazem decisões.

Crie um ADR no Archyl

Documente a decisão, contexto e opções consideradas.

Vincule a elementos C4

Conecte o ADR aos sistemas e componentes afetados.

Navegue decisões por elemento

Clique em qualquer elemento C4 para ver ADRs vinculados.

Use o servidor MCP para perguntar sobre decisões passadas.

ADRs vinculados a elementos C4

Cada ADR conectado aos elementos que afeta.

Rastreamento de ciclo de vida

Acompanhe o status: proposto, aceito, deprecado, substituído.

Histórico pesquisável

Encontre decisões por palavra-chave, elemento ou data.

Decisões consultáveis por IA

Ferramentas MCP permitem que assistentes consultem ADRs.

Seleção de tecnologia

Documente por que escolheu bancos de dados e frameworks específicos.

Decisões de segurança

Registre decisões críticas de segurança.

Documente decisões de migração.

Dê a cada decisão de arquitetura um lar permanente

ADRs estruturados vinculados a elementos C4.