Repository navigation
Travel Spec v2
⚠️ 현행 정본은 확정 명세 v2.1 (다구간)이다. (2026-08-10) v2.1에서 목적지가 여행이 아니라 날짜에 붙도록 바뀌었다 — 여행당 타임존 1개(§1.1)를 비롯해 아래 여러 조항이 덮어써졌다. 이 페이지는 원문 보존용이며 수정하지 않는다(D-1). 조항 번호는 v2.1이 계속 인용하므로 그대로 둔다.
이 페이지는 확정 명세 원문이다. 여행 모듈의 제품 결정 정본이며, 설계 문서(유스케이스 · 아키텍처 · 데이터 모델 · API · 화면)는 전부 여기서 파생된다.
조항 번호(§1.9 · §4.2 · §4.7 · §5 …)는 디자인 핸드오프가 직접 인용하므로 변경하지 않는다. 결정이 바뀌면 원문을 수정하지 말고 결정 기록에 변경 이력으로 남긴다.
| 항목 | 내용 |
|---|---|
| 문서 버전 | v2.0 (확정) |
| 작성일 | 2026-08-07 |
| 플랫폼 | PWA / Android Chrome |
| 사용자 | 1인 |
| 목표 일자 | 2026-10-24 일본 여행에서 실사용 |
| 잔여 기간 | 78일 |
이 문서는 논의가 끝난 확정 명세다. 선택지나 검토 항목은 남기지 않는다. 모든 수치는 확정값이다.
| 항목 | 확정 |
|---|---|
| 일정 시각 | 시작 시각만. 종료 시각·소요시간 필드 없음 |
| 시각 없는 일정 | 허용 |
| 시각 충돌 경고 | 없음 |
| 일정 유형 필드 | 없음. 장소 연결 유무로만 구분 |
| 미배정 보관함 | 여행별로 하나 |
| 일정 URL 필드 | 있음 (예약 페이지 링크용) |
| 여행당 타임존 | 1개 고정 |
| 항목 | 확정 |
|---|---|
| 알림 종류 | 일정 알림 + 출발 알림, 둘 다 |
| 일정 알림 기본 시점 | 시작 15분 전 |
| 출발 알림 계산식 | 시작시각 − 이동시간 − 5분 |
| 아침 요약 알림 | 있음. 현지 08:00 |
| 설정 단위 | 일정별 개별 on/off + 여행 단위 기본값 |
| 시각 없는 일정 | 알림 대상에서 제외 |
| 알림 탭 | 해당 일정 상세로 이동 |
| 항목 | 확정 |
|---|---|
| 앱 내 계산 수단 | 도보, 자동차 |
| 수단 자동 판정 | 직선거리 1.5km 이하 도보, 초과 자동차 |
| 표시 위치 | 일정 리스트에 항상 표시 |
| 딥링크 이동수단 | 대중교통 고정 |
| 딥링크 버튼 | 이동시간 탭 시 시트에서 |
| 캐싱 | 순서·장소 변경 전까지 재조회 안 함 |
| 노선·환승·요금 정보 | 앱에서 다루지 않음 |
| 항목 | 확정 |
|---|---|
| 마커 간 연결선 | 직선 |
| 진입 방식 | 일정 보드 헤더의 리스트/지도 토글 |
| 표시 범위 | 선택한 날짜만 |
| 마커 탭 | 하단 일정 요약 카드 |
| 항목 | 확정 |
|---|---|
| 결과 사진 | 표시 |
| 영업시간 | 장소 상세 화면에만 |
| 지도 롱프레스 추가 | 없음 |
| 제목만으로 일정 추가 | 가능 |
| 검색 범위 | 여행 목적지 주변 우선 |
| 항목 | 확정 |
|---|---|
| 사진 업로드 | 포함 |
| 평점 | 포함 (별 1~5) |
| 사진 위치정보 장소 제안 | 없음 |
| 작성 위치 | 일정 상세 화면 안 |
| 완료 여행 기록 뷰 | 일정 보드 재사용 (기록 모드) |
| 항목 | 확정 |
|---|---|
| 오프라인 편집 | 불가. 조회 전용 |
| 캐시 범위 | 진행 중 + 예정 여행 |
| 사진 업로드 | 온라인에서만 |
| 항목 | 확정 |
|---|---|
| 환율 통화 | 여행 통화 자동 선택, 변경 가능 |
| 프리셋 | 1,000 / 5,000 / 10,000 |
| 날씨 | 날짜 탭 요약 + 도구 화면 시간대별 상세 |
| 강수 강조 임계값 | 60% |
| 번역 | 구글 번역 딥링크 |
| 진입점 | 일정 보드 헤더 아이콘 |
| 항목 | 확정 |
|---|---|
| 앱 시작 화면 | 진행 중 여행이 있으면 일정 보드, 없으면 홈 |
| 기간 단축 시 잘리는 일정 | 미배정 보관함으로 이동 |
| 여행 복제 | 없음 |
| 커버 이미지 | 없음 |
| 일정 삭제 | 5초 실행취소 스낵바 |
시각 충돌 경고 · 일정 유형 필드 · 지도 롱프레스 추가 · 사진 위치정보 제안 · 오프라인 편집 · 여행 복제 · 커버 이미지 · 앱 내 대중교통 계산 · 앱 내 번역 · 오프라인 지도 · 동행자 공유 · iOS
| 필드 | 타입 | 필수 | 비고 |
|---|---|---|---|
| 제목 | 문자열 | O | 최대 50자 |
| 목적지 도시 | 장소 참조 | O | 검색으로 선택 |
| 시작일 | 날짜 | O | |
| 종료일 | 날짜 | O | 시작일 이상 |
| 타임존 | IANA ID | O | 목적지에서 자동 지정, 수정 가능 |
| 통화 | ISO 4217 | O | 목적지에서 자동 지정, 수정 가능 |
| 기본 알림 시점 | 정수(분) | O | 기본 15 |
| 상태 | 파생값 | — | 오늘 날짜와 기간으로 자동 판정 |
상태 판정 규칙
- 오늘 < 시작일 →
예정 - 시작일 ≤ 오늘 ≤ 종료일 →
진행 중 - 오늘 > 종료일 →
완료
기준은 여행 타임존의 오늘 날짜다. 기기 시간대가 아니다.
| 필드 | 타입 | 필수 | 비고 |
|---|---|---|---|
| 제목 | 문자열 | O | 최대 100자 |
| 날짜 | 날짜 | X | 없으면 미배정 보관함 소속 |
| 순서 | 정수 | O | 같은 날짜 내 정렬 기준 |
| 시작 시각 | 시각 | X | 여행 타임존 기준 벽시계 시각 |
| 장소 | 장소 참조 | X | |
| 메모 | 문자열 | X | 최대 1000자 |
| URL | 문자열 | X | 1개 |
| 일정 알림 | 불리언 + 정수(분) | X | 시각 있을 때만 유효 |
| 출발 알림 | 불리언 | X | 시각 + 이전 일정 장소 있을 때만 유효 |
| 필드 | 비고 |
|---|---|
| 외부 장소 ID | 구글 장소 식별자 |
| 이름 | |
| 주소 | |
| 좌표 | 위도, 경도 |
| 카테고리 | |
| 영업시간 | 캐싱 대상, 30일 만료 |
| 대표 사진 | 캐싱 대상, 30일 만료 |
| 직접 입력 여부 | 검색 없이 만든 장소 구분 |
이름·좌표·외부 ID는 영구 보관한다. 영업시간과 사진은 30일 후 재조회한다.
| 필드 | 타입 | 필수 | 비고 |
|---|---|---|---|
| 소속 일정 | 일정 참조 | O | 일정당 최대 1개 |
| 메모 | 문자열 | X | 최대 2000자 |
| 평점 | 정수 1~5 | X | |
| 사진 | 이미지 목록 | X | 최대 10장 |
| 항목 | 확정값 |
|---|---|
| 일정당 최대 장수 | 10 |
| 파일당 최대 용량 | 15MB |
| 허용 형식 | JPEG, PNG, WebP, HEIC |
| 업로드 방식 | 사용자가 파일 선택기로 직접 선택 |
| 갤러리 자동 스캔 | 없음 |
| 위치정보 활용 | 없음. 업로드 시 EXIF 제거 |
| 썸네일 | 목록용 축소본 생성 |
| 정렬 | 업로드 순서 |
| 삭제 | 개별 삭제. 기록·일정 삭제 시 함께 정리 |
| 오프라인 | 업로드 불가. "연결 후 업로드 가능" 안내 |
| 업로드 실패 | 실패한 파일만 표시, 재시도 버튼 제공 |
진입 조건: 진행 중 여행이 없을 때의 시작 화면
| 상태 | 표시 내용 |
|---|---|
| 예정 여행 있음 | D-day 카운트다운, 여행 제목, 기간, 일정 개수 |
| 완료 여행만 있음 | 최근 완료 여행 카드 + "여행 만들기" |
| 여행 없음 | "여행 만들기" 단일 버튼 |
- 탭:
예정/진행 중/완료 - 카드: 제목, 목적지, 기간, 일정 개수
- 정렬: 예정·진행 중은 시작일 오름차순, 완료는 종료일 내림차순
입력 순서: 목적지 검색 → 제목 → 기간 → (자동 지정된 타임존·통화 확인)
- 목적지 선택 시 타임존과 통화가 자동 채워진다
- 제목 미입력 시 목적지 이름을 기본값으로 사용
- 기간 단축 시 잘리는 날짜의 일정은 미배정 보관함으로 이동. 이동 개수를 확인 모달에 표시
┌───────────────────────────────────┐
│ ← 도쿄 3박 4일 [🔄] [🛠] [⋯] │ 토글 / 도구 / 메뉴
│ 현지 09:42 · Asia/Tokyo │ 시차 있을 때만
├───────────────────────────────────┤
│ [1일차] [2일차] [3일차] [보관함] │
│ 10.24☀️ 10.25☂️ 10.26☀️ │
│ 15/8° 14/9° 17/10° │
├───────────────────────────────────┤
│ 09:00 숙소 체크아웃 │
│ 🚶 12분 › │
│ 10:30 시부야 스카이 🔔 │
│ 🚗 25분 › │
│ 14:00 아사쿠사 │
│ ── 기념품 사기 │ 시각 없는 일정
│ │
│ + │
└───────────────────────────────────┘
헤더
- 시차가 0이면 타임존 줄을 숨긴다
- 🔄 = 리스트/지도 토글, 🛠 = 도구 화면
날짜 탭
- 가로 스크롤. 진행 중 여행은 오늘 날짜 탭이 기본 선택
- 각 탭에 날씨 아이콘 + 최고/최저 기온
- 강수 확률 60% 이상이면 우산 아이콘 강조
- 마지막 탭은 항상
보관함
일정 행
- 시각 있으면 좌측에
HH:mm, 없으면── - 알림 설정된 일정에 🔔
- 장소가 있는 연속된 두 일정 사이에만 이동 시간 행을 넣는다
제스처
| 동작 | 결과 |
|---|---|
| 탭 | 일정 상세 (S-07) |
| 길게 누르기 | 드래그 모드, 햅틱 |
| 드래그 (같은 날) | 순서 변경 → 이동시간 재계산 → 알림 재계산 |
| 드래그 (날짜 탭 위로) | 해당 날짜로 이동 |
| 좌 스와이프 | 삭제 + 5초 실행취소 |
| 우 스와이프 | 보관함으로 이동 |
| 이동시간 행 탭 | 이동수단 시트 |
| + 탭 | 추가 방식 시트 |
추가 방식 시트: 장소 검색 / 직접 입력 / 보관함에서 가져오기
이동수단 시트: 도보 / 자동차 / 구글 지도에서 길찾기
(#1208) 이 시트는 이동 편집 시트로 바뀌었다. 수단 9종을 고르고 편명·소요 시간·예매 링크·메모를 적는다 — 자동 계산이 사라졌기 때문이다. D-26 참고.
빈 상태
- 일정 없는 날짜: "일정이 없어요" + 장소 검색 버튼
- 빈 보관함: "가고 싶은 곳을 미리 담아두세요" + 장소 검색 버튼
오프라인
- 상단에 회색 배너 "오프라인 · 일정 조회만 가능합니다"
- + 버튼, 드래그, 스와이프 비활성화
- 지도 토글 비활성화
- 이동시간은 캐시값을 회색으로 표시
- 선택된 날짜의 장소 있는 일정만 마커 표시
- 마커에 번호. 번호는 지도에 표시된 순서 기준으로 1부터 다시 매긴다 (리스트 순번과 다를 수 있음)
- 마커를 직선으로 연결
- 모든 마커가 보이도록 자동 줌, 여백 10%
- 마커 탭 시 하단 카드: 시각, 제목, 주소, "일정 열기"
- 오프라인 진입 시: 지도 대신 안내 + 리스트 전환 버튼
- 상단 검색 입력, 최근 검색어 5개
- 결과 카드: 사진, 이름, 카테고리, 주소, 평점
- 결과 개수 20개
- 카드 탭 → 장소 상세
- 카드 우측
담기→ 날짜 선택 시트 (1일차~N일차/보관함) -
이전 여행에서 평점 4 이상을 준 장소는→ 미도입(결정 기록 D-18)⭐ 좋았던 곳배지 - 결과 없음: "검색 결과가 없어요" + "직접 입력" 버튼
계획 영역
- 제목, 날짜, 시작 시각, 장소, 메모, URL
- 장소 있으면: 지도 미리보기, 주소, 영업시간, 전화번호, "구글 지도에서 길찾기"
- 알림: 일정 알림 스위치 + 시점(분), 출발 알림 스위치
- 시각이 없으면 알림 영역 전체 비활성화 + "시각을 입력하면 알림을 설정할 수 있어요"
기록 영역 (여행 시작일 이후에만 노출)
- 메모 입력
- 평점 별 5개. 누른 별을 다시 누르면 해제된다 — 되돌릴 방법이 없으면 별점은 함정이 된다
- 자동 저장(디바운스). 현지에서 저장 버튼을 찾게 하지 않는다. 계획 영역과 저장 경로가 분리돼 있어 계획을 저장하지 않아도 기록만 남는다
- 사진 추가 버튼 + 썸네일 그리드. 최대 10장·장당 15MB
- 업로드 중인 장은 로컬 미리보기로 자리를 잡고, 실패한 장은 목록에 남겨 다시 고르게 한다 — 조용히 사라지면 몇 장이 빠졌는지도 모른다
- 사진 탭 → 전체화면 뷰어, 좌우 스와이프(키보드 ←/→·Esc도 된다)
- 오프라인: 기록 영역 비활성화
세 카드로 구성.
환율
- 상단: 여행 통화 ↔ KRW, 통화 변경 가능
- 양방향 입력, 숫자 키패드
- 프리셋 버튼 1,000 / 5,000 / 10,000
- 하단: "ECB 기준 · YYYY-MM-DD" + "실제 결제 환율과 다를 수 있습니다"
- 오프라인: 마지막 환율로 계산, 기준일 회색 + "최신 아님"
날씨
- 여행 기간 일자별 요약 (아이콘, 최고/최저, 강수확률)
- 날짜 선택 시 시간대별 예보
- 예보 범위 밖 날짜: "예보 범위 밖"
- 하단에 데이터 출처 표기 (Open-Meteo, CC BY 4.0)
번역
- 탭 시 구글 번역을 여행 목적지 언어로 실행
- 앱 미설치 시 웹으로 대체
- 알림 권한 상태 / 요청 버튼
- 기본 알림 시점 (분)
- 아침 요약 알림 on/off
- 오프라인 저장 용량 표시 / 초기화
- 바이트와 함께 저장된 응답 건수를 보여준다 — 바이트만으로는 크기가 큰지 작은지 감이 안 온다
- 초기화는 여행 데이터 캐시만 비운다. 앱 셸(precache)은 남긴다 — 셸까지 지우면 오프라인에서 앱이 아예 안 열린다
-
navigator.storage.estimate()를 지원하지 않으면 0으로 꾸미지 않고 모른다고 말한다
- 앱 버전, 데이터 출처 표기
- 일정 시각은 여행 타임존의 벽시계 시각으로 저장한다
- 기기 시간대와 무관하게 화면에는 항상 같은 시각이 보인다
- 여행 타임존을 변경해도 일정 시각은 그대로 유지되고, 알림 발송 시각만 재계산된다
- 기기 시간대와 여행 타임존이 다르면 일정 보드 헤더에 현지 시각과 타임존명을 표시한다
다음 중 하나라도 발생하면 해당 일정의 예약 알림을 취소하고 다시 예약한다.
- 일정 시각 변경
- 일정 순서 변경 (출발 알림의 이동시간이 바뀜)
- 일정 날짜 이동
- 앞 일정의 장소 변경
- 여행 타임존 변경
- 알림 설정 변경
일정이 삭제되거나 보관함으로 이동하면 예약 알림을 취소한다.
- 여행 기간 중 매일 현지 08:00
- 내용:
오늘 일정 4개 · 첫 일정 09:00 숙소 체크아웃 - 해당 날짜에 일정이 없으면 발송하지 않는다
- 장소가 있는 연속된 두 일정 사이에만 계산한다
- 사이에 장소 없는 일정이 끼면 건너뛰고 계산한다
- 직선거리 1.5km 이하는 도보, 초과는 자동차
- 계산 실패 시
약 N.Nkm로 대체 - 이미 계산된 값은 순서·장소가 바뀌기 전까지 재조회하지 않는다
- 이동수단은 항상 대중교통으로 연다
- 출발지·도착지는 좌표로 전달한다
- 앱 내 이동시간 표시가 도보/자동차여도 딥링크는 대중교통이다
조회 가능: 홈, 여행 목록, 일정 보드, 일정 상세(읽기), 보관함, 환율, 날씨(캐시)
조회 불가: 지도, 장소 검색, 시간대별 예보 갱신
편집 불가: 모든 생성·수정·삭제·정렬, 사진 업로드
오프라인 상태에서는 편집 UI를 비활성화하고 상단 배너로 알린다. 온라인 복귀 시 배너가 사라지고 편집이 즉시 가능해진다.
| 대상 | 보관 |
|---|---|
| 여행·일정 데이터 | 진행 중 + 예정 여행 전체 |
| 장소 이름·좌표 | 영구 |
| 장소 영업시간·사진 | 30일 |
| 이동 시간 | 순서·장소 변경 시까지 |
| 환율 | 24시간 |
| 날씨 | 6시간 |
10/24 출발 기준 역산. 각 단계는 그 시점에 여행을 가도 쓸 수 있는 상태로 마감한다.
| 단계 | 기간 | 범위 | 마감 기준 |
|---|---|---|---|
| 1 | 8/7 – 8/24 | 여행 CRUD, 일정 CRUD, 드래그 정렬, 보관함, 홈, 여행 목록 | 도쿄 일정을 텍스트만으로 끝까지 만들 수 있다 |
| 2 | 8/25 – 9/14 | 장소 검색, 담기, 장소 상세, 지도 뷰, 이동시간, 딥링크 | 실제 장소로 3박4일 일정을 완성하고 지도로 동선을 확인할 수 있다 |
| 3 | 9/15 – 9/28 | 타임존, 알림(일정·출발·아침 요약), 설정 | 도쿄 시각으로 알림이 정확히 온다 |
| 4 | 9/29 – 10/12 | 오프라인 조회, 환율, 날씨, 번역 딥링크, 기록, 사진 업로드 | 비행기 모드에서 전체 일정이 보인다 |
| 5 | 10/13 – 10/19 | 실사용 리허설. 실제 10/24 일정을 전부 입력하고 서울에서 하루 써본다 | 발견된 문제 목록 확정 |
| 6 | 10/20 – 10/23 | 리허설에서 나온 문제만 수정. 신규 기능 추가 금지 | 배포 완료 |
기능 동결일: 10/13. 이후에는 수정만 한다.
| 단계 | 위험 | 대응 |
|---|---|---|
| 1 | 드래그 정렬이 터치 환경에서 부자연스러움 | 1단계 안에서 실기기 검증 완료. 여기서 막히면 뒤가 전부 밀림 |
| 3 | 알림이 안 오거나 시각이 어긋남 | 9/28까지 실기기로 최소 3일 연속 검증 |
| 4 | 사진 업로드 실패 처리 | 실패해도 메모·평점은 저장되도록 분리 |
| 5 | 리허설에서 큰 문제 발견 | 그래서 리허설을 10/13에 한다. 11일 여유 |
일정이 밀릴 경우 아래 순서로 뺀다. 위에서부터 뺀다.
- 사진 업로드 (기록의 메모·평점은 유지)
- 아침 요약 알림
- 날씨 시간대별 상세 (날짜 탭 요약은 유지)
- 환율 프리셋
- 번역 딥링크
- 출발 알림 (일정 알림은 유지)
절대 빼지 않는 것: 일정 CRUD, 드래그 정렬, 장소 검색, 오프라인 조회, 타임존, 일정 알림, 구글 지도 딥링크.
10/24 여행에서 아래가 모두 성립하면 성공이다.
- 출발 전 일정 전체를 이 앱에서만 만들었다
- 여행 중 다른 일정 앱·메모를 열지 않았다
- 알림을 보고 움직인 적이 있다
- 기내나 데이터 끊긴 상황에서 일정을 확인했다
- 시각이 어긋난 적이 없다
- 길찾기가 필요할 때 앱에서 구글 지도로 한 번에 넘어갔다