Architecture Decision Records
Dokumentieren Sie jede Architekturentscheidung mit Kontext

ADRs in Archyl sind direkt mit C4-Modellelementen verknüpft und bieten nachvollziehbaren Kontext für jede Entscheidung.

Preise ansehen
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
Das Problem

Probleme, die Sie nur zu gut kennen

Diese Herausforderungen verschärfen sich mit der Zeit. Je länger sie ungelöst bleiben, desto mehr kosten sie an Entwicklungszeit und Zuverlässigkeit.

Entscheidungen gehen in Slack verloren

Kritische Entscheidungen werden in Slack-Threads und Zoom-Calls getroffen.

Keine Verbindung zwischen Entscheidungen und Architektur

Selbst wenn ADRs in Wikis existieren, sind sie von den Diagrammen getrennt.

Vergangene Entscheidungen werden ständig hinterfragt

Ohne zugängliche Aufzeichnungen stellen neue Teammitglieder vergangene Entscheidungen in Frage.

So funktioniert's

In wenigen Schritten startklar

1

Erstellen Sie einen ADR

Dokumentieren Sie die Entscheidung, den Kontext und die gewählte Lösung.

2

Verknüpfen Sie mit C4-Elementen

Verbinden Sie den ADR mit betroffenen Systemen, Containern oder Komponenten.

3

Durchsuchen Sie Entscheidungen pro Element

Klicken Sie auf ein C4-Element, um alle verknüpften ADRs zu sehen.

4

Fragen Sie ADRs mit KI-Assistenten ab

Nutzen Sie den MCP-Server, um nach vergangenen Entscheidungen zu fragen.

Funktionen

Alles, was diese Funktion für Sie leistet

ADRs verknüpft mit C4-Elementen

Jeder ADR ist mit den betroffenen Elementen verbunden.

Lebenszyklus-Tracking

Verfolgen Sie den ADR-Status: vorgeschlagen, akzeptiert, veraltet, ersetzt.

Durchsuchbarer Entscheidungsverlauf

Finden Sie Entscheidungen nach Stichwort, Element, Datum oder Status.

KI-abfragbare Entscheidungen

MCP-Tools ermöglichen KI-Assistenten, ADRs abzufragen.

Anwendungsfälle

Wo Teams sie einsetzen

01

Technologie-Auswahl-Entscheidungen

Dokumentieren Sie, warum Sie bestimmte Datenbanken oder Frameworks gewählt haben.

02

Sicherheitsarchitektur-Entscheidungen

Zeichnen Sie sicherheitskritische Entscheidungen auf.

03

Migrations- und Abschaltungspläne

Dokumentieren Sie Migrationsentscheidungen und verknüpfen Sie sie.

Dauerhaft kostenloser Plan

Geben Sie jeder Architekturentscheidung ein permanentes Zuhause

Strukturierte ADRs verknüpft mit C4-Elementen.

  • Keine Kreditkarte
  • In fünf Minuten eingerichtet
  • Betrachter sind immer kostenlos

Architecture Decision Records (ADR) - Das Warum dokumentieren

Verknuepfen Sie Architekturentscheidungen direkt mit C4-Elementen. Verfolgen Sie das Warum hinter jeder Architekturentscheidung mit strukturierten ADRs.

Architecture Decision Records

Dokumentieren Sie jede Architekturentscheidung mit Kontext

ADRs in Archyl sind direkt mit C4-Modellelementen verknüpft und bieten nachvollziehbaren Kontext für jede Entscheidung.

Architecture Decision Records (ADR) | Archyl

Verknüpfen Sie ADRs mit C4-Elementen für nachvollziehbare Architekturentscheidungen.

Architecture Decision Records, ADR-Tool, Architekturentscheidungen-Dokumentation

Entscheidungen gehen in Slack verloren

Kritische Entscheidungen werden in Slack-Threads und Zoom-Calls getroffen.

Keine Verbindung zwischen Entscheidungen und Architektur

Selbst wenn ADRs in Wikis existieren, sind sie von den Diagrammen getrennt.

Vergangene Entscheidungen werden ständig hinterfragt

Ohne zugängliche Aufzeichnungen stellen neue Teammitglieder vergangene Entscheidungen in Frage.

Erstellen Sie einen ADR

Dokumentieren Sie die Entscheidung, den Kontext und die gewählte Lösung.

Verknüpfen Sie mit C4-Elementen

Verbinden Sie den ADR mit betroffenen Systemen, Containern oder Komponenten.

Durchsuchen Sie Entscheidungen pro Element

Klicken Sie auf ein C4-Element, um alle verknüpften ADRs zu sehen.

Fragen Sie ADRs mit KI-Assistenten ab

Nutzen Sie den MCP-Server, um nach vergangenen Entscheidungen zu fragen.

ADRs verknüpft mit C4-Elementen

Jeder ADR ist mit den betroffenen Elementen verbunden.

Lebenszyklus-Tracking

Verfolgen Sie den ADR-Status: vorgeschlagen, akzeptiert, veraltet, ersetzt.

Durchsuchbarer Entscheidungsverlauf

Finden Sie Entscheidungen nach Stichwort, Element, Datum oder Status.

KI-abfragbare Entscheidungen

MCP-Tools ermöglichen KI-Assistenten, ADRs abzufragen.

Technologie-Auswahl-Entscheidungen

Dokumentieren Sie, warum Sie bestimmte Datenbanken oder Frameworks gewählt haben.

Sicherheitsarchitektur-Entscheidungen

Zeichnen Sie sicherheitskritische Entscheidungen auf.

Migrations- und Abschaltungspläne

Dokumentieren Sie Migrationsentscheidungen und verknüpfen Sie sie.

Geben Sie jeder Architekturentscheidung ein permanentes Zuhause

Strukturierte ADRs verknüpft mit C4-Elementen.