Repository navigation
Travel Open Items
모듈 9 설계 중 확정된 결정과 미결 리스크. 제품 결정 정본은 확정 명세 v2.2(이전 판 v2.1 · v2.0)이고, 이 페이지는 명세를 구현으로 옮기며 내린 기술 결정을 남긴다. 상세 설계는 아키텍처 · 데이터 모델 · API · 화면.
| 자산 | 날짜 | 처리 |
|---|---|---|
| Orino Travel 확정 명세 v2.0 | 2026-08-07 | Travel-Spec-v2에 전문 보존. §번호를 핸드오프가 인용하므로 변경 금지 |
디자인 핸드오프 + 프로토타입(Orino Travel.dc.html) |
2026-08-07 | Travel-UI-Design에 흡수. 프로토타입 파일은 로컬 산출물이라 Wiki가 유일한 영구 사본 |
디자인 핸드오프 v2.1 + 프로토타입(Orino Travel v2.dc.html) |
2026-08-09 | 제품 명세는 Travel-Spec-v2-1·Travel-UI-Design §9에 흡수. 작업 지시서(CLAUDE_CODE.md)는 채택하지 않는다 — D-20
|
| 여행 v2.2 기획안 — 경비 · 준비 | 2026-09-05 | Travel-Spec-v2-2에 전문 보존. §번호를 핸드오프·이슈가 인용하므로 변경 금지 |
디자인 핸드오프 v2.2 + 프로토타입(여행 경비·준비.dc.html) |
2026-09-05 | 화면 결정은 Travel-UI-Design §10에 흡수. github.md(화면↔리포 파일 매핑)는 참고 자료로 §10.0에 녹였다 |
| 디자인 핸드오프 v2.2 — 2판 (사이드바 재설계) | 2026-09-06 | 「사이드바 — 여행을 펼친다」 절이 추가된 것이 유일한 변경이다(나머지는 1판과 동일). Travel-UI-Design §10.8에 흡수 → D-36~D-40 |
⚠️ 2판 문서 안에서 프레임 번호가 어긋난다.README.md의 「Files」는2a를 확정이라 적었지만, 같은 문서의 본문과 프로토타입 캔버스는3a가 확정(2a·3b는 채택 안 함)이라고 말한다. 프로토타입을 따랐다 — 확정 이유(「숨긴 드롭다운이 최선은 아니다」)가 캔버스에 근거와 함께 적혀 있고,Files줄은 1판에서 프레임 목록만 갱신하다 남은 자국으로 보인다.
-
결정: 다른 모듈처럼 통합 PRD에 흡수하지 않고,
Travel-Spec-v2페이지에 원문 그대로 둔다. PRD에는 모듈 9 요약 + 링크만. -
근거: 디자인 핸드오프가
§1.9·§4.2·§4.7·§5를 직접 인용한다. PRD로 옮기면 조항 번호가13.1.9처럼 바뀌어 인용이 전부 깨진다. 명세가 "논의가 끝난 확정 문서"라 계약처럼 다루는 편이 맞다.
-
결정:
/select+ 사이드바 스위처로 일상/여행을 나눈다. 인증·앱 셸·디자인 시스템은 공유하고, 도메인·API·라우트는 완전히 분리한다. - 일상 범위는 변경 없음. 기존 라우트를 하나도 건드리지 않는다.
- 근거: 학습·기록 맥락과 여행 준비 맥락은 겹치지 않는다. 사이드바를 합치면 양쪽 다 지저분해진다. 플래너 통합(Planner-Module)에서 "통합은 내비게이션이지 데이터 통합이 아니다"라고 정리한 것과 같은 원칙.
-
결정:
activity_date DATE+start_time TIME. UTC로 변환하지 않는다. 알림 발송 시각만trip.timezone으로 환산해 별도 컬럼(push_notification.scheduled_at)에 UTC로 저장한다. -
근거: §4.1. 서울에서 짜든 도쿄에서 보든
10:30은10:30이어야 한다.Instant로 저장하면 타임존을 바꾸는 순간 전 일정이 밀린다. 이 모듈에서 가장 틀리기 쉬운 지점이라 명시적으로 못박는다.
-
결정:
LocalDate.now(ZoneId.of(trip.timezone))와 기간을 비교해 매 조회 시 파생. BETripStatus와 FElib/tripStatus.ts가 같은 규칙을 갖는다. - 근거: §2.1. 저장하면 날짜가 넘어갈 때 갱신할 주체가 없다(배치를 돌리는 것은 과설계). 파생 비용은 비교 두 번이다.
2026-10-19 뒤집힘(#1432) — 삭제·보관함 이동은 누르는 즉시 요청을 보낸다. 실행취소는 없다. 5초 보류 동안 「삭제했어요」라고 떴는데 실제로는 아직 안 지워진 상태가 더 헷갈렸다(사용자 요청). 행은 낙관적으로 먼저 빼고, 실패하면 되돌려 놓고 알린다. 소프트 삭제·복원 API를 두지 않는다는 결론은 그대로다 — 그래서 되돌리기도 없다. 아래는 당시 결정이다.
- 결정: 삭제/보관함 이동 시 낙관적으로 화면만 바꾸고 서버 요청을 5초 보류한다. 취소하면 요청 자체가 나가지 않는다. 화면 이탈·언마운트 시 즉시 flush.
-
대안 검토:
deleted_at소프트 삭제 +POST /restore. -
근거: 5초 안에 되돌리는 UX(§1.9)에는 서버 왕복이 필요 없다. 소프트 삭제는 모든 조회 쿼리에
deleted_at IS NULL을 달고 정리 배치까지 만들어야 한다 — 1인용 앱에 과하다. Gmail이 쓰는 방식이기도 하다. - 트레이드오프: 5초 안에 앱이 죽으면 삭제가 반영되지 않는다(데이터는 남는다 — 안전한 방향의 실패).
-
결정: FE가 구간마다 API를 부르지 않는다. BE가 조립해 함께 내려준다(
legs[]→travelTimes[]→moves[]). -
근거: ① 오프라인에서 보드 응답 캐시 하나로 이동까지 함께 보여야 한다(§4.6) ② N+1 호출 방지 ③
Google Routes 호출을 서버 한 곳에서만 통제(비용). - (#1208) 세 번째 근거는 사라졌지만 결정은 그대로다. 계산이 조회로 바뀌었을 뿐 ①②는 여전히 유효하다 — 이제는 유료 호출 대신 DB 왕복을 한 번으로 묶는다(D-26).
-
캐시 무효화가 필요 없다: 캐시 키가
(좌표쌍, 모드)라 순서·장소가 바뀌면 인접 쌍이 달라져 키가 자연히 바뀐다. §1.3의 "순서·장소 변경 전까지 재조회 안 함"이 키 설계로 충족된다.
-
결정: 1단계 S-03의 목적지 필드를
Input(도시명) + 타임존·통화Select로 만든다. 화면 순서와 "자동 지정됐어요" Alert 자리는 그대로 두고, 2단계에 입력 수단만 검색으로 교체한다. - 근거: 목적지 검색은 Google Places 프로젝트·키·프록시·캐시가 전부 서야 한다 = 2단계 인프라. 1단계 마감 기준이 "도쿄 일정을 텍스트만으로 끝까지 만들 수 있다"(§5)이므로 정합하다. 1단계에 유료 API를 끌어오면 최대 리스크(드래그 정렬 실기기 검증)에 쓸 시간을 잠식한다.
-
결정:
travel_place는member_id스코프. 여행을 가로질러 재사용된다. -
근거: 같은 장소를 일정마다 새 행으로 만들면 캐시가 중복되고 한 행만 갱신되는 일이 생긴다.
uk_place_member_google이 멤버당 한 행을 강제한다. (원래 근거였던⭐ 좋았던 곳배지는 미도입 — D-18. 재사용 자체의 이유는 그대로 남는다.)
-
결정:
push_notification은type·scheduled_at·참조만 갖는다. 제목·본문은 발송 직전trip_activity를 조인해 만든다. - 근거: §4.2 재계산 트리거에 "제목 변경"이 없다. payload를 저장하면 제목만 고친 일정이 옛 제목으로 알림된다. 조립 비용은 조인 한 번이다.
-
결정:
push_subscription·push_notification은domain.planner.push에 두고 여행에서 사용만 한다. - 근거: 복습 알림 등 다른 모듈이 나중에 같은 인프라를 쓴다. 여행 하위에 묻으면 그때 이사해야 한다.
-
결정: 순서 변경 시 해당 날짜 행 전체에
sort_order를 0..n-1로 다시 부여한다. -
근거: 하루 일정은 10건 남짓이다. 데이터 그리드 #778의 gap index 논의는 대량 행 삽입 상황이라 여기와 다르다. 드래그 결과는 어차피 배열 전체를 보내므로(§API
/activities/order) 재인덱싱이 오히려 단순하다.
결정: BE가 Place Photos를 1회 받아 저장하고img.orino.dev로 서빙. 30일 후 갱신.-
철회 사유(2026-08-09): 구글 약관상 허용되지 않는다. ToS §3.2.3(b)는 Service Specific Terms가 명시적으로 허용한 것 외의 캐싱을 금지하고, SST §14.3이 Places에 허용하는 것은 위경도 30일뿐이다(
place_id는 무기한). Place Photos 문서는 *"You cannot cache a photo name."*까지 못박는다. - 근거로 삼았던 "성능 목적 30일 캐시"는 2018년판 §10.5(d)의 조항이고 현행에는 없다 — API별 화이트리스트로 바뀌었다. 상세는 #1102.
-
결정: 사진 기능을 도입하지 않는다.
photoUrl필드는 응답에 남지만 항상 null이다. - 근거: 캐시는 약관 밖이고(D-12 철회), 캐시 없이 가면 노출당 유료 호출이라 애초에 피하려던 비용 문제로 돌아간다. 사진 없이도 검색·담기·상세는 전부 동작하고, 에픽의 "잘라낼 순서"에서도 사진이 맨 앞이었다.
- 비고: 구현했던 PR(#1100)은 머지하지 않고 닫았다.
-
결정:
TripDayMap(S-05)·PlacePreviewMap(S-07)을 leaflet/OSM에서 Maps JavaScript API로 교체한다. 일상기록 지도는 그대로 leaflet.-
비고:
TripDayMap은 #1144에서TripMap으로 일반화됐다 —이 날짜(일정)와전체(도시)가 같은 지도를 쓴다. 다른 것은 무엇을 점으로 찍느냐뿐이고, SDK 수명주기·정리·불러오기 실패 처리를 두 벌 두지 않는다.
-
비고:
- 근거: ToS의 "No Use With Non-Google Maps"가 금지하는 것은 비구글 지도 **"위에(on)"**가 아니라 **"with or near"**다. 일정 상세는 주소·영업시간·전화(Places)가, 지도 화면은 이동시간(Routes)이 지도 옆에 있어 배치를 떼어놓는 것으로는 풀리지 않는다. Routes도 같은 조항이라 한 번에 정리된다.
- 비용은 문제가 아니다 — Dynamic Maps는 월 10,000회 무료, 1인 앱은 월 수백 회라 $0이다.
- 일상기록 지도는 Nominatim(OSM) 데이터라 이 제약과 무관하다.
-
비고: 브라우저 키는 Terraform(
gcp-maps.tf), Map ID는 콘솔(Terraform 리소스 없음). 로더는 반드시callback=으로 준비를 기다려야 한다 —script.onload시점에는google.maps.Map이 아직 없어Map is not a constructor로 죽는다(#1113).
-
결정: SW가
GET /api/travel/**를 NetworkFirst로 캐시하고, 편집 mutation은 UI 단계에서 막는다. 오프라인 중 변경을 쌓아뒀다 나중에 보내지 않는다. - 근거: §1.7 확정. 큐잉을 하면 충돌 해소·순서 보장·부분 실패 UI가 전부 따라온다. 1인용 앱에서 얻을 게 없다.
-
결정:
PUT /log(평점·메모)와POST /photos(사진)를 별도 요청·별도 테이블로. - 근거: §5.1 단계 4 위험 대응 — "사진 업로드가 실패해도 메모·평점은 저장되도록 분리". 한 요청으로 묶으면 사진 하나 실패에 평점까지 날아간다.
-
결정: API 키(
orino-travel-places-routes)에 API 제한만 걸고(places·routes 두 개), 애플리케이션(IP) 제한은 두지 않는다. 대신 프로젝트 단위 월 예산 3만원 + 50/90/100% 및 예측 100% 알림을 건다. - 근거: 클러스터 이그레스가 집 회선이라 공인 IP가 고정이 아니다. IP 제한을 걸면 회선 IP가 바뀌는 순간 장소 검색이 통째로 죽는데, 그 실패는 여행 중에 드러난다 — 고치러 갈 수 없는 시점이다. API 제한만으로도 키가 새어나갔을 때 쓸 수 있는 범위는 이 두 API로 묶이고, 금전 피해는 예산 알림이 조기에 잡는다.
- 비고: 알림은 결제 관리자 이메일로 간다. 회선을 고정 IP로 바꾸면 그때 IP 제한을 추가하는 편이 낫다.
-
결정: §S-06의 "이전 여행에서 평점 4 이상을 준 장소에 배지" 요구를 철회한다.
PlaceSearchResult.loved필드와 배지 UI를 제거했다. - 근거: 1인용 앱이고 여행이 아직 한 번도 안 끝났다. 판정을 붙여도 한동안 아무 장소에도 배지가 안 뜬다 — 늘 false인 필드와 절대 안 보이는 UI를 들고 다니는 비용만 남는다. 필요해지면 그때 넣는 편이 싸다(기록 테이블은 이미 있다).
- 비고: #1101 not planned로 닫음.
- 결정: 여행 기록(평점·메모·사진)과 Lifelog Moment를 각각 둔다. 동시 생성(B)도, Lifelog 일원화(C)도 하지 않는다. R-8을 이 결정으로 닫는다.
- 근거: 여행 기록은 이미 구현돼 동작한다(#1090·#1092). B는 삭제·수정 동기화라는 새 문제를 만들고, C는 만든 기능을 걷어내는 일이다. 10/13 동결 기준으로 유일하게 안전한 선택이고, 두 도메인의 목적도 실제로 다르다 — 여행 기록은 "그 일정이 어땠나"(사후 한 줄), Lifelog는 서사와 지도.
- 비고: 10/24 실사용 후 진짜로 겹치는지 다시 본다. 그때 합치는 편이 지금 합치는 것보다 싸다.
-
결정:
CLAUDE_CODE.md의 PR-1~PR-7 단위와 §5.1·§5.2 구현 지침을 폐기한다. 제품 명세(README.md)만 채택한다. -
근거: 지시서가 v2.0 구현 착수 전의 리포를 전제로 쓰였다.
- "대상은
fe/하나, BE 없으면 MSW로 계약 고정" → BE는 이미 있다(Liquibase 047~052). v2.1은 스키마 마이그레이션이다 - PR-1(
/select·사이드바 스위처·/travel라우트 신설) → 이미 있다(#1033) - §5.1(드래그는 라이브러리 전에 pointer로) → #1048에서 dnd-kit으로 종결. 되돌릴 이유가 없다
- §5.2(react-leaflet + CARTO 타일) → 따르면 약관 위반(D-17)
- "대상은
- 비고: 지시서를 그대로 실행하면 이미 있는 것을 다시 만들고, 이미 고친 결정을 되돌리게 된다.
-
결정: 구간 테이블·구간 상태를 만들지 않는다.
trip_day.base_place_id의 연속 묶음으로 매번 파생한다. - 근거: 입력은 구간이지만 진실은 날짜다. 둘 다 저장하면 어긋날 수 있는 상태가 두 개 생기고, 날짜 하나의 도시만 바꾸는 조작(도쿄/닛코/도쿄)에서 즉시 어긋난다. 파생 비용은 날짜 30개 순회로 무시할 만하다.
-
결정: 기존
GET /trips/{id}/legs→travel-time, 보드 응답legs[]→travelTimes[], FELegRow→TravelTimeRow.Leg는 v2.1의 도시 구간 전용어가 된다. - 근거: 같은 단어를 두 뜻으로 쓰면 다음 사람이 반드시 틀린다. 구간 편집기를 만들기 전에 재명명을 먼저 한다 — 순서를 바꾸면 같은 이름의 두 개념이 공존하는 구간이 생긴다.
-
결정:
travel_place에city_place_ref(구글 장소 id)를 두고 그 값의 일치로만 같은 도시인지 판정한다. 좌표 거리·행정구역 이름 문자열로 추정하지 않는다. - 근거: 이 판정이 도시 이탈 표시와 보관함 그룹을 가른다(#1208 전에는 이동시간 계산 여부도 갈랐다). 거리 임계로 하면 오사카-교토(43km)와 도쿄-요코하마(30km)에서 서로 다른 답이 나오고, 이름 비교는 표기 흔들림에 깨진다.
-
비고: 기준 도시로 지정 가능한 장소는
place_kind = CITY로 제한한다. 가게를 기준 도시로 만들 수 없다.
-
결정: Places 검색 결과에서
locality타입을 우선 채택하고, 없으면administrative_area_level_1|2로 폴백한다. 국가(country)는 기준 도시로 받지 않는다. -
근거: 닛코(
locality)와 하코네(administrative_area_level_2, 정확히는 町)가 둘 다 필요한데 한 타입만 걸면 하나가 빠진다. 국가를 허용하면 "일본"이 기준 도시가 되어 타임존은 맞아도 검색 편향·날씨가 무의미해진다. - 비고: ELOG-024에서 목적지 검색이 빵집을 물어온 원인이 타입 필터 부재였다. 같은 실수를 반복하지 않는다.
-
결정: 이동일(직전 날짜와 기준 도시가 다른 날)의 **유효 도시 = {떠나온 도시, 도착한 도시}**로 파생한다. 저장은 그대로
trip_day.base_place_id하나다. 기준 도시는 여전히 도착한 도시 하나이고, 떠나온 도시는arrivingFrom으로 함께 내려간다.- 도시 이탈 판정(
outOfBaseCity)은 두 도시 중 어디에도 안 속할 때만 선다 - 날씨는 이동일에 두 도시를 준다(보드는
arrivingFromWeather, S-08은 줄이 둘) - 타임존·알림 발송 시각·"오늘" 판정은 도착 도시 하나만 쓴다. 여기는 절대 둘로 쪼개지 않는다
- 도시 이탈 판정(
- 근거: 구간을 일 단위로 배타적으로 나누면 이동일이 갈 곳이 없다. 10.28 오전은 오사카, 오후는 교토인데 기준 도시가 교토 하나라 오전 일정 전부에 도시 경고가 붙었다 — 7구간이면 이동일이 여섯 번이라 여섯 날의 오전이 통째로 잘못 담은 것처럼 보인다. 떠나온 도시는 직전 날짜의 기준 도시일 뿐이라 저장 없이 나온다.
-
채택하지 않은 안 — 박(night) 기준 구간 저장 (
trip_segment(start_date, end_date),end_date == 다음 start_date):- 구간 테이블은 존재하지 않는다. 지금은
LegDeriver가 매번 파생한다(D-21) — 이건 마이그레이션이 아니라 SSOT를 날짜에서 구간으로 옮기는 일이다 - 옮기면 하루 단위 기준 도시 변경(#1133 롱프레스 시트)이 한 행 UPDATE에서 저장된 구간을 셋으로 쪼개는 쓰기가 된다. D-21이 경고한 그 지점이다
- 박 단위 반열린 구간은 이미
trip_stay가 그 모양([checkIn, checkOut))이다. 같은 자료구조의 두 번째 테이블이 생긴다 - 결정적으로 박은 "자는 도시"만 안다. 도쿄에 자면서 닛코에 다녀오는 당일치기를 표현하지 못한다 — 기준 도시와 숙소를 분리한 이유가 정확히 그것이다(§2.4). 날짜 기준이면 당일치기는 앞뒤로 이동일이 두 번 서면서 그대로 표현된다
- 구간 테이블은 존재하지 않는다. 지금은
-
비고: 구간 표기를
N일→N박으로 바꾸는 것도 함께 검토했고 뺐다. 도쿄 / 닛코 당일치기 / 도쿄에서 닛코 구간이1박으로 파생되는데 그날 밤은 도쿄에서 잔다. 일 단위는 구간이, 박 단위는 숙소가 각자 갖는다. 경계일은 구간 카드 사이의 이동 줄로 보여주고합계 N일 / 기간 N일불변식은 유지한다. - 범위 밖: 여행 첫날·마지막날의 국제 이동(인천 → 오사카)은 전날이 없어 여전히 경고가 뜬다. 리허설(#1176)에서 실제 빈도를 세어 보고 정한다. 하루 3도시 이상도 표현하지 않는다.
-
구현: #1205 ·
TransitionDays
-
결정: 직선거리 1.5km 임계로 도보/자동차를 판정하고 Google Routes로 소요 시간을 사 오던 자동 계산을 전부 걷어낸다. 사용자가 수단·이름·소요 시간·예매 링크·메모를 직접 적고, 앱은 읽어서 보여주기만 한다.
- 저장 단위는
(member_id, from_place_id, to_place_id)— 장소 쌍이다 - 수단 분류는 범용 9종(
WALK BIKE BUS CAR SUBWAY TRAIN FLIGHT FERRY OTHER), 구체적인 이름은 자유 입력 -
crossCity(도시 경계는 계산하지 않음)와fallback(직선거리 대체)이 함께 사라진다
- 저장 단위는
- 근거: 자동 계산이 못 하는 것이 두 가지였다. ① 비행기·신칸센·페리를 표현하지 못했다 — 앱이 아는 수단이 도보와 자동차뿐이었다. ② 도시를 넘는 구간은 아예 계산하지 않았다(D-23 · v2.1 §3.4). 오답을 지우려던 규칙인데, 정작 미리 예매까지 끝내 두는 이동이 그 구간이라 가장 확실히 아는 값이 화면에서 비어 있었다. 답은 이미 사용자가 알고 있다.
-
왜 장소 쌍인가: 일정 쌍에 붙이면 드래그로 순서를 바꾸는 순간 값이 거짓이 되거나 사라진다. 장소 쌍이면 순서를 바꿔도 살아 있고, 같은 두 장소를 다시 이으면 다른 날·다른 여행에서도 그대로 뜬다 — 도쿄역에서 숙소까지를 한 번 적으면 매일 다시 적지 않아도 된다.
travel_place가 이미 멤버별이라 다른 사용자에게 새지 않는다.- 방향은 유지한다(A→B ≠ B→A). 편도 항공과 일방통행이 실제로 다르다.
-
왜 나라 고유명을 enum에 넣지 않나:
SHINKANSEN을 값으로 박으면 일본 밖에서 쓸 수 없고, 다음엔TGV·KTX를 넣어 달라는 요청이 이어진다. 분류는 아이콘용으로 범용하게, 구체적인 것은name으로 내리면 그 줄이 끊긴다.OTHER가 있어 목록에 없다는 이유로 이동을 기록하지 못하는 일이 없다. - 뒤집은 결정: v2.1 §7이 "도시 간 이동수단 필드(KTX/신칸센/비행기 등 저장)"를 하지 않기로 확정했었다. 실사용에서 그 자리가 가장 크게 비어 되돌린다.
- 부수 효과: Routes 관련 비용이 0이 된다. #1203("경로 없는 구간을 매번 다시 물어본다")은 전제가 사라져 닫았고, ELOG-023의 캐시 설계도 이 축에서는 더 볼 것이 없다. 다만 비용은 이유가 아니라 결과다 — 표현력이 이유다.
- 마이그레이션 없음: 자동 계산값은 Redis 캐시라 옮길 원본이 없다. 배포 직후 모든 구간이 빈 상태로 시작하고 사용자가 채운다.
-
구현: #1208 ·
travel_move·MoveService
D-27. 여행 경비는 테이블을 만들지 않는다 — 폐기 (2026-09-20, D-43)
-
결정:
trip_expense를 만들지 않는다. 여행 경비 =ledger_transaction중trip_id가 이 여행인 행이고, 여행 화면은 읽기 뷰 + 빠른 입력 통로다. 지출 쓰기는 FE가/api/ledger/transactions로 직접 보낸다 — 여행 BE가 중계하지 않는다. - 근거: 가계부 §3-10이 이미 「원장은 하나뿐이다」로 정했다. 장부를 여행 안에 따로 만들면 합계가 어긋난 날 어느 쪽이 맞는지 판단할 근거가 사라진다. 중계 계층을 두면 입력 검증·환율 확정·청구서 편입이 두 곳에 생겨 같은 문제가 코드 안에서 재현된다.
-
의존 방향: 코드는 여행 → 가계부 단방향, FK는
ledger_transaction.trip_id → trip(id)ON DELETE SET NULL. 「여행을 지워도 쓴 돈은 남는다」가 애플리케이션이 아니라 DB 제약으로 보장된다. -
비고: 이 결정으로 가계부가 「차기」로 미뤄둔 §11.2 여행 연계(
LDG-019)를 v2.2로 당긴다. 가계부에 생기는 것은 컬럼 하나와 파라미터 몇 개뿐이다.
-
결정: 여행 단위 예산 총액을
trip테이블의budget_amount BIGINT NULL로 저장한다. 가계부의ledger_budget에 넣지 않는다. NULL = 예산 미설정이고 0과 다르다. -
근거:
ledger_budget은uk (member_id, period)로 기간 하나당 한 행이다 — 여행은 기간 개념이 다르고(10/24~10/29가 두 달에 걸칠 수도 있다), 여기에 여행 예산을 끼우면 월 예산과 같은 표에서 살면서 「섞지 않는다」(§5.2)를 코드로 지켜야 한다. 여행의 속성이면 여행이 갖는 게 맞다. -
함께 정한 것: 예산 해제는
null이지0이 아니다. 0을 허용하면 「안 정함」과 「0원으로 정함」이 같은 값이 되고, 화면은 「0원 중 41.2만」을 그린다. - 채택하지 않은 안 — 예산도 가계부에: 그러면 여행 도메인이 가계부에 쓰기를 하게 된다. 읽기만 하는 지금의 경계가 무너진다.
-
(2026-09-20) 이 결정이 값을 했다.
ledger_budget이 테이블째 사라지는데, 예산을 그쪽에 넣었다면 가계부 제거에 예산 이관이 하나 더 붙었을 것이다.trip.budget_amount는 손댈 곳이 없다 → D-43
-
결정:
trip_prep_item.due_days_before INT. 「10월 10일까지」를 저장하지 않는다. 화면의D-14와 기한 지남 판정은 매번start_date − N으로 파생한다. - 근거: 여행 기간은 바뀐다. 출발일을 하루 당기는 순간 날짜로 적어둔 기한은 조용히 하루 늦은 기한이 되고, 화면은 멀쩡해 보인다. D−N이면 기간을 바꿔도 따라 움직이고 재계산 연쇄가 아예 생기지 않는다 — R-12가 경고한 종류의 실패가 여기서는 불가능하다.
-
대가: 기한에 인덱스를 걸 수 없어
overdue가 조회 시 계산이다. 한 여행의 항목은 수십 개라 문제되지 않는다. - 기준 시각은 첫날 기준 도시의 오늘이다. 서버 로컬 날짜를 쓰면 출발 전날 밤에 화면과 알림이 하루 어긋난다.
-
결정: 미배정 보관함·일정·노트 어디에도 넣지 않고
/travel/trips/:id/prep을 만든다. - 근거: 보관함은 「가고 싶은 곳」이라 장소 없는 「멀티어댑터」가 섞이면 도시별 그룹이 「도시 없음」으로 반쯤 찬다(v2.1에서 만든 그룹이 바로 망가진다). 일정은 날짜·시각·순서·장소·이동·알림을 갖는데 준비물은 그중 아무것도 없다 — 억지로 넣으면 이동 표시와 도시 판정이 「양말 4켤레」에 걸린다. 노트는 일상 워크스페이스라 준비하다 워크스페이스를 갈아타야 한다.
- 따라오는 것: 준비 항목 → 일정 변환 버튼을 만들지 않는다. 변환이 가능하다고 말하는 순간 「준비는 날짜가 없는 것」이라는 정의가 무효가 된다.
-
결정:
DOCUMENT(서류) ·BOOKING(예약) ·BAG(짐) ·TODO(할 일). 애매하면TODO. 서버 기본값도TODO. - 근거: 네 분류는 행동이 다르다 — 챙긴다 / 끝낸다 / 넣는다 / 한다. 「환전」을 위해 돈 분류를 따로 빼면 「해외카드 되는지 확인」이 서류인지 돈인지 매번 헷갈린다. 분류가 늘면 어디에 적을지 고민하는 시간이 늘고, 그만큼 안 적게 된다.
-
비고:
quantity는BAG에서만 의미가 있다. 다른 분류로 옮기면 NULL로 떨구되 400을 내지 않는다 — 남은 값 때문에 항목 저장이 막히는 편이 더 나쁘다.
-
결정:
push_notification.type='PREP_REMINDER'를 기존 스케줄러에 얹는다. D-7·D-3·D-1을 만들지 않는다. 본문의 남은 개수는 발송 직전에 다시 센다. - 근거: 알림이 여러 번 오면 그때부터 무시하게 되고, 정작 필요한 여행 중 일정 알림까지 같이 무시된다. 개수를 미리 저장하면 예약 후에도 체크가 계속 일어나므로 거의 반드시 틀린 숫자가 나간다 — payload를 저장하지 않는 기존 규칙(아키텍처 §6)이 여기서 그대로 값을 한다.
-
재계산 경로:
activity_id가 NULL이라 일정 단위 재계산 그물에 걸리지 않는다. 아침 요약처럼 자기 경로(reschedulePrepReminder)를 탄다. 트리거는 여행 생성 · 기간 변경 · 첫날 기준 도시 변경.
- 결정: v2.1의 「볼 수는 있고 적을 수는 없다」를 그대로 지킨다. 경비·준비 모두 쓰기는 진입 자체를 막는다.
- 근거: 지출은 신호 없는 곳에서 적고 싶은 것이 맞다 — 이 기능에서 가장 아픈 자리다. 그래도 예외를 하나 열면 준비도 일정도 열어야 하고, 그 순간 충돌 해소가 설계에 들어온다. 이 모듈이 단순한 유일한 이유가 그것이다.
- 대신 한 것: 금액만 적고 저장되는 입력(§6.1). 나중에 적는 비용을 낮춘다.
- 재검토 조건: 리허설·실사용에서 놓친 건수가 5건을 넘으면 다시 본다. 숫자를 정해 두지 않으면 「불편했다」는 느낌만 남고 결정이 안 바뀐다.
-
결정: 항공권·JR패스처럼 두 달 전에 결제한 건도
occurred_on은 결제일 그대로,trip_id만 붙인다. 화면에서 「출발 전」 그룹으로 묶는다. 돌아온 뒤 결제는 「다녀온 뒤」. - 근거: 날짜를 여행 기간으로 옮기면 가계부의 그 달 통계가 거짓말이 된다 — 8월에 쓴 64만이 10월 지출로 잡힌다. 원장은 사실의 기록이고, 「여행에 속한다」는 사실은 날짜와 별개다.
-
(2026-09-20) 근거가 하나 없어져도 결정은 그대로다. 가계부의 월 통계가 사라지지만, 결제한 날은 그날 결제했다는 사실이다.
trip_expense.occurred_on도 결제일 그대로 둔다 → D-43 -
따라오는 것: 「출발 전 82만」이 화면에 안 보이면 총액이 설명되지 않으므로,
BEFORE·AFTER그룹은 비어 있지 않을 때만 내리되 있으면 반드시 보인다.
D-35. 지출 편집 화면을 여행 안에 만들지 않는다 — 폐기 (2026-09-20, D-43)
-
결정: 경비 화면의 지출 행을 누르면 가계부 지출 상세(
/ledger/transactions/{id})로 간다. 여행에는 편집 폼이 없다. - 근거: 같은 편집 화면이 둘이면 필드가 하나 늘 때마다 두 곳을 고쳐야 하고, 반드시 한쪽만 고치는 날이 온다. 빠른 입력 시트는 입력 전용이라 이 문제를 만들지 않는다 — 고치는 일은 원래 자리에서 한다.
- 비고: 워크스페이스가 갈리지만(여행 → 가계부) 편집은 드물고, 「원장이 진실」이라는 사실을 화면이 한 번 더 말해주는 효과가 있다.
-
결정: 진행 중·예정 여행을 사이드바에 한 줄씩 펼치고, 선택된 여행 하나만 일정 보드·준비·경비를 자식으로 편다(프레임
3a). 드롭다운 스위처(2a)와 그 위에 브레드크럼을 얹은 안(3b)은 채택하지 않는다. - 근거: ① 선택지가 정적이고 8개 미만이면 접는 것보다 펼치는 편이 잘 읽힌다 — 이 앱은 1인용이고 진행 중·예정 여행이 2~3개다. ② 사이드바에 안 보이는 컨텍스트 내비게이션은 기억되지 않는다. 숨김은 화면의 잡동사니를 줄이는 대신 머릿속의 잡동사니를 늘린다.
- 1판의 구멍: 사이드바에 「준비」·「경비」만 더하면 그 항목이 어느 여행 것인지 화면 어디에도 없다. 「일정 보드」는 여행이 하나일 때 그럭저럭 굴러갔지만, 준비·경비는 여행마다 따로라 같은 방식이 그대로 깨진다.
- 경계: 사이드바 최상단 워크스페이스 스위처(드롭다운)는 손대지 않는다. 일상·여행·링크·가계부를 가르는 다른 층위이고, 4칸이 224px에 안 들어가 드롭다운이 된 것이다(가계부 D-1). 여기서 펼치는 것은 여행 워크스페이스 안의 여행이다.
-
한계선: 진행 중·예정이 6개를 넘으면 토글 부분만 드롭다운으로 바꾼다(
3b가 그 대비다). 지금은 생기지 않는 상태다.
-
결정: 여행은 경로의
:id가 소유한다. 기본 여행 판정은 진행 중 → 다음 예정 → 마지막으로 본 여행(localStorage: travel.lastTripId) → 폴백 화면 순이고, 저장값은 여행 id가 없는 진입에서만 쓴다. - 근거: 「마지막으로 본 여행」을 서버에 두면 1인용 앱에 동기화·마이그레이션·기기 간 충돌이 생긴다. 반대로 그것을 진실로 삼으면 링크를 공유하거나 뒤로 가기를 눌렀을 때 URL과 화면이 다른 여행을 가리킨다. URL이 진실이면 그 두 문제가 동시에 없다.
-
함정: 저장된 id가 더 이상 없을 수 있다(삭제·다른 기기·시크릿 창). 요약의
trips[]에 없는 id는 조용히 버리고 다음 폴백으로 내려간다. 죽은 id로 화면을 열면 「여행을 못 찾았습니다」가 사용자 잘못처럼 보인다.
-
결정:
/travel/prep·/travel/expenses(여행 id 없는 경로)는 폴백 화면(2b)을 그린다. 진행 중·예정 여행 카드 리스트 + 「한 번 고르면 그 여행을 기억합니다」. 여행이 하나도 없으면EmptyState. - 근거: 딥링크·여행 삭제 직후가 실제로 생긴다. 목록으로 조용히 튕기면 사용자는 자기가 왜 거기 왔는지 모르고, 빈 화면을 보여주면 고장으로 읽는다. 「어느 여행의 준비인가요?」는 한 번의 선택으로 끝나는 질문이다.
-
비고: 삭제된 여행 id로 들어오면 폴백 경로로
replace한다 — 뒤로가기 스택에 죽은 URL을 남기지 않는다. -
구현하며 정한 것(#1353): 폴백 화면은 D-37의 판정을 다시 돌리지 않는다. 판정은 사이드바가 링크를 만들 때만 쓰고, 넷 다 실패했을 때 이 화면으로 온다. ① 폴백에서도 자동으로 넘기면 그게 여기서 금지한 조용한 리다이렉트다 — 지운 여행의 링크로 들어온 사람이 다른 여행의 준비를 자기가 찾던 화면으로 읽는다. ②
trips[]가 비어 있지 않으면 서버가ongoing이나next를 반드시 채우므로(API §2.1), 폴백에서 판정을 돌리면 카드 리스트가 영영 안 뜨는 죽은 코드가 된다.
-
결정: 사이드바 트리는 진행 중·예정만 펼치고, 나머지는 「다녀온 여행 N개」 한 줄로 접어
/travel/trips로 보낸다. 여행 목록 화면은 다녀온 여행까지 전부 보여준다. - 근거: 사이드바는 시간이 갈수록 길어지면 안 되는 자리다 — 여행이 쌓이면 그 자체가 목록 화면이 되고, 정작 오늘 쓰는 여행이 스크롤 아래로 내려간다. 줄이는 것은 사이드바에서만이다(지나간 여행을 돌아보는 자리는 목록 화면이다).
-
비고: 그래서 요약 API는
trips[](진행 중·예정)와completedCount를 나눠 내린다.prep·expense집계가 여행 수에 비례하는 유일한 자리라, 여기에만 싣고/trips목록 응답에는 넣지 않는다.
- 결정: 준비 화면 상단에 한 줄을 둔다 — 「준비 목록은 여행마다 따로입니다. 사이드바에서 여행을 바꾸면 이 화면도 그 여행의 목록으로 바뀝니다.」 모든 v2.2 화면은 PageHeader 위에 브레드크럼(「여행 › 일본 가을 › 준비」)을 갖는다.
- 근거: §15에서 템플릿·지난 여행에서 가져오기를 만들지 않기로 했다. 그래서 새 여행의 준비 목록은 항상 비어서 시작하는데, 이유를 화면이 말해주지 않으면 빈 목록이 버그로 읽힌다. 브레드크럼은 사이드바가 닫힌 모바일에서 스코프를 말하는 유일한 자리다.
D-41. 목록이 길어지면 분류를 늘리지 않고 그 안에 묶음을 둔다 (#1358)
-
결정:
trip_prep_item.section_label VARCHAR(30) NULL컬럼 하나. 분류 넷은 그대로다(D-31 유지). 묶음의 자리는 **그 안의 최소display_order**에서 조회 시 나오고, 「묶음 없음」(null)만 예외로 맨 앞이다. 응답은groups[].sections[].items[]— 항목은 묶음을 거쳐서만 실린다. - 근거: 쓰다 보니 짐이 스물을 넘어 분류 하나가 한 화면에 안 들어왔다. 다섯 번째 분류로는 안 고쳐진다 — 긴 것은 「짐 안쪽」이고, 나눌 축이 여행마다 다르다(겨울/여름, 캐리어/기내백). 서버 enum은 그걸 못 따라간다. 축이 둘이다: 분류는 행동(여행이 바뀌어도 안 변한다 → 고정), 묶음은 이번 여행의 사정(매번 다르다 → 자유 이름).
- 테이블도 순서 컬럼도 만들지 않는다. 묶음이 갖는 것은 이름뿐이고 마지막 항목이 나가면 사라져야 한다 — 행으로 만들면 빈 묶음이 남고 그걸 지우는 화면을 또 만들게 된다. 순서를 저장하면 항목을 옮길 때마다 둘을 맞춰야 하고, 어긋난 것이 화면에는 안 보인다.
- 안 쓰면 없는 것과 같다. 이름 붙은 묶음이 하나도 없는 분류는 소제목을 그리지 않는다. 백필도 없다 — 기존 항목은 전부 「묶음 없음」이고 그 화면은 넣기 전과 같다.
- 비고: 분류를 옮겨도 묶음 이름은 따라간다(수량과 반대다 — 수량은 짐 전용이라 우리가 정의한 값이고, 묶음은 사용자가 적은 말이다). 묶음을 옮기면 그 묶음의 맨 뒤이고, 같은 이름을 다시 보내면 자리는 그대로다(앞뒤 공백은 같은 이름으로 본다).
D-42. 응답에서 필드를 뺄 때는 두 번에 나눠 뺀다 — 옛 번들이 계속 돌기 때문 (#1361)
- 결정: 새 모양을 더해서 내리고(expand), 옛 필드는 클라이언트가 갈린 뒤에 뺀다(contract). 뺄 때는 지우는 이슈를 같은 날 연다(#1362) — 호환 코드는 지우는 이슈가 없으면 영원히 남는다.
-
근거: D-41을 내면서
groups[].items[]를 없앴더니, 배포 직후 이미 열려 있던 탭의 준비 화면이 흰 화면이 됐다(undefined.filter). 이 앱은 서비스워커가 새 버전을 사용자가 받아들여야 갈고(registerType: "prompt"), 앱 셸이 precache라 서버에서 그 청크가 404가 된 뒤에도 옛 번들은 계속 돈다. 「배포했으니 모두 새 코드」가 성립하지 않는다. -
반대 방향도 막는다:
/api/travel/*는 오프라인 조회를 위해 NetworkFirst로 캐시된다(최대 30일). 그래서 새 번들이 캐시에 남은 옛 모양 응답을 읽을 수 있다 — 기내에서 목록만 여는 바로 그 경로다. FE는 응답을 받는 자리 한 곳(fetchPrep)에서 옛 모양을 지금 모양으로 맞춘다. 컴포넌트마다?? []를 흩어 놓으면 빠뜨린 한 곳에서 흰 화면이 되고, 그게 어디인지는 배포하고 나서야 안다. - 비고: 필드를 더하는 변경은 이 규칙이 필요 없다. 옛 번들은 모르는 필드를 그냥 무시한다.
-
결정:
trip_expense테이블을 만든다. 여행 경비는 더 이상 가계부 원장 위의 읽기 뷰가 아니라 여행이 소유하는 지출 목록이다. 쓰기도 여행 BE가 받는다(POST /api/travel/trips/{id}/expenses) — FE가 다른 도메인 API로 직접 쓰러 가지 않는다. - 왜 뒤집나: D-27의 근거는 「원장은 가계부 하나뿐이다」 하나였다. 합계가 어긋난 날 어느 쪽이 맞는지 판단할 근거를 남기려고 장부를 둘로 만들지 않은 것이다. 가계부를 제거하므로 그 하나가 없어진다. 근거가 사라진 결정은 유지할 이유도 없다.
- 함께 뒤집히는 것 — D-35: 지출 행을 누르면 가계부 지출 상세로 보내던 길이 없어진다. 편집 시트를 여행 안에 둔다. 「같은 편집 화면이 둘이면 반드시 한쪽만 고치는 날이 온다」는 D-35의 걱정은 가계부 편집 화면이 사라지므로 성립하지 않는다 — 오히려 빠른 입력과 편집이 한 컴포넌트가 되어 자리가 하나로 준다.
-
유지되는 것 — D-28: 여행 예산은 계속
trip.budget_amount다. 애초에ledger_budget에 넣지 않은 판단이 여기서 값을 한다 — 이번 제거에 예산은 손댈 곳이 없다. -
FK 방향이 뒤집힌다:
ledger_transaction.trip_id는ON DELETE SET NULL이었다(「여행을 지워도 쓴 돈은 원장에 남는다」).trip_expense.trip_id는 **ON DELETE CASCADE**다 — 남을 원장이 없어졌고, 그 여행이 없으면 그 지출도 뜻이 없다. 준비 항목(trip_prep_item)과 같은 취급이 된다. - 여행 안에 가계부를 다시 짓지 않는다: 자산·잔액·이체·청구서·정기 항목은 아무것도 따라오지 않는다. 카테고리는 고정 프리셋 여섯(D-31과 같은 이유), 결제수단은 자유 텍스트 라벨, 예정은 상태 컬럼 하나이고 새 스케줄러를 만들지 않는다.
-
순서가 안전의 전부다: 이관이 끝나기 전에
ledger_transaction을 지우면 여행 지출 기록이 같이 사라진다. 그래서 경비 독립이 제거 작업의 0단계다. - 명세: Travel-Expense-Standalone
- Java용 Web Push(RFC 8291) 구현체는 대개 BouncyCastle에 의존한다. Java 25 / Spring Boot 4.0.7 조합에서의 동작을 검증하지 않았다.
- 대안: ① 검증된 서드파티 라이브러리 ② VAPID JWT(ES256)를
java.security로 직접 서명 + 페이로드 암호화만 최소 구현 ③ 페이로드 없는 푸시(알림 내용을 SW가 API로 가져오기 — 암호화 부담 제거, 오프라인 시 실패) - 9/15 전에 스파이크로 결론낸다. 여기서 막히면 3단계 전체가 밀린다.
-
@Scheduled폴링은 replica 1 전제다(HolidayScheduler선례와 동일). HPA·수동 스케일로 replica가 2 이상이 되면 알림이 중복 발송된다. - 대응: 지금은 replica 1을 유지하고, 스케일이 필요해지면
UPDATE … SET status='SENDING' WHERE status='PENDING'의 조건부 UPDATE 락으로 전환한다. 배포 시점에 replica 수를 확인한다.
- SW는 오리진 전체에 걸린다. 여행만 PWA로 만들 수 없다 — 일상 화면도 SW 아래로 들어간다.
- 리스크: 배포 후 stale 캐시로 구버전 화면이 뜨는 것. 대응 — precache 대상을 앱 셸로 한정,
skipWaiting+ 새 버전 감지 시 새로고침 유도, API 응답은 NetworkFirst(캐시 우선 아님). - 3단계에 SW를 세우므로 일상 회귀 테스트를 그때 함께 돌린다.
- 단일 사용자·저볼륨이라 무료 티어 안에 들어갈 가능성이 높지만 보장은 없다.
- 방어: 전 호출 BE 프록시 + Redis 캐시, 장소 영구 저장, 사진 MinIO 캐시, 일별 호출 상한(초과 시 폴백), Google Cloud 예산 알림.
-
실측 후 비용이 문제가 되면 이동시간을 직선거리 추정으로 완전 전환한다.#1208에서 Routes를 통째로 걷어내 이 리스크가 없어졌다 — 직선거리로 내려간 게 아니라 사용자 입력으로 올라갔다.
- dnd-kit(기존 의존성)으로 구현하고 Playwright real mouse/touch로 전 경로 검증. 그 과정에서 버그 2개를 잡았다 — ① 모드 진입 직후 첫 탭이 삼켜지는 문제(진입은
useLongPress, 정렬은 모드 안에서만useSortable로 분리) ② 날짜 탭 드롭 실패(pointerWithin우선 판정 + 탭을 항상 드롭 대상으로 등록). - 남은 것은 Android 실기기 확인 하나뿐이다. v2.1에서 이 구조를 바꾸지 않는다.
원문
- §5.1이 지목한 1번 위험. 400ms 롱프레스 → 드래그 → 날짜 탭 드롭이 실기기(Android Chrome)에서 자연스러운지가 1단계 안에 결론나야 한다.
- 새 dnd 라이브러리를 넣기 전에 pointer 이벤트로 먼저 검증한다. PM/드래그 계열은 유닛 테스트로 안 잡히므로 Playwright real mouse drag + 실기기 확인을 함께 한다.
- 명세 §2.5는 HEIC를 허용 형식에 넣었지만, 브라우저 canvas는 HEIC를 디코드하지 못한다(Safari 제외). 썸네일 생성·EXIF 제거가 canvas 재인코딩에 의존하므로 HEIC는 실질적으로 처리 불가다.
- 타깃이 Android Chrome이라 실사용상 거의 안 들어온다. 디코드 실패 시 "지원하지 않는 형식" 안내로 처리하고, 필요해지면 BE 변환을 검토한다.
- §S-03의 "타임존과 통화가 자동 지정됐어요"를 무엇으로 구현할지 미확정. 후보 — Google Time Zone API(과금), 좌표→IANA 오프라인 데이터셋, 국가코드→통화 정적 매핑.
- 2단계 착수 시 결정. 1단계는 수동 Select이므로 블로커가 아니다(D-7).
R-8. 여행 기록 vs 일상기록(Lifelog)의 개념 중복 → 종결 (D-19)
- A안(중복 감수)으로 확정. 10/24 실사용 후 재검토한다.
원문
- Lifelog의 **Flow(흐름)**는 "제주 여행"처럼 여행을 묶는 것을 예시로 들고 있다. 여행 모듈의 기록(평점·메모·사진)과 겹쳐 보인다.
- 현재 정리: 여행 = 계획하고 따라가는 도구(사전), 일상기록 = 겪은 것을 남기고 다시 읽는 도구(사후). 여행의 기록은 "그 일정이 어땠나"에 한정되고, 서사화·지도 흐름은 일상기록의 몫이다.
- 10/24 실사용 후 두 기록이 실제로 중복되는지 관찰한다. 중복이 확인되면 여행 기록 → Lifelog Moment 승격(또는 연결)을 검토한다. 지금은 합치지 않는다 — 마감이 박힌 상태에서 도메인을 엮으면 양쪽이 다 늦어진다.
- 이 모듈은 orino에서 처음으로 **외부 마감(10/24 출발)**이 있는 작업이다. §5.2의 잘라낼 순서가 이미 정해져 있으므로, 밀릴 때 협상하지 말고 위에서부터 뺀다.
- 절대 빼지 않는 것: 일정 CRUD · 드래그 정렬 · 장소 검색 · 오프라인 조회 · 타임존 · 일정 알림 · 구글 지도 딥링크.
- v2.1은 신규 기능이 아니라 완성된 v2.0 위의 재설계다.
trip.timezone을 읽는 모든 지점(상태·D-day·알림·날씨·환율·보드 헤더)을 빠짐없이 바꿔야 하고, 하나라도 남으면 그 화면만 조용히 틀린다. 테스트가 잡아주지 않는 종류의 오류다. - 대응: 스키마에서
trip.timezone을 삭제한다(NULL 허용으로 남겨두지 않는다). 컴파일이 깨지는 곳이 곧 고쳐야 할 목록이다.
- 여행 1건에 1회였던 Open-Meteo 호출이 도시 6개면 6회가 된다. 무료지만 rate limit이 있고, 날짜 단위로 캐시하면 10일 × 6도시 = 60회가 된다.
- 대응: 캐시 키를
(도시, 날짜)가 아니라 도시로 잡고, 서버가 도시별로 한 번씩 부른 뒤 날짜에 펼쳐 내린다. 6시간 TTL.
- 도시를 바꾸면 알림 재계산·날씨 재조회가 따라와야 한다. 하나라도 빠지면 화면은 새 도시를 보여주는데 알림은 옛 시각에 온다. (#1208 이후 이동은 장소 쌍에 붙어 있어 무효화할 것이 없다)
- 대응: 연쇄를 서비스 한 곳(
BaseCityChangeService)에 모으고, 통합 테스트로 "도시 변경 → PENDING 알림의scheduled_at이 바뀐다"를 직접 검증한다.
- v2.0의 미완 항목(Epic #1029)이 v2.1로 넘어온다. v2.1은 발송 시각 계산식을 바꾸므로 v2.1 4단계 이후에 다시 검증해야 한다.
- 도시가 바뀌는 날의 아침 요약(전날 08:00)은 실제로 하루를 기다려야 확인된다. 리허설(10/6~) 안에 반드시 포함한다.
- 경비 화면은 만들었는데 가계부 쪽
excludeTrip·「여행」 필터·「여행에 붙이기」가 없으면, 여행 지출이 평상시 통계에 섞인 채로 10월 통계가 나온다. 그러면 「이번 달 왜 이렇게 썼지」에 답이 안 나온다. - 대응: 가계부 쪽 변경(
tripId파라미터 · 월 예산 한 줄 · 붙이기)을 경비 화면과 같은 PR 묶음에 넣는다. 화면만 먼저 내지 않는다.
- 기간으로 걸러 일괄 선택하는 UI라, 여행 기간에 낀 카드값 납부·통신비까지 함께 선택될 수 있다. 한 번 붙으면 총액이 두 배로 보인다(§4.2가 막으려던 바로 그 오류).
- 대응:
TRANSFER는 기본 미선택 + 「— 여행 경비가 아니에요」 표시, 조회 단계에서 아예 제외(합계에서만 빼면 목록에는 보이고 합계에는 없는 줄이 생겨 더 헷갈린다). 완료 판정 5번이 이것을 직접 검사한다.
- 완료 판정 2번은 「원화 합계가 카드 청구서와 3% 안에서 맞았다」인데, ECB 고시로 굳힌 값과 카드사 적용 환율은 다르다. 게다가
EcbRatesClient는 최신 고시표 한 벌만 준다 — 과거 날짜의 고시를 못 가져온다(#1259). - 대응: 이미 있는 경로를 쓴다 — 거래 수정으로 환율만 고쳐 쓰기(가계부 §11.1). 청구서가 도착한 뒤 몇 건을 고치는 것으로 3%를 맞춘다. 새 유료 환율 API를 들이지 않는다.
- v2.2는 준비(독립) → 경비(가계부 의존) 순이다(§16). 준비가 밀리면 경비는 그만큼 뒤로 밀리고, 경비는 자르기 목록의 마지막 항목이다.
- 대응: 밀리면 §17 순서대로 위에서부터 뺀다. 경비 전체가 빠져도 §18의 길(여행 중엔 가계부에 그냥 적고, 돌아와 기간으로 걸러 붙인다)이 남도록 「여행에 붙이기」를 경비 첫 묶음에 넣는다 — 이 하나가 있으면 「다녀와서 얼마 들었나」는 답이 나온다.
- 지금 「일정 보드」 항목 하나가 보드·지도·일정 상세를
matchPath로 대표한다. 트리로 바뀌면 그 판정이 여행 id별로 갈라지고, 도구·설정은 구분선 아래로 내려간다. 활성 표시가 틀려도 화면은 열리므로 테스트가 조용히 지나갈 수 있다. - 대응: 사이드바를 지나가는 스펙이 여럿이라 E2E는 전체로 돌린다(바꾼 화면 이름으로 골라 돌리면 놓친다). 활성 판정은 경로별 단위 테스트로 못 박는다 — 보드·지도·일정 상세·준비·경비 각각이 어느 여행의 어느 자식을 활성으로 만드는지.
- ✅ 닫힘(#1352). 경로별 활성 판정 단위 테스트 5건을 넣었고 E2E 전체를 돌렸다. 일정 상세(
/travel/activities/:id)는 URL에 여행 id가 없어 기본 여행의 「일정 보드」로 친다 — 여기서 아무것도 안 켜면 상세를 보는 동안 트리가 어느 탭도 가리키지 않는다.
여행을 실제로 한 번 다녀와야만 닫히는 항목들이다. 추적하던 이슈(#1160 · Epic #1148)는 닫았다 — 열어 두어도 아무도 손댈 수 없고, 열린 이슈가 쌓이면 진짜 할 일이 묻힌다. 대신 없어지면 안 되는 것만 여기 남긴다.
#1151이 건 메서드별 일일 할당량은 실측의 100배 이상 여유를 둔 임시값이다(infra/terraform/gcp-quota.tf). 상한으로서 의미가 있으려면 「정상 사용이면 절대 안 닿고, 폭주면 걸리는」 지점에 있어야 하는데, 그 지점은 정상 사용이 몇 호출인지를 알아야 정해진다.
- 지금 상태로도 안전 장치는 산다 — 폭주(무한 루프·키 유출)는 걸린다. 못 잡는 것은 「완만한 초과」뿐이다
- 되재는 데 필요한 것은 갖춰져 있다: 호출 계측(#1158) · BigQuery 실단가(#1157) · 초과 시 graceful degradation(#1159)
-
재착수 조건: 실제 여행 일정을 한 번 전부 입력한다 → #1158 메트릭으로 API별 호출 수·캐시 히트율을 읽는다 →
여행 1회 비용 = Σ(miss 호출 수 × BigQuery 실단가)→ 새 캡 = 일일 최대 호출 × 3~5배 - 추정 단가를 쓰지 않는다. Maps Platform은 SKU 등급별로 단가가 크게 달라, 기억이나 블로그 값을 쓰면 자릿수가 틀린다
한시 설정을 추적하던 이슈를 닫으면 그 설정은 잊힌다(#1211이 2일 초과로 남아 있던 것이 같은 모양이었다). 그래서 이슈가 아니라 문서에 남긴다.
위 R-13과 같은 항목이다. 도시가 바뀌는 날의 아침 요약(전날 08:00)은 실제로 하루를 기다려야 확인된다.