ADR-DS-040_Verification Method 전이 규칙
ADR-DS-040 Verification Method 전이 규칙
1. Metadata
- ADR ID: ADR-DS-040
- Title: Verification Method 전이 규칙
- Status: draft
- Date: 2026-03-08
- Owner: YSY
- Related ADRs: ADR-DS-010, ADR-DS-030, ADR-DS-070, ADR-DS-140
- Supersedes:
- Superseded By:
2. Context
검증 방식과 결제 방식을 분리하지 않으면 redeemed 전이 시점이 일관되지 않다.
3. Decision
verification_method는none,location,qr로 고정한다.payment_method=prepaid는 결제 성공 시 즉시redeemed로 전이한다.payment_method=on_site에서만 verification 전이를 적용한다.on_site + none은 예약 확정 시 즉시redeemed로 전이한다.on_site + location은 위치 검증 성공 시redeemed로 전이한다.- 위치 검증 실패 시 QR 폴백을 기본 경로로 적용한다.
on_site + qr은 QR 스캔 성공 시redeemed로 전이한다.- 파트너 보조 검증은 상태 전이를 추가하지 않고
redeemed이후 증적 기록으로만 처리한다. - 보조 검증 필드는
partner_verified,partner_verified_at,partner_verified_by_store_id로 고정한다. - 보조 검증 요청은 같은 예약에 대해 멱등 처리한다.
4. Consequences / Impact
- 결제 방식과 검증 방식의 책임 경계가 명확해진다.
- 위치 실패 시 폴백 경로가 고정되어 운영 혼선을 줄일 수 있다.
- 상태 모델 단순성을 유지하면서 사후 분쟁 대응 증적을 확보할 수 있다.
5. Validation
-
prepaid결제 성공 시 즉시redeemed전이가 동작한다. -
on_site에서 verification_method별 전이 경로가 정의되어 있다. - 위치 실패 시 QR 폴백 경로가 정상 동작한다.
-
redeemed이전 보조 검증 요청은 차단된다. - 보조 검증 중복 요청 시 데이터가 중복 생성되지 않는다.