GATEWAY PATTERN

게이트웨이는 외부 계약을 안정화하고 서비스 결합을 줄인다

인증, 라우팅, 집계, timeout, 관측은 gateway에 두되 도메인 규칙은 하위 서비스 소유로 남긴다.

Route 클라이언트 URL을 내부 service endpoint와 분리한다.

Auth JWT 검증과 rate limit을 먼저 적용하고 세부 권한은 서비스가 재확인한다.

Aggregate 여러 service 응답을 묶을 때 partial failure 기준을 둔다.

Resilience timeout, circuit breaker, retry budget으로 느린 downstream을 격리한다.

추적성

gateway가 만든 correlation id를 내부 호출과 로그에 전달한다.

계약 관리

외부 DTO와 내부 메시지 DTO를 분리해 서비스 구조가 API에 새지 않게 한다.

성능 기준

fan-out 호출 수, p95 latency, error ratio를 gateway dashboard로 본다.