ADR-W-001

## 사용자 웹은 조회 전용을 기본으로 하고, 확보 및 사용 확정은 모바일 앱으로 위임한다

  • ADR ID: ADR-W-001

  • 상태: Accepted

  • 작성일: 2026-03-02

  • 작성자: YSY

  • 관련 ADR: ADR-P-002, ADR-T-002, ADR-U-001


1. 배경 (Context)

플랫폼의 핵심 흐름은 다음과 같다:

탐색 → 확보(15분) → 사용 확정 → 확정

확보 및 사용 확정은 다음 요소를 필요로 한다:

  • 사용자 인증

  • 위치 정확도 검증

  • 반복 미도착 제재 적용

  • 타이머 기반 만료 동기화

  • 수량 차감 트랜잭션

웹 환경에서는 다음 제약이 존재한다:

  • 브라우저 위치 정확도 편차

  • 데스크톱 환경에서 GPS 부정확성

  • 부정 사용 위험 증가

  • 세션/탭 중복 실행 가능성

  • 보안 및 제재 정책 적용 복잡성

MVP 단계에서 웹에서 확보까지 허용할 경우
복잡도가 급격히 증가한다.


2. 결정 (Decision)

사용자 웹은 조회 전용으로 시작한다.

웹에서는 다음만 허용한다:

  • 위치 기반 슬롯 탐색

  • 필터 적용

  • 슬롯 상세 조회

  • 외부 지도 딥링크

  • 앱으로 열기

슬롯 확보(Reserved 생성) 및 사용 확정(Redeemed)은 모바일 앱에서만 수행한다.


3. 대안 (Alternatives Considered)

대안 A: 웹에서도 확보 허용

장점

  • 앱 설치 없이 사용 가능

  • 접근성 증가

단점

  • 위치 검증 정확도 낮음

  • 제재 정책 우회 가능성

  • 중복 세션/탭 문제

  • 구조 복잡성 증가

채택하지 않은 이유
MVP 단계에서 부정 사용 리스크가 높고, 정책 일관성이 흔들릴 수 있다.


대안 B: 웹에서 로그인 후 확보 허용

장점

  • 인증 기반 제어 가능

  • 모바일 의존도 감소

단점

  • 위치 정확도 문제는 여전히 존재

  • 웹/앱 로직 이중화

  • 개발 복잡도 증가

채택하지 않은 이유
초기 단계에서 필요 대비 복잡도가 과도하다.


대안 C: 조회 전용 + 앱 위임 (채택)

장점

  • 구조 단순성 유지

  • 위치 기반 정책 정확성 유지

  • 제재 및 트랜잭션 일관성 확보

  • 앱 중심 전략 유지

단점

  • 앱 설치 유도 필요

  • 웹 전환율 일부 제한

채택 이유
플랫폼 핵심은 모바일 즉시성 구조에 있다.


4. 결과 (Consequences)

긍정적 결과

  • 부정 사용 리스크 감소

  • 정책 일관성 유지

  • 서버 로직 단순화

  • MVP 범위 명확

부정적 결과

  • 웹에서 완결된 사용 경험 제공 불가

  • 앱 설치 전환 장벽 존재


5. 영향 범위 (Impact)

기술

  • 웹은 read-only API 사용

  • Reservation/usage_verify API는 웹에서 호출하지 않음

UX

  • 웹 상세 화면에 “앱에서 15분 확보” CTA 제공

  • 과도한 설치 유도 UI 금지

운영

  • 웹 유입 → 앱 전환 퍼널 분석 필요

6. 재검토 조건 (Revisit Conditions)

다음 조건 중 하나 이상 충족 시 재검토:

  • 웹 유입이 전체 트래픽의 40% 이상

  • 앱 설치 전환율이 20% 미만

  • 위치 검증을 웹에서도 신뢰 가능하게 구현 가능할 경우