ADR-T-004

MVP에서는 앱 내 지도를 기본 UI로 채택하지 않고, 목록 중심 + 외부 지도 앱 딥링크를 사용한다

  • ADR ID: ADR-T-004

  • 상태: Accepted

  • 작성일: 2026-03-02

  • 작성자: YSY

  • 관련 ADR: ADR-T-001, ADR-T-002, ADR-P-002(시간 중심), ADR-U-001(무한 스크롤 지양)


1. 배경 (Context)

본 서비스는 위치 기반이지만, UX의 1차 단위는 “지도”가 아니라 “타임슬롯(시간 기회)”이다.
MVP 단계에서 앱 내 지도(embedded map)를 기본 화면으로 채택하면 다음 비용이 크게 증가한다.

  • 지도 SDK 선택(국내/해외), 약관/과금, 키 관리

  • RN(특히 Expo)에서 네이티브 모듈 호환성 이슈 대응

  • 클러스터링/마커 렌더링/성능 최적화

  • 위치 정확도/배터리/백그라운드 정책 대응

또한 Expo 환경에서 지도 라이브러리 호환성 문제가 실제로 보고되고 있다. (GitHub)

국내 지도는 Naver/Kakao의 데이터 품질과 생태계가 강하지만, 상용 정책/과금/약관 변화와 네이티브 의존성이 존재한다. (NAVER CLOUD PLATFORM)

MVP의 목표는 “지도 완성”이 아니라 “슬롯 흐름(탐색→확보→도착)” 검증이다.


2. 결정 (Decision)

MVP 기본 탐색 UI는 목록(List) 중심으로 구성한다.
사용자가 길찾기/이동이 필요할 때는 외부 지도 앱(네이버지도/카카오맵/구글맵 등) 딥링크로 연결한다.

앱 내 지도(embedded map)는 기본값으로 도입하지 않고, Phase 2 이후 필요성이 검증될 때 도입 여부를 재검토한다.


3. 대안 (Alternatives Considered)

대안 A: 앱 내 지도 기본 화면(react-native-maps 기반)

설명
react-native-maps(MapView)로 지도를 기본 화면에 배치. (Expo Documentation)

장점

  • 지도에서 직관적 탐색 가능

  • 위치 기반 서비스처럼 보이기 쉬움

단점

  • Expo 버전/플러그인 호환성 이슈 가능 (GitHub)

  • 성능(마커/클러스터링) 최적화 필요

  • UX가 “시간”에서 “지도”로 주인공이 바뀔 위험

채택하지 않은 이유
MVP 검증 목표 대비 구현/운영 리스크가 과도하다.


대안 B: 국내 지도 SDK(네이버/카카오) 네이티브 연동을 MVP에서 즉시 도입

설명
RN 네이티브 모듈을 붙여 네이버/카카오 지도를 사용. (예: react-native-naver-map, @react-native-kakao/map) (GitHub)

장점

  • 국내 데이터/경로/POI 품질 기대

  • 사용자 친숙도 높음

단점

  • Expo에서 네이티브 모듈 구성 복잡도 증가

  • 상용 정책/과금/약관 변화 리스크(예: 무료 제공 종료 공지 등) (NAVER CLOUD PLATFORM)

  • MVP 범위를 빠르게 초과

채택하지 않은 이유
MVP에서 지도는 “필수”가 아니라 “편의”이며, 우선순위가 아니다.


대안 C: 앱 내 지도는 옵션(2차 화면)으로만 제공

장점

  • 목록 중심을 유지하면서 지도도 제공 가능

단점

  • 결국 SDK/성능/정책 문제는 동일

  • MVP 일정이 흔들릴 가능성

채택하지 않은 이유
Phase 1에서는 지도 도입 자체를 보류하는 편이 안전하다.


4. 결과 (Consequences)

긍정적 결과

  • MVP 범위가 선명해지고 개발 속도가 빨라짐

  • Expo/네이티브 호환성 리스크를 크게 줄임 (GitHub)

  • “시간 중심 탐색” 구조가 흐려지지 않음

부정적 결과

  • 지도 기반 탐색을 기대하는 일부 사용자에겐 매력도가 낮을 수 있음

  • 마커 기반 “한눈에 보기” 경험은 Phase 2 이후로 미뤄짐


5. 영향 범위 (Impact)

기술

  • 지도 SDK 키/약관/과금 리스크를 MVP에서 회피

  • 딥링크 스킴만 안정적으로 지원하면 됨

UX

  • 탐색은 목록 + 필터 중심으로 고정

  • 이동은 외부 지도 앱으로 위임(사용자 선택권 제공)

운영

  • 지도 API 비용/쿼터 모니터링이 초기에는 불필요

6. 재검토 조건 (Revisit Conditions)

다음 조건 중 하나 이상 충족 시 앱 내 지도 도입을 재검토한다.

  • 사용자 피드백에서 “지도 탐색 요구”가 우세(예: 활성 사용자 중 30% 이상 반복 요청)

  • 슬롯 밀도가 높아져 지도 클러스터링이 탐색 효율을 실질적으로 개선

  • Expo/RN 지도 호환성이 안정화되고, 선택 SDK의 상용 정책/과금이 명확해짐 (Expo Documentation)