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
- 도메인 실패 코드를 API 에러 포맷으로 표준화한다.
- 클라이언트 매핑 테이블을 버전 관리한다.
- 비표준 에러는 관측 가능하도록 별도 태깅한다.
- 정책 오류와 시스템 오류 코드를 상위 카테고리로 분리한다.
3. Consequences / Impact
- 장애 탐지와 UX 대응이 빨라진다.
- 코드 표준 준수 점검이 필요하다.
4. Validation
- 주요 API가 표준 에러 포맷을 반환한다.
- 매핑 누락 코드가 모니터링된다.
- 정책/시스템 오류 카테고리가 일관되게 적용된다.