ADR-U-020_QR 기반 사용 확정 UX
## 1. 기본 정보
- ADR ID: ADR-U-020
- 제목: QR 기반 사용 확정 UX 구조
- 상태: Accepted
- 작성일: 2026-03-06
- 작성자: YSY
- 관련 ADR: ADR-DS-020, ADR-DS-021
- Supersedes: N/A
- Superseded By: N/A
2. 배경 (Context)
도메인 정책상 중간 인증 단계는 제거되었고, 사용자는 사용 확정 액션을 수행한다.
QR은 상태가 아니라 사용 확정을 보조하는 검증 수단이다.
3. 결정 (Decision)
사용자 UX
- 슬롯 상세에서
사용 확정버튼을 제공한다. verification_method=qr이면 버튼 클릭 후 QR 스캔 오버레이를 연다.- 스캔 성공 시 즉시
redeemed처리한다. - 스캔 실패 시 재시도와 대체 경로(지원되는 경우 location)를 제공한다.
파트너 UX
- 파트너 앱/웹에 QR 표시, 출력, 재발급 기능을 둔다.
- QR 재발급 시 기존 토큰은 즉시 무효화한다.
- 파트너 보조 검증은
redeemed이후 확인 단계로만 동작한다.
In Scope
- 사용자/파트너 QR 상호작용
Out of Scope
- QR 암호화 상세 스펙
- 결제 정책
4. 경계 및 책임 (Boundaries)
- UX(본 ADR): 사용자 인터랙션과 오류 처리
- Domain(ADR-DS-020/021): 상태 전이와 보조 검증 데이터
- Tech: 카메라 권한, 스캔 SDK, 네트워크 재시도
5. 단일 출처(SoT) 참조
- 사용 확정 정책: ADR-DS-020
- 파트너 보조 검증: ADR-DS-021
6. 대안 (Alternatives Considered)
대안 A: QR 전용 화면을 탭으로 분리
- 장점: 기능 집중
- 단점: 핵심 흐름 이탈 증가
- 미채택 이유: 슬롯 상세 내 즉시성 저하
대안 B: 위치 검증만 제공
- 장점: 운영 준비물 감소
- 단점: 실내/밀집 지역 실패율 증가
- 미채택 이유: 업종별 요구 미충족
7. 결과 (Consequences)
긍정적 결과
- 사용 확정 흐름이 단순해진다.
- 검증 방식 변경이 UX에서 명시적으로 드러난다.
부정적 결과
- QR 준비/관리 부담이 파트너에게 남는다.
8. 영향 범위 (Impact)
- 사용자 앱: 슬롯 상세 CTA 및 스캔 오버레이
- 파트너 앱/웹: QR 관리 기능
9. 검증 및 운영 확인 (Validation)
- 퍼널:
버튼 클릭 -> 검증 성공 -> redeemed - 오류율: 스캔 실패율, 네트워크 재시도 성공률
10. 재검토 조건 (Revisit Conditions)
- 스캔 실패율 상승
- QR 부정 사용 징후 증가
Buy me a coffee