ADR-DS-070_멱등성 및 중복 요청 처리

ADR-DS-070_멱등성 및 중복 요청 처리

ADR-DS-070 멱등성 및 중복 요청 처리

1. Metadata

  • ADR ID: ADR-DS-070
  • Title: 멱등성 및 중복 요청 처리
  • Status: draft
  • Date: 2026-03-08
  • Owner: YSY
  • Related ADRs: ADR-DS-030, ADR-DS-050
  • Supersedes:
  • Superseded By:

2. Context

재시도와 중복 요청이 빈번한 환경에서 멱등 규칙이 없으면 중복 전이와 이중 처리 위험이 커진다.

3. Decision

  1. 상태 변경 요청은 멱등키 기준으로 1회 확정 처리한다.
  2. 재시도 요청은 기존 결과를 재반환한다.
  3. 중복 결제/중복 전이를 서버에서 차단한다.

4. Consequences / Impact

  1. 네트워크 재시도 환경에서 정합성이 높아진다.
  2. 클라이언트 단 단순화가 가능하다.

5. Validation

  • 동일 멱등키 재요청 시 동일 결과가 반환된다.
  • 중복 전이/중복 생성이 발생하지 않는다.