Repository navigation
Travel Expense Standalone
2026-09-20 결정. 가계부가 없어지므로(Ledger-Removal) 여행 경비를 여행 전용 장부로 독립시킨다. 이 문서가 경비의 새 정본이다. Travel-Spec-v2-2 §4~§8의 경비 부분과 Travel-API-Spec §11을 대체한다. 뒤집는 결정: D-27 · D-28 · D-35 → D-43
v2.2는 「원장은 가계부 하나뿐이다」를 전제로 경비를 설계했다. 여행 경비 = ledger_transaction 중 trip_id가 이 여행인 행이고, 여행 화면은 그 위의 읽기 뷰 + 빠른 입력 통로였다(D-27).
그 전제가 사라진다. 원장이 없어지면 읽을 것이 없다.
세 갈래 중 「여행 전용 장부로 독립」을 골랐다. 경비를 함께 폐기하면 v2.2의 절반이 날아가고, 10/24 실사용을 앞둔 여행 모듈이 「얼마 들었나」에 답하지 못한다. 여행은 이 앱에서 실제로 쓰는 모듈이고, 경비는 그 안에서 값을 한다.
경비를 가계부에서 떼어 내되, 가계부였던 부분은 되살리지 않는다.
원장이 아니라 여행 하나의 지출 목록이 된다. 그래서 잔액·자산·복식부기·청구서·정기 항목은 아무것도 따라오지 않는다. 따라오면 가계부를 여행 안에 다시 짓는 것이다.
| 그대로 | |
|---|---|
| 「출발 전 / N일차 · 도시 / 다녀온 뒤」 그룹 | §4.1 · §4.4 그대로. occurred_on은 결제한 날 그대로 둔다(D-34) |
| 외화 — 엔으로 적고 원으로 센다 | 환율은 쓴 날의 값으로 굳는다. 조회 시 재계산하지 않는다(§4.3) |
| 예산 — 여행 단위 총액 하나 |
trip.budget_amount. null = 미설정이고 0과 다르다(D-28 유지) |
| 게이지 두 겹 | 확정은 진하게, 예정(숙소 잔금 등)은 연하게 |
| 금액만 적고 저장 | 미분류는 「정리할 내역 N건」으로 남는다 |
| 오프라인 — 볼 수는 있고 적을 수는 없다 | D-33 유지 |
| 도시별 예산·더치페이·여행 전용 통계 화면 | 여전히 만들지 않는다(§8) |
| 없어진다 | 왜 | |
|---|---|---|
기존 거래 붙이기·떼기 (/expenses/attach · /detach) |
붙일 원장이 없다. 경비는 이제 여행 화면에서 직접 만든다 | |
| 카드 대금 납부 구분 | 이체라는 개념이 없다. 여행 경비에는 지출만 있으므로 「카드값이 이중 계산된다」는 문제 자체가 성립하지 않는다 | |
TRANSFER·INCOME 필터링 |
위와 같은 이유로 불필요 | |
| 가계부 지출 상세로 이동 | 갈 곳이 없다 → 여행 안에 편집 시트를 둔다(D-35 뒤집음) | |
| 월 예산 화면의 「이 달 여행으로 41만」 한 줄 | 월 예산 화면이 없어진다 | |
| 가계부 통계의 「여행」 필터 | 같은 이유. 여행 합계는 경비 화면이 답한다 | |
| 영수증 첨부 | 가계부 기능이었다. 여행 경비에 만들지 않는다 |
가계부가 테이블로 갖고 있던 것을 그대로 옮기면 모듈을 하나 더 만드는 꼴이다. 셋 다 테이블을 새로 만들지 않는다.
ledger_category를 옮기지 않는다. FOOD(식비) · TRANSPORT(교통) · STAY(숙소) · SIGHT(관광·입장) · SHOPPING(쇼핑) · ETC(기타) 로 고정하고 일곱 번째를 만들지 않는다.
- 근거는 D-31과 같다. 준비 분류를 넷으로 고정한 이유 — 분류가 늘면 「어디에 적을지 고민하는 시간」이 늘고, 그만큼 안 적게 된다. 여행 지출은 종류가 실제로 좁다
- NULL을 허용한다. 금액만 적고 저장하는 길(§6.1)이 이 기능의 핵심이라, 카테고리는 끝까지 선택 사항이다
- 사용자 정의 카테고리를 만들지 않는다. 만드는 순간 관리 화면·순서·삭제 시 재배정이 따라온다
ledger_asset을 옮기지 않는다. payment_method VARCHAR(40) NULL 한 칸이다.
- 잔액을 볼 원장이 사라졌다. 자산이 실체를 가질 이유가 그것뿐이었다. 남은 것은 「어디서 냈더라」를 나중에 읽는 일이고, 그건 라벨로 충분하다
- 기본값은 직전에 쓴 것이고 FE가 기억한다(
lastAsset.ts가 이미 그렇게 동작한다). 서버가 「직전」을 추측하지 않는다 - 자동완성은 그 여행에서 이미 쓴 값에서만 고른다. 전역 목록을 만들면 그게 자산 테이블이다
status는 CONFIRMED · SCHEDULED 둘뿐이다. 게이지 2층이 이 값이다.
-
새 스케줄러를 만들지 않는다. 가계부의
ScheduledPromotionScheduler(예약 → 확정 자동 승격)를 옮겨 오지 않는다. 이 앱의 주기 작업은 가계부 제거로 7개에서 3개가 되는데, 여기서 하나를 도로 늘리는 것은 방향이 반대다 - 대신 날짜가 지난 예정은 조회가 표시한다. 화면이 「확정하세요」를 걸고 사람이 누른다 — Ledger-Archive D-17이 대출 상환에 대해 정한 것과 같은 모양이고, 여기서도 실제 결제 여부를 앱이 알 수 없다
- 미확정 예정은 사라지지 않는다. 예산 게이지 2층에 계속 남는다(Ledger-Archive §3-5의 「미납은 삭제가 아니다」와 같은 정신)
가계부의 「원장은 지우지 않고 상쇄한다」는 원장이라서 있던 규칙이다. 여행 경비는 원장이 아니다.
- 잘못 적었으면 고치거나 지운다. 환불 거래를 반대 방향으로 만들지 않는다
-
deleted_at으로 소프트 삭제하되 되돌리기는 화면 토스트에서 즉시만 연다. 휴지통 화면을 만들지 않는다 -
이 변경으로 없던 답이 하나 생긴다. 기존 경비 화면은
INCOME을 조회에서 뺐기 때문에 환불이 보이지 않았다(총액은 줄었는데 목록에는 이유가 없었다). 이제 취소된 지출은 그 자리에서 지워지므로 목록과 합계가 같은 이야기를 한다
trip_expense
├── id BIGINT PK
├── trip_id BIGINT NOT NULL → trip(id) ON DELETE CASCADE
├── member_id BIGINT NOT NULL
├── occurred_on DATE NOT NULL -- 결제한 날. 여행 기간으로 옮기지 않는다(D-34)
├── title VARCHAR(100) NULL -- 금액만 적고 저장하는 길이 있다
├── amount BIGINT NOT NULL -- 원 단위. 집계는 전부 이 값만 읽는다
├── category VARCHAR(20) NULL -- FOOD·TRANSPORT·STAY·SIGHT·SHOPPING·ETC
├── payment_method VARCHAR(40) NULL
├── status VARCHAR(20) NOT NULL DEFAULT 'CONFIRMED'
├── fx_currency VARCHAR(3) NULL
├── fx_amount DECIMAL(18,2) NULL
├── fx_rate DECIMAL(18,6) NULL -- 쓴 날의 값으로 굳는다
├── created_at / updated_at / deleted_at
└── INDEX (trip_id, occurred_on)
ON DELETE CASCADE다. ledger_transaction.trip_id는 SET NULL이었다 — 「여행을 지워도 쓴 돈은 원장에 남는다」가 그 이유였고, 남을 원장이 없어졌다. 준비 항목(trip_prep_item)과 같은 취급이 된다: 그 여행이 없으면 아무 뜻도 없다.
금액은 **원 단위
BIGINT**다(가계부에서 가져오는 규칙 하나). 외화만DECIMAL.
ledger_transaction → trip_expense. Liquibase SQL 체인지셋으로 한다 — 손으로 INSERT 하면 로컬·테스트·운영이 갈라진다.
대상: trip_id IS NOT NULL AND type = 'EXPENSE' AND deleted_at IS NULL
| 옮기는 값 | 어디서 |
|---|---|
occurred_on · title · amount · status · fx_*
|
같은 이름 그대로 |
payment_method |
ledger_asset.name을 문자열로 복사
|
category |
아래 매핑, 애매하면 NULL |
카테고리 매핑은 자동으로 다 하려 들지 않는다. 가계부 카테고리는 사용자가 늘린 것이라 여섯 프리셋에 딱 떨어지지 않는다. 이름이 확실한 것만 옮기고 나머지는 NULL로 두면 화면이 「정리할 내역 N건」으로 잡아 준다 — 이미 있는 길이다. 「자동 병합하지 않는다」(Ledger-Archive §3)와 같은 판단이다.
검증: 이관 전후로 각 여행의 확정 지출 합계가 같아야 한다. 다르면 배포를 멈춘다.
이관은 복사다.
ledger_transaction의 원본을 지우지 않는다. 원본은 3단계에서 테이블째 사라진다 — 그 사이에 두 벌이 공존하지만, 경비 화면은 이미trip_expense만 읽는다.
모두 /api/travel/trips/{tripId} 아래다. 여행 BE가 소유한다 — FE가 다른 도메인 API로 직접 쓰러 가는 구조(v2.2의 빠른 입력)는 여기서 끝난다.
응답 모양은 v2.2 §11과 거의 같다. 그룹 규칙(BEFORE / DAY-N / AFTER), 빈 날짜 sum: 0, budget이 없으면 통째로 null, dailyAllowance는 0 아래로 내려가지 않음, budget.dailyAllowance와 totals.dailyAverage가 동시에 차지 않음 — 전부 유지한다.
바뀌는 것은 셋이다.
| 바뀜 | 내용 |
|---|---|
rows[].transactionId → rows[].expenseId
|
가리키는 것이 달라졌다 |
rows[]에 category · paymentMethod 추가
|
편집 시트를 여행 안에서 열므로 편집용 값이 필요하다. v2.2가 「편집용 필드를 싣지 않는다」고 한 이유(편집 화면이 가계부에 있었다)가 사라졌다 |
rows[].overdue |
status = 'SCHEDULED'인데 occurred_on이 지났다. 화면이 「확정하세요」를 건다(§4.3) |
POST { "occurredOn": "2026-10-27", "amount": null, "title": null,
"category": null, "paymentMethod": "국민 체크", "status": "CONFIRMED",
"fx": { "currency": "JPY", "amount": 1200.00, "rate": null } }-
amount또는fx중 하나는 있어야 한다. 둘 다 없으면 400 -
fx.rate가null이면 서버가ExchangeRateService(ECB 고시)로 채우고 그 값을 고정한다. 못 가져오면 에러로 만들지 않고 직접 입력을 받는다 — 환율 때문에 기록을 막지 않는다 -
title·category는 없어도 저장된다(§6.1) - PATCH는 부분 수정이다. 빠른 입력 시트를 편집에도 그대로 쓴다
- DELETE는 소프트 삭제. 되돌리기는 토스트에서만
그대로다. { "amount": 800000 } · { "amount": null }(해제). amount <= 0은 400(TRAVEL-ERR-024).
POST /expenses/attach · POST /expenses/detach — 삭제한다.
| 상황 | HTTP | 코드 |
|---|---|---|
| 경비 없음 · 남의 여행 경비 | 404 | TRAVEL-ERR-026 |
amount·fx 둘 다 없음 |
400 | TRAVEL-ERR-027 |
amount <= 0 또는 fx.amount <= 0
|
400 | TRAVEL-ERR-027 |
| 고시표에 없는 통화 | 400 | TRAVEL-ERR-028 |
| ECB에 못 닿음 | 200 | 에러가 아니다. rate: null로 내리고 화면이 직접 입력 칸을 연다 |
Travel-UI-Design §10의 경비 레이아웃은 그대로다. 게이지 두 겹, 날짜 그룹 접힘(기본 오늘만 펼침), 「아직 적은 게 없어요」, 빠른 입력 FAB.
바뀌는 것은 넷.
- 지출 행을 누르면 여행 안에서 편집 시트가 열린다. 가계부로 넘어가지 않는다. 시트는 빠른 입력과 같은 컴포넌트다 — 필드가 하나 늘 때 고칠 자리가 하나다
- 카테고리 칩이 여섯 개 고정이다. 서버에서 목록을 받아오지 않는다
- 결제수단은 입력 + 자동완성이다. 자동완성 후보는 그 여행에서 이미 쓴 값
-
지난 예정에 「확정」 버튼이 붙는다. 누르면
status가CONFIRMED가 된다
사이드바의 「경비」 항목, 홈 요약의 「예산 80만 중 41.2만」 한 줄은 그대로다.
| 이유 | |
|---|---|
| 도시별 예산 | §5.1 그대로 |
| 더치페이·정산 | 1인용이다 |
| 여행 전용 통계 화면 | 카테고리 합계는 경비 화면의 그룹 합으로 충분하다. 도넛·추이를 그리려고 화면을 하나 더 만들지 않는다 |
| 일정에 금액 붙이기 | 날짜만으로 「N일차 얼마」는 이미 나온다 |
| 예산 초과 알림 | 여행 중에 "돈 그만 써라"는 알림은 받고 싶지 않다 |
| 영수증 첨부 | §3 |
| 오프라인 입력 큐 | D-33. 놓친 건수가 5건을 넘으면 그때 다시 본다 |
| 자산·잔액·이체·청구서·정기 항목 | 여기에 가계부를 다시 짓지 않는다(§2) |
- 여행 경비 화면이 가계부 코드를 한 줄도 import 하지 않는다
- 이관 전후로 각 여행의 확정 지출 합계가 같다
- 가계부 없이 지출을 적고·고치고·지울 수 있다
- 외화 지출의 환율이 저장 시점 값으로 굳어 있다(다음 날 총액이 바뀌지 않는다)
- 여행을 지우면 그 여행의 경비도 함께 사라진다(CASCADE)
- 새 스케줄러가 늘지 않았다
- Ledger-Removal — 이 변경이 0단계다
- Ledger-Archive — 가계부가 무엇이었나
- Travel-Open-Items D-43 — D-27·D-28·D-35를 정리하는 결정
- Travel-Spec-v2-2 · Travel-API-Spec · Travel-UI-Design