ADR-DS-130_도메인 실패 코드 표준

ADR-DS-130_도메인 실패 코드 표준

ADR-DS-130 도메인 실패 코드 표준

1. Metadata

  • ADR ID: ADR-DS-130
  • Title: 도메인 실패 코드 표준
  • Status: draft
  • Date: 2026-03-08
  • Owner: YSY
  • Related ADRs: ADR-DS-110
  • Supersedes:
  • Superseded By:

2. Context

도메인 실패를 표준 코드로 관리하지 않으면 UX 메시지와 운영 모니터링이 분산된다.

3. Decision

  1. 도메인 실패 코드를 의미 단위로 표준화한다.
  2. 클라이언트 표시 문구는 코드 매핑으로 분리한다.
  3. 신규 실패 코드는 하위 호환 기준을 따른다.

4. Consequences / Impact

  1. 에러 처리 일관성이 올라간다.
  2. 다국어 UX 반영이 쉬워진다.

5. Validation

  • 주요 실패 상황에 표준 코드가 매핑된다.
  • 클라이언트가 코드 기반 분기 처리한다.