매장 등록 및 위치 인증 규칙 통합
ADR-150 매장 등록 및 위치 인증 규칙 통합
1. Metadata
- ADR ID: ADR-150
- Status: draft
- Date: 2026-03-09
- Owner: YSY
2. Domain Decision
- 매장 등록과 위치 인증 단계를 분리한다.
- 위치 인증 완료 전 발행 가능한 기능 범위를 제한한다.
- 위치 인증 실패/보류 상태를 명확히 구분한다.
- 위치 좌표는 핀 선택(Pin Selection) 기반 확정을 기본으로 하고 현재 위치 자동 입력은 보조 기능으로만 사용한다.
- 매장 사진은 등록 필수값이 아닌 선택 입력으로 처리한다.
- 주소/좌표 변경 시 재인증 플로우를 강제한다.
3. Product Decision
- 파트너 등록 단계와 권한 활성 조건을 정의한다.
- 구독 상태와 발행 권한 연동을 유지한다.
- 등록/인증 안내 기준을 통일한다.
4. UX Decision
- 매장 등록과 위치 인증 단계를 분리해 안내한다.
- 인증 대기/실패/완료 상태를 명확히 표시한다.
- 인증 전 기능 제한을 사전에 고지한다.
5. Tech Decision
- 위치 검증 정확도 기준과 허용 오차를 정의한다.
- 검증 실패 시 QR 폴백 경로를 기술적으로 보장한다.
- 위치 검증 이벤트를 감사로그로 수집한다.
6. Ops Decision
- 매장 위치 인증 심사 절차를 정의한다.
- 보류/반려/재검증 처리 기준을 문서화한다.
- 검증 결과 통지 SLA를 운영한다.
7. Implementation Contract (Optional)
7.1 API Contract
- 파트너 등록과 위치 인증 API를 분리하고 상태를 명시적으로 반환한다.
- 인증 전 기능 접근 시
LOCATION_VERIFICATION_REQUIRED로 차단한다.
7.2 Data Contract
- 매장 상태와 위치 인증 상태를 분리 필드로 저장한다.
- 주소/좌표 변경 시 재인증 필요 플래그를 강제한다.
7.3 Error/Observability Contract
- 위치 인증 실패 사유를 표준 코드로 기록한다.
- 재인증 요청/승인/반려 이벤트를 감사로그로 남긴다.
7.4 Test/Acceptance Contract
- 인증 미완료 파트너는 발행 기능이 항상 차단되어야 한다.
- 좌표 변경 시 재인증 플로우가 자동 활성화되어야 한다.
8. Validation
Buy me a coffee