아키텍처 결정 기록
모든 아키텍처 결정을 컨텍스트와 함께 기록

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 스레드와 통화에서 이루어집니다.

결정과 아키텍처의 연결 없음

위키의 ADR은 다이어그램과 단절되어 있습니다.

과거 결정이 반복적으로 재논의

새 구성원이 과거 결정을 뒤집습니다.

작동 방식

몇 단계면 바로 시작

1

ADR 생성

결정, 컨텍스트, 고려된 옵션을 기록합니다.

2

C4 요소에 연결

영향받는 시스템과 컴포넌트에 연결합니다.

3

요소별 결정 탐색

C4 요소를 클릭하여 연결된 ADR을 확인합니다.

4

AI로 ADR 조회

MCP 서버로 과거 결정을 질문합니다.

기능

이 기능이 해 주는 모든 것

C4에 연결된 ADR

각 ADR이 영향을 주는 요소에 연결됩니다.

수명주기 추적

상태 추적: 제안, 수락, 폐기, 대체.

검색 가능한 이력

키워드, 요소, 날짜로 결정을 검색합니다.

AI로 조회 가능

MCP 도구로 ADR을 조회합니다.

사용 사례

팀들이 활용하는 곳

01

기술 선택 결정

특정 DB나 프레임워크를 선택한 이유를 기록합니다.

02

보안 아키텍처 결정

중요한 보안 결정을 기록합니다.

03

마이그레이션 계획

마이그레이션 결정을 기록합니다.

평생 무료 플랜

모든 아키텍처 결정에 영구적인 자리를

C4 요소에 연결된 구조화된 ADR.

  • 신용카드 불필요
  • 5분이면 설정 완료
  • 뷰어는 언제나 무료

아키텍처 결정 기록 (ADR) - 무엇이 아닌 왜를 기록

아키텍처 결정을 C4 요소에 직접 연결. 구조화된 ADR로 각 아키텍처 선택의 이유를 추적.

FileText

아키텍처 결정 기록

모든 아키텍처 결정을 컨텍스트와 함께 기록

Archyl의 ADR은 C4 모델 요소에 직접 연결됩니다.

Architecture Decision Records (ADR) | Archyl

추적 가능한 결정을 위해 ADR을 C4 요소에 연결합니다.

아키텍처 결정 기록, ADR 도구

TriangleAlert

결정이 Slack에서 유실

중요한 결정이 Slack 스레드와 통화에서 이루어집니다.

결정과 아키텍처의 연결 없음

위키의 ADR은 다이어그램과 단절되어 있습니다.

RefreshCw

과거 결정이 반복적으로 재논의

새 구성원이 과거 결정을 뒤집습니다.

결정, 컨텍스트, 고려된 옵션을 기록합니다.

C4 요소에 연결

영향받는 시스템과 컴포넌트에 연결합니다.

요소별 결정 탐색

C4 요소를 클릭하여 연결된 ADR을 확인합니다.

AI로 ADR 조회

MCP 서버로 과거 결정을 질문합니다.

C4에 연결된 ADR

각 ADR이 영향을 주는 요소에 연결됩니다.

GitPullRequestArrow

수명주기 추적

상태 추적: 제안, 수락, 폐기, 대체.

검색 가능한 이력

키워드, 요소, 날짜로 결정을 검색합니다.

AI로 조회 가능

MCP 도구로 ADR을 조회합니다.

기술 선택 결정

특정 DB나 프레임워크를 선택한 이유를 기록합니다.

보안 아키텍처 결정

중요한 보안 결정을 기록합니다.

마이그레이션 계획

마이그레이션 결정을 기록합니다.

모든 아키텍처 결정에 영구적인 자리를

C4 요소에 연결된 구조화된 ADR.