Repository navigation
Travel Data Model
확정 명세 v2.2 · v2.1 · v2.0 · 유스케이스 · 아키텍처 · API 설계
v2.2에서 여행이 갖는 새 테이블은
trip_prep_item하나였다. 경비는 테이블을 만들지 않고ledger_transaction.trip_id로 연결만 했다 → §2.11v2.3(2026-09-20)에서 뒤집혔다. 가계부 제거로 경비가 **
trip_expense**를 갖는다 → §2.12 · D-43 · Travel-Expense-Standalonev2.1(다구간)로 스키마가 바뀐다.
trip에서 목적지 6개 컬럼이 빠지고trip_day·trip_stay가 생긴다 → §2.8 · §2.9 · §4 마이그레이션. 아래trip·travel_place표에 v2.1 표시를 달아 두었다.Liquibase:
047-create-travel-tables.yaml(1·2단계) ·048·049(3단계 푸시) ·050-create-trip-activity-log.yaml(4단계) ·064·065(v2.2). 컨벤션 — 불리언은BIT(1)(Hibernatevalidate호환), 절대시각은 엔티티Instant/ DBDATETIME(6), 단일 사용자지만 최상위 엔티티에member_id스코프를 둔다(Note·Moment관례).컬럼명은 MySQL 8.4 예약어를 피한다. 예약어를 쓰면 Liquibase가 만드는 DDL과 Hibernate가 만드는 SQL이 문법 오류로 깨진다(
manual→manual_entry로 교체한 이유).
trip 1 ──< trip_activity ──? travel_place (activity.place_id, NULL 허용)
│ │
│ 1 ──? trip_activity_log 1 ──< trip_activity_photo
│
├──< trip_day ── travel_place (v2.1) day.base_place_id, NOT NULL — 날짜의 기준 도시
├──< trip_stay ──? travel_place (v2.1) stay.place_id, NULL 허용
├──< trip_prep_item (v2.2) 준비 항목. 장소도 날짜도 갖지 않는다
│
├──< trip_expense (v2.3) 여행 경비. 지출만 갖는다 — 잔액도 이체도 없다
│
└──< push_notification >── push_subscription (발송 시점 조인, FK 아님)
trip.destination_place_id ──? travel_place (목적지 도시) — v2.1에서 삭제
travel_move ── travel_place ×2 (#1208) from/to, 멤버+장소 쌍이 유니크
travel_place 는 trip 에 종속되지 않는다 — 멤버 단위로 재사용(같은 장소를 두 번 저장하지 않는다)
구간(Leg)은 테이블이 아니다 — 연속된 같은 base_place_id 날짜를 묶어 파생한다
| 테이블 | 역할 |
|---|---|
trip |
여행 1건. 상태(예정/진행 중/완료)는 저장하지 않고 파생 |
trip_day |
(v2.1) 여행 기간의 날짜 1건. 기준 도시를 갖는다. 기간 내 모든 날짜에 반드시 존재 |
trip_stay |
(v2.1) 숙소 1건. 기준 도시와 무관하게 체크인~체크아웃 날짜에 붙는다 |
trip_prep_item |
(v2.2) 준비 항목 1건. 네 분류 · 체크 · D−N 기한. 날짜도 장소도 갖지 않는다 |
trip_activity |
일정 1건. activity_date IS NULL = 미배정 보관함
|
travel_place |
장소 캐시. 여행을 넘어 멤버 단위로 재사용 |
travel_move |
(#1208) 두 장소 사이 이동 — 수단·소요시간·편명·예매 링크. 여행을 넘어 재사용 |
trip_activity_log |
일정당 최대 1건의 사후 기록(평점·메모) |
trip_activity_photo |
기록 사진 0~10장 (MinIO key) |
push_subscription |
브라우저 푸시 구독. 여행 전용 아님 — 공용 |
push_notification |
예약된 알림 1건. 발송 스케줄러가 폴링 |
trip_expense |
(v2.3) 여행 지출 1건. 원 단위 금액 + 외화 근거 + 고정 카테고리. 원장이 아니다 — 잔액·이체·청구서가 없다 |
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| member_id | BIGINT | NOT NULL | 소유 멤버(스코프) |
| title | VARCHAR(50) | NOT NULL | 최대 50자(§2.1). |
| VARCHAR(100) | v2.1 삭제 — 날짜로 내려감 | ||
| BIGINT | v2.1 삭제 | ||
| start_date | DATE | NOT NULL | |
| end_date | DATE | NOT NULL |
>= start_date (애플리케이션 검증) |
| VARCHAR(64) |
v2.1 삭제 → trip_day.base_place_id의 타임존 |
||
| CHAR(3) | v2.1 삭제 → 기준 도시의 통화 | ||
|
|
DECIMAL(10,7) | v2.1 삭제 → 날짜별 기준 도시 좌표로 날씨 조회 | |
| default_notify_minutes | INT | NOT NULL, DEFAULT 15 | 여행 단위 기본 알림 시점(§1.2) |
| morning_summary_enabled | BIT(1) | NOT NULL, DEFAULT b'0' | 아침 요약 알림(§4.3) |
| budget_amount | BIGINT | NULL | (v2.2) 여행 단위 예산 총액(원). NULL = 예산 미설정 — 0과 다르다(v2.2 §5.3: 안 정했으면 줄을 숨긴다). 카테고리·도시로 쪼개지 않는다 |
| created_at / updated_at | DATETIME(6) | NOT NULL | JPA Auditing |
인덱스
-
idx_trip_member_start (member_id, start_date)— 예정·진행 중 정렬(시작일 오름차순) -
idx_trip_member_end (member_id, end_date DESC)— 완료 정렬(종료일 내림차순)
상태 컬럼을 두지 않는다.
LocalDate.now(ZoneId.of(timezone))와 기간을 비교해 매 조회 시 파생한다(§2.1). 저장하면 날짜가 넘어갈 때 갱신할 주체가 없어 반드시 어긋난다.v2.1: 판정에 쓰는 타임존이
trip.timezone→ 오늘에 해당하는trip_day의 기준 도시 타임존으로 바뀐다. 기간 밖이면 첫날(예정) / 마지막 날(완료)의 타임존. 상태를 저장하지 않는다는 원칙은 그대로다.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| trip_id | BIGINT | FK→trip(id), NOT NULL, ON DELETE CASCADE | |
| title | VARCHAR(100) | NOT NULL | 최대 100자(§2.2) |
| activity_date | DATE | NULL | NULL = 미배정 보관함. 여행 기간 내 날짜만 허용 |
| sort_order | INT | NOT NULL | 같은 날짜(또는 보관함) 내 정렬 |
| start_time | TIME | NULL | 여행 타임존 벽시계 시각. UTC 변환하지 않는다(§4.1) |
| place_id | BIGINT | FK→travel_place(id), NULL, ON DELETE SET NULL | |
| memo | VARCHAR(1000) | NULL | 최대 1000자 |
| url | VARCHAR(500) | NULL | 예약 페이지 링크 1개 |
| notify_enabled | BIT(1) | NOT NULL, DEFAULT b'0' | 일정 알림 |
| notify_minutes | INT | NULL | NULL이면 trip.default_notify_minutes 사용 |
| departure_notify_enabled | BIT(1) | NOT NULL, DEFAULT b'0' | 출발 알림 |
| created_at / updated_at | DATETIME(6) | NOT NULL |
인덱스
-
idx_activity_trip_date_order (trip_id, activity_date, sort_order)— 보드 조회의 유일한 접근 경로
정렬 규칙
-
sort_order가 유일한 정렬 기준이다. 시각으로 정렬하지 않는다 — 시각 없는 일정이 허용되고(§1.1), 사용자가 드래그로 정한 순서가 시각보다 우선한다. - 순서 변경은 해당 날짜의 행 전체를 0..n-1로 재부여한다. 하루 일정이 10건 남짓이라 gap/fractional index는 과설계다(데이터 그리드 #778과 상황이 다르다).
- 날짜 이동 =
activity_date변경 + 양쪽 날짜 재인덱싱. 한 트랜잭션으로 처리한다.
알림 유효성은 DB 제약이 아니라 애플리케이션에서 판정한다.
start_time IS NULL이면notify_enabled가 켜져 있어도 알림을 만들지 않는다(§1.2). 출발 알림은 추가로 "직전 장소 있는 일정"이 있어야 유효하다.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| member_id | BIGINT | NOT NULL | |
| google_place_id | VARCHAR(255) | NULL | 구글 장소 식별자. 직접 입력이면 NULL |
| name | VARCHAR(200) | NOT NULL | |
| address | VARCHAR(500) | NULL | |
| lat | DECIMAL(10,7) | NULL | |
| lng | DECIMAL(10,7) | NULL | |
| category | VARCHAR(100) | NULL | |
| phone | VARCHAR(50) | NULL | 장소 상세용 |
| rating | DECIMAL(2,1) | NULL | 구글 평점(§S-06 결과 카드) |
| opening_hours | JSON | NULL | 캐시. 30일 만료 |
|
|
삭제됨 — 장소 사진 미도입(D-16). Liquibase 052, #1117 |
||
| city_name | VARCHAR(100) | NULL | (v2.1) 이 장소가 속한 도시 표시명 |
| city_place_ref | VARCHAR(255) | NULL | (v2.1) 도시 식별자(구글 장소 id). 도시 일치 판정은 이 값으로만 한다 |
| country_code | CHAR(2) | NULL | (v2.1) ISO 3166-1 alpha-2. 통화·번역 목적 언어 파생 |
| timezone | VARCHAR(64) | NULL | (v2.1) IANA ID. 기준 도시로 쓰일 때 필수 |
| currency | CHAR(3) | NULL | (v2.1) ISO 4217 |
| place_kind | VARCHAR(20) | NOT NULL, DEFAULT POI
|
(v2.1) CITY · POI. CITY만 기준 도시로 지정할 수 있다
|
| details_refreshed_at | DATETIME(6) | NULL | 영업시간 갱신 시각. +30일이 지나면 재조회(§4.7) |
| manual_entry | BIT(1) | NOT NULL, DEFAULT b'0' | 직접 입력 여부(§2.3). manual은 MySQL 8.4 예약어라 쓸 수 없다 |
| created_at / updated_at | DATETIME(6) | NOT NULL |
인덱스
-
uk_place_member_google (member_id, google_place_id)— UNIQUE. 같은 장소를 두 번 저장하지 않는다(NULL은 중복 허용 = 직접 입력 다건 OK) -
idx_place_member_name (member_id, name)— 최근/이름 조회
여행에 종속시키지 않는다. 같은 장소를 일정마다 새 행으로 만들면 영업시간·좌표 캐시가 장소 수만큼 중복되고, 한 행만 갱신돼 나머지가 옛 값으로 남는다.
uk_place_member_google이 멤버당 한 행을 강제한다.(원래 근거는
⭐ 좋았던 곳배지의 여행 간 장소 동일성 요구였는데, 그 기능은 미도입으로 정리됐다 — D-18. 재사용 자체의 이유는 위와 같이 그대로 남는다.)
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| activity_id | BIGINT | FK→trip_activity(id), NOT NULL, UNIQUE, ON DELETE CASCADE | 일정당 최대 1개(§2.4) |
| memo | VARCHAR(2000) | NULL | 최대 2000자. 공백만 남으면 NULL로 저장한다 |
| rating | TINYINT | NULL | 1~5. 별 해제가 가능해야 해서 NULL을 허용한다 |
| created_at / updated_at | DATETIME(6) | NOT NULL |
사진과 분리된 테이블이라는 점이 중요하다. 사진 업로드가 실패해도 평점·메모는 독립적으로 저장된다(§5.1 단계 4 위험 대응).
rating이TINYINT라 엔티티 필드를Integer로 두면 Hibernate가INTEGER를 기대해ddl-auto: validate가 컨텍스트를 통째로 못 띄운다.@JdbcTypeCode(SqlTypes.TINYINT)로 매핑을 맞춘다 —Byte로 바꾸면 호출부마다 캐스팅이 번진다. (BIT(1)불리언과 같은 부류의 함정이다.)
평점·메모가 둘 다 비면 행을 지운다. 빈 행을 남기면
hasLog가 계속 참이라 목록에 기록 표시가 남는데, 사용자가 보기엔 다 지운 상태다.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| log_id | BIGINT | FK→trip_activity_log(id), NOT NULL, ON DELETE CASCADE | |
| object_key | VARCHAR(512) | NOT NULL | MinIO 원본 (travel/activities/{activityId}/{uuid}.jpg) |
| thumb_key | VARCHAR(512) | NULL | 썸네일 |
| width / height | INT | NULL | 원본 px |
| sort_order | INT | NOT NULL, DEFAULT 0 | 업로드 순서(§2.5) |
| created_at | DATETIME(6) | NOT NULL |
인덱스: idx_photo_log (log_id, sort_order)
- 최대 10장·15MB 제한은 애플리케이션 검증(§2.5).
- EXIF는 FE canvas 재인코딩으로 이미 제거된 상태로 올라온다. 위치정보 컬럼을 두지 않는다(§1.6 — 사진 위치정보 활용 없음).
-
원본도 재인코딩한다. 파일을 그대로 올리면 촬영 위치가 따라간다. 재인코딩 결과가 JPEG이라 업로드 URL 발급은
image/jpeg만 받는다. - 단 orientation은 버리기 전에 적용한다(
createImageBitmap(file, { imageOrientation: "from-image" })). 회전 플래그만 떨구면 아이폰 세로 사진이 눕는다 — 정보를 지우는 것과 그림을 망치는 것은 다르다. -
width/height는 재인코딩 후 크기다(원본은 긴 변 2560px로 축소). DB 값과 실제 오브젝트가 어긋나면 안 된다.
-
원본도 재인코딩한다. 파일을 그대로 올리면 촬영 위치가 따라간다. 재인코딩 결과가 JPEG이라 업로드 URL 발급은
-
object_key만 저장하고 공개 URL은img.orino.dev+ key로 조립한다(호스트 하드코딩 회피). 응답에는 key가 아니라 URL을 담는다 — 조립 규칙이 화면마다 흩어지면 환경이 바뀔 때 한 곳만 고쳐도 나머지가 깨진다. - key prefix는 원본
travel/activities/{activityId}/, 썸네일travel/thumbs/{activityId}/. MinIO·버킷·자격증명은 노트/일상기록 이미지와 공유하고 prefix만 가른다. -
thumb_key는 NULL을 허용한다 — 썸네일만 실패할 수 있다. 그때는 화면이 원본을 줄여 쓴다. - 사진은 일정이 아니라 기록에 매달린다. 평점·메모 없이 사진만 올리면 빈 기록을 만들어 붙이고, 반대로 평점·메모를 다 지워도 사진이 남아 있으면 기록 행을 지우지 않는다(지우면 CASCADE로 사진까지 날아간다).
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| member_id | BIGINT | NOT NULL | |
| endpoint | VARCHAR(1000) | NOT NULL | 푸시 서비스 엔드포인트 |
| endpoint_hash | CHAR(64) | NOT NULL, UNIQUE |
SHA-256(endpoint) — endpoint가 길어 직접 인덱싱 불가 |
| p256dh | VARCHAR(255) | NOT NULL | 구독 공개키 |
| auth | VARCHAR(255) | NOT NULL | 인증 시크릿 |
| user_agent | VARCHAR(255) | NULL | 기기 식별용(디버깅) |
| last_success_at | DATETIME(6) | NULL | |
| failure_count | INT | NOT NULL, DEFAULT 0 | |
| created_at | DATETIME(6) | NOT NULL |
- 발송 시
410 Gone/404를 받으면 행을 삭제한다(브라우저가 구독을 폐기한 것). - 여행 전용이 아니다. 복습 알림 등에 나중에 재사용할 수 있도록
push도메인에 둔다.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| member_id | BIGINT | NOT NULL | |
| trip_id | BIGINT | FK→trip(id), NOT NULL, ON DELETE CASCADE | |
| activity_id | BIGINT | FK→trip_activity(id), NULL, ON DELETE CASCADE | 아침 요약·준비 알림은 NULL |
| type | VARCHAR(20) | NOT NULL |
ACTIVITY · DEPARTURE · MORNING_SUMMARY · PREP_REMINDER(v2.2)
|
| target_date | DATE | NULL | 아침 요약이 가리키는 날짜 |
| scheduled_at | DATETIME(6) | NOT NULL |
UTC 절대시각. 벽시계 시각을 trip.timezonetrip_day의 기준 도시 타임존으로 환산한 결과. 아침 요약은 도시가 바뀌는 날이면 전날 날짜의 타임존을 쓴다 |
| status | VARCHAR(20) | NOT NULL |
PENDING · SENT · FAILED · CANCELED
|
| sent_at | DATETIME(6) | NULL | |
| fail_reason | VARCHAR(255) | NULL | |
| created_at | DATETIME(6) | NOT NULL |
인덱스
-
idx_notification_due (status, scheduled_at)— 스케줄러 폴링(PENDING AND scheduled_at <= now) -
idx_notification_activity (activity_id, status)— 재계산 시 PENDING 일괄 취소
payload(제목·본문)를 저장하지 않는다. 발송 시점에
trip_activity를 조인해 조립한다. §4.2 재계산 트리거에 "제목 변경"이 없으므로, 저장해두면 제목만 고친 일정이 옛 제목으로 알림된다. 재계산은 삭제가 아니라CANCELED전이 + 신규 INSERT로 한다. 알림이 왜 그 시각에 갔는지(혹은 안 갔는지)를 나중에 추적할 수 있어야 한다.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| trip_id | BIGINT | FK→trip(id), NOT NULL, ON DELETE CASCADE | |
| day_date | DATE | NOT NULL | 여행 기간 내. date는 MySQL 함수명과 혼동되므로 쓰지 않는다
|
| base_place_id | BIGINT | FK→travel_place(id), NOT NULL |
기준 도시. place_kind = CITY인 행만 허용(애플리케이션 검증) |
| city_memo | VARCHAR(200) | NULL | "체크아웃 후 교토역 코인로커에 짐 보관" |
| created_at / updated_at | DATETIME(6) | NOT NULL |
인덱스
-
uk_day_trip_date (trip_id, day_date)— UNIQUE. 하루에 기준 도시는 하나다 - 보드 조회는
trip_id로 전 기간을 한 번에 읽는다(최대 30행 남짓이라 추가 인덱스 불필요)
기간 내 모든 날짜에 행이 반드시 존재한다. 비어 있는 날짜를 허용하면 타임존이 없는 날이 생기고, 그 순간 알림·날씨·상태 판정이 전부 NPE 아니면 조용한 오답이 된다. 여행 생성·기간 변경 트랜잭션에서 날짜 집합을 항상 기간과 일치시킨다.
- 기간을 늘리면 새 날짜는 직전(마지막) 날짜의
base_place_id를 상속한다- 기간을 줄이면 잘린 날짜 행을 지우고, 그 날짜의 일정을
activity_date = NULL(보관함)로 옮긴다구간(Leg) 테이블을 만들지 않는다. 연속된 같은
base_place_id를 묶어 파생한다. 구간을 저장하면 날짜와 구간이 어긋날 수 있는 상태가 두 개 생긴다.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| trip_id | BIGINT | FK→trip(id), NOT NULL, ON DELETE CASCADE | |
| name | VARCHAR(100) | NOT NULL | |
| place_id | BIGINT | FK→travel_place(id), NULL, ON DELETE SET NULL | 좌표·도시 판정에 쓴다 |
| check_in_date | DATE | NOT NULL | |
| check_out_date | DATE | NOT NULL |
> check_in_date (애플리케이션 검증) |
| check_in_time | TIME | NULL | 벽시계 시각 |
| check_out_time | TIME | NULL | 벽시계 시각 |
| booking_url | VARCHAR(500) | NULL | |
| memo | VARCHAR(500) | NULL | |
| created_at / updated_at | DATETIME(6) | NOT NULL |
인덱스: idx_stay_trip_checkin (trip_id, check_in_date)
판정 규칙 — DB가 아니라 애플리케이션에서 한다.
stayTonight(day) = check_in_date <= day < check_out_date 오늘 밤 자는 곳
stayCheckout(day) = check_out_date == day 오늘 체크아웃하는 곳
-
기간이 겹치는 숙소는 저장할 수 없다 —
[in, out)반열린 구간 겹침을 저장 전 검증한다. 겹치면 400으로 막고 기존 숙소 기간을 먼저 줄이도록 안내한다. - 체크아웃일은 겹침이 아니다.
10.24–10.27다음에10.27–10.29는 정상이다(이동일). - 기준 도시와 무관하다. 닛코 당일치기 날의 기준 도시는 닛코지만 자는 곳은 도쿄일 수 있다.
- 여행 기간을 줄이면 걸쳐 있던 숙소의
check_out_date를 새 종료일로 당긴다. 그 결과in >= out이 되면 숙소를 삭제한다.
두 장소 사이를 어떻게 이동하는가. 사용자가 직접 적는다 — 앱이 계산하지 않는다.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| member_id | BIGINT | NOT NULL | 장소가 이미 멤버별이지만 유니크 키를 멤버로 닫기 위해 둔다 |
| from_place_id | BIGINT | FK→travel_place(id), NOT NULL, ON DELETE CASCADE | |
| to_place_id | BIGINT | FK→travel_place(id), NOT NULL, ON DELETE CASCADE | 장소가 지워지면 그 장소를 잇던 이동도 의미가 없다 |
| mode | VARCHAR(20) | NOT NULL |
WALK BIKE BUS CAR SUBWAY TRAIN FLIGHT FERRY OTHER
|
| name | VARCHAR(100) | NULL | 실제로 타는 것 — 나리타 익스프레스 3호 · 피치 MM8
|
| duration_minutes | INT | NULL | NULL 허용 — 수단을 먼저 정하고 시간은 나중에 확인하는 것이 실제 순서다 |
| url | VARCHAR(500) | NULL | 예매·확인 링크 |
| memo | VARCHAR(500) | NULL | 좌석·플랫폼·예약번호 |
| created_at / updated_at | DATETIME(6) | NOT NULL |
유니크: uk_move_member_places (member_id, from_place_id, to_place_id)
- 여행이 아니라 장소 쌍에 붙는다. 일정 쌍에 붙이면 드래그로 순서를 바꾸는 순간 값이 거짓이 되거나 사라진다. 장소 쌍이면 순서를 바꿔도 살아 있고, 같은 두 장소를 다시 이으면 다른 날·다른 여행에서도 그대로 뜬다.
- 방향을 유지한다. A→B와 B→A는 다른 행이다 — 편도 항공과 일방통행이 실제로 다르고, 돌아오는 길이 같으리라고 앱이 단정할 근거가 없다.
-
mode에 나라 고유명을 넣지 않는다.신칸센을 값으로 박으면 일본 밖에서 쓸 수 없고, 다음엔TGV·KTX요청이 이어진다. 분류는 범용으로 두고 구체적인 이름은name으로 내린다.OTHER가 있어 케이블카·툭툭도 적을 자리가 있다. - 숙소로 가는 이동도 같은 테이블이다 — 도착지가 숙소의
place_id일 뿐이다.
출발까지 챙길 것 하나. 네 분류 안에서만 산다 — 다섯 번째 분류를 만들지 않는다(v2.2 §11).
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| id | BIGINT | PK, AI | |
| trip_id | BIGINT | FK→trip(id), NOT NULL, ON DELETE CASCADE | 여행에 종속된다. 여행을 지우면 준비 목록도 사라진다 |
| member_id | BIGINT | NOT NULL | 다른 최상위 엔티티와 같은 스코프 관례 |
| category | VARCHAR(20) | NOT NULL |
DOCUMENT · BOOKING · BAG · TODO — 애매하면 TODO
|
| title | VARCHAR(100) | NOT NULL | |
| done | BIT(1) | NOT NULL, DEFAULT b'0' | 체크 여부. 정렬에 관여하지 않는다(§13: 체크해도 자리를 옮기지 않는다) |
| section_label | VARCHAR(30) | NULL | (v2.2 · #1358) 분류 안의 묶음 이름(「캐리어」·「기내백」). NULL이면 묶음 없음 |
| quantity | INT | NULL |
BAG에서만 쓴다. 다른 분류에 값이 있으면 저장 시 NULL로 떨군다 |
| due_days_before | INT | NULL | 출발 D−N. 절대 날짜를 저장하지 않는다(§12) |
| url | VARCHAR(500) | NULL | 예약 확인 링크 |
| memo | VARCHAR(500) | NULL | |
| display_order | INT | NOT NULL | 분류 안에서의 순서. 새 항목은 그 분류의 맨 뒤 |
| created_at / updated_at | DATETIME(6) | NOT NULL | JPA Auditing |
인덱스: idx_prep_trip_category_order (trip_id, category, display_order) — 화면이 분류별로 읽는 유일한 경로다.
기한을
DATE로 저장하지 않는다. 출발일을 하루 당기는 순간 「10월 10일까지」는 조용히 하루 늦은 기한이 된다 — 화면은 멀쩡해 보이고 아무도 모른다.due_days_before면 기간을 바꿔도 따라 움직이고, 되돌릴 것이 없다(재계산 연쇄가 생기지 않는다).그 대가로 기한 지남 판정이 조회 시 파생이다:
dueDate = trip.start_date − due_days_before,overdue = !done && dueDate < today(첫날 기준 도시 tz). DB에 인덱스를 걸 수 없지만 한 여행의 항목은 수십 개라 문제가 되지 않는다.
done을checked_at DATETIME으로 두지 않는다. 언제 체크했는지 쓰는 화면이 없다. 안 읽는 값을 저장하면 다음 사람이 그걸로 정렬해도 되는 줄 안다.묶음에 테이블을 만들지 않는다(
section_label, #1358 · D-41). 묶음이 갖는 것은 이름뿐이고, 마지막 항목이 나가면 그대로 사라져야 한다 — 행으로 만들면 아무도 안 쓰는 빈 묶음이 남고 그걸 지우는 화면을 또 만들게 된다.묶음의 순서 컬럼도 두지 않는다. 묶음의 자리는 **그 안의 최소
display_order**에서 조회 시 나온다(「묶음 없음」만 예외로 맨 앞). 순서를 따로 저장하면 항목을 옮길 때마다 둘을 맞춰야 하고, 어긋난 것이 화면에는 보이지 않는다.idx_prep_trip_category_order를 그대로 타므로 인덱스도 늘지 않는다.
v2.2는 이 테이블을 만들지 않기로 했었다. 「
trip_expense를 만들지 않는다 — 원장은 가계부 하나뿐이다」가 D-27이었고, 여행 경비는ledger_transaction중trip_id가 이 여행인 행이었다. 가계부를 제거하므로 그 근거가 사라졌다 → D-43.
| 컬럼 | 타입 | 설명 |
|---|---|---|
id |
BIGINT PK | |
trip_id |
BIGINT NOT NULL | FK→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. NULL = 미분류
|
payment_method |
VARCHAR(40) NULL | 자유 텍스트 라벨 |
status |
VARCHAR(20) NOT NULL |
CONFIRMED · SCHEDULED. 기본값 CONFIRMED
|
fx_currency / fx_amount / fx_rate
|
VARCHAR(3) / DECIMAL(18,2) / DECIMAL(18,6) | 표시용이자 근거. 저장 시점에 굳는다 |
created_at / updated_at / deleted_at
|
소프트 삭제 |
인덱스: idx_trip_expense_trip (trip_id, occurred_on) — 경비 화면이 읽는 유일한 경로다.
ledger_transaction.trip_id는 **ON DELETE SET NULL**이었다. 「여행을 지워도 쓴 돈은 원장에 남는다」를 애플리케이션이 아니라 DB 제약으로 보장한 것이다.
남을 원장이 없어졌다. 그래서 trip_expense는 CASCADE다 — trip_prep_item과 같은 취급이 된다. 「여권 챙기기」가 그 여행 없이 뜻이 없듯, 이제 그 지출도 그렇다.
| 만들지 않는 것 | 대신 |
|---|---|
| 카테고리 테이블 |
고정 프리셋 여섯을 VARCHAR 한 칸에. 관리 화면·순서·삭제 시 재배정이 안 생긴다(D-31과 같은 이유) |
| 자산 테이블 |
payment_method 자유 텍스트. 잔액을 볼 원장이 사라져 자산이 실체를 가질 이유가 없다 |
| 이체·청구서·정기 항목 | 없다. 여행 경비에는 지출만 있다 |
| 상쇄 거래 | 고치거나 지운다(소프트 삭제). 원장이 아니다 |
-
집계는
amount(원화 환산액)로만 한다.fx_*3개는 표시용이자 근거다 -
— 그럴 일이 없다. 이체라는 개념이 테이블에 없으므로 「카드 대금 납부가 여행 경비로 샌다」는 문제 자체가 성립하지 않는다type='TRANSFER'는 합계에서 빠진다 - 「출발 전 / N일차·도시 / 다녀온 뒤」 그룹은
occurred_on과trip_day로 조회 시 파생한다. 그룹 라벨을 저장하면 기준 도시를 바꿨을 때 조용히 옛 도시가 남는다 -
budget_amount는 계속trip이 갖는다(D-28 유지).ledger_budget에 넣지 않은 판단이 여기서 값을 한다 — 이번 변경에 예산은 손댈 곳이 없다
ledger_transaction → trip_expense. 대상은 trip_id IS NOT NULL AND type='EXPENSE' AND deleted_at IS NULL.
-
payment_method는ledger_asset.name을 문자열로 복사한다 - 카테고리는 이름이 확실한 것만 여섯 프리셋에 매핑하고 나머지는 NULL로 둔다 — 화면이 「정리할 내역 N건」으로 잡아 준다
- 이관은 복사다. 원본을 지우지 않는다. 원본은 제거 3단계에서 테이블째 사라진다
- 검증: 이관 전후로 각 여행의 확정 지출 합계가 같아야 한다
| 값 | 계산 | 위치 |
|---|---|---|
| 여행 상태 |
today(오늘 날짜의 기준 도시 tz) vs start_date/end_date
|
BE TripStatus · FE lib/tripStatus.ts
|
| D-day | start_date − today(첫날 기준 도시 tz) |
동일 |
| 일차 번호 | activity_date − start_date + 1 |
동일 |
| 구간(Leg) | 연속된 같은 trip_day.base_place_id 묶음 |
BE LegDeriver · FE lib/legs.ts
|
| 오늘 밤 숙소 / 체크아웃 숙소 |
stayTonight / stayCheckout (§2.9) |
BE · FE lib/stayForDay.ts
|
| 대표 국가 | 날짜들의 기준 도시 country_code 집합 |
BE |
파생이 아니다(#1208) — travel_move에 사용자가 적은 값을 읽는다 |
BE, 보드 응답에 포함 | |
| 오프라인 저장 용량 | Cache Storage / IndexedDB 실측(navigator.storage.estimate()) |
FE (S-09) |
| 준비 기한 (v2.2) | start_date − due_days_before |
BE PrepItemView · FE lib/prep.ts
|
| 기한 지남 개수 (v2.2) | !done && dueDate < today(첫날 기준 도시 tz) |
동일. 사이드바 배지가 같은 값을 읽는다 |
| 진행률 (v2.2) | 전체 done/total + 분류별 done/total
|
동일 |
| 여행 경비 그룹·합계 (v2.2) |
occurred_on vs 여행 기간 → 출발 전 / N일차(기준 도시) / 다녀온 뒤 |
BE TripExpenseAssembler
|
| 하루 쓸 수 있는 돈 (v2.2) |
(budget_amount − spent) ÷ 남은 날짜. 예산이 NULL이면 계산하지 않는다
|
동일 |
런타임 캐시 이름(
travel-api)은shared/lib/cacheNames.ts한 곳에 둔다. 서비스워커와 설정 화면이 각자 문자열을 들면 한쪽만 고쳤을 때 화면은 "저장된 것 없음"이라 하고 캐시는 계속 쌓인다.
| 파일 | 단계 | 내용 |
|---|---|---|
047-create-travel-tables.yaml |
1 |
trip, trip_activity, travel_place — 장소 컬럼까지 한 번에 만든다(2단계에서 채우기만) |
048-create-push-subscription.yaml |
3 | push_subscription |
049-create-push-notification.yaml |
3 | push_notification |
050-create-trip-activity-log.yaml |
4 | trip_activity_log |
051-create-trip-activity-photo.yaml |
4 | trip_activity_photo |
052-drop-travel-place-photo-columns.yaml |
— | 장소 사진 컬럼 제거 (D-16, #1117) |
053-travel-multi-city.yaml |
v2.1-1 | 아래 순서를 한 파일에 담는다 |
054-create-travel-move.yaml |
— |
travel_move (#1208). 백필 없음 — 자동 계산값은 Redis 캐시였고 캐시는 진실이 아니다. 배포 직후 모든 구간이 빈 상태로 시작한다 |
064-create-trip-prep-item.yaml |
v2.2-1 |
trip_prep_item 생성 + trip.budget_amount 컬럼 추가. 백필 없음 — 준비 목록은 처음부터 비어 있는 것이 맞다(템플릿을 만들지 않기로 했다, §15) |
066-add-prep-section-label.yaml |
v2.2 후속 |
trip_prep_item.section_label 추가(#1358). 백필 없음 — 기존 항목은 전부 「묶음 없음」이고, 그 상태의 화면은 넣기 전과 같다 |
065-add-trip-id-to-ledger-transaction.yaml |
ledger_transaction.trip_id + idx_ledger_tx_trip. 가계부 스키마를 여행이 고치는 유일한 파일이었다 — 가계부 제거 3단계에서 테이블과 함께 사라진다 |
|
070-create-trip-expense.yaml |
v2.3 |
trip_expense 생성 + 이관 SQL. 064가 넣은 trip.budget_amount는 그대로 쓴다 — 건드릴 것이 없다 |
064에trip.budget_amount를 같이 넣는다. 준비만 먼저 나가는 단계(§16)에서 예산 컬럼은 아무도 안 읽지만, 여행 테이블을 두 번 ALTER 하는 것보다 낫다. NULL 허용이라 기존 행에 영향이 없다.
065는 컬럼 추가와 인덱스뿐이고 백필이 없다. 이미 적힌 지출에 여행을 붙이는 것은 마이그레이션이 아니라 사용자의 선택이다(§18의 「여행에 붙이기」). 자동으로 기간을 걸어 붙이면 여행 기간에 낸 통신비까지 여행 경비가 된다.
rollback은 컬럼·인덱스 DROP이면 충분하다. 다만 롤백하면 붙여둔 연결이 전부 사라진다 — 지출 자체는 남지만 어떤 여행 것이었는지는 복구되지 않는다.
한 파일에 순서대로 넣는다. 컬럼 삭제를 백필과 분리하면 중간 상태에서 배포가 물릴 수 있다.
-
travel_place에 v2.1 컬럼 추가 (city_name·city_place_ref·country_code·timezone·currency·place_kind) - 기존
trip.destination_place_id가 가리키던 장소를place_kind = CITY로 표시하고,trip.timezone·currency를 그 장소에 복사 -
trip_day·trip_stay생성 -
백필 — 여행 1건당
start_date~end_date전 날짜에trip_dayINSERT,base_place_id는 그 여행의 목적지 장소 (기존 여행 = 단일 도시 여행이므로 전 날짜 동일)- 목적지 장소가 NULL인 여행(1단계 수동 입력분)은
destination_name·timezone·currency·좌표로travel_place를 만들어 붙인다
- 목적지 장소가 NULL인 여행(1단계 수동 입력분)은
-
trip에서destination_name·destination_place_id·timezone·currency·lat·lngDROP
rollback을 반드시 적는다. 5번이 실행된 뒤에는 목적지 정보가trip_day에만 남으므로, 롤백은trip_day의 첫날 기준 도시에서 되돌려 채우는 방향이어야 한다.파일 맨 앞에
tagDatabase: pre-travel-multi-city를 둔다 — changeSet 수를 세지 않고liquibase rollback pre-travel-multi-city한 줄로 되돌린다.
trip_day·trip_stay는 자동 롤백을 쓰지 않는다. 자동 롤백은 changeSet을 거꾸로 되짚어 인덱스부터 지우는데,(trip_id, …)인덱스는 FK가 쓰고 있어 MySQL이Cannot drop index … needed in a foreign key constraint로 거부한다.dropTable을 명시하면 인덱스·FK가 함께 사라진다.실사용 데이터가 아직 없어 손실 위험은 낮지만, 백필 없이 컬럼만 지우면 기존 여행이 전부 타임존을 잃고 상태 판정이 죽는다. 순서를 지킨다.
1단계에서
travel_place를 미리 만드는 이유:trip.destination_place_id·trip_activity.place_idFK를 나중에 추가하면 ALTER가 필요하다. 테이블은 처음부터 두고 2단계에 쓰기 시작한다.