ADR-DS-110_무결성 및 불변 조건 검증 규칙

ADR-DS-110_무결성 및 불변 조건 검증 규칙

ADR-DS-110 무결성 및 불변 조건 검증 규칙

1. Metadata

  • ADR ID: ADR-DS-110
  • Title: 무결성 및 불변 조건 검증 규칙
  • Status: draft
  • Date: 2026-03-08
  • Owner: YSY
  • Related ADRs: ADR-DS-010, ADR-DS-020
  • Supersedes:
  • Superseded By:

2. Context

불변 조건 검증이 약하면 상태/수량/권한 데이터가 부분 반영되어 무결성이 깨진다.

3. Decision

  1. 상태 전이 불변 조건을 명시하고 서버에서 검증한다.
  2. 수량/시간/권한 조건을 전이 전 필수 검증한다.
  3. 위반 시 표준 실패 코드를 반환한다.
  4. 불변 조건 검증 실패 시 데이터 변경은 부분 반영 없이 중단한다.

4. Consequences / Impact

  1. 데이터 오염 가능성을 낮출 수 있다.
  2. 장애 원인 분석이 쉬워진다.

5. Validation

  • 불변 조건 위반 요청이 차단된다.
  • 검증 실패 로그가 누락 없이 기록된다.
  • 실패 요청에서 데이터 부분 반영이 발생하지 않는다.