ADR-T-130_오류 코드 매핑 규칙

ADR-T-130_오류 코드 매핑 규칙

# ADR-T-130 오류 코드 매핑 규칙

1. Metadata

  • ADR ID: ADR-T-130
  • Title: 오류 코드 매핑 규칙
  • Status: draft
  • Date: 2026-03-08
  • Owner: YSY
  • Related ADRs: ADR-DS-130
  • Supersedes:
  • Superseded By:

2. Decision

  1. 도메인 실패 코드를 API 에러 포맷으로 표준화한다.
  2. 클라이언트 매핑 테이블을 버전 관리한다.
  3. 비표준 에러는 관측 가능하도록 별도 태깅한다.
  4. 정책 오류와 시스템 오류 코드를 상위 카테고리로 분리한다.

3. Consequences / Impact

  1. 장애 탐지와 UX 대응이 빨라진다.
  2. 코드 표준 준수 점검이 필요하다.

4. Validation

  • 주요 API가 표준 에러 포맷을 반환한다.
  • 매핑 누락 코드가 모니터링된다.
  • 정책/시스템 오류 카테고리가 일관되게 적용된다.