Architecture Decision Records
Documenta cada decisión de arquitectura con contexto

Los ADR en Archyl están vinculados directamente a los elementos del modelo C4, proporcionando contexto trazable para cada decisión.

Ver precios
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
El problema

Problemas que conoces demasiado bien

Estos problemas se acumulan con el tiempo. Cuanto más tiempo siguen sin resolverse, más cuestan en tiempo de ingeniería y en fiabilidad.

Las decisiones se pierden en Slack y reuniones

Las decisiones críticas se toman en hilos de Slack y llamadas de Zoom. Meses después, nadie recuerda por qué.

Sin vínculo entre decisiones y arquitectura

Incluso cuando existen ADRs en wikis, están desconectados de los diagramas.

Las decisiones pasadas se relitigan constantemente

Sin registros accesibles, los nuevos miembros cuestionan o rehacen decisiones pasadas.

Cómo funciona

En marcha en pocos pasos

1

Crea un ADR en Archyl

Documenta la decisión, contexto, opciones consideradas y enfoque elegido.

2

Vincula a elementos C4

Conecta el ADR a los sistemas, contenedores o componentes que afecta.

3

Navega decisiones en cada elemento

Haz clic en cualquier elemento C4 para ver todos los ADRs vinculados.

4

Consulta ADRs con asistentes de IA

Usa el servidor MCP para preguntar sobre decisiones pasadas.

Funcionalidades

Todo lo que esta función hace por ti

ADRs vinculados a elementos C4

Cada ADR está conectado a los elementos que afecta.

Seguimiento del ciclo de vida

Sigue el estado: propuesto, aceptado, deprecado, reemplazado.

Historial de decisiones buscable

Encuentra decisiones por palabra clave, elemento, fecha o estado.

Decisiones consultables por IA

Los nuevos miembros obtienen respuestas instantáneas sobre la lógica arquitectónica.

Casos de uso

Dónde la usan los equipos

01

Decisiones de selección tecnológica

Documenta por qué elegiste bases de datos, frameworks o servicios cloud específicos.

02

Decisiones de arquitectura de seguridad

Registra decisiones críticas de seguridad y vincúlalas a límites de confianza.

03

Planes de migración y depreciación

Documenta decisiones de migración y vincúlalas a los sistemas afectados.

Plan gratuito para siempre

Dale a cada decisión de arquitectura un hogar permanente

ADRs estructurados vinculados a elementos C4.

  • Sin tarjeta de crédito
  • Listo en cinco minutos
  • Los lectores siempre son gratis

Architecture Decision Records (ADR) - Documenta el por que

Vincula decisiones de arquitectura directamente a elementos C4. Registra el por que de cada decision arquitectonica con ADR estructurados.

Architecture Decision Records

Documenta cada decisión de arquitectura con contexto

Los ADR en Archyl están vinculados directamente a los elementos del modelo C4, proporcionando contexto trazable para cada decisión.

Architecture Decision Records (ADR) | Archyl

Vincula ADRs a elementos del modelo C4 para decisiones de arquitectura trazables.

architecture decision records, herramienta ADR, documentación decisiones arquitectura

Las decisiones se pierden en Slack y reuniones

Las decisiones críticas se toman en hilos de Slack y llamadas de Zoom. Meses después, nadie recuerda por qué.

Sin vínculo entre decisiones y arquitectura

Incluso cuando existen ADRs en wikis, están desconectados de los diagramas.

Las decisiones pasadas se relitigan constantemente

Sin registros accesibles, los nuevos miembros cuestionan o rehacen decisiones pasadas.

Crea un ADR en Archyl

Documenta la decisión, contexto, opciones consideradas y enfoque elegido.

Vincula a elementos C4

Conecta el ADR a los sistemas, contenedores o componentes que afecta.

Navega decisiones en cada elemento

Haz clic en cualquier elemento C4 para ver todos los ADRs vinculados.

Consulta ADRs con asistentes de IA

Usa el servidor MCP para preguntar sobre decisiones pasadas.

ADRs vinculados a elementos C4

Cada ADR está conectado a los elementos que afecta.

Seguimiento del ciclo de vida

Sigue el estado: propuesto, aceptado, deprecado, reemplazado.

Historial de decisiones buscable

Encuentra decisiones por palabra clave, elemento, fecha o estado.

Decisiones consultables por IA

Los nuevos miembros obtienen respuestas instantáneas sobre la lógica arquitectónica.

Decisiones de selección tecnológica

Documenta por qué elegiste bases de datos, frameworks o servicios cloud específicos.

Decisiones de arquitectura de seguridad

Registra decisiones críticas de seguridad y vincúlalas a límites de confianza.

Planes de migración y depreciación

Documenta decisiones de migración y vincúlalas a los sistemas afectados.

Dale a cada decisión de arquitectura un hogar permanente

ADRs estructurados vinculados a elementos C4.