---
type: template
domain: product
role: Backend
status: active
last-reviewed: 2026-07-27
---

# 도메인·오류 정책

> HTTP 처리와 분리된 비즈니스 규칙, 상태 전이, 오류 의미를 정의한다. 규칙의 정본은 기능사양서 — 현업 인터뷰에서 나온 새 규칙은 여기 임의 반영하지 않고 CR로 회부한다.

## 도메인 규칙

| 규칙 ID | 조건 | 허용 동작 | 거부 동작 | 불변식 | 요구사항 ID |
|---|---|---|---|---|---|
| BE-RULE-001 |  |  |  |  |  |

## 상태 전이·트랜잭션

| 현재 상태 | 명령·이벤트 | 다음 상태 | transaction 경계 | 동시성·중복 방지 | 보상·복구 |
|---|---|---|---|---|---|
|  |  |  |  |  |  |

## 경계 검증

| 입력 | schema·제약 | 정규화 | 실패 코드 | 사용자 메시지 | 로그 필드 |
|---|---|---|---|---|---|
|  |  |  |  |  |  |

## 오류 정책

| 오류 종류 | HTTP·도메인 코드 | retry 가능 | 외부 노출 메시지 | 내부 원인·알림 | 개인정보 마스킹 |
|---|---|---|---|---|---|
| 검증 |  | 아니요 |  |  |  |
| 인증·권한 |  | 아니요 |  |  |  |
| 충돌 |  | 조건부 |  |  |  |
| 의존 서비스·timeout |  | 조건부 |  |  |  |
| 내부 오류 |  | 아니요 |  |  |  |

## 결정 질문

- [ ] 전송·프레임워크 코드 없이 도메인 규칙을 설명하고 테스트할 수 있는가?
- [ ] 상태 변경의 원자성, race condition, 중복 요청을 다뤘는가?
- [ ] 오류를 silently swallow하지 않고 호출자에게 일관되게 전달하는가?
- [ ] 인증 실패가 사용자 존재 여부나 내부 stack을 누설하지 않는가?
- [ ] 모든 규칙이 기능사양서 항목 또는 승인된 CR에 연결되는가?

## 미결·승인

> 규칙 확정에 필요한 발주사 현업의 답변 지연은 기한과 함께 기록하고 일정 영향을 공지한다.

| 결정 ID | 대안 | 채택안·근거 | 영향 | 승인자 | 상태 |
|---|---|---|---|---|---|
| BE-DOM-001 |  |  |  |  | Draft |