架构决策记录
记录每个架构决策及其背景

Archyl中的ADR直接链接到C4模型元素。

查看定价
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
问题所在

这些痛点你再熟悉不过

这些问题会随时间不断累积。拖得越久,在工程时间和系统可靠性上付出的代价就越大。

决策在Slack中丢失

关键决策在Slack线程和电话中做出。

决策与架构无关联

即使wiki中有ADR,也与图表断开。

过去的决策不断被重新讨论

新成员质疑或重做过去的决策。

工作原理

几步即可上手

1

创建ADR

记录决策、背景和考虑的选项。

2

链接到C4元素

将ADR连接到受影响的系统和组件。

3

按元素浏览决策

点击C4元素查看相关ADR。

4

用AI查询ADR

使用MCP服务器询问过去的决策。

能力

这项功能能为你做的一切

链接到C4的ADR

每个ADR连接到其影响的元素。

生命周期追踪

追踪状态:提议、接受、弃用、取代。

可搜索的历史

按关键词、元素或日期查找决策。

AI可查询

MCP工具允许AI查询ADR。

使用场景

团队如何使用它

01

技术选型决策

记录为什么选择特定数据库或框架。

02

安全架构决策

记录关键安全决策。

03

迁移计划

记录迁移决策。

永久免费方案

给每个架构决策一个永久的归属

结构化ADR链接到C4元素。

  • 无需信用卡
  • 五分钟完成设置
  • 查看者始终免费

架构决策记录 (ADR) - 记录为什么而非什么

将架构决策直接关联到C4元素。通过结构化ADR追踪每个架构决策的原因。

FileText

记录每个架构决策及其背景

Archyl中的ADR直接链接到C4模型元素。

架构决策记录(ADR) | Archyl

将ADR链接到C4元素以实现可追溯的决策。

架构决策记录, ADR工具

TriangleAlert

决策在Slack中丢失

关键决策在Slack线程和电话中做出。

决策与架构无关联

即使wiki中有ADR,也与图表断开。

RefreshCw

过去的决策不断被重新讨论

新成员质疑或重做过去的决策。

记录决策、背景和考虑的选项。

链接到C4元素

将ADR连接到受影响的系统和组件。

按元素浏览决策

点击C4元素查看相关ADR。

用AI查询ADR

使用MCP服务器询问过去的决策。

链接到C4的ADR

每个ADR连接到其影响的元素。

GitPullRequestArrow

追踪状态:提议、接受、弃用、取代。

按关键词、元素或日期查找决策。

MCP工具允许AI查询ADR。

记录为什么选择特定数据库或框架。

记录关键安全决策。

记录迁移决策。

给每个架构决策一个永久的归属

结构化ADR链接到C4元素。