Repository navigation
Travel Spec v2 2
원문 보존 페이지다. 2026-09-05 확정된 기획안을 그대로 둔다(D-1 원칙). 이 문서의
§번호를 화면 설계·결정 기록·이슈가 직접 인용하므로 조항 번호를 바꾸지 않는다.이전 판: v2.1 다구간 · v2.0 구현 설계: 아키텍처 · 데이터 모델 · API · 화면 · 결정 기록
여행 모듈에 경비와 준비 두 기능을 더한다. 확정 명세 v2.1을 대체하지 않고 덮어쓴다. 여기 적힌 것만 바뀌고, 적히지 않은 것은 v2.1 그대로다.
| 항목 | 내용 |
|---|---|
| 작성일 | 2026-09-05 |
| 목표 일자 | 2026-10-24 일본 여행 실사용 (기능 동결 10/13) |
| 사용자 | 1인 |
| 기능 | 질문 |
|---|---|
| 경비 | 이번 여행에 얼마 쓰기로 했나 · 지금까지 얼마 썼나 · 남은 며칠에 하루 얼마 쓸 수 있나 · 다녀와서 결국 얼마 들었나 |
| 준비 | 출발까지 아직 안 한 게 뭔가 · 가방에 뭘 넣어야 하나 · 지금 안 하면 늦는 게 있나 |
이 7개 질문 밖으로 나가는 기능은 이번에 넣지 않는다.
여행은 돈을 적는 곳이 아니라, 이미 적힌 돈을 여행이라는 렌즈로 다시 보는 곳이다.
이 절이 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).
(v2.3) §4.1·§4.3·§4.4는 그대로다. §4.2(카드 대금 납부)만 폐기된다 — 이체라는 개념이 테이블에서 사라져 구분할 것이 없다.
항공권·숙소·JR패스는 두 달 전에 결제한다. 이걸 빼면 「여행에 얼마 들었나」에 답이 안 나온다.
- 결제한 날은 결제한 날 그대로 두고, 여행에 속한다는 사실만 따로 붙인다
- 화면에서는 **「출발 전」**으로 따로 묶는다. 「1일차 3.2만」 옆에 「출발 전 82만」이 안 보이면 총액이 설명되지 않는다
- 돌아온 뒤의 결제(현상 인화, 배송비)는 **「다녀온 뒤」**로 같은 자리에 붙는다
「도쿄에서 카드로 쓴 3만 엔이 여행 경비이고, 다음 달 통장에서 빠지는 카드값은 아니다」 — 원장을 읽던 시절의 구분이다.
trip_expense에는 지출만 있다. 이체·카드 대금이라는 개념이 테이블에 없으므로 「여행에 200만 썼는데 카드값 200만이 또 나갔다」는 이중 계산이 일어날 수 없다. 화면의 각주(「카드 대금 납부는 여기 들어가지 않아요」)도 함께 뺀다.
현지에서는 엔화가 기억난다. 합계는 원화로 나와야 한다. 둘 다 보여준다.
점심 라멘 ¥1,200 · 11,300원
환율은 쓴 날의 값으로 굳는다. 조회할 때마다 다시 계산하면 다녀온 여행의 총액이 매일 바뀐다. 「그 여행에 얼마 썼나」는 사실이지 시세가 아니다.
카드사가 실제로 적용한 환율은 며칠 뒤 청구서에 찍히고 고시 환율과 다르다. 그때 환율만 고쳐 쓸 수 있다.
쓴 날짜가 여행 기간 안이면 자동으로 「3일차 · 교토」가 붙는다. 사용자가 고르지 않는다.
도시가 바뀌는 날은 도착한 도시 하나로 센다. v2.1이 타임존과 「오늘」 판정을 도착 도시 하나로 정한 것과 같다 — 하루를 둘로 쪼개면 어느 쪽 합계도 맞지 않는다.
「이번 여행에 80만」 하나만 정한다. 카테고리별·도시별로 나누지 않는다.
- 도시별 예산은 만들지 않는다. v2.1 §7의 제외를 유지한다. 여행을 한 번도 안 다녀왔는데 도시마다 예산을 걸면, 지키지도 않을 숫자를 여섯 개 관리하게 된다
- 도시별·날짜별 합계는 그냥 보여준다. 예산을 거는 것과 얼마 썼는지 보는 것은 다른 일이다
- 헷갈리지 않게: v2.1이 제외한 것은 「구간별 예산」이다. 여행 단위 예산 하나는 남는다 — (v2.3) 가계부가 없어져도
trip.budget_amount는 그대로다(D-28)
「여행 지출이 월 예산 게이지에 들어가면 여행 간 달은 항상 예산 초과가 된다」가 근거였다. 월 예산 화면이 없어진다. 섞일 대상이 사라졌으므로 규칙도, 월 예산 화면의 「이 달 여행으로 41만」 한 줄도 함께 없어진다.
여행 예산은 계속
trip.budget_amount다(D-28 유지). 애초에ledger_budget에 넣지 않은 판단이 여기서 값을 한다 — 이번 변경에 예산은 손댈 곳이 없다.
(예산 − 지금까지 쓴 돈) ÷ 남은 날짜
- 예산을 안 정했으면 이 줄을 숨긴다. 0으로 꾸미지 않는다
- 여행이 끝나면 이 자리가 「총 6일 · 하루 평균 13.7만」으로 바뀐다
여행 사이드바에 「경비」를 더한다.
┌───────────────────────────────────┐
│ ← 경비 │
├───────────────────────────────────┤
│ ▓▓▓▓▓▓▓▓▓▓▓░░░░░░ 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) 금액을 적은 줄을 누르면 여행 안에서 편집 시트가 열린다. 빠른 입력과 같은 컴포넌트라
편집 화면을 두 벌 만들지 않는다는 걱정은 그대로 지켜진다 — 가계부 편집 화면이 없어졌을 뿐이다
현지에서 30초 안에 끝나야 한다.
금액 → 통화 → 카테고리 → 결제수단 → 저장
- 통화 기본값은 오늘 있는 도시의 통화다. 오사카면 엔, 인천공항이면 원
- 결제수단 기본값은 직전에 쓴 것이다. 여행 중에는 같은 카드를 계속 쓴다. (v2.3) 자산을 고르는 것이 아니라 라벨을 적는다 — 후보는 그 여행에서 이미 쓴 값뿐이다
- 금액만 적고 저장할 수 있다. 카테고리를 고르느라 기록을 포기하느니 나중에 채운다. 미분류로 남은 건은 화면에 「정리할 내역 N건」으로 남는다
- (v2.3) 카테고리는 고정 여섯이다 — 식비·교통·숙소·관광·쇼핑·기타. 사용자 정의를 두지 않고 일곱 번째도 만들지 않는다(D-31과 같은 이유)
v2.1과 같다. 볼 수는 있고 적을 수는 없다.
여기가 이 기능에서 가장 아픈 자리다. 지출은 지하철에서, 식당에서, 신호가 없는 곳에서 적고 싶은 것이다. 그래도 예외를 두지 않는다 — 이 앱은 오프라인에서 적은 것을 나중에 보내지 않기로 이미 정했고, 그 문을 경비에만 열면 준비도, 일정도 열어야 한다.
대신 나중에 적어도 되게 만든다. 금액만으로 저장되는 입력(§6.1)이 그 대비다.
리허설에서 놓친 건수를 센다. 5건이 넘으면 그때 다시 본다.
진행 중 여행이면 요약에 한 줄:
예산 80만 중 41.2만
예산을 안 정했으면 줄 자체를 숨긴다. 없는 데이터로 자리를 채우지 않는다.
| 안 만드는 것 | 이유 |
|---|---|
| 영수증 사진·자동 인식 | 1인용 앱에 값하지 않는다. (v2.3) 가계부의 첨부 기능도 함께 사라진다 |
| 더치페이·정산 | 1인용이다 |
| 도시별 예산 | §5.1 |
| 여행 전용 통계 화면 |
(v2.3) 카테고리 합계는 경비 화면의 그룹 합으로 충분하다. |
| 일정에 금액 붙이기 | 날짜만으로 「N일차 얼마」는 이미 나온다. 일정마다 금액을 고르게 하면 입력이 한 단계 늘고, 그만큼 안 적게 된다 |
| 예산 초과 알림 | 여행 중에 "돈 그만 써라"는 알림은 받고 싶지 않다 |
| 지금 환율로 과거 지출 재계산 | §4.3 |
| (v2.3) 자산·잔액·이체·청구서·정기 항목 | 여기에 가계부를 다시 짓지 않는다(§3) |
| (v2.3) 예정 자동 승격 스케줄러 | 지난 예정은 화면이 표시하고 사람이 확정한다. 가계부 제거로 앱의 주기 작업이 7개 → 3개가 되는데 여기서 하나를 도로 늘리지 않는다 |
| (v2.3) 사용자 정의 카테고리 | 만드는 순간 관리 화면·순서·삭제 시 재배정이 따라온다 |
출발 전날 밤에 이 화면 하나만 열면 되게 한다.
| 넣을 뻔한 곳 | 왜 아닌가 |
|---|---|
| 미배정 보관함 | 보관함은 **「가고 싶은 곳」**이다. 장소가 없는 「멀티어댑터」가 섞이면 도시별 그룹이 「도시 없음」으로 반쯤 찬다 |
| 일정 | 일정은 날짜·시각·순서·장소·이동·알림을 갖는다. 준비물은 그중 아무것도 없다. 억지로 넣으면 이동 표시와 도시 판정이 「양말 4켤레」에 걸린다 |
| 노트·메모 | 일상 워크스페이스다. 여행 준비하다 워크스페이스를 갈아타야 한다 |
준비는 따로 선다.
네 갈래다.
| 분류 | 하는 일 | 예 |
|---|---|---|
| 서류 | 챙기는 것 | 여권, 여행자보험 증서, 국제운전면허증 |
| 예약 | 끝내는 것 | 항공권 발권, 숙소 잔금, JR패스 교환권 |
| 짐 | 넣는 것 | 멀티어댑터, 상비약, 양말 4 |
| 할 일 | 하는 것 | 환전, 데이터 유심, 집 화분 물주기 |
「환전」을 위해 다섯 번째 분류를 만들지 않는다. 돈 관련을 따로 빼면 「해외카드 되는지 확인」이 서류인지 돈인지 매번 헷갈린다. 네 분류는 행동이 다르다. 애매하면 「할 일」이다.
한 항목이 갖는 것: 제목 · 체크 · 묶음 · 수량(짐만) · 기한 · 링크 · 메모.
11.1 분류 안의 묶음 (#1358, 2026-09-06 추가)
분류는 넷 그대로 두고, 그 안에 이름 붙인 묶음을 한 겹 둔다. 선택이다 — 안 쓰면 목록은 넣기 전과 똑같이 보인다.
쓰다 보니 짐이 스물을 넘겨 분류 하나가 한 화면에 안 들어왔다. 다섯 번째 분류로는 이걸 못 고친다 — 긴 것은 「짐 안쪽」이고, 나눌 축이 여행마다 다르기 때문이다(겨울/여름, 국내/해외, 캐리어/기내백). 축이 둘인데 하나만 있었던 것이다.
| 축 | 성격 | 형태 |
|---|---|---|
| 분류 | 행동이 다르다 — 챙긴다 / 끝낸다 / 넣는다 / 한다. 여행이 바뀌어도 안 변한다 | 고정 넷 (§11 그대로) |
| 묶음 | 이번 여행의 사정 — 캐리어 · 기내백 · 세면백, 출발 전 · 공항에서 · 현지에서 | 사용자가 적는 이름 |
- 이름 하나가 곧 묶음이다. 별도 테이블도, 순서 값도 만들지 않는다 — 묶음의 자리는 그 안의 첫 항목이 정하고, 마지막 항목이 나가면 묶음도 함께 사라진다
- 「묶음 없음」이 항상 맨 위다. 그리고 이름 붙은 묶음이 하나도 없는 분류는 소제목 자체를 그리지 않는다 — 안 나눈 사람에게 줄 하나가 늘어나면 그건 기능이 아니라 군더더기다
- 묶음을 옮기면 그 묶음의 맨 뒤로 간다. 분류를 옮길 때와 같은 규칙이다
- 분류를 옮겨도 묶음 이름은 따라간다. 수량과 다르다 — 수량은 짐 전용이라고 우리가 정의한 값이고, 묶음은 사용자가 적은 말이라 조용히 지우면 무엇을 적었는지가 어디에도 안 남는다
다섯 번째 분류는 여전히 만들지 않는다(D-31 유지 · D-41).
「10월 10일까지」가 아니라 **「출발 14일 전까지」**로 적는다.
여행 기간은 바뀐다. 출발일을 하루 당기는 순간, 날짜로 적어둔 「10월 10일 숙소 잔금」은 조용히 하루 늦은 기한이 된다. D−N으로 두면 알아서 따라 움직인다.
화면에는 D-14로 보이고, 지났으면 경고색이다.
여행 사이드바에 「준비」를 더한다.
┌───────────────────────────────────┐
│ ← 준비 D-49 │
├───────────────────────────────────┤
│ ▓▓▓▓▓▓▓▓▓▓▓▓░░░░ 18/24 │
│ 남은 6개 · 기한 지난 것 1개 ⚠ │
├───────────────────────────────────┤
│ 서류 (3/3) ▾ │
│ ───────────────────────────── │
│ 예약 (4/5) ▾ │
│ ☑ 항공권 발권 🔗 │
│ ☐ 숙소 잔금 결제 D-14 ⚠ │
│ ───────────────────────────── │
│ 짐 (9/12) ▾ │
│ ☐ 멀티어댑터 │
│ ☐ 양말 4 │
│ ───────────────────────────── │
│ 할 일 (2/4) ▾ │
│ │
│ + 추가하고 엔터… │
└───────────────────────────────────┘
진행률은 전체와 분류별 둘 다 보여준다. 「18/24」만 있으면 접힌 채로는 뭐가 남았는지 모른다.
기한 지난 항목은 맨 위에 개수로 상시 노출된다. 가계부의 미납 경고와 같은 태도다 — 눈에 거슬리는 게 목적이고, 「무시」 버튼을 두지 않는다. 체크하거나 기한을 옮겨야만 사라진다.
체크해도 자리를 옮기지 않는다. 취소선 + 흐리게. 짐 싸기는 목록을 위에서 아래로 훑는 작업이라 순서가 흔들리면 어디까지 했는지 잃는다. 다 끝난 뒤에 보기 싫으면 「완료 숨기기」를 켠다.
+는 하단에 붙박이 입력줄이다. 시트를 열고 닫지 않는다. 짐 목록은 스무 개를 연달아 치는 작업이고, 엔터로 계속 이어져야 한다. 분류는 방금 적은 분류를 이어받는다.
삭제는 누르는 즉시 된다(#1432). 일정과 같다. 예전의 5초 실행취소는 없앴다.
오프라인에서는 볼 수만 있다. 기내에서 목록을 확인하는 건 되고, 체크는 안 된다.
출발 전날 아침 9시, 남은 항목이 있을 때만.
내일 출발 · 준비 6개 남았어요
여행 중 아침 요약은 여행 기간에만 온다. 준비는 그 전에 끝나야 하는 일이라 거기 얹을 수 없다. 그래서 별개로 하나 둔다.
두 개 이상 만들지 않는다. D-7, D-3, D-1로 계속 오면 그때부터 알림을 무시하게 되고, 정작 필요한 여행 중 일정 알림까지 같이 무시된다.
| 안 만드는 것 | 이유 |
|---|---|
| 템플릿 · 지난 여행에서 가져오기 | 여행이 아직 한 번도 안 끝났다. 복사할 과거가 없다. 늘 빈 목록만 뜨는 버튼을 들고 다니게 된다. 두 번째 여행을 만들 때 넣는 게 싸다 |
| 자동 추천(날씨·목적지 기반) | 규칙을 만들 근거가 없다. 틀린 제안 몇 번이면 목록 전체를 안 믿게 된다 |
| 무게·수하물 규정 계산 | |
| 사진 첨부 | 여권 사진을 앱에 넣는 건 준비가 아니라 보안 문제다 |
| 동행자 공유 | v2.0에서 이미 제외했다 |
| 준비 항목 → 일정 변환 | 준비는 날짜가 없는 것이라고 §10에서 정의했다. 변환 버튼이 그 정의를 무효로 만든다 |
| 반복 준비물(매 여행 공통) | 템플릿과 같은 이유 |
| ① 준비 | 가계부와 무관하게 지금 시작할 수 있고, 출발 전에 값을 낸다. 늦게 만들면 이번 여행에 못 쓴다 |
| ② 경비 | 가계부 원장 위에 서는 기능이라 그쪽이 먼저 준비돼 있어야 했다 |
(v2.3) 이 순서의 근거는 사라졌다. 경비가 독립하면서 가계부를 기다릴 것이 없어졌다 — 이제 준비와 경비가 같은 모양이다(둘 다 여행 안에서 닫힌다). 다만 v2.2는 이 순서대로 이미 나갔다.
동결은 10/13이다. 그 뒤로는 고치기만 한다.
- 준비 알림
- 경비 — 도시별 합계
- 경비 — 하루 사용 가능액
- 준비 — 순서 바꾸기
- 준비 — 수량
- 홈·보드 요약 한 줄
- 경비 전체 → §18
절대 빼지 않는 것
- 준비: 네 분류 체크리스트 · 붙박이 입력줄 · 진행률 · 오프라인 조회
- 경비: 여행 연결 · 빠른 입력 · 날짜별 합계 · 예산 게이지
「여행 중에는 가계부에 그냥 적고, 돌아와서 기간으로 걸러 「여행에 붙이기」 한 번」이 비상 경로였다. 가계부도, attach/detach도 없어진다.
역설적으로 이 절의 걱정이 현실이 됐다. 「여행 안에 급히 장부를 만들지 않는다 — 나중에 두 장부를 합치는 일이 이번에 아끼는 2주보다 크다」고 적어 두었는데, 결국 장부를 여행 안에 만든다. 다만 합칠 두 번째 장부가 없다는 점이 다르다. 이관은 한 방향 복사 한 번으로 끝난다(Travel-Expense-Standalone §5.2).
10/24 여행에서 아래가 성립하면 성공이다.
경비
- 여행 중 쓴 돈을 이 앱에만 적었다
- 엔화로 적었는데 원화 합계가 카드 청구서와 3% 안에서 맞았다
-
월 예산이 여행 때문에 터지지 않았다— (v2.3) 폐기. 월 예산이 없다 -
가계부에서 본 합계와 여행에서 본 합계가 같았다— (v2.3) 폐기. 비교할 두 번째 숫자가 없다 -
카드값 납부가 여행 경비에 한 번도 안 들어갔다— (v2.3) 폐기. 이체 개념이 없다 - (v2.3) 지출을 적고·고치고·지우는 일이 여행 화면을 벗어나지 않았다
준비
- 출발 전날 이 화면만 보고 짐을 쌌다
- 빠뜨린 게 없었다
- 메모앱·「나에게 보내기」를 열지 않았다
- 기내에서(오프라인) 목록을 확인했다
- 기한 지난 항목이 눈에 걸려서 실제로 처리했다