Skip to content

Travel Spec v2

wcorn edited this page Aug 15, 2026 · 7 revisions

Orino Travel — 확정 명세 v2.0

⚠️ 현행 정본은 확정 명세 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일

이 문서는 논의가 끝난 확정 명세다. 선택지나 검토 항목은 남기지 않는다. 모든 수치는 확정값이다.


1. 확정 결정 요약

1.1 데이터 모델

항목 확정
일정 시각 시작 시각만. 종료 시각·소요시간 필드 없음
시각 없는 일정 허용
시각 충돌 경고 없음
일정 유형 필드 없음. 장소 연결 유무로만 구분
미배정 보관함 여행별로 하나
일정 URL 필드 있음 (예약 페이지 링크용)
여행당 타임존 1개 고정

1.2 알림 (서버 푸시)

항목 확정
알림 종류 일정 알림 + 출발 알림, 둘 다
일정 알림 기본 시점 시작 15분 전
출발 알림 계산식 시작시각 − 이동시간 − 5분
아침 요약 알림 있음. 현지 08:00
설정 단위 일정별 개별 on/off + 여행 단위 기본값
시각 없는 일정 알림 대상에서 제외
알림 탭 해당 일정 상세로 이동

1.3 이동·경로

항목 확정
앱 내 계산 수단 도보, 자동차
수단 자동 판정 직선거리 1.5km 이하 도보, 초과 자동차
표시 위치 일정 리스트에 항상 표시
딥링크 이동수단 대중교통 고정
딥링크 버튼 이동시간 탭 시 시트에서
캐싱 순서·장소 변경 전까지 재조회 안 함
노선·환승·요금 정보 앱에서 다루지 않음

1.4 지도

항목 확정
마커 간 연결선 직선
진입 방식 일정 보드 헤더의 리스트/지도 토글
표시 범위 선택한 날짜만
마커 탭 하단 일정 요약 카드

1.5 장소

항목 확정
결과 사진 표시
영업시간 장소 상세 화면에만
지도 롱프레스 추가 없음
제목만으로 일정 추가 가능
검색 범위 여행 목적지 주변 우선

1.6 기록

항목 확정
사진 업로드 포함
평점 포함 (별 1~5)
사진 위치정보 장소 제안 없음
작성 위치 일정 상세 화면 안
완료 여행 기록 뷰 일정 보드 재사용 (기록 모드)

1.7 오프라인

항목 확정
오프라인 편집 불가. 조회 전용
캐시 범위 진행 중 + 예정 여행
사진 업로드 온라인에서만

1.8 도구

항목 확정
환율 통화 여행 통화 자동 선택, 변경 가능
프리셋 1,000 / 5,000 / 10,000
날씨 날짜 탭 요약 + 도구 화면 시간대별 상세
강수 강조 임계값 60%
번역 구글 번역 딥링크
진입점 일정 보드 헤더 아이콘

1.9 기타

항목 확정
앱 시작 화면 진행 중 여행이 있으면 일정 보드, 없으면 홈
기간 단축 시 잘리는 일정 미배정 보관함으로 이동
여행 복제 없음
커버 이미지 없음
일정 삭제 5초 실행취소 스낵바

1.10 제외 확정 기능

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


2. 데이터 정의

2.1 여행 (Trip)

필드 타입 필수 비고
제목 문자열 O 최대 50자
목적지 도시 장소 참조 O 검색으로 선택
시작일 날짜 O
종료일 날짜 O 시작일 이상
타임존 IANA ID O 목적지에서 자동 지정, 수정 가능
통화 ISO 4217 O 목적지에서 자동 지정, 수정 가능
기본 알림 시점 정수(분) O 기본 15
상태 파생값 — 오늘 날짜와 기간으로 자동 판정

상태 판정 규칙

  • 오늘 < 시작일 → 예정
  • 시작일 ≤ 오늘 ≤ 종료일 → 진행 중
  • 오늘 > 종료일 → 완료

기준은 여행 타임존의 오늘 날짜다. 기기 시간대가 아니다.

2.2 일정 (Activity)

필드 타입 필수 비고
제목 문자열 O 최대 100자
날짜 날짜 X 없으면 미배정 보관함 소속
순서 정수 O 같은 날짜 내 정렬 기준
시작 시각 시각 X 여행 타임존 기준 벽시계 시각
장소 장소 참조 X
메모 문자열 X 최대 1000자
URL 문자열 X 1개
일정 알림 불리언 + 정수(분) X 시각 있을 때만 유효
출발 알림 불리언 X 시각 + 이전 일정 장소 있을 때만 유효

2.3 장소 (Place)

필드 비고
외부 장소 ID 구글 장소 식별자
이름
주소
좌표 위도, 경도
카테고리
영업시간 캐싱 대상, 30일 만료
대표 사진 캐싱 대상, 30일 만료
직접 입력 여부 검색 없이 만든 장소 구분

이름·좌표·외부 ID는 영구 보관한다. 영업시간과 사진은 30일 후 재조회한다.

2.4 기록 (Log)

필드 타입 필수 비고
소속 일정 일정 참조 O 일정당 최대 1개
메모 문자열 X 최대 2000자
평점 정수 1~5 X
사진 이미지 목록 X 최대 10장

2.5 사진 (Photo)

항목 확정값
일정당 최대 장수 10
파일당 최대 용량 15MB
허용 형식 JPEG, PNG, WebP, HEIC
업로드 방식 사용자가 파일 선택기로 직접 선택
갤러리 자동 스캔 없음
위치정보 활용 없음. 업로드 시 EXIF 제거
썸네일 목록용 축소본 생성
정렬 업로드 순서
삭제 개별 삭제. 기록·일정 삭제 시 함께 정리
오프라인 업로드 불가. "연결 후 업로드 가능" 안내
업로드 실패 실패한 파일만 표시, 재시도 버튼 제공

3. 화면 명세

S-01 홈

진입 조건: 진행 중 여행이 없을 때의 시작 화면

상태 표시 내용
예정 여행 있음 D-day 카운트다운, 여행 제목, 기간, 일정 개수
완료 여행만 있음 최근 완료 여행 카드 + "여행 만들기"
여행 없음 "여행 만들기" 단일 버튼

S-02 여행 목록

  • 탭: 예정 / 진행 중 / 완료
  • 카드: 제목, 목적지, 기간, 일정 개수
  • 정렬: 예정·진행 중은 시작일 오름차순, 완료는 종료일 내림차순

S-03 여행 생성·수정

입력 순서: 목적지 검색 → 제목 → 기간 → (자동 지정된 타임존·통화 확인)

  • 목적지 선택 시 타임존과 통화가 자동 채워진다
  • 제목 미입력 시 목적지 이름을 기본값으로 사용
  • 기간 단축 시 잘리는 날짜의 일정은 미배정 보관함으로 이동. 이동 개수를 확인 모달에 표시

S-04 일정 보드 — 주 화면

┌───────────────────────────────────┐
│ ← 도쿄 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 참고.

빈 상태

  • 일정 없는 날짜: "일정이 없어요" + 장소 검색 버튼
  • 빈 보관함: "가고 싶은 곳을 미리 담아두세요" + 장소 검색 버튼

오프라인

  • 상단에 회색 배너 "오프라인 · 일정 조회만 가능합니다"
  • + 버튼, 드래그, 스와이프 비활성화
  • 지도 토글 비활성화
  • 이동시간은 캐시값을 회색으로 표시

S-05 지도 뷰

  • 선택된 날짜의 장소 있는 일정만 마커 표시
  • 마커에 번호. 번호는 지도에 표시된 순서 기준으로 1부터 다시 매긴다 (리스트 순번과 다를 수 있음)
  • 마커를 직선으로 연결
  • 모든 마커가 보이도록 자동 줌, 여백 10%
  • 마커 탭 시 하단 카드: 시각, 제목, 주소, "일정 열기"
  • 오프라인 진입 시: 지도 대신 안내 + 리스트 전환 버튼

S-06 장소 검색

  • 상단 검색 입력, 최근 검색어 5개
  • 결과 카드: 사진, 이름, 카테고리, 주소, 평점
  • 결과 개수 20개
  • 카드 탭 → 장소 상세
  • 카드 우측 담기 → 날짜 선택 시트 (1일차~N일차 / 보관함)
  • 이전 여행에서 평점 4 이상을 준 장소는 ⭐ 좋았던 곳 배지 → 미도입(결정 기록 D-18)
  • 결과 없음: "검색 결과가 없어요" + "직접 입력" 버튼

S-07 일정 상세·편집

계획 영역

  • 제목, 날짜, 시작 시각, 장소, 메모, URL
  • 장소 있으면: 지도 미리보기, 주소, 영업시간, 전화번호, "구글 지도에서 길찾기"
  • 알림: 일정 알림 스위치 + 시점(분), 출발 알림 스위치
  • 시각이 없으면 알림 영역 전체 비활성화 + "시각을 입력하면 알림을 설정할 수 있어요"

기록 영역 (여행 시작일 이후에만 노출)

  • 메모 입력
  • 평점 별 5개. 누른 별을 다시 누르면 해제된다 — 되돌릴 방법이 없으면 별점은 함정이 된다
  • 자동 저장(디바운스). 현지에서 저장 버튼을 찾게 하지 않는다. 계획 영역과 저장 경로가 분리돼 있어 계획을 저장하지 않아도 기록만 남는다
  • 사진 추가 버튼 + 썸네일 그리드. 최대 10장·장당 15MB
  • 업로드 중인 장은 로컬 미리보기로 자리를 잡고, 실패한 장은 목록에 남겨 다시 고르게 한다 — 조용히 사라지면 몇 장이 빠졌는지도 모른다
  • 사진 탭 → 전체화면 뷰어, 좌우 스와이프(키보드 ←/→·Esc도 된다)
  • 오프라인: 기록 영역 비활성화

S-08 도구

세 카드로 구성.

환율

  • 상단: 여행 통화 ↔ KRW, 통화 변경 가능
  • 양방향 입력, 숫자 키패드
  • 프리셋 버튼 1,000 / 5,000 / 10,000
  • 하단: "ECB 기준 · YYYY-MM-DD" + "실제 결제 환율과 다를 수 있습니다"
  • 오프라인: 마지막 환율로 계산, 기준일 회색 + "최신 아님"

날씨

  • 여행 기간 일자별 요약 (아이콘, 최고/최저, 강수확률)
  • 날짜 선택 시 시간대별 예보
  • 예보 범위 밖 날짜: "예보 범위 밖"
  • 하단에 데이터 출처 표기 (Open-Meteo, CC BY 4.0)

번역

  • 탭 시 구글 번역을 여행 목적지 언어로 실행
  • 앱 미설치 시 웹으로 대체

S-09 설정

  • 알림 권한 상태 / 요청 버튼
  • 기본 알림 시점 (분)
  • 아침 요약 알림 on/off
  • 오프라인 저장 용량 표시 / 초기화
    • 바이트와 함께 저장된 응답 건수를 보여준다 — 바이트만으로는 크기가 큰지 작은지 감이 안 온다
    • 초기화는 여행 데이터 캐시만 비운다. 앱 셸(precache)은 남긴다 — 셸까지 지우면 오프라인에서 앱이 아예 안 열린다
    • navigator.storage.estimate()를 지원하지 않으면 0으로 꾸미지 않고 모른다고 말한다
  • 앱 버전, 데이터 출처 표기

4. 동작 규칙

4.1 시각과 타임존

  • 일정 시각은 여행 타임존의 벽시계 시각으로 저장한다
  • 기기 시간대와 무관하게 화면에는 항상 같은 시각이 보인다
  • 여행 타임존을 변경해도 일정 시각은 그대로 유지되고, 알림 발송 시각만 재계산된다
  • 기기 시간대와 여행 타임존이 다르면 일정 보드 헤더에 현지 시각과 타임존명을 표시한다

4.2 알림 재계산 트리거

다음 중 하나라도 발생하면 해당 일정의 예약 알림을 취소하고 다시 예약한다.

  • 일정 시각 변경
  • 일정 순서 변경 (출발 알림의 이동시간이 바뀜)
  • 일정 날짜 이동
  • 앞 일정의 장소 변경
  • 여행 타임존 변경
  • 알림 설정 변경

일정이 삭제되거나 보관함으로 이동하면 예약 알림을 취소한다.

4.3 아침 요약 알림

  • 여행 기간 중 매일 현지 08:00
  • 내용: 오늘 일정 4개 · 첫 일정 09:00 숙소 체크아웃
  • 해당 날짜에 일정이 없으면 발송하지 않는다

4.4 이동 시간

  • 장소가 있는 연속된 두 일정 사이에만 계산한다
  • 사이에 장소 없는 일정이 끼면 건너뛰고 계산한다
  • 직선거리 1.5km 이하는 도보, 초과는 자동차
  • 계산 실패 시 약 N.Nkm로 대체
  • 이미 계산된 값은 순서·장소가 바뀌기 전까지 재조회하지 않는다

4.5 구글 지도 딥링크

  • 이동수단은 항상 대중교통으로 연다
  • 출발지·도착지는 좌표로 전달한다
  • 앱 내 이동시간 표시가 도보/자동차여도 딥링크는 대중교통이다

4.6 오프라인

조회 가능: 홈, 여행 목록, 일정 보드, 일정 상세(읽기), 보관함, 환율, 날씨(캐시)

조회 불가: 지도, 장소 검색, 시간대별 예보 갱신

편집 불가: 모든 생성·수정·삭제·정렬, 사진 업로드

오프라인 상태에서는 편집 UI를 비활성화하고 상단 배너로 알린다. 온라인 복귀 시 배너가 사라지고 편집이 즉시 가능해진다.

4.7 캐시 정책

대상 보관
여행·일정 데이터 진행 중 + 예정 여행 전체
장소 이름·좌표 영구
장소 영업시간·사진 30일
이동 시간 순서·장소 변경 시까지
환율 24시간
날씨 6시간

5. 일정 계획

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. 이후에는 수정만 한다.

5.1 단계별 위험 요소

단계 위험 대응
1 드래그 정렬이 터치 환경에서 부자연스러움 1단계 안에서 실기기 검증 완료. 여기서 막히면 뒤가 전부 밀림
3 알림이 안 오거나 시각이 어긋남 9/28까지 실기기로 최소 3일 연속 검증
4 사진 업로드 실패 처리 실패해도 메모·평점은 저장되도록 분리
5 리허설에서 큰 문제 발견 그래서 리허설을 10/13에 한다. 11일 여유

5.2 잘라낼 순서

일정이 밀릴 경우 아래 순서로 뺀다. 위에서부터 뺀다.

  1. 사진 업로드 (기록의 메모·평점은 유지)
  2. 아침 요약 알림
  3. 날씨 시간대별 상세 (날짜 탭 요약은 유지)
  4. 환율 프리셋
  5. 번역 딥링크
  6. 출발 알림 (일정 알림은 유지)

절대 빼지 않는 것: 일정 CRUD, 드래그 정렬, 장소 검색, 오프라인 조회, 타임존, 일정 알림, 구글 지도 딥링크.


6. 완료 판정

10/24 여행에서 아래가 모두 성립하면 성공이다.

  1. 출발 전 일정 전체를 이 앱에서만 만들었다
  2. 여행 중 다른 일정 앱·메모를 열지 않았다
  3. 알림을 보고 움직인 적이 있다
  4. 기내나 데이터 끊긴 상황에서 일정을 확인했다
  5. 시각이 어긋난 적이 없다
  6. 길찾기가 필요할 때 앱에서 구글 지도로 한 번에 넘어갔다

Clone this wiki locally