Skip to content

Travel Spec v2 2

wcorn edited this page Oct 19, 2026 · 5 revisions

Orino Travel — 확정 명세 v2.2 (경비 · 준비)

원문 보존 페이지다. 2026-09-05 확정된 기획안을 그대로 둔다(D-1 원칙). 이 문서의 §번호를 화면 설계·결정 기록·이슈가 직접 인용하므로 조항 번호를 바꾸지 않는다.

이전 판: v2.1 다구간 · v2.0 구현 설계: 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록


여행 v2.2 기획안 — 경비 · 준비

여행 모듈에 경비와 준비 두 기능을 더한다. 확정 명세 v2.1을 대체하지 않고 덮어쓴다. 여기 적힌 것만 바뀌고, 적히지 않은 것은 v2.1 그대로다.

항목 내용
작성일 2026-09-05
목표 일자 2026-10-24 일본 여행 실사용 (기능 동결 10/13)
사용자 1인

1. 두 화면이 답해야 할 질문

기능 질문
경비 이번 여행에 얼마 쓰기로 했나 · 지금까지 얼마 썼나 · 남은 며칠에 하루 얼마 쓸 수 있나 · 다녀와서 결국 얼마 들었나
준비 출발까지 아직 안 한 게 뭔가 · 가방에 뭘 넣어야 하나 · 지금 안 하면 늦는 게 있나

이 7개 질문 밖으로 나가는 기능은 이번에 넣지 않는다.


제1부 — 경비

2. 한 문장

여행은 돈을 적는 곳이 아니라, 이미 적힌 돈을 여행이라는 렌즈로 다시 보는 곳이다.

3. 장부는 가계부 하나뿐이다 → 여행이 자기 장부를 갖는다 (v2.3, 2026-09-20)

이 절이 v2.2 경비 설계의 뿌리였고, 뒤집혔다.

v2.2는 가계부 §3-10(「원장은 하나뿐이다. 여행 모듈은 별도 경비 장부를 갖지 않는다」)을 그대로 받아, 여행 화면을 읽기 뷰 + 빠른 입력 통로로 두었다. 가계부를 제거하므로 그 전제가 사라졌다 — D-43 · Travel-Expense-Standalone.

이제 진실의 소재는 여행이다. 경비는 trip_expense에 쌓이고, 읽기도 쓰기도 여행 BE가 받는다.

「장부를 여행 안에 따로 만들면 합계가 어긋난 날 어느 쪽이 맞는지 판단할 근거가 사라진다」가 v2.2의 걱정이었다. 장부가 하나가 되므로 그 상황이 생기지 않는다 — 비교할 두 번째 숫자가 없다.

v2.2 v2.3
저장 ledger_transaction.trip_id trip_expense
쓰기 FE → POST /api/ledger/transactions 여행 BE (POST /api/travel/trips/{id}/expenses)
여행 삭제 SET NULL — 쓴 돈은 원장에 남는다 CASCADE — 남을 원장이 없다
편집 가계부 지출 상세로 이동 여행 안의 편집 시트

여행 안에 가계부를 다시 짓지는 않는다. 자산·잔액·이체·청구서·정기 항목은 아무것도 따라오지 않고, 새 스케줄러도 만들지 않는다(§8).

4. 무엇을 여행 경비로 세나

(v2.3) §4.1·§4.3·§4.4는 그대로다. §4.2(카드 대금 납부)만 폐기된다 — 이체라는 개념이 테이블에서 사라져 구분할 것이 없다.

4.1 출발 전에 쓴 돈도 여행 경비다

항공권·숙소·JR패스는 두 달 전에 결제한다. 이걸 빼면 「여행에 얼마 들었나」에 답이 안 나온다.

  • 결제한 날은 결제한 날 그대로 두고, 여행에 속한다는 사실만 따로 붙인다
  • 화면에서는 **「출발 전」**으로 따로 묶는다. 「1일차 3.2만」 옆에 「출발 전 82만」이 안 보이면 총액이 설명되지 않는다
  • 돌아온 뒤의 결제(현상 인화, 배송비)는 **「다녀온 뒤」**로 같은 자리에 붙는다

4.2 카드 대금 납부는 여행 경비가 아니다 — 폐기 (v2.3)

「도쿄에서 카드로 쓴 3만 엔이 여행 경비이고, 다음 달 통장에서 빠지는 카드값은 아니다」 — 원장을 읽던 시절의 구분이다.

trip_expense에는 지출만 있다. 이체·카드 대금이라는 개념이 테이블에 없으므로 「여행에 200만 썼는데 카드값 200만이 또 나갔다」는 이중 계산이 일어날 수 없다. 화면의 각주(「카드 대금 납부는 여기 들어가지 않아요」)도 함께 뺀다.

4.3 엔화로 적고 원화로 센다

현지에서는 엔화가 기억난다. 합계는 원화로 나와야 한다. 둘 다 보여준다.

점심 라멘     ¥1,200 · 11,300원

환율은 쓴 날의 값으로 굳는다. 조회할 때마다 다시 계산하면 다녀온 여행의 총액이 매일 바뀐다. 「그 여행에 얼마 썼나」는 사실이지 시세가 아니다.

카드사가 실제로 적용한 환율은 며칠 뒤 청구서에 찍히고 고시 환율과 다르다. 그때 환율만 고쳐 쓸 수 있다.

4.4 N일차와 도시는 날짜에서 나온다

쓴 날짜가 여행 기간 안이면 자동으로 「3일차 · 교토」가 붙는다. 사용자가 고르지 않는다.

도시가 바뀌는 날은 도착한 도시 하나로 센다. v2.1이 타임존과 「오늘」 판정을 도착 도시 하나로 정한 것과 같다 — 하루를 둘로 쪼개면 어느 쪽 합계도 맞지 않는다.

5. 예산

5.1 여행 단위 총액 하나

「이번 여행에 80만」 하나만 정한다. 카테고리별·도시별로 나누지 않는다.

  • 도시별 예산은 만들지 않는다. v2.1 §7의 제외를 유지한다. 여행을 한 번도 안 다녀왔는데 도시마다 예산을 걸면, 지키지도 않을 숫자를 여섯 개 관리하게 된다
  • 도시별·날짜별 합계는 그냥 보여준다. 예산을 거는 것과 얼마 썼는지 보는 것은 다른 일이다
  • 헷갈리지 않게: v2.1이 제외한 것은 「구간별 예산」이다. 여행 단위 예산 하나는 남는다 — (v2.3) 가계부가 없어져도 trip.budget_amount는 그대로다(D-28)

5.2 월 예산과 섞지 않는다 — 폐기 (v2.3)

「여행 지출이 월 예산 게이지에 들어가면 여행 간 달은 항상 예산 초과가 된다」가 근거였다. 월 예산 화면이 없어진다. 섞일 대상이 사라졌으므로 규칙도, 월 예산 화면의 「이 달 여행으로 41만」 한 줄도 함께 없어진다.

여행 예산은 계속 trip.budget_amount다(D-28 유지). 애초에 ledger_budget에 넣지 않은 판단이 여기서 값을 한다 — 이번 변경에 예산은 손댈 곳이 없다.

5.3 하루 얼마 쓸 수 있나

(예산 − 지금까지 쓴 돈) ÷ 남은 날짜
  • 예산을 안 정했으면 이 줄을 숨긴다. 0으로 꾸미지 않는다
  • 여행이 끝나면 이 자리가 「총 6일 · 하루 평균 13.7만」으로 바뀐다

6. 화면 — 경비

여행 사이드바에 「경비」를 더한다.

┌───────────────────────────────────┐
│ ← 경비                            │
├───────────────────────────────────┤
│  ▓▓▓▓▓▓▓▓▓▓▓░░░░░░  51%           │
│  80만 중 41.2만                    │
│  남은 4일 · 하루 9.7만              │
├───────────────────────────────────┤
│ 출발 전                    82.0만  │
│   항공권                    64.0만 │
│   JR패스                    18.0만 │
├───────────────────────────────────┤
│ 1일차 · 오사카             3.2만   │
│   점심 라멘      ¥1,200 · 11,300원 │
│   지하철         ¥  580 ·  5,460원 │
├───────────────────────────────────┤
│ 2일차 · 오사카                0원  │
│   아직 적은 게 없어요               │
│                                   │
│           +                      │
└───────────------──────────────────┘
  • 게이지는 두 겹이다. 이미 쓴 돈은 진하게, 결제만 해둔 예정분(숙소 잔금 등)은 연하게. 아직 안 썼지만 나갈 게 확정된 돈이 예산의 어디까지 차지하는지 보여야 한다
  • 날짜 그룹은 접힌다. 기본은 오늘만 펼침
  • (v2.3) 금액을 적은 줄을 누르면 여행 안에서 편집 시트가 열린다. 빠른 입력과 같은 컴포넌트라 편집 화면을 두 벌 만들지 않는다는 걱정은 그대로 지켜진다 — 가계부 편집 화면이 없어졌을 뿐이다

6.1 빠른 입력

현지에서 30초 안에 끝나야 한다.

금액 → 통화 → 카테고리 → 결제수단 → 저장
  • 통화 기본값은 오늘 있는 도시의 통화다. 오사카면 엔, 인천공항이면 원
  • 결제수단 기본값은 직전에 쓴 것이다. 여행 중에는 같은 카드를 계속 쓴다. (v2.3) 자산을 고르는 것이 아니라 라벨을 적는다 — 후보는 그 여행에서 이미 쓴 값뿐이다
  • 금액만 적고 저장할 수 있다. 카테고리를 고르느라 기록을 포기하느니 나중에 채운다. 미분류로 남은 건은 화면에 「정리할 내역 N건」으로 남는다
  • (v2.3) 카테고리는 고정 여섯이다 — 식비·교통·숙소·관광·쇼핑·기타. 사용자 정의를 두지 않고 일곱 번째도 만들지 않는다(D-31과 같은 이유)

6.2 오프라인

v2.1과 같다. 볼 수는 있고 적을 수는 없다.

여기가 이 기능에서 가장 아픈 자리다. 지출은 지하철에서, 식당에서, 신호가 없는 곳에서 적고 싶은 것이다. 그래도 예외를 두지 않는다 — 이 앱은 오프라인에서 적은 것을 나중에 보내지 않기로 이미 정했고, 그 문을 경비에만 열면 준비도, 일정도 열어야 한다.

대신 나중에 적어도 되게 만든다. 금액만으로 저장되는 입력(§6.1)이 그 대비다.

리허설에서 놓친 건수를 센다. 5건이 넘으면 그때 다시 본다.

7. 홈과 보드

진행 중 여행이면 요약에 한 줄:

예산 80만 중 41.2만

예산을 안 정했으면 줄 자체를 숨긴다. 없는 데이터로 자리를 채우지 않는다.

8. 경비 — 만들지 않는 것

안 만드는 것 이유
영수증 사진·자동 인식 1인용 앱에 값하지 않는다. (v2.3) 가계부의 첨부 기능도 함께 사라진다
더치페이·정산 1인용이다
도시별 예산 §5.1
여행 전용 통계 화면 (v2.3) 카테고리 합계는 경비 화면의 그룹 합으로 충분하다. 가계부 통계에 「여행」 필터 → 그 화면이 없어졌지만, 그렇다고 도넛·추이를 여기 만들지 않는다
일정에 금액 붙이기 날짜만으로 「N일차 얼마」는 이미 나온다. 일정마다 금액을 고르게 하면 입력이 한 단계 늘고, 그만큼 안 적게 된다
예산 초과 알림 여행 중에 "돈 그만 써라"는 알림은 받고 싶지 않다
지금 환율로 과거 지출 재계산 §4.3
(v2.3) 자산·잔액·이체·청구서·정기 항목 여기에 가계부를 다시 짓지 않는다(§3)
(v2.3) 예정 자동 승격 스케줄러 지난 예정은 화면이 표시하고 사람이 확정한다. 가계부 제거로 앱의 주기 작업이 7개 → 3개가 되는데 여기서 하나를 도로 늘리지 않는다
(v2.3) 사용자 정의 카테고리 만드는 순간 관리 화면·순서·삭제 시 재배정이 따라온다

제2부 — 준비

9. 한 문장

출발 전날 밤에 이 화면 하나만 열면 되게 한다.

10. 왜 일정 보드에 넣지 않나

넣을 뻔한 곳 왜 아닌가
미배정 보관함 보관함은 **「가고 싶은 곳」**이다. 장소가 없는 「멀티어댑터」가 섞이면 도시별 그룹이 「도시 없음」으로 반쯤 찬다
일정 일정은 날짜·시각·순서·장소·이동·알림을 갖는다. 준비물은 그중 아무것도 없다. 억지로 넣으면 이동 표시와 도시 판정이 「양말 4켤레」에 걸린다
노트·메모 일상 워크스페이스다. 여행 준비하다 워크스페이스를 갈아타야 한다

준비는 따로 선다.

11. 무엇을 적나

네 갈래다.

분류 하는 일 예
서류 챙기는 것 여권, 여행자보험 증서, 국제운전면허증
예약 끝내는 것 항공권 발권, 숙소 잔금, JR패스 교환권
짐 넣는 것 멀티어댑터, 상비약, 양말 4
할 일 하는 것 환전, 데이터 유심, 집 화분 물주기

「환전」을 위해 다섯 번째 분류를 만들지 않는다. 돈 관련을 따로 빼면 「해외카드 되는지 확인」이 서류인지 돈인지 매번 헷갈린다. 네 분류는 행동이 다르다. 애매하면 「할 일」이다.

한 항목이 갖는 것: 제목 · 체크 · 묶음 · 수량(짐만) · 기한 · 링크 · 메모.

11.1 분류 안의 묶음 (#1358, 2026-09-06 추가)

분류는 넷 그대로 두고, 그 안에 이름 붙인 묶음을 한 겹 둔다. 선택이다 — 안 쓰면 목록은 넣기 전과 똑같이 보인다.

쓰다 보니 짐이 스물을 넘겨 분류 하나가 한 화면에 안 들어왔다. 다섯 번째 분류로는 이걸 못 고친다 — 긴 것은 「짐 안쪽」이고, 나눌 축이 여행마다 다르기 때문이다(겨울/여름, 국내/해외, 캐리어/기내백). 축이 둘인데 하나만 있었던 것이다.

축 성격 형태
분류 행동이 다르다 — 챙긴다 / 끝낸다 / 넣는다 / 한다. 여행이 바뀌어도 안 변한다 고정 넷 (§11 그대로)
묶음 이번 여행의 사정 — 캐리어 · 기내백 · 세면백, 출발 전 · 공항에서 · 현지에서 사용자가 적는 이름
  • 이름 하나가 곧 묶음이다. 별도 테이블도, 순서 값도 만들지 않는다 — 묶음의 자리는 그 안의 첫 항목이 정하고, 마지막 항목이 나가면 묶음도 함께 사라진다
  • 「묶음 없음」이 항상 맨 위다. 그리고 이름 붙은 묶음이 하나도 없는 분류는 소제목 자체를 그리지 않는다 — 안 나눈 사람에게 줄 하나가 늘어나면 그건 기능이 아니라 군더더기다
  • 묶음을 옮기면 그 묶음의 맨 뒤로 간다. 분류를 옮길 때와 같은 규칙이다
  • 분류를 옮겨도 묶음 이름은 따라간다. 수량과 다르다 — 수량은 짐 전용이라고 우리가 정의한 값이고, 묶음은 사용자가 적은 말이라 조용히 지우면 무엇을 적었는지가 어디에도 안 남는다

다섯 번째 분류는 여전히 만들지 않는다(D-31 유지 · D-41).

12. 기한은 날짜가 아니라 D−N이다

「10월 10일까지」가 아니라 **「출발 14일 전까지」**로 적는다.

여행 기간은 바뀐다. 출발일을 하루 당기는 순간, 날짜로 적어둔 「10월 10일 숙소 잔금」은 조용히 하루 늦은 기한이 된다. D−N으로 두면 알아서 따라 움직인다.

화면에는 D-14로 보이고, 지났으면 경고색이다.

13. 화면 — 준비

여행 사이드바에 「준비」를 더한다.

┌───────────────────────────────────┐
│ ← 준비              D-49          │
├───────────────────────────────────┤
│  ▓▓▓▓▓▓▓▓▓▓▓▓░░░░  18/24          │
│  남은 6개 · 기한 지난 것 1개  ⚠    │
├───────────────────────────────────┤
│ 서류 (3/3)                     ▾  │
│ ─────────────────────────────     │
│ 예약 (4/5)                     ▾  │
│  ☑ 항공권 발권              🔗    │
│  ☐ 숙소 잔금 결제      D-14 ⚠     │
│ ─────────────────────────────     │
│ 짐 (9/12)                      ▾  │
│  ☐ 멀티어댑터                     │
│  ☐ 양말          4                │
│ ─────────────────────────────     │
│ 할 일 (2/4)                    ▾  │
│                                   │
│ + 추가하고 엔터…                  │
└───────────────────────────────────┘

진행률은 전체와 분류별 둘 다 보여준다. 「18/24」만 있으면 접힌 채로는 뭐가 남았는지 모른다.

기한 지난 항목은 맨 위에 개수로 상시 노출된다. 가계부의 미납 경고와 같은 태도다 — 눈에 거슬리는 게 목적이고, 「무시」 버튼을 두지 않는다. 체크하거나 기한을 옮겨야만 사라진다.

체크해도 자리를 옮기지 않는다. 취소선 + 흐리게. 짐 싸기는 목록을 위에서 아래로 훑는 작업이라 순서가 흔들리면 어디까지 했는지 잃는다. 다 끝난 뒤에 보기 싫으면 「완료 숨기기」를 켠다.

+는 하단에 붙박이 입력줄이다. 시트를 열고 닫지 않는다. 짐 목록은 스무 개를 연달아 치는 작업이고, 엔터로 계속 이어져야 한다. 분류는 방금 적은 분류를 이어받는다.

삭제는 누르는 즉시 된다(#1432). 일정과 같다. 예전의 5초 실행취소는 없앴다.

오프라인에서는 볼 수만 있다. 기내에서 목록을 확인하는 건 되고, 체크는 안 된다.

14. 알림 — 하나만

출발 전날 아침 9시, 남은 항목이 있을 때만.

내일 출발 · 준비 6개 남았어요

여행 중 아침 요약은 여행 기간에만 온다. 준비는 그 전에 끝나야 하는 일이라 거기 얹을 수 없다. 그래서 별개로 하나 둔다.

두 개 이상 만들지 않는다. D-7, D-3, D-1로 계속 오면 그때부터 알림을 무시하게 되고, 정작 필요한 여행 중 일정 알림까지 같이 무시된다.

15. 준비 — 만들지 않는 것

안 만드는 것 이유
템플릿 · 지난 여행에서 가져오기 여행이 아직 한 번도 안 끝났다. 복사할 과거가 없다. 늘 빈 목록만 뜨는 버튼을 들고 다니게 된다. 두 번째 여행을 만들 때 넣는 게 싸다
자동 추천(날씨·목적지 기반) 규칙을 만들 근거가 없다. 틀린 제안 몇 번이면 목록 전체를 안 믿게 된다
무게·수하물 규정 계산
사진 첨부 여권 사진을 앱에 넣는 건 준비가 아니라 보안 문제다
동행자 공유 v2.0에서 이미 제외했다
준비 항목 → 일정 변환 준비는 날짜가 없는 것이라고 §10에서 정의했다. 변환 버튼이 그 정의를 무효로 만든다
반복 준비물(매 여행 공통) 템플릿과 같은 이유

제3부 — 순서

16. 준비를 먼저 낸다

① 준비 가계부와 무관하게 지금 시작할 수 있고, 출발 전에 값을 낸다. 늦게 만들면 이번 여행에 못 쓴다
② 경비 가계부 원장 위에 서는 기능이라 그쪽이 먼저 준비돼 있어야 했다

(v2.3) 이 순서의 근거는 사라졌다. 경비가 독립하면서 가계부를 기다릴 것이 없어졌다 — 이제 준비와 경비가 같은 모양이다(둘 다 여행 안에서 닫힌다). 다만 v2.2는 이 순서대로 이미 나갔다.

동결은 10/13이다. 그 뒤로는 고치기만 한다.

17. 밀리면 위에서부터 뺀다

  1. 준비 알림
  2. 경비 — 도시별 합계
  3. 경비 — 하루 사용 가능액
  4. 준비 — 순서 바꾸기
  5. 준비 — 수량
  6. 홈·보드 요약 한 줄
  7. 경비 전체 → §18

절대 빼지 않는 것

  • 준비: 네 분류 체크리스트 · 붙박이 입력줄 · 진행률 · 오프라인 조회
  • 경비: 여행 연결 · 빠른 입력 · 날짜별 합계 · 예산 게이지

18. 경비를 이번에 못 내면 — 폐기 (v2.3)

「여행 중에는 가계부에 그냥 적고, 돌아와서 기간으로 걸러 「여행에 붙이기」 한 번」이 비상 경로였다. 가계부도, attach/detach도 없어진다.

역설적으로 이 절의 걱정이 현실이 됐다. 「여행 안에 급히 장부를 만들지 않는다 — 나중에 두 장부를 합치는 일이 이번에 아끼는 2주보다 크다」고 적어 두었는데, 결국 장부를 여행 안에 만든다. 다만 합칠 두 번째 장부가 없다는 점이 다르다. 이관은 한 방향 복사 한 번으로 끝난다(Travel-Expense-Standalone §5.2).

19. 완료 판정

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

경비

  1. 여행 중 쓴 돈을 이 앱에만 적었다
  2. 엔화로 적었는데 원화 합계가 카드 청구서와 3% 안에서 맞았다
  3. 월 예산이 여행 때문에 터지지 않았다 — (v2.3) 폐기. 월 예산이 없다
  4. 가계부에서 본 합계와 여행에서 본 합계가 같았다 — (v2.3) 폐기. 비교할 두 번째 숫자가 없다
  5. 카드값 납부가 여행 경비에 한 번도 안 들어갔다 — (v2.3) 폐기. 이체 개념이 없다
  6. (v2.3) 지출을 적고·고치고·지우는 일이 여행 화면을 벗어나지 않았다

준비

  1. 출발 전날 이 화면만 보고 짐을 쌌다
  2. 빠뜨린 게 없었다
  3. 메모앱·「나에게 보내기」를 열지 않았다
  4. 기내에서(오프라인) 목록을 확인했다
  5. 기한 지난 항목이 눈에 걸려서 실제로 처리했다

Clone this wiki locally