Architecture Decision Records
Documentez chaque décision d'architecture avec son contexte

Les Architecture Decision Records dans Archyl sont liés directement aux éléments du modèle C4, fournissant un contexte traçable pour chaque décision. Sachez non seulement à quoi ressemble votre système, mais pourquoi il a été conçu ainsi.

Voir les tarifs
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
Le problème

Des douleurs que vous connaissez trop bien

Ces difficultés s'accumulent avec le temps. Plus elles restent sans réponse, plus elles coûtent en temps d'ingénierie et en fiabilité.

Les décisions se perdent dans Slack et les réunions

Les décisions d'architecture critiques sont prises dans des fils Slack, des appels Zoom et des sessions tableau blanc. Des mois plus tard, personne ne sait pourquoi le système fonctionne ainsi.

Aucun lien entre décisions et architecture

Même quand des ADR existent dans des wikis, ils sont déconnectés des diagrammes d'architecture. Impossible de voir quels éléments sont affectés par quelles décisions.

Les décisions passées sont sans cesse remises en question

Sans registres accessibles, les nouveaux membres de l'équipe remettent en question ou refont des décisions passées, gaspillant du temps et créant de la confusion.

Comment ça marche

Opérationnel en quelques étapes

1

Créez un ADR dans Archyl

Documentez la décision, le contexte, les options envisagées et l'approche choisie avec l'éditeur ADR structuré.

2

Liez aux éléments C4

Connectez l'ADR aux systèmes, conteneurs ou composants spécifiques qu'il affecte. La décision devient partie du contexte de l'élément.

3

Parcourez les décisions sur chaque élément

Cliquez sur n'importe quel élément C4 pour voir tous les ADR liés. Comprenez pourquoi il existe, pourquoi il a été conçu ainsi et quelles alternatives ont été envisagées.

4

Interrogez les ADR avec des assistants IA

Utilisez le serveur MCP pour demander aux assistants IA les décisions passées : 'Pourquoi avons-nous choisi PostgreSQL ?' 'Quelles alternatives ont été envisagées pour le service d'auth ?'

Fonctionnalités

Tout ce que cette fonctionnalité fait pour vous

ADR liés aux éléments C4

Chaque ADR est connecté aux éléments d'architecture qu'il affecte. Naviguez du diagramme à la décision de manière fluide.

Suivi du cycle de vie des décisions

Suivez le statut des ADR : proposé, accepté, déprécié, remplacé. Voyez l'évolution des décisions dans le temps.

Historique des décisions recherchable

Trouvez les décisions passées par mot-clé, élément, date ou statut. Ne perdez jamais la trace du pourquoi.

Décisions interrogeables par l'IA

Les outils du serveur MCP permettent aux assistants IA d'interroger les ADR. Les nouveaux arrivants obtiennent des réponses instantanées sur la logique architecturale.

Cas d'usage

Comment les équipes s'en servent

01

Décisions de sélection technologique

Documentez pourquoi vous avez choisi des bases de données, frameworks ou services cloud spécifiques. Liez l'ADR aux conteneurs qui les utilisent.

02

Choix d'architecture de sécurité

Enregistrez les décisions critiques de sécurité et liez-les aux frontières de confiance et aux composants de traitement des données.

03

Plans de migration et dépréciation

Documentez les décisions de migration et liez-les aux systèmes en cours de migration ou de dépréciation.

Plan gratuit à vie

Donnez à chaque décision d'architecture un foyer permanent

Des ADR structurés liés aux éléments C4. Ne perdez plus jamais le contexte derrière vos décisions d'architecture.

  • Sans carte bancaire
  • Prêt en cinq minutes
  • Les lecteurs sont toujours gratuits

Architecture Decision Records (ADR) - Documentez le pourquoi

Liez les decisions d'architecture directement aux elements C4. Tracez le pourquoi de chaque choix architectural avec des ADR structures.

Architecture Decision Records

Documentez chaque décision d'architecture avec son contexte

Les Architecture Decision Records dans Archyl sont liés directement aux éléments du modèle C4, fournissant un contexte traçable pour chaque décision. Sachez non seulement à quoi ressemble votre système, mais pourquoi il a été conçu ainsi.

Architecture Decision Records (ADR) | Archyl

Liez les ADR aux éléments du modèle C4 pour des décisions d'architecture traçables. Documentez le pourquoi de la conception de votre système.

architecture décision records, outil ADR, documentation décisions architecture, ADR liés au C4, décisions architecture traçables

Les décisions se perdent dans Slack et les réunions

Les décisions d'architecture critiques sont prises dans des fils Slack, des appels Zoom et des sessions tableau blanc. Des mois plus tard, personne ne sait pourquoi le système fonctionne ainsi.

Aucun lien entre décisions et architecture

Même quand des ADR existent dans des wikis, ils sont déconnectés des diagrammes d'architecture. Impossible de voir quels éléments sont affectés par quelles décisions.

Les décisions passées sont sans cesse remises en question

Sans registres accessibles, les nouveaux membres de l'équipe remettent en question ou refont des décisions passées, gaspillant du temps et créant de la confusion.

Créez un ADR dans Archyl

Documentez la décision, le contexte, les options envisagées et l'approche choisie avec l'éditeur ADR structuré.

Connectez l'ADR aux systèmes, conteneurs ou composants spécifiques qu'il affecte. La décision devient partie du contexte de l'élément.

Parcourez les décisions sur chaque élément

Cliquez sur n'importe quel élément C4 pour voir tous les ADR liés. Comprenez pourquoi il existe, pourquoi il a été conçu ainsi et quelles alternatives ont été envisagées.

Interrogez les ADR avec des assistants IA

Utilisez le serveur MCP pour demander aux assistants IA les décisions passées : 'Pourquoi avons-nous choisi PostgreSQL ?' 'Quelles alternatives ont été envisagées pour le service d'auth ?'

ADR liés aux éléments C4

Chaque ADR est connecté aux éléments d'architecture qu'il affecte. Naviguez du diagramme à la décision de manière fluide.

Suivi du cycle de vie des décisions

Suivez le statut des ADR : proposé, accepté, déprécié, remplacé. Voyez l'évolution des décisions dans le temps.

Historique des décisions recherchable

Trouvez les décisions passées par mot-clé, élément, date ou statut. Ne perdez jamais la trace du pourquoi.

Décisions interrogeables par l'IA

Les outils du serveur MCP permettent aux assistants IA d'interroger les ADR. Les nouveaux arrivants obtiennent des réponses instantanées sur la logique architecturale.

Décisions de sélection technologique

Documentez pourquoi vous avez choisi des bases de données, frameworks ou services cloud spécifiques. Liez l'ADR aux conteneurs qui les utilisent.

Choix d'architecture de sécurité

Enregistrez les décisions critiques de sécurité et liez-les aux frontières de confiance et aux composants de traitement des données.

Plans de migration et dépréciation

Documentez les décisions de migration et liez-les aux systèmes en cours de migration ou de dépréciation.

Donnez à chaque décision d'architecture un foyer permanent

Des ADR structurés liés aux éléments C4. Ne perdez plus jamais le contexte derrière vos décisions d'architecture.

Commencer gratuitement