Skip to content

Travel Usecase

wcorn edited this page Oct 19, 2026 · 6 revisions

유스케이스: 여행 (Travel)

확정 명세 v2.1 · v2.0 · 아키텍처 · 데이터 모델 · API 설계 · 화면 설계 · 결정 기록

1. 무엇을 해결하는가

여행은 "언제 어디를 어떤 순서로"를 출발 전에 확정해두고, 현지에서는 결정 없이 따라가기만 하는 것이다. 지금은 이게 노션·메모·구글 지도 즐겨찾기·캘린더에 흩어져 있어서, 현지에서 "다음 어디였지"를 매번 재구성해야 한다.

여행 모듈은 그 흩어짐을 없앤다. 일정 보드 하나가 여행의 유일한 진실이고, 현지에서는 그 화면만 열면 된다. 데이터가 끊겨도, 알림이 와도, 길을 찾아야 해도 이 화면에서 출발한다.

Study Planner의 블록-과업 사전 배정과 같은 뿌리다 — 결정을 사전에 소진해 현장의 인지부하를 0으로 만든다. 다만 여행은 검증 대상이 아니라 10/24 실사용 마감이 박힌 실전 도구다.

2. 액터

액터 설명
여행자 (단일 사용자) orino 로그인 멤버. 계획 작성자이자 현지 사용자
외부 시스템 Google Places, Open-Meteo, ECB, Web Push (FCM/Mozilla 엔드포인트), Google Maps 앱 (Routes는 #1208에서 제거)

3. 워크스페이스 분리 (선행 조건)

여행은 기존 앱(일상)과 병렬 워크스페이스로 존재한다. 학습·기록·플래너를 쓰는 맥락과 여행 준비를 하는 맥락은 겹치지 않으므로, 사이드바를 공유하면 양쪽 다 지저분해진다.

로그인(/login) → 페이지 선택(/select) ─┬─ 여행  (신규)
                                       └─ 일상  (현재 앱 전체 그대로)
  • 로그인 직후 항상 선택 화면을 보여준다(마지막 선택 기억 없음).
  • 전환은 사이드바 최상단 스위처로. /select 재방문 불필요.
  • 딥링크로 /travel/*에 바로 들어와도 선택 화면으로 되돌리지 않는다.
  • 일상의 범위는 변경 없음.

4. 유스케이스 목록

ID 유스케이스 주요 화면 단계
TRV-001 워크스페이스 선택·전환 /select, 사이드바 1
TRV-002 여행 만들기 (기간·타임존·통화 확정) S-03 1
TRV-003 여행 목록·상태별 조회 S-02 1
TRV-004 다음 여행 확인 (D-day) S-01 1
TRV-005 일정 추가 (직접 입력) S-04 → 추가 시트 1
TRV-006 일정 순서 바꾸기 / 다른 날로 옮기기 S-04 드래그 1
TRV-007 일정 삭제·보관함 이동(즉시, 실행취소 없음 — #1432) S-04 스와이프 1
TRV-008 보관함에 후보 담아두기 → 날짜 배정 S-04 보관함 탭 1
TRV-009 일정 상세 편집 (시각·메모·URL·장소) S-07 계획 → 장소는 S-06 교체 모드(#1396) 1
TRV-010 장소 검색해서 일정에 담기 S-06 → 날짜 선택 시트 2
TRV-011 하루 동선을 지도로 확인 S-05 2
TRV-012 일정 간 이동 적기(수단·편명·시간·예매 링크) · 길찾기 넘기기 S-04 이동 행 → 편집 시트 2
TRV-013 현지 시각으로 일정 보기 S-04 헤더 3
TRV-014 일정·출발 알림 받기 S-07 알림, 푸시 3
TRV-015 아침 요약 알림 받기 푸시 3
TRV-016 알림 권한·기본값 설정 S-09 3
TRV-017 오프라인에서 일정 확인 전 화면 4
TRV-018 환율 환산 S-08 4
TRV-019 날씨 확인 (날짜 탭 요약 + 시간대별) S-04 탭, S-08 4
TRV-020 번역 열기 S-08 4
TRV-021 다녀온 일정에 기록 남기기 (평점·메모·사진) S-07 기록 4
TRV-022 완료 여행 다시 보기 (기록 모드) S-01 → S-04 4

5. 핵심 시나리오

5.1 출발 전 — 일정을 짠다 (단계 1~2)

  1. 로그인 → /select → 여행 카드 (진행 중 여행 없으면 /travel 홈)
  2. (v2.1) "여행 만들기" → 제목·기간을 넣고 구간을 쌓는다 — 오사카 3일 교토 1일 나고야 1일. 도시를 고르면 타임존·통화가 그 도시에서 자동으로 정해진다. 합계가 기간과 달라도 저장된다(남으면 마지막 도시를 이어 쓴다).
  3. 일정 보드 진입. 날짜 탭 1 오사카 … 5 나고야 · 보관함이 구간에서 자동 전개된다. 도시가 바뀌는 탭 왼쪽에 구분선이 보인다.
    • 전 기간이 한 도시면 탭은 1일차 … 4일차로 나온다(v2.0과 같은 모습).
  4. + → 장소 검색으로 "시부야 스카이" → 담기 → 날짜 선택 시트에서 2일차
  5. 시각 없이 먼저 넣어도 된다(──로 표시). 확정되면 상세에서 시각을 채운다.
  6. 아직 날짜를 못 정한 후보는 보관함에 쌓아두고, 나중에 드래그로 날짜에 배정한다.
  7. 순서를 길게 눌러 드래그 → 어느 구간이 이어지는지가 다시 잡히고, 알림이 걸려 있으면 재예약된다. 적어 둔 이동은 장소 쌍에 붙어 있어 사라지지 않는다(#1208).
  8. 지도 토글로 그날 동선이 말이 되는지 본다. 마커 번호는 지도 표시 순서대로 1부터.

기간을 줄이면 잘리는 날짜의 일정이 사라지지 않고 보관함으로 이동한다. 몇 개가 이동하는지 확인 모달에 표시한다. (v2.1) 걸쳐 있던 숙소는 기간이 줄어든다.

(v2.1) 하루만 다른 도시에 가는 날 — 날짜 탭을 450ms 길게 눌러 기준 도시를 닛코로 바꾼다. 그날의 날씨·검색 좌표·통화·알림이 다시 계산되고, 이미 담아 둔 일정의 장소는 그대로 남는다. 구간이 도쿄 / 닛코 / 도쿄 셋으로 쪼개지는 것은 정상이다.

(v2.1) 숙소 — 체크인~체크아웃으로 숙소를 넣으면 그 사이 날짜에 자동으로 붙는다. 기준 도시와 무관해서 닛코에 있는 날에도 "오늘 밤 도쿄 호텔" 로 뜬다.

5.2 현지에서 — 따라간다 (단계 3~4)

  1. 앱을 열면 진행 중 여행의 일정 보드가 바로 뜬다(§1.9). 오늘 날짜 탭이 선택돼 있다.
  2. 헤더에 (v2.1) 현지 09:42 · 교토 · Asia/Tokyo · JPY. 기기 시간대와 오프셋이 0이면 시각 부분만 숨는다.
  3. 08:00에 아침 요약 알림 — 교토 · 오늘 일정 4개 · 첫 일정 09:00
    • (v2.1) 도시가 바뀌는 날은 오사카 → 교토 · 오늘 일정 3개가 전날 오사카 08:00에 온다. 이동 중에 받으면 늦다.
  4. 10:15에 일정 알림(15분 전) → 탭하면 해당 일정 상세로.
  5. 이동 행을 탭 → 편집 시트에서 구글 지도에서 시간 확인 → 앱이 대중교통으로 열린다. 거기서 본 값을 시트에 적는다(#1208).
    • 도시를 넘는 이동도 같은 시트에서 적는다. 비행기·신칸센이 바로 그 자리다 — v2.1까지는 도시 이동 넉 자만 떠 있었다.
    • 딥링크는 언제나 대중교통이다 — 앱은 노선·환승·요금을 다루지 않는다.
  6. 지하철에서 데이터가 끊긴다 → 배너 "오프라인 · 일정 조회만 가능합니다". 일정·보관함·환율·날씨는 그대로 보인다. 편집 UI는 전부 비활성.
  7. 가게에서 ¥3,800이 얼마인지 → 도구 → 환율.

5.3 다녀와서 — 기록한다 (단계 4)

  1. 일정 상세의 기록 영역(여행 시작일 이후에만 노출)에 평점·메모·사진.
  2. 사진 업로드가 실패해도 메모·평점은 이미 저장돼 있다(분리 저장). 실패한 파일만 재시도.
  3. 완료 여행은 홈의 "최근 완료"에서 기록 모드 보드로 다시 읽는다.
  4. 다음 여행에서 같은 장소가 검색되면 ⭐ 좋았던 곳 배지가 붙는다. → 미도입(D-18)

6. 화면 흐름

/login ──▶ /select ─┬─▶ /home            (일상: 기존 전체)
                    │
                    └─▶ /travel          S-01 홈
                          ├─▶ /travel/trips              S-02 목록
                          │     └─▶ /travel/trips/new    S-03 생성·수정
                          └─▶ /travel/trips/:id/board    S-04 일정 보드 ★주 화면
                                ├─▶ ?day=0..N | archive        날짜 탭 / 보관함
                                ├─▶ /travel/trips/:id/map      S-05 지도
                                ├─▶ /travel/trips/:id/places   S-06 장소 검색
                                ├─▶ /travel/activities/:id     S-07 일정 상세·편집
                                ├─▶ /travel/tools              S-08 도구
                                └─▶ /travel/settings           S-09 설정

진행 중 여행이 있으면 /select 의 여행 카드 → 곧바로 board (§1.9)
푸시 알림 탭 → /travel/activities/:id

7. 경계 조건

상황 동작
시각 없는 일정 허용. 정렬은 sort_order로만. 알림 대상에서 제외
시각이 겹치는 일정 경고하지 않는다(§1.1). 사용자가 의도한 것으로 본다
장소 없는 일정이 사이에 낀 경우 이동에서 건너뛰고 앞뒤 장소 일정끼리 잇는다
이동을 아직 안 적음 + 이동 추가 빈 행 — 그 자리가 입력 지점이다(#1208)
예보 범위 밖 날짜 날짜 탭 3행을 비우고, 도구에서는 "예보 범위 밖"
여행 타임존 변경 일정 시각은 그대로, 알림 발송 시각만 재계산
오프라인 진입 편집 진입 자체를 막는다. 큐잉·나중 동기화 없음
완료 여행 보드가 기록 모드로 열린다. 편집 가능하되 기록 영역이 주가 된다

8. 범위 외 (§1.10)

시각 충돌 경고 · 일정 유형 필드 · 지도 롱프레스 추가 · 사진 위치정보 기반 장소 제안 · 오프라인 편집 · 여행 복제 · 커버 이미지 · 앱 내 대중교통 경로 계산 · 앱 내 번역 · 오프라인 지도 · 동행자 공유 · iOS 지원

Clone this wiki locally