본문으로 건너뛰기

도메인별 에러 코드 레지스트리

이 문서는 DTA Wide 플랫폼의 모든 도메인별 에러 코드 번호대를 관리합니다. 새로운 도메인을 추가할 때는 반드시 이 문서를 참조하여 중복되지 않는 번호대를 할당해야 합니다.

에러 코드 할당 규칙​

  1. 번호대 할당: 각 도메인은 고유한 1000 또는 100 단위의 번호대를 사용합니다.
  2. 범위 내 구조화: 각 도메인 내에서 에러 유형별로 10 단위로 그룹화합니다.
  3. 예약 범위: 마지막 10개 코드(예: x090-x099)는 기타/알 수 없는 오류용으로 예약합니다.
  4. 문서화: 새 도메인 추가 시 이 레지스트리를 반드시 업데이트합니다.

DTA Wide API (Main) - 에러 코드 맵​

범위도메인파일 위치비고
2000-2999Authlibs/feature/auth/src/lib/domain/errors/auth-error-codes.enum.ts인증/권한
2200-2299Auth-KRlibs/feature/auth-kr/src/lib/domain/errors/auth-kr-error-codes.enum.ts한국 OAuth (Auth 범위 내)
3000-3099AccessCodelibs/feature/access-code/src/lib/domain/errors/access-code-error-codes.enum.ts액세스 코드
4000-4099Agreementslibs/feature/agreements/src/lib/domain/errors/agreements-error-codes.enum.ts약관
5000-5099TimeMachinelibs/feature/time-machine/src/lib/domain/errors/time-machine-error-codes.enum.ts가상 시간 관리
6000-6999IAMlibs/feature/iam/src/lib/domain/errors/iam-error-codes.enum.tsID/접근 관리
7000-7999Userlibs/feature/user/src/lib/domain/errors/user-error-codes.enum.ts사용자 관리
8000-8099Mobilelibs/feature/mobile/src/lib/domain/errors/mobile-error-codes.enum.ts모바일 앱 설정
9000-9099Questionnairelibs/feature/questionnaire/src/lib/domain/errors/questionnaire-error-codes.enum.ts설문지
10000-10099Sleeplibs/feature/sleep/src/lib/domain/errors/sleep-error-codes.enum.ts수면 관리
11000-11099Learninglibs/feature/learning/src/lib/domain/errors/learning-error-codes.enum.ts학습 콘텐츠
12000-12999AgentBoardlibs/feature/agent-board/src/lib/domain/errors/agent-board-error-codes.enum.ts에이전트 보드
13000-13999Relaxationlibs/feature/relaxation/src/lib/domain/errors/relaxation-error-codes.enum.ts이완요법
14000-14099Planlibs/feature/plan/src/lib/domain/errors/plan-error-codes.enum.ts플랜 관리
15000-15099Grouplibs/feature/group/src/lib/domain/errors/group-error-codes.enum.ts그룹 관리
16000-16099Conditionlibs/feature/condition/src/lib/domain/errors/condition-error-codes.enum.ts상태/증상 관리
17000-17099CodLineup (SOL Prediction)libs/feature/sol-prediction-wir/src/lib/domain/errors/cod-lineup-error-codes.enum.tsCoD 라인업
18000-18099Conversationlibs/shared/contracts-conversation/src/lib/types/conversation-error-codes.enum.ts대화 관리
19000-19099Chatlibs/shared/contracts-chat/src/lib/types/chat-error-codes.enum.ts채팅
20000-20099Medicationlibs/shared/contracts-medication/src/lib/types/medication-error-codes.enum.ts약물 관리
21000-21099External Health(신규 예정)외부 건강 데이터

WIR API (Secondary) - 에러 코드 맵​

WIR API는 별도의 서비스로 1000번대를 사용합니다.

범위도메인파일 위치비고
1001-1099AuthWirlibs/feature/auth-wir/src/lib/domain/errors/auth-wir-error-codes.enum.tsWIR 인증
1101-1299MedicalStatementlibs/feature/medical-statement/src/lib/domain/errors/medical-statement-error-codes.enum.ts의료 진술서 분석

문자열 기반 에러 코드​

일부 도메인은 숫자 대신 문자열 기반 에러 코드를 사용합니다.

도메인파일 위치비고
ContextFlowlibs/feature/context-flow/src/lib/domain/errors/context-flow-error-codes.enum.ts문자열 기반

예약된 번호대 (Reserved)​

다음 번호대는 향후 사용을 위해 예약되어 있습니다:

범위예약 용도
22000-22099(미할당)
23000-23099(미할당)
24000-24099(미할당)
25000-25099(미할당)

새 도메인 에러 코드 추가 가이드​

  1. 번호대 확인: 이 문서에서 사용 가능한 번호대를 확인합니다.
  2. Enum 파일 생성: libs/feature/{domain}/src/lib/domain/errors/{domain}-error-codes.enum.ts 경로에 파일을 생성합니다.
  3. 주석 작성: 파일 상단에 사용 범위를 명시하는 주석을 추가합니다.
  4. 레지스트리 업데이트: 이 문서를 업데이트하여 새 도메인의 번호대를 등록합니다.

예시 템플릿​

/**
 * {Domain} 도메인 오류 코드
 *
 * {Domain} 관련 오류 코드는 {XXXXX}-{XXXXX} 범위에서 정의됩니다.
 */
export enum {Domain}ErrorCode {
  // 서버 오류 ({XXXXX})
  SERVER_ERROR = {XXXXX},

  // 도메인 특화 오류 ({XXXXX+1}-{XXXXX+9})
  // ...

  // 기타 오류 ({XXXXX+90}-{XXXXX+99})
  UNKNOWN_{DOMAIN}_ERROR = {XXXXX+99},
}

변경 이력​

버전날짜작성자변경 내용
0.1.02025-12-15bok@weltcorp.com최초 작성 - 기존 도메인 에러 코드 조사 및 레지스트리 생성