Repository navigation
Travel UI Design
확정 명세 v2.2 · v2.1 · v2.0 · 유스케이스 · 아키텍처 · API 설계 · 결정 기록
이 페이지는 디자인 핸드오프의 명세를 흡수한 것이다. 프로토타입 파일은 로컬 산출물이라 여기에 옮겨 보존한다. 수치는 전부 기존 Tailwind 유틸리티/토큰으로 표현 가능한 값이며, 새로 만들 CSS·색·간격은 없다.
판 프로토타입 상태 v2.0 Orino Travel.dc.html(2026-08-07, 단일 도시)구현 완료 v2.1 Orino Travel v2.dc.html(2026-08-09, 다구간)구현 완료 v2.2 여행 경비·준비.dc.html(2026-09-05, 경비 · 준비)구현 기준
- 프로토타입은 레퍼런스다. 인라인 스타일을 그대로 옮기지 않는다. 마크업은
src/components/ui의 컴포넌트로 조립하고, 픽셀만 프로토타입에 맞춘다. -
새 디자인 토큰 없음. 전부
fe/src/index.css의@theme/:root/.dark에 이미 있다. 임의 hex 금지(FlowMap의#8b00ff는 예외적 레거시 — 따라하지 않는다). - 아이콘은
lucide-react만. 프로토타입의l-icon커스텀 엘리먼트·lucide-icon.js는 디자인 파일 전용 셔틀이므로 구현에 쓰지 않는다. - 로고는
components/brand/Logo.tsx(Logo/BrandMark/Wordmark) 그대로. 좌표·색 변경 금지, 어두운 배경은tone="inverse". - 뷰포트는 기존
AppLayout반응형. 모바일 프레임을 따로 만들지 않는다.
AppLayout.tsx는 변경 없다.
- 헤더:
flex items-center justify-between border-b px-6 py-3- 좌: (md 미만만)
Button variant=ghost size=icon-sm+Menu16 →<Logo size={22} /> - 우: 테마 토글
Button ghost icon-sm(Sun/Moon 16),Button ghost size=sm+LogOut14 + "로그아웃"
- 좌: (md 미만만)
- 본문:
flex flex-1→Sidebar+main.min-w-0.flex-1.p-4.md:p-6
기존: w-56 shrink-0 border-r, 모바일은 fixed inset-y-0 left-0 z-50 + -translate-x-full, 스크림 bg-foreground/40 z-40.
추가 (<ul> 위, p-2 pb-0):
- 컨테이너:
flex gap-0.5 rounded-lg bg-muted p-1 - 버튼 2개:
flex-1 h-7 rounded-md text-[13px] font-medium inline-flex items-center justify-center gap-1.5- 활성
bg-background text-foreground shadow-sm/ 비활성text-muted-foreground - 여행 =
Plane14 · 일상 =LayoutGrid14
- 활성
- 클릭 시 이동: 여행 →
/travel(진행 중 여행 있으면 그 보드), 일상 →/home. 모바일은 시트가 닫힌다.
NAV_ITEMS 분기 — pathname.startsWith("/travel")이면 여행 목록, 아니면 기존 일상 목록.
| 워크스페이스 | 항목 (icon) |
|---|---|
| 일상 | 홈(Home) · 학습 자료(BookOpen) · 노트(FileText) · 일상기록(Camera) · 복습(CheckSquare, 배지) · 플래너(CalendarDays) · 연동 설정(Settings) |
| 여행 | 홈(Home) · 여행 목록(Plane) · 일정 보드(CalendarDays) · 도구(Wrench) · 설정(Settings) |
항목 스타일은 기존 그대로: h-9 rounded-md px-3 text-sm font-medium, 활성 bg-primary/10 text-primary, 비활성 text-foreground/70 hover:bg-muted hover:text-foreground. 여행의 activePaths — 일정 보드는 /travel/trips/:id/board|map과 상세(/travel/activities/:id)까지 활성으로 본다.
기존 화면 그대로. navigate("/select")만 바뀐다. (Card w-full max-w-[360px], CardHeader text-center + Logo size={32}, Label text-xs, Input, Button mt-1 w-full)
- 자체 헤더(AppLayout 헤더와 동일 마크업: Logo 22 + 테마 토글 + 로그아웃). 사이드바 없음.
- 본문:
flex-1 grid place-items-center px-4 pt-8 pb-16→w-full max-w-[680px] flex flex-col gap-6 - 제목
text-title font-semibold"어디로 갈까요" + 설명text-sm text-muted-foreground"사이드바 맨 위에서 언제든 바꿀 수 있어요." - 카드 2개:
flex flex-wrap gap-4, 각flex-1 basis-[260px]-
Card를 버튼으로:rounded-xl bg-card p-5 ring-1 ring-foreground/10 text-left flex flex-col gap-3.5 - hover:
ring-primary+-translate-y-px(transition 150ms) - 상단 행: 아이콘 타일
size-10 rounded-lg grid place-items-center(여행bg-accent text-accent-foreground+Plane20 / 일상bg-muted+LayoutGrid20) + 우측Badge variant=secondary - 제목
text-heading font-medium/ 설명text-[13px] text-muted-foreground/ 하단 메타text-[13px]+ 아이콘 14
-
| 카드 | 배지 | 설명 | 메타 |
|---|---|---|---|
| 여행 |
D-78 (다음 여행 D-day, 진행 중이면 진행 중) |
일정 보드, 지도, 알림, 환율·날씨 |
CalendarDays + "도쿄 3박 4일 · 10.24 – 10.27" |
| 일상 |
복습 3 (미완료 복습 건수) |
학습 자료, 노트, 일상기록, 복습, 플래너 |
Camera + "어제 기록 2개 · 오늘 루틴 5개" |
배지·메타는 실데이터다. 여행은
GET /api/travel/summary, 일상은useReviewSummary().counts.now+ 오늘 루틴 수. 데이터가 없으면 배지 없이 "여행 만들기" 문구, 메타 줄은 숨긴다(더미 텍스트 금지). 여행 카드를 누르면 진행 중 여행이 있을 때/travel/trips/:id/board, 없으면/travel(§1.9).
max-w-[720px] flex flex-col gap-6-
PageHeader title="여행" description="진행 중인 여행이 없어요. 다음 여행까지 78일."(진행 중이면 description에 진행 중 여행 제목) -
다음 여행 Card
- Header:
Badge variant=info(예정)/success(진행 중), 제목text-heading font-medium,text-sm text-muted-foreground"10월 24일 – 10월 27일 · 일정 13개" - 우측: D-day
text-display font-semibold tabular-nums text-primary+text-caption text-muted-foreground"Asia/Tokyo · JPY" - Content: 일자 칩 가로 스크롤 —
min-w-[84px] rounded-lg border px-2.5 py-2, 1행text-caption text-muted-foreground"1일차 · 금", 2행 아이콘 13 +15/8°. 예보 범위 밖이면예보 밖 - Footer:
Button(CalendarDays) "일정 보드 열기" +Button variant=outline(Plus) "여행 만들기"
- Header:
-
최근 완료:
text-caption font-semibold text-muted-foreground"최근 완료" + 카드 행(제목text-[15px], 메타text-[13px], 우측ChevronRight16) → 완료 여행 보드(기록 모드) -
여행 없음:
EmptyState+ "여행 만들기" 단일 버튼
PageHeader title="여행 목록" actions={<Button><Plus/>여행 만들기</Button>}- 탭:
Tabs(예정/진행 중/완료) — 각 라벨 뒤 건수opacity-60 tabular-nums - 정렬 안내
text-caption text-muted-foreground: 예정·진행 중 "시작일 오름차순", 완료 "종료일 내림차순" - 카드 행:
rounded-xl bg-card p-4 ring-1 ring-foreground/10, 제목text-[15px] font-medium, 메타 한 줄text-[13px] text-muted-foreground="{목적지} · {기간} · 일정 {n}개"(한 문자열로 만들어 "6 / 개" 줄바꿈 방지), 우측ChevronRight - 빈 탭:
EmptyState+ "여행 만들기"
max-w-[560px](v2.0은 520), 헤더는 Button ghost icon-sm(ArrowLeft) + text-heading font-semibold.
입력 순서: 제목 → 기간 → 구간 → 타임존 안내 → 기본 알림 시점
-
제목
Input— 필수. 자동 기본값을 넣지 않는다(v2.0의 "목적지명으로 채움"은 폐기) -
시작일 / 종료일
Input type="date"2개flex gap-3(각flex-1) -
구간 — 아래 구간 행 목록 +
+ 구간 추가(border-dashed) + 합계 바 -
타임존 안내
Alert variant="info" -
기본 알림 시점
Select(5/10/15/30분 전, 1시간 전 — 기본 15) - 하단 우측:
Button ghost취소 +Button만들기
구간 행 grid grid-cols-[26px_1fr_auto_auto] items-center gap-2 rounded-lg border bg-card px-2.5 py-2
| 열 | 내용 |
|---|---|
| 번호 | size-[22px] rounded-full bg-muted text-xs font-semibold tabular-nums |
| 도시 | 버튼 text-[15px] font-medium + ChevronDown 13 → 도시 선택 시트. 아래 자동 계산된 날짜 범위 text-xs text-muted-foreground tabular-nums
|
| 일수 | 스테퍼 Minus / 3일 / Plus (ghost icon-sm) |
| 순서·삭제 |
ChevronUp/ChevronDown + Trash2 (실기기는 드래그도 지원) |
합계 바 — 합계 10일 / 기간 10일 + 판정
| 상태 | 표시 |
|---|---|
| 일치 |
bg-muted + Check + "딱 맞아요" |
| 초과 |
bg-warning/16 + Info + "N일 초과 · 뒤 구간이 잘려요" |
| 부족 |
bg-warning/16 + Info + "N일 남음 · 마지막 구간 도시를 이어써요" |
저장을 막지 않는다. 남는 날짜는 마지막 구간 도시를 상속한다.
타임존 안내 Alert — 타임존이 2개 이상이면 제목 "타임존이 N개예요", 아니면 "타임존과 통화는 날짜마다 정해져요".
설명: Asia/Tokyo / JPY — 각 날짜의 기준 도시에서 자동으로 파생되고, 일정 시각은 그 도시의 벽시계 시각으로 표시됩니다.
Alert의 아이콘은 직계
<svg>여야 한다. DS가&>svg로 배치하므로 래퍼로 감싸면 아이콘이 텍스트와 겹친다.
기간 단축 확인 — 종료일을 앞으로 당기면 ConfirmDialog
- title "기간을 줄이면 일정이 이동합니다"
- description (v2.1) "잘리는 날짜의 일정 {n}개가 미배정 보관함으로 이동하고, 걸쳐 있던 숙소는 기간이 줄어듭니다."
- confirmLabel "이동하고 저장" (destructive 아님 — 일정은 사라지지 않는다)
max-w-[720px] flex flex-col gap-3
헤더
- 좌:
ArrowLeftghost icon-sm + (제목text-heading font-semibold truncate, 아래text-caption text-muted-foreground)-
v2.1 부제에 그날 도시가 들어간다 — 진행 중 오늘
현지 09:42 · 교토 · Asia/Tokyo · JPY/ 그 외교토 · Asia/Tokyo · JPY/ 보관함미배정 보관함/ 완료 여행기록 모드 · Asia/Tokyo - 기기 타임존과 오프셋이 0이면 시각 부분만 숨긴다(도시·타임존은 남긴다)
-
v2.1 부제에 그날 도시가 들어간다 — 진행 중 오늘
- 우: ghost icon-sm 3개 —
Map16(지도, 오프라인 시 disabled) ·Wrench16(도구) ·MoreVertical16(Menu— 기준 도시 변경(v2.1) / 다른 날짜와 교체(#1368) / 구간 수정 / 알림 설정 / 여행 삭제(destructive))
오프라인 배너 (헤더 바로 아래): flex items-center gap-2 rounded-lg bg-muted px-3 py-2 text-[13px] text-muted-foreground + WifiOff 14 + "오프라인 · 일정 조회만 가능합니다"
날짜 탭 — flex gap-1.5 overflow-x-auto
- 칩:
rounded-lg px-2.5 py-[7px] flex flex-col gap-0.5 items-start- 활성
bg-accent text-accent-foreground border border-primary/ 비활성bg-card border border-border - 1행 (v2.1)
N 도시명text-[13px] font-semibold truncate max-w-[110px], 칩min-w-[92px]-
전 기간 도시가 하나면 도시명을 숨기고
N일차(min-w-[78px]) — 완료된 단일 도시 여행이 이 경로다 - 보관함 칩은 앞에
Archive13
-
전 기간 도시가 하나면 도시명을 숨기고
- 2행
text-[11px] text-muted-foreground=10.24 금(보관함은3개) - 3행
text-[11px] tabular-nums날씨 아이콘 12 +15/8°- 강수확률 60% 이상이면 아이콘을
Umbrella로 바꾸고text-warning - 예보 없으면 3행 비움
- 강수확률 60% 이상이면 아이콘을
- 활성
-
(v2.1) 도시가 바뀌는 탭 왼쪽에 세로 구분선
w-px bg-border my-1 -
(v2.1) 칩을 450ms 길게 누르면 기준 도시 변경 시트가 열린다
- 일정 행의 드래그 진입은 400ms다. 탭과 행은 서로 다른 제스처 대상이라 충돌하지 않는다
- 도시를 바꿔도 이미 담긴 일정의 장소는 그대로 남고 경고를 띄우지 않는다
- 진행 중 여행은 오늘 탭이 기본 선택. 마지막 탭은 항상 보관함
(v2.1) 도시 메모 — 있을 때만, 탭 아래 flex items-center gap-2 rounded-lg bg-muted px-3 py-2 text-[13px] + StickyNote 14
(v2.1) 숙소 배지 — 리스트 위
| 상황 | 표시 |
|---|---|
| 오늘 체크아웃하는 숙소가 있다 |
Hotel + 도톤보리 호텔 · 오늘 체크아웃 11:00
|
| 없고 오늘 밤 숙소가 있다 |
Hotel + 교토 게스트하우스 (체크인일이면 · 오늘 체크인 15:00) |
| 둘 다 없다 |
+ 숙소 추가 (border-dashed) |
탭하면 숙소 상세 시트(§9.6). 체크아웃 숙소를 우선 보여주는 이유는 아침에 먼저 필요한 정보이기 때문이다.
일정 행 — grid grid-cols-[52px_1fr_auto] items-start gap-2 rounded-lg px-2 py-2.5 hover:bg-muted
- 시각
text-sm tabular-nums pt-px, 없으면──+text-muted-foreground - 본문: 제목
text-[15px] leading-[1.4], 장소 있으면 아래text-xs text-muted-foreground+MapPin11- (v2.1) 장소명이 제목과 같으면 장소 줄을 숨긴다 (같은 문자열을 두 번 읽히지 않는다)
-
(v2.1) 그날 기준 도시와 다른 도시의 장소면 뒤에
· 오사카를text-warning으로 붙인다. 막지는 않는다 — 사용자의 선택이다
- 우측: 알림 설정 시
Bell14text-primary, 기록 있으면Star14 muted, 그리고 액션Button ghost icon-sm—Archive15(보관함으로) /Trash215(삭제)- 모바일 스와이프(좌=삭제, 우=보관함)와 같은 동작을 데스크톱에 노출한 것. 터치에서는 스와이프도 함께 지원
- 오프라인이면 액션 숨김
이동 행(MoveRow, #1208) — 장소가 있는 연속된 두 일정 사이에. ml-[52px] flex items-center gap-1.5 rounded-md px-2 py-0.5 text-xs hover:bg-muted
-
적어 둔 이동: 수단 아이콘 13 +
나리타 익스프레스 3호 · 53분+ (링크 있으면Link212) +ChevronRight12 → 탭 시 이동 편집 시트-
이름이 분류보다 앞에 온다. 현지에서 찾아야 하는 것은
기차가 아니라나리타 익스프레스 3호다. 분류는 아이콘이 이미 말한다 - 이름을 안 적었으면 분류 이름으로 대신한다 —
지하철 · 전철 · 18분 - 시간을 안 적었으면 지어내지 않고 수단만 —
지하철 · 전철
-
이름이 분류보다 앞에 온다. 현지에서 찾아야 하는 것은
-
아직 안 적은 구간:
Plus13 +이동 추가(text-muted-foreground/70)- 행을 없애지 않는다. 그 자리가 곧 입력 지점이라, 값이 없다고 빼면 어디를 눌러야 이동을 적는지 알 수 없다
- 적어 둔 이동은 계획의 일부라 또렷하게, 빈 자리는 안내라 흐리게 읽힌다
-
도시 경계에 따라 갈리지 않는다. v2.1의
도시 이동갈래는 없어졌다 — 신칸센·비행기 구간도 똑같이 적는 자리다 - 마지막 일정 → 숙소 이동도 같은 행이다(
border-t pt-2.5). 빈 값이면Hotel13 +숙소로 이동 추가 - 오프라인이면 캐시값
opacity-60, 클릭 비활성 — 고쳐서 보낼 수 없다 - 사이에 장소 없는 일정이 끼면 건너뛰고 잇는다
(v2.1) 숙소 이동 — 리스트 맨 아래, border-t pt-2.5
- 같은 도시:
🚶 숙소까지 8분(계산함) - 다른 도시:
🚄 숙소로 이동(계산하지 않는다) - 그 아래 오늘 밤 숙소 배지 — 상단 배지와 다를 때만(= 이동일). 같으면 중복이라 그리지 않는다
추가 버튼 — 리스트 아래 flex justify-center py-2 pb-6, Button variant=outline size=icon-lg + Plus 18. 오프라인·드래그 모드에서는 숨김
드래그 모드 — 행을 400ms 길게 누르면 진입(+ navigator.vibrate(10))
- 진입 시 각 행 우측이
ChevronUp/ChevronDown/GripVertical로 교체 - 드래그 중인 행:
bg-card ring-2 ring-primary shadow-lg scale-[1.01] - 하단 안내 바:
rounded-lg border border-dashed border-primary px-3 py-2 text-[13px] text-primary"드래그 모드 · 순서를 바꾸면 이동과 알림을 다시 잡아요" +Button ghost sm완료 - 순서 변경·날짜 이동 후 스낵바 "순서 변경 · 이동과 알림을 다시 잡았어요"
- 적어 둔 이동은 사라지지 않는다. 장소 쌍에 붙어 있어 순서를 되돌리면 그대로 돌아온다(#1208)
- ✅ 구현 완료 (#1048). dnd-kit(이미 리포 의존성)으로 만들었고, 모드 진입은 자체
useLongPress(400ms), 정렬은useSortable({ disabled: !dragMode })로 모드 안에서만 켠다. 충돌 판정은pointerWithin우선 →closestCenter. v2.1에서 이 구조를 바꾸지 않는다
(v2.1) 보관함 탭 — 도시별 그룹
- 그룹 헤더
flex items-center gap-1.5 text-caption font-semibold text-muted-foreground+MapPin12 + 도시명 - 그룹 순서는 구간 순서. 여행 도시에 없으면
기타, 장소가 없으면도시 없음을 맨 뒤에 - 행 우측
CalendarPlus(날짜에 담기) ·Trash2 - 날짜에 담기 시트는 그 장소의 도시가 기준 도시인 날짜를 위로 정렬한다
빈 상태 — EmptyState className="min-h-[30svh]" + Button variant=outline(Search) "장소 검색"
- 일정 없는 날짜: "일정이 없어요" / 빈 보관함: "가고 싶은 곳을 미리 담아두세요"
구현은 Google Maps JS다 — D-17. Places 데이터를 비구글 지도에 표시하는 것은 약관 위반(§No Use With Non-Google Maps)이라 leaflet·OSM·CARTO 타일을 쓰지 않는다. 아래 leaflet/OSM 서술은 v2.0 초안의 잔재이며 실제 구현(
features/travel/map/googleMaps.ts)이 정본이다. 일상기록FlowMap은 leaflet 그대로 둔다(구글 데이터를 쓰지 않으므로).
(v2.1) 이 날짜 / 전체 토글 — 헤더 우측 flex gap-0.5 rounded-lg bg-muted p-[3px] 세그먼트. 기본값 이 날짜, 상태는 URL ?mode=day|all이 소유한다. ✅ 구현 완료(#1144)
-
모드를 바꿔도 보던 날짜(
?day=)는 그대로 둔다 —이 날짜로 돌아왔을 때 그 날짜여야 한다 -
전체를 보지 않는 동안에는/city-legs를 부르지 않는다
| 모드 | 내용 | 카드 |
|---|---|---|
이 날짜 |
선택 날짜의 장소 있는 일정만, 순번 마커 + 직선 연결 | 시각 · 도시 / 제목 / 주소 + 일정 열기
|
전체 |
구간 순서로 도시를 연결. 마커는 도시당 1개(같은 도시가 여러 구간이면 첫 방문 구간 번호) |
3일 · 구간 1 / 도시명 / 10.24 – 10.26 · Asia/Tokyo + 첫날 열기
|
전체 모드는 지도 아래 구간 리스트(① 오사카 3일 · 10.24–10.26)를 함께 그린다. 행을 탭하면 그 구간 첫날 보드로 간다.
리스트는 마커처럼 접지 않는다. 마커는 도시당 하나지만 구간 리스트는 구간마다 한 줄이다 — 도쿄 → 닛코 → 도쿄면 점은 둘, 줄은 셋이다. 며칠씩 어디에 머무는지는 구간별 사실이라 접으면 사라진다.
연결선도 구간 순서 그대로다. 마커를 따라 이으면 닛코에 갔다 온 자취가 선에서 사라진다.
겹치는 마커(오사카·교토처럼 가까운 도시)는 전국 줌에서 뭉친다. 좌표를 조작해 벌리지 않는다 — 클러스터링이나 줌으로 푼다. 프로토타입이 살짝 벌려 놓은 것은 그림이라서 가능한 것이다.
- 헤더: ArrowLeft + (
{n}일차 동선/장소가 있는 일정 3개 · 직선 연결) + 우측List16(리스트 전환) - 지도 컨테이너:
w-full aspect-[8/5] rounded-lg border overflow-hidden - 마커:
size-[26px] rounded-full bg-primary text-primary-foreground border-2 border-card text-xs font-semibold grid place-items-center+shadow- 번호는 지도 표시 순서 기준 1부터 다시 매긴다(리스트 순번과 다를 수 있음)
- 선택된 마커
scale-125 - 핀 색은
var(--primary)토큰
- 연결선:
Polyline직선,stroke var(--primary), weight 3,vector-effect: non-scaling-stroke - 자동 줌:
fitBounds, 여백 10% - 마커 탭 → 하단 카드:
rounded-xl border bg-card px-3.5 py-3 flex items-center gap-3— 번호 뱃지 + (시각text-xs tabular-nums muted/ 제목text-[15px] font-medium/ 주소text-xs muted) +Button variant=outline size=sm"일정 열기" - 오프라인:
EmptyState+WifiOff24 + "오프라인에서는 지도를 볼 수 없어요." +Button variant=outline(List) "리스트로 전환" -
이 날짜의 표시 범위는 선택한 날짜만 -
타일 attribution을 우리가 그리지 않는다. 구글 지도 SDK가 자기 표기를 직접 넣는다 —
© OpenStreetMap을 붙이라던 서술은 leaflet/OSM을 전제한 v2.0 초안의 잔재이고, D-17 이후로는 틀린 지시다(쓰지도 않는 타일의 출처를 표기하게 된다). 지도 없이 Places 데이터만 나열하는 화면(S-06)에만GoogleAttribution을 직접 붙인다
- 헤더: ArrowLeft +
Search16 +Inputplaceholder (v2.1){기준도시} 주변 장소 검색 -
(v2.1) 기준 도시 칩 —
검색 기준라벨 +rounded-full border border-primary bg-accent px-2.5 py-1 text-[13px] font-medium+MapPin13 + 도시명 +ChevronDown13. ✅ 구현 완료(#1145)- 검색 편향 좌표는 직전에 보던 날짜의 기준 도시. 칩을 탭하면 여행 안 다른 도시로 바꾼다
- 보드가
?city=로 들고 온다. 검색 화면의 보드 조회는 날짜를 지정하지 않아 서버 기본값(오늘 또는 1일차)이 오므로, 들고 오지 않으면 교토 날짜를 보다 들어와도 첫날 도시로 편향된다
- 보드가
- 상태는 URL
?city=가 소유한다 (새로고침·뒤로가기에서 살아남아야 한다).?q=와 한 주소에 같이 살므로 한쪽을 바꿀 때 다른 쪽을 지우지 않는다 - 도시가 하나뿐인 여행에서는 고를 것이 없어 누를 수 없다. 칩 자체는 남긴다 — 무엇을 기준으로 찾는지는 여전히 정보다
- 보드 응답이 오기 전에는 검색하지 않는다. 기준 도시를 모르는 채로 부르면 편향 없는 결과를 한 번 보여줬다가 다시 부르게 된다 — 틀린 결과에 호출당 과금까지 두 배다
- 검색 편향 좌표는 직전에 보던 날짜의 기준 도시. 칩을 탭하면 여행 안 다른 도시로 바꾼다
-
(v2.1) 담기 시트 — 날짜 항목에 도시명을 붙이고(
3일차 · 교토/10.26 일), 그 장소의 도시가 기준 도시인 날짜를 위로 정렬한다- 이 화면에서 그 장소의 도시는 곧 기준 도시 칩이다(#1145). 칩이 붙기 전에는 정렬 기준이 없어 보드 순서 그대로였다
- 최근 검색어 5개(쿼리 비었을 때만): 칩
rounded-full border bg-card px-2.5 py-1 text-[13px]+Clock12 - 결과 카드(20개):
flex items-center gap-3 rounded-xl border bg-card p-2.5-
사진— 장소 사진은 미도입(D-16, #1117). 자리를 비우고 이름부터 시작한다size-16 - 이름
text-[15px] font-medium -
text-xs muted:{카테고리} · ★ {평점}/ 주소truncate - 우측
Button variant=outline size=sm"담기" → 날짜 선택 시트 -
저장하면 담은 날짜의 탭으로 돌아간다(
?day=<인덱스>, 보관함이면?day=archive— #1434). 검색 화면은 기록에서 바꿔 끼운다(보드에서 뒤로 가면 검색으로 다시 들어오지 않는다). 날짜 없이/board로 보내면 서버 기본값(오늘 또는 1일차)이 열려 방금 담은 일정이 보이지 않았다 - 헤더의 뒤로 가기는 들어오기 전 보던 날짜(
?date=)의 탭으로 돌아간다
-
- 결과 없음:
EmptyState"검색 결과가 없어요." +Button variant=outline(Pencil) "직접 입력" -
교체 모드
?replace={일정id}— S-07 "장소 변경/장소 추가"가 데려온다. ✅ 구현 완료(#1396)- 헤더 아래
text-[13px] muted"“{제목}” 일정의 장소를 바꿔요", 결과 카드 버튼이 "담기" 대신 "선택" - 고르면 날짜 시트 없이
PUT /travel/activities/{id}로 그 일정의 장소만 바꾸고 S-07로 돌아간다(googlePlaceId+ 기준 도시cityPlaceId, 직접 입력이면placeId) - 나머지 필드(제목·날짜·시각·메모·알림)는 서버가 준 값 그대로 되돌려 보낸다 — 수정은 전체 교체다(#1197). 제목은 바꾸지 않는다(장소명과 다른 제목이 흔하다)
- S-07이 보던 날짜를
?date=로 들고 와 기준 도시가 그 날짜 도시로 잡힌다. 뒤로가기는 보드가 아니라 S-07로 간다
- 헤더 아래
max-w-[560px] flex flex-col gap-5. 헤더: ArrowLeft + 제목 truncate + 우측 Trash2 15 ghost icon-sm.
계획 (섹션 제목 text-caption font-semibold text-muted-foreground "계획")
- 제목
FormField+Input - 날짜
Select(1일차~N일차 +보관함 (미배정)) / 시작 시각TimeInput(24시간제, 숫자만 입력 →14:30. 브라우저type="time"은 한국어 로캘에서 오전/오후를 고르게 해서 쓰지 않는다 — #1430) —flex gap-3, 각flex-1 - 장소 블록(장소 있을 때):
rounded-xl border bg-card p-3 flex flex-col gap-2.5-
MapPin15text-primary+ 이름text-[15px] font-medium/ 주소text-xs muted/Clock11 + 영업시간 /Phone11 + 전화번호 - 이름 행 우측
Button variant=ghost size=sm"장소 변경" → S-06 교체 모드(?replace=). 고르는 즉시 저장된다 — 폼의 저장 버튼과 별개다(#1396) - 지도 미리보기
h-[120px] rounded-lg+ 중앙 핀 + attribution -
Button variant=outline size=sm w-full+Navigation14 "구글 지도에서 길찾기 (대중교통)"
-
- 장소 없을 때:
Button variant=outline size=sm self-start+MapPin14 "장소 추가" → S-06 교체 모드. 오프라인이면 두 버튼 모두 disabled(#1396) - 메모
Textarea rows=3(최대 1000자) / URLInput
알림 — 시각이 없으면 섹션 전체 opacity-55 + 컨트롤 disabled + text-[13px] muted "시각을 입력하면 알림을 설정할 수 있어요."
- 일정 알림 행: 라벨
text-sm font-medium+ 보조text-xs muted"시작 15분 전" / 우측Select(시점) +Switch. 행 아래border-b pb-3 - 출발 알림 행: 보조 "시작시각 − 이동 시간 − 5분" (시각+이전 장소 없으면 "시각과 이전 장소가 필요해요", disabled / 이동 시간을 아직 안 적었으면 "보드에서 이동 시간을 적으면 알림이 잡혀요")
기록 — 여행 시작일 이후에만 노출 (border-t pt-5)
- 평점:
Star22 버튼 5개, 채워짐text-warning strokeWidth 2.4/ 빈 것text-muted-foreground strokeWidth 1.6, 뒤에text-[13px] muted"4 / 5" - 메모
Textarea rows=3placeholder "이 일정은 어땠나요" (최대 2000자) - 사진:
grid grid-cols-4 gap-1.5, 각aspect-square rounded-lg bg-muted썸네일, 마지막에 추가 버튼border border-dashed+Plus16 +{n}/10- 탭 → 전체화면 뷰어:
fixed inset-0 z-[80] bg-black/92, 닫기/좌우 버튼size-9 rounded-full bg-white/12, 하단1 / 3카운터, 좌우 스와이프 - 업로드: 파일 선택기로만, 최대 10장·15MB, JPEG/PNG/WebP/HEIC, EXIF 제거, 썸네일 생성, 실패한 파일만 표시 + 재시도
- 탭 → 전체화면 뷰어:
- 오프라인: 기록 영역 비활성 +
text-xs muted"연결 후 업로드 가능"
Card 3개.
환율 — 헤더 "환율"(text-heading font-medium) + 오프라인 시 Badge variant=secondary "최신 아님"
- JPY / KRW 양방향
Input(inputmode="numeric", 천단위 콤마, 통화 변경 가능) 사이에ArrowRightLeft16 - 프리셋 칩
rounded-full border px-3 py-1 text-[13px] tabular-nums:¥1,000¥5,000¥10,000 - 하단
text-xs muted: "ECB 기준 · 2026-08-07 · 실제 결제 환율과 다를 수 있습니다" (오프라인이면 기준일 회색 + "(오프라인 캐시)")
날씨
- 일자 행:
w-[74px] text-[13px]날짜 + 아이콘 16 +15° / 8°+ 우측 강수확률text-xs tabular-nums- 60% 이상이면 아이콘
Umbrella+ 행의 아이콘·확률text-warning - 선택 행
bg-muted
- 60% 이상이면 아이콘
- 시간대별:
border-t pt-2.5 flex gap-1.5 overflow-x-auto, 항목min-w-[52px](시각text-[11px] muted/ 아이콘 15 /14°) - 예보 범위 밖이면
text-[13px] muted"예보 범위 밖" - 하단 출처
text-xs muted"Open-Meteo · CC BY 4.0" (필수)
번역 — 설명 text-[13px] muted "한국어 → 일본어로 구글 번역을 엽니다. 앱이 없으면 웹으로 열려요." + Button variant=outline + Languages 16 "구글 번역 열기" → https://translate.google.com/?sl=ko&tl={목적지 언어}
섹션 3개, 각 제목 text-caption font-semibold text-muted-foreground, 섹션 사이 border-t pt-5.
-
알림: 권한 행(라벨 + 보조 "서버 푸시로 일정·출발 알림을 보냅니다" / 우측
Badgesuccess=허용됨 ·warning=요청 필요 +Button variant=outline size=sm"권한 요청") · 기본 알림 시점Select· 아침 요약 알림Switch(보조 "여행 기간 중 매일 현지 08:00") -
오프라인: 저장된 데이터 "진행 중 · 예정 여행 24.6MB" +
Button variant=outline size=sm"초기화" →ConfirmDialog(destructive, "오프라인 데이터를 초기화할까요") - 정보: 앱 버전, "날씨 Open-Meteo (CC BY 4.0) · 환율 ECB · 장소 Google Places · 지도 © OpenStreetMap"
| 트리거 | 동작 |
|---|---|
| 로그인 성공 |
/select로 replace 이동 |
| 선택 화면 여행 카드 | 진행 중 여행 있으면 보드, 없으면 /travel
|
| 사이드바 스위처 | 워크스페이스 전환(모바일은 시트 닫힘) |
| 일정 행 탭 | 상세로 이동 (드래그 모드에서는 이동 없음) |
| 행 400ms 롱프레스 | 드래그 모드 + 햅틱 |
| 순서 변경 / 날짜 이동 | 다시 이어진 구간의 이동 재조립 → 알림 재예약 → 스낵바 |
좌 스와이프 / Trash2
|
삭제 — 누르는 즉시(#1432). 안내 스낵바만, 실행취소 없음 |
우 스와이프 / Archive
|
보관함으로 이동 — 삭제와 같이 즉시 |
| 이동 행 탭 | 이동 편집 시트 (수단 9칸 그리드 · 이름 · 소요 시간 · 예매 링크 · 메모 · 저장/지우기 / 구글 지도에서 시간 확인 — 딥링크는 항상 대중교통, 좌표 전달) |
| + 탭 | 추가 시트 (장소 검색 / 직접 입력 / 보관함에서 가져오기) |
| 담기 | 날짜 선택 시트 (1일차~N일차 / 보관함) |
| 알림 탭(푸시) | 해당 일정 상세로 이동 |
| 오프라인 진입 | 편집 UI 전부 비활성 + 배너, 온라인 복귀 시 즉시 해제 |
모션 — 시트 translateY(100%)→0 180ms ease-out, 스크림/오버레이 fade 150ms, 스낵바 fade+translateY(10px) 200ms, 시트 상단 핸들 w-9 h-1 rounded-full bg-border. 이 이상의 커스텀 모션은 없다.
기존 스택 그대로 — 서버 상태는 TanStack Query(features/travel/queryKeys.ts 신설), 화면 로컬 상태만 useState.
-
URL이 소유: 선택 날짜(
?day=), 보드/지도 모드(경로), 도구 탭(?tab=) - 컴포넌트 로컬: 시트 open, 드래그 모드/드래그 중 id, 스낵바(실행취소 payload + 5초 타이머), 사진 뷰어 인덱스, 환율 입력값
- 낙관적 업데이트: 순서 변경·삭제·보관함 이동은 낙관적 반영 + 실패 시 롤백. 삭제·보관함 이동은 요청을 보류하지 않는다(#1432 — 5초 실행취소를 없앴다)
| 용도 | 토큰 / 클래스 | 값(라이트) |
|---|---|---|
| 브랜드·주요 액션·포커스 |
--primary = --brand = --ring
|
oklch(0.55 0.22 297.5) (다크 0.58) |
| 배경 / 카드 / 뮤티드 |
--background --card --muted
|
oklch(0.985 0 0) / oklch(1 0 0) / oklch(0.97 0 0)
|
| 본문 / 보조 텍스트 |
--foreground --muted-foreground
|
oklch(0.12 0 0) / oklch(0.45 0 0)
|
| 강조 표면(선택 탭) |
--accent / --accent-foreground
|
oklch(0.95 0.03 297.5) / oklch(0.3 0.12 297.5)
|
| 경고(강수 60%↑, 평점 별) | --warning |
oklch(0.75 0.15 75) |
| 정보 / 성공 / 위험 |
--info --success --destructive
|
oklch(0.58 0.15 250) / oklch(0.6 0.15 150) / oklch(0.577 0.245 27.325)
|
| 경계선 |
--border --input
|
oklch(0.925 0 0) |
| 반경 |
--radius 0.5rem → rounded-md 6.4 / rounded-lg 8 / rounded-xl 11.2 |
|
| 타이포 |
text-display 36 · text-title 24 · text-heading 18 · text-body 15 · text-label 14 · text-caption 12 |
|
| 폰트 | Pretendard Variable | --font-sans |
다크 모드는 루트 .dark 클래스 — 기존 shared/lib/theme.ts 그대로.
| 컴포넌트 | 위치 | 비고 |
|---|---|---|
bottom-sheet.tsx |
components/ui/ |
base-ui Dialog + 하단 정렬. ✅ 구현 완료(#1034) — v2.1의 BaseCitySheet·StaySheet·도시 선택 시트도 이것을 공유한다. 새로 만들지 않는다
|
| Toaster 실행취소 확장 |
components/Toaster.tsx, shared/lib/toast.ts
|
액션 버튼 + 5초 타이머 지원. ✅ 구현 완료 |
(v2.1) LegEditor / LegRow / LegSumBar
|
features/travel/trip/ |
S-03 구간 입력 |
(v2.1) BaseCitySheet
|
features/travel/board/ |
날짜 탭 롱프레스 → 기준 도시 변경 |
(#1368) SwapDaySheet
|
features/travel/board/ |
여행 메뉴 → 하루 통째로 교체할 날짜 고르기. 건너올 일정 수를 함께 보여준다 — 맞바꾸면 저쪽 일정이 이쪽으로 오는 것이라, 고르기 전에 무엇이 오는지 보여야 한다. 비어 있는 날짜는 비어 있음이라 적어 교체가 아니라 통째 이동임을 미리 알린다 |
(v2.1) StayBadge / StaySheet / StayFormSheet
|
features/travel/stay/ |
숙소 배지·상세 시트·입력. ✅ 구현 완료(#1143) — 무엇을 보여줄지는 배지가 정하지 않는다. 위는 체크아웃 우선, 아래는 위와 다를 때만이라는 우선순위는 날짜를 아는 쪽의 판단이라 lib/stayBadge.ts가 갖는다 |
(v2.1) StayMoveRow
|
features/travel/board/ |
숙소 이동 행. ✅ 구현 완료(#1143) — 탭할 것이 없다. 목적지는 배지가 열어 주므로 여기서 또 시트를 열면 같은 숙소로 가는 문이 두 개가 된다 |
CityMoveRow |
— |
만들지 않았다(#1142). 그리고 #1208에서 도시 이동 갈래 자체가 없어졌다 |
(v2.1) SearchCityChip
|
features/travel/places/ |
S-06 기준 도시 칩. ✅ 구현 완료(#1145) — 도시가 하나뿐인 여행에서는 고를 것이 없어 누를 수 없다(무엇을 기준으로 찾는지는 여전히 정보라 칩 자체는 남긴다) |
(v2.1 재명명) LegRow → TravelTimeRow → (#1208) MoveRow
|
features/travel/board/ |
이동 행. StayMoveRow도 여기 흡수됐다 — 같은 모양·같은 시트를 쓰는데 껍데기를 두 벌 두면 한쪽만 고쳐진다 |
(#1208) TransportSheet → MoveSheet
|
features/travel/board/ |
수단을 사는 시트에서 적는 시트로 |
이름 충돌 주의. v2.1에서
Leg는 "연속 같은 도시 날짜 묶음"이다. 기존 이동시간 컴포넌트가LegRow를 쓰고 있으므로 먼저TravelTimeRow로 재명명한 뒤 구간 편집기를 만든다. 순서를 바꾸면 같은 이름의 두 컴포넌트가 공존하는 순간이 생긴다.
lucide-react에서 — Home BookOpen FileText Camera CheckSquare CalendarDays Settings Menu Sun Moon LogOut Plus Layers MapPin MoreHorizontal MoreVertical ArrowLeft ArrowRightLeft ChevronRight ChevronLeft ChevronUp ChevronDown Bell Footprints Car X Search Star Clock Wrench Umbrella Cloud CloudRain WifiOff Map List Archive Navigation Trash2 Pencil GripVertical ImageIcon Languages Plane LayoutGrid Info Phone
v2.1 추가 — Hotel TrainFront StickyNote CalendarPlus Minus Check Link
프로토타입의 숫자·문장은 명세 예시를 채운 데모다. 실데이터로 대체할 것 — 환율 9.42 KRW/JPY, D-78, 도쿄 3박 4일 13개 일정, 오사카 완료 여행, 날씨 15/8°·강수 70%, 오프라인 저장 24.6MB, 앱 버전 0.1.0.
앞 절에 표시하지 않은 델타를 모아 둔다. 여기 없는 것은 v2.0 그대로다.
여행 카드 메타를 다구간 표기로: MapPin + 일본 9박 10일 · 오늘 오사카 → 교토.
배지는 진행 중(success) 또는 D-54(secondary). 실데이터가 없으면 줄을 숨긴다 — 더미를 넣지 않는다.
- 진행 중 카드 요약에 도시 수:
10월 24일 – 11월 2일 · 6개 도시 · 일정 27개 - 우측
4일차+ 그 아래Asia/Tokyo · JPY— 그날 기준 도시에서 파생 - Content 3줄
-
오늘 · 교토— 도시가 바뀌는 날이면오늘 · 오사카 → 교토.rounded-lg bg-accent text-accent-foreground px-3 py-2 text-sm font-medium+MapPin15 - 다음 일정 (시각 + 제목 +
Bell) -
Hotel14 +오늘 밤 교토 게스트하우스
-
- 예정 여행 행에 첫 구간 도시 + D-day
카드에 구간 순서대로 도시 나열 — 오사카 → 교토 → … → 도쿄 (6개 도시)
- 4개 초과면
첫 · 둘째 · … · 마지막 - 연속 중복 도시는 접는다 (도쿄 → 닛코 → 도쿄면 마지막은 도쿄)
- 아래
10월 24일 – 11월 2일 · 일정 27개(보관함 제외) - 진행 중 여행은 오늘의 기준 도시를 강조
✅ 구현 완료(#1168)
판정은 서버 것을 읽기만 한다. 출발 알림 가능 여부는
activities[].canDepartureNotify, 들어오는 이동은moves[]다. 화면이 좌표로 다시 따지면 보드와 답이 갈린다(D-23).날짜가 갖는 것들은 보드에서 읽는다 —
useBoard(tripId, { date })하나로 기준 도시·타임존·경계 판정이 함께 온다. 여행 상세의trip.timezone은 첫날 도시에서 파생된 값이라 도시를 옮긴 날짜에서 조용히 틀린다.
- 헤더 부제
4일차 · 교토 · 10.27(보관함이면보관함 · 날짜 미정)- 아직 못 읽은 조각은 빼고 잇는다 — 빈 자리나
?일차는 로딩 중 화면을 고장난 것처럼 보이게 한다
- 아직 못 읽은 조각은 빼고 잇는다 — 빈 자리나
- 날짜
Select옵션도4일차 · 교토 (10.27)형식 -
도시 경계 안내— #1208에서 뺐다. 도시를 넘어도 이동을 적을 수 있게 되어 안내할 것이 없다 - 알림 보조에 타임존 표기 —
시작 15분 전 · Asia/Tokyo -
출발 알림 보조 문구는 세 갈래다(#1208)
- 직전 장소 없음 → disabled +
시각과 이전 장소가 필요해요 - 켤 수 있지만 이동 시간을 아직 안 적음 → 켜지되
보드에서 이동 시간을 적으면 알림이 잡혀요 - 다 갖춰짐 →
시작시각 − 이동 시간 − 5분 - 못 켜는 이유와 켜도 안 서는 이유를 구분해 말한다. 스위치는 켰는데 알림이 안 오면, 이유를 모르는 사용자에게는 그냥 고장이다
- 직전 장소 없음 → disabled +
- 기록 영역은 v2.0 그대로 (평점·메모·사진, 여행 시작일 이후에만)
✅ 구현 완료(#1169)
오늘 도시는 보드에서 읽는다. 여행 상세의
trip.currency·trip.timezone은 서버가 첫날 기준 도시에서 파생해 채워 주는 값이라, 교토에 있는 날에도 오사카의 통화·언어를 말한다. 일본 안에서는 같은 엔·같은 언어라 눈에 띄지 않을 뿐이고 국가를 넘으면 곧바로 틀린다.
환율
- 헤더 우측 기준 도시 칩
교토 · JPY—rounded-full bg-muted px-2.5 py-[3px] text-xs+MapPin11 - 통화
Select는 여행에 등장하는 통화를 먼저, 그다음 나머지 - 기본 통화 = 오늘 날짜 기준 도시의 국가 통화
- 프리셋 칩은 통화별 (
¥1,000 ¥5,000 ¥10,000)
날씨
- 행 구성:
10.27(38px) + 도시명(66px, truncate) + 아이콘 +20° / 13°+ 강수확률 - 60% 이상이면
Umbrella+text-warning - 하단 출처에 한 줄 추가:
도시별로 따로 조회해요 · Open-Meteo · CC BY 4.0
번역 — 목적 언어는 기준 도시 국가를 따라간다. translate.google.com/?sl=ko&tl={ja|zh-TW|…}
S-09 설정 ✅ 구현 완료(#1169) — 아침 요약 보조를
그날 기준 도시의 현지 08:00 · 도시가 바뀌는 날은 전날 도시 08:00로 바꾸고,
켜져 있으면 미리보기 블록:
교토 · 오늘 일정 4개 · 첫 일정 09:00
오사카 → 교토 · 오늘 일정 3개
bottom-sheet 공유. 보드의 숙소 배지 탭으로 연다. ✅ 구현 완료(#1143)
- 상단: 이름 +
Hotel17 - 체크인·체크아웃 박스 2개 —
flex-1 rounded-lg border px-3 py-2.5, 내용10.27 16:00-
시각이 없으면 날짜만 쓴다. 없는 시각을
00:00으로 채우면 사용자가 그 시각에 맞춰 움직인다
-
시각이 없으면 날짜만 쓴다. 없는 시각을
-
N박(시트 부제) - 메모
rounded-lg bg-muted+StickyNote· 예약 URL 링크 +Link13 - 버튼:
일정으로 추가(체크인/아웃을 일정으로 — 자동 생성하지 않는다) - 하단: 닫기 / 수정 / 삭제
- 삭제는
ConfirmDialogdestructive — "이 숙소가 붙어 있던 날짜에서 모두 사라집니다." -
일정으로 추가로 만든 일정은 숙소를 지워도 남는다 — 만든 뒤로는 숙소와 무관한 보통 일정이다
- 삭제는
주소와
구글 지도에서 길찾기는 장소를 붙였을 때만 나온다. ✅ 구현 완료(#1155) — 숙소 폼에서 장소를 검색해 붙이면 좌표(소요 시간)와 도시 식별자(경계 판정)가 함께 저장된다.도시는 폼에서 사용자가 고른다. 그날 기준 도시를 자동으로 쓰면 닛코 당일치기 날의 도쿄 숙소가 "닛코 숙소"로 저장된다 — 보던 날짜의 도시는 기본값일 뿐이다.
도시
Badge는 넣지 않았다. 폼의 도시 칩이 이미 그 값을 보여주고, 상세에서 한 번 더 말하면 사용자가 고칠 수 없는 자리에 같은 사실이 반복된다.
새로고침·뒤로가기에서 살아남아야 한다. 컴포넌트 state로 두지 않는다.
| 값 | 파라미터 |
|---|---|
| 선택 날짜 |
?day=0..N 또는 archive
|
| 지도 모드 | ?mode=day|all |
| 검색 기준 도시 (v2.1) | ?city= |
| 장소 검색 교체 대상 일정 (#1396) | ?replace={일정id} |
| 도구 탭 | ?tab=fx|weather |
경비는 v2.3에서 독립했다 (2026-09-20). 가계부를 제거하므로 경비 화면은 원장 위의 읽기 뷰가 아니라 여행이 소유하는 장부를 그린다 — D-43 · Travel-Expense-Standalone.
레이아웃은 그대로다. 게이지 두 겹·날짜 그룹·미분류 줄·FAB·바텀시트 — 아래 치수와 토큰을 그대로 쓴다. 바뀐 자리에는 「v2.3」을 달아 두었다.
확정 명세 v2.2의 화면 결정을 흡수했다. 핸드오프 번들(README.md · github.md · 여행 경비·준비.dc.html, 2026-09-05)은 로컬 산출물이라 여기가 유일한 영구 사본이다.
핸드오프의 「Existing code to build on」을 그대로 따른다. 셸·사이드바·카드·게이지·바텀시트·토스트·오프라인 배너는 전부 리포에 있다. 새로 만드는 컴포넌트는 준비 항목 행 하나뿐이다.
프로토타입에서 구현 대상이 아닌 것: 캔버스 프레임 껍데기(라운드 카드·그림자·
1a/1b배지·프레임 라벨)와 데스크톱/모바일 나란히 배치. 리뷰용 액자다.
| 라우트 |
/travel/trips/:id/prep · /travel/trips/:id/expenses (router.tsx · routeImports.ts). 여행이 정해지지 않은 진입은 /travel/prep · /travel/expenses → §10.8 폴백 화면
|
| 사이드바 |
TRAVEL_NAV_ITEMS 구조가 바뀐다 — 여행을 사이드바에 펼치고 준비·경비·일정 보드를 그 여행의 자식으로 둔다 → §10.8
|
| 배지 | 「준비」에 선택된 여행의 기한 지난 개수를 bg-destructive 원형 배지로 |
| 스코프 표시 | 모든 v2.2 화면은 PageHeader 위에 브레드크럼을 갖는다 — 「여행 › 일본 가을 › 준비」(§10.8) |
| 레이아웃 | mx-auto max-w-[720px] flex flex-col gap-5 |
| 카드 |
bg-card rounded-xl ring-1 ring-foreground/10, 패딩 p-5(데스크톱) / p-4(모바일) |
| 숫자 | 전부 tabular-nums. 음수는 −(U+2212). (v2.3) formatAmount·formatFxNote·MINUS·dDayFrom은 features/travel/lib/money.ts가 갖는다 — 가계부에서 쓰던 함수만 옮기고 lib을 통째 복사하지 않는다 |
| 오프라인 |
OfflineBanner 재사용(문구만 「오프라인 · 준비 조회만 가능합니다」/「오프라인 · 경비 조회만 가능합니다」). 체크박스·입력줄·+ 비활성 |
| 쿼리 키 |
travelKeys에 prep(tripId) · expenses(tripId) 추가 |
| 오늘 도시·N일차 |
features/travel/lib/baseCity.ts의 cityOn(board.days, today)에서 파생한다. trip.currency·trip.timezone은 v2.1에서 사라졌다
|
┌───────────────────────────────────┐
│ ← 준비 D-49 │
├───────────────────────────────────┤
│ ▓▓▓▓▓▓▓▓▓▓▓▓░░░░ 18/24 │
│ 남은 6개 · 기한 지난 것 1개 ⚠ │
├───────────────────────────────────┤
│ 서류 (3/3) ▾ │
│ 예약 (4/5) ▾ │
│ ☑ 항공권 발권 🔗 │
│ ☐ 숙소 잔금 결제 D-14 ⚠ │
│ 짐 (9/12) ▾ │
│ ─ 묶음 없음 (0/2) ▾ │
│ ☐ 멀티어댑터 │
│ ─ 캐리어 (7/8) ▸ │
│ ─ 기내백 (2/2) ▾ │
│ ☐ 양말 4 │
│ 할 일 (2/4) ▾ │
│ │
│ + 추가하고 엔터… │
└───────────────────────────────────┘
-
PageHeader —
title="준비",description="10/24 일본 여행 · 출발까지 49일".actions에 ① 「완료 숨기기」Switch+ 라벨(text-[13px] text-muted-foreground, gap 8) ②D-49(text-title font-semibold text-primary tabular-nums) -
전체 진행률 카드 — 헤더 행
h2 text-sm font-semibold「전체 진행률」 / 우측18/24(text-[22px]/[1.15] font-semibold). 게이지bg-muted h-2.5 rounded-full overflow-hidden+ 채움bg-primary. 하단text-[13px] text-muted-foreground「남은 6개」, 기한 지난 게 있으면text-destructive font-semibold로TriangleAlert(14) + 「기한 지난 것 1개」 -
분류 카드 4개 —
flex flex-col gap-3.5. 헤더가 버튼 전체(접기/펼치기): 좌 아이콘 15 + 이름text-[15px] font-semibold+3/3, 우 88×6 미니 게이지(h-1.5) +ChevronDown/ChevronRight16- 항목 행
flex items-center gap-2.5 px-4 py-2.5 min-h-11—Checkbox(16,aria-label=제목) · 제목text-sm flex-1(체크되면text-muted-foreground line-through) · 수량(짐만) · 기한ml-auto text-xs(지났으면text-destructive font-semibold+TriangleAlert13) · 링크Link14 · (데스크톱) 삭제X14 - 빈 분류: 완료 숨기기 켬이면 「남은 게 없어요」, 아니면 「아직 적은 게 없어요」
- 아이콘: 서류
FileText· 예약CalendarCheck· 짐Luggage· 할 일ListChecks -
순서 바꾸기(#1364) — 일정 보드와 같은 손짓이다(§9.x · #1038 · #1223). 마우스는 행에 올리면 나오는 손잡이(
GripVertical)로 모드 없이 끌고, 손가락은 400ms 길게 눌러 정렬 모드로 들어간 뒤 행 전체를 끈다. 모드에 들어가면 상단에DragModeBar가 뜬다- 위/아래 버튼은 끌기의 대안이다(WCAG 2.5.7) — 마우스에서는 손잡이 옆에 함께 나오고, 정렬 모드에서는 항상 보인다. 끌기로 되는 일은 단일 포인터로도 돼야 한다
- 정렬은 분류 카드 안에서만 일어난다. 분류를 넘는 이동은 편집 시트가 한다 — 카드가 접혀 있으면 끌어다 놓을 자리가 없다
- 다른 묶음의 줄 위에 놓으면 그 묶음으로 옮겨간다. 아래로 끌면 그 줄 다음, 위로 끌면 그 줄 앞이고 어느 쪽이든 그 줄의 묶음을 따라간다 — 끄는 동안 보이는 미리보기가 그대로 결과다. 버튼도 같은 규칙이라 묶음의 끝에서 한 번 더 누르면 다음 묶음의 처음이 된다
- 낙관적으로 먼저 반영한다. 손을 뗀 순간 결과가 보여야 한다 — 왕복을 기다리면 줄이 제자리로 튀었다가 다시 움직여 「놓은 자리가 아닌 데로 갔다」로 읽힌다
- 묶음 자체도 끈다(#1366). 소제목에 같은 손잡이·같은 위/아래 버튼이 붙고, 옮기면 그 안의 항목이 통째로 따라간다 — 묶음의 자리는 저장된 값이 아니라 그 안의 첫 항목이 정하는 파생값이라(D-41), 화면이 하는 일은 항목을 그 차례로 다시 적는 것뿐이다. 서버는 이미 배치를 통째로 받으므로 API가 바뀌지 않았다
- 「묶음 없음」은 자리를 지킨다. 손잡이도 이동 버튼도 없고, 다른 묶음이 그 위로 올라가지도 못한다 — 이름을 안 붙인 것이 분류의 기본 상태다(#1358)
- 소제목과 항목은 서로에게 떨어뜨릴 수 있다. 소제목을 항목 위에 놓으면 그 항목의 묶음 자리로, 항목을 소제목 위에 놓으면 그 묶음의 첫 줄로 간다 — 소제목끼리만 맞추게 하면 접힌 묶음 사이에서 놓을 자리가 좁다
-
묶음 소제목(#1358) — 분류 안을 한 겹 더 나눈다. 헤더 버튼 전체가 토글이고(분류 카드와 같은 손놀림)
border-t px-4 py-2: 이름text-[13px] font-medium text-muted-foreground+7/8text-xs tabular-nums+ml-autoChevronDown/ChevronRight14.aria-label은 「캐리어 7/8」- 이름 붙은 묶음이 하나라도 있을 때만 그린다. 아무도 안 나눈 분류는 소제목 없이 지금처럼 항목만 나열한다 — 「묶음 없음」 한 줄이 늘어나는 것이 안 쓰는 사람에게는 군더더기다
- 「묶음 없음」이 맨 위. 그 아래는 서버가 준 차례 그대로다(그 묶음의 첫 항목 순서)
- 접힘은 카드가 들고 있고 접힌 것만 기억한다 — 펼친 것을 기억하면 방금 만든 묶음이 접힌 채로 나타나 적은 줄이 어디 갔는지 알 수 없다
- 항목 행
-
붙박이 입력줄 —
sticky bottom-0 bg-background border-t pt-3 flex flex-wrap items-center gap-2:Plus16 + 분류Menu· 묶음Menu·Input(h-9, 모바일h-11, placeholder추가하고 엔터… (짐 · 캐리어)) + 안내 「분류와 묶음은 방금 적은 것을 이어받아요」(모바일 생략)-
Plus+ 분류 이름이Menu트리거다(#1324). 이어받기만 있으면 첫 짐 하나를 넣으려고 「할 일로 추가 → 시트에서 분류 변경」을 거쳐야 하고, §10.6의 「추가된 분류는 자동으로 펼친다」도 그때는 쓸 일이 없어진다 — 이어받는 값을 보여주는 자리에서 바로 바꾸게 한다. 새 컴포넌트가 아니라 기존Menu다 -
묶음 칩도 같은 자리·같은
Menu다(#1358). 항목은 「묶음 없음」 + 그 분류에 이미 있는 이름들 + 「새 묶음…」. 새 묶음을 고르면 칩 자리가 그 자리에서 입력칸으로 바뀌고(Enter로 확정 · Esc 취소 · 비우면 안 만든 것) 확정하면 포커스가 항목 입력으로 넘어간다 — 첫 묶음을 만들려고 편집 시트까지 가야 하면 아무도 안 만든다 - 묶음도 방금 적은 것을 이어받는다. 다만 분류를 바꾸면 묶음은 「묶음 없음」으로 돌아간다 — 짐에만 있던 「캐리어」를 들고 넘어가면 할 일에 같은 이름이 하나 더 생긴다
-
-
항목 편집 시트 — 제목
text-heading· 분류 4칩 · 묶음(자유 입력 + 그 분류에 있는 이름 칩) · 기한은[출발] [14] [일 전]숫자 입력 하나 · 수량은 짐에서만 활성 · 하단 「삭제」(ghost) / 「저장」- 묶음은 고르기와 적기를 둘 다 둔다(#1358). 고르기만 되면 첫 묶음을 만들 자리가 없고, 적기만 되면 두 번째부터 같은 이름을 다시 쳐야 한다 — 오타 하나로 묶음이 둘로 갈리는 것이 이 화면에서 되돌리기 가장 어려운 실수다
- 칩은 옮겨 갈 분류의 묶음을 보여준다. 지금 분류의 목록을 보여주면 옮긴 뒤에 없는 이름이 된다
절대 하지 않는 것
- 체크해도 자리를 옮기지 않는다. 취소선 + 흐리게만(v2.2 §13). 목록을 위에서 아래로 훑는 작업이라 순서가 흔들리면 어디까지 했는지 잃는다
- 날짜 입력을 두지 않는다. 기한은 D−N 하나뿐이다(§12)
- 기한 경고에 「무시」를 두지 않는다. 체크하거나 기한을 옮겨야 사라진다
-
PageHeader —
title="경비",description="10/24 일본 여행 · 4일차 · 오사카", actions = 「예산 정하기」(outline) + 「지출 적기」(default) -
예산 카드 — 두 겹 게이지
bg-muted h-2.5 rounded-full: 1층bg-primary(쓴 돈), 2층color-mix(in oklab, var(--primary) 32%, var(--muted))(예정). (v2.3)gaugeWidths(spent, scheduled, total)를 쓴다 — 가계부에서features/travel/lib/balance.ts로 옮겨 온 함수다. 같은 계산을 두 곳에 적으면 두 화면이 다른 폭을 그린다.role="img"+aria-label- 「80만 중 41.2만」
text-[22px]/[1.15] font-semibold/ 우측 「쓴 돈 51% · 예정 10%」 -
border-t pt-3행: 「남은 4일 · 하루 쓸 수 있는 돈」 /9.7만 - 각주 「남은 38.8만 ÷ 남은 4일」. (v2.3) 「카드 대금 납부는 여기 들어가지 않아요」는 뺀다 — 이체라는 개념이 없어져 설명할 것이 없다
- 예산 미설정 — 게이지·하루 사용액·각주를 모두 숨기고 한 줄: 「아직 예산을 정하지 않았어요. 이번 여행에 41.2만 썼습니다.」 + 「예산 정하기」(outline sm). 0으로 꾸미지 않는다(§5.3)
- 여행 종료 후 — 같은 자리가 「총 82.3만 / 예산 80만 · 2.3만 초과」 + 「총 6일 · 하루 평균 13.7만」
- 「80만 중 41.2만」
-
미분류 줄(있을 때만) —
color-mix(in oklab, var(--warning) 18%, var(--card))rounded-lg px-3.5 py-3:ReceiptText16 + 「정리할 내역 3건」 / 우측 「카테고리만 채우면 끝나요」 -
날짜 그룹 카드 — 준비의 분류 카드와 같은 껍데기·같은 헤더 버튼. 순서는 출발 전 → 1일차 → … → 다녀온 뒤. 헤더에 필요시
Badge variant="secondary"(「결제일 그대로」·「오늘」)- 행: 좌 제목(+
예정·정리 필요아웃라인 칩) / 우¥1,200(text-[13px] text-muted-foreground) +11,300원 - (v2.3) 행을 누르면 여행 안에서 편집 시트가 열린다. 가계부로 넘어가지 않는다(D-35 폐기) — 시트는 빠른 입력과 같은 컴포넌트라 필드가 늘어도 고칠 자리가 하나다
-
(v2.3)
overdue(지난 예정)인 행은예정칩 대신 「확정」 버튼(outline sm)을 오른쪽에 둔다. 누르면PATCH {status:'CONFIRMED'} - 기본 펼침은 오늘만. 프로토타입이 여러 개를 펼쳐 둔 것은 리뷰 편의다
- 행: 좌 제목(+
-
하단 각주— (v2.3) 뺀다. 「이 화면은 가계부 원장 위의 읽기 뷰예요」가 더 이상 사실이 아니다. 대신 설명할 것이 없다 — 지출은 이 화면이 갖는다 -
모바일 FAB — 우하단 56×56
rounded-full bg-primary,Plus24, 그림자0 6px 18px color-mix(in oklab, var(--primary) 40%, transparent). 데스크톱은 헤더의 「지출 적기」가 같은 역할
BottomSheet(max-w-[520px], 하단 정렬, 180ms) — title="지출 적기", description="오사카 · 4일차 · 30초 안에 끝나게". 순서는 금액 → 통화 → 카테고리 → 결제수단 → 저장(§6.1).
(v2.3) 이 시트가 편집도 맡는다. 기존 지출 행을 누르면 같은 컴포넌트가 값이 채워진 채 열리고,
title="지출 고치기"· 하단에 「삭제」(ghost)가 붙는다. 준비의 항목 편집 시트(§10.1-5)와 같은 모양이다 — 입력과 편집을 두 벌 만들지 않는다.
- 금액
Inputh-13 text-[28px] font-semibold,inputMode="numeric", autoFocus. 통화 칩 2개(JPY ¥/KRW ₩)가 오른쪽 - 환산 줄 「11,300원 · 오늘 환율로 굳습니다」 / 비었으면 「금액을 적으면 원화가 여기 나와요」
- 카테고리 라벨 뒤 「— 나중에 채워도 돼요」. (v2.3) 칩 6개 고정, 선택 없이도 저장 가능
-
FOOD(식비) ·TRANSPORT(교통) ·STAY(숙소) ·SIGHT(관광) ·SHOPPING(쇼핑) ·ETC(기타). 서버에서 목록을 받아오지 않는다 -
가계부 프리셋에 관광·쇼핑·숙소가 없다(#1330)— 그 문제가 사라졌다. 빌려 쓰던 목록이 없어졌으므로 여행이 자기 말로 여섯 개를 정한다. 없는 카테고리를 지어내거나 「관광 → 문화」처럼 짝지어 둘 이유가 없다 - 일곱 번째를 만들지 않는다. 분류가 늘면 「어디에 적을지 고민하는 시간」이 늘고 그만큼 안 적게 된다(D-31과 같은 이유)
-
- 결제수단 라벨 뒤 「— 직전에 쓴 것」. 직전 값이 미리 선택돼 있다
- 칩: 미선택
border-border bg-background text-muted-foreground/ 선택border-primary bg-primary/10 text-primary font-semibold,rounded-full px-3.5 py-2 min-h-9 -
기본값은 FE가 정한다 — 통화 =
cityOn(days, today).currency, 결제수단 = 직전에 쓴 것, N일차·도시 = 날짜에서 자동(사용자가 고르지 않는다)-
(v2.3) 결제수단은 자산 선택이 아니라 입력 + 자동완성이다. 후보는 그 여행에서 이미 쓴 값(
paymentMethod)만 — 전역 목록을 만들면 그게 자산 테이블이다 - 「직전에 쓴 것」은 이 여행의 이 시트에서 마지막으로 고른 값이고
localStorage에 남는다(#1330). 서버가 「직전」을 추측하면 여행 밖 지출까지 끌어온다 — 명세가 이 판정을 FE에 맡긴 이유가 그것이다 - 통화 기본값을 위해 보드를 시트 열 때만 부른다. 경비 응답에는 도시 이름만 있고 통화가 없다
-
(v2.3) 결제수단은 자산 선택이 아니라 입력 + 자동완성이다. 후보는 그 여행에서 이미 쓴 값(
-
(v2.3) 저장은 **
POST /api/travel/trips/{id}/expenses**로 나간다.여행 전용 지출 엔드포인트는 없다→ 이제 그게 유일한 통로다
「여행 예산」 / 「이번 여행에 쓸 총액 하나만 정합니다. 도시별·카테고리별로 나누지 않아요.」 → 총액 Input(h-11 text-xl font-semibold) + 「원」 → (v2.3) Alert variant="info" 「도시별·카테고리별로 나누지 않아요 / 여행 하나에 총액 하나입니다. 도시별·날짜별 합계는 경비 화면이 그냥 보여줘요.」 → Modal.Footer submitLabel="저장".
「월 예산과 섞이지 않아요」— 뺀다. 섞일 월 예산이 없어졌다.Alert는AlertDescription으로 감싼다(맨 텍스트는 첫 칸이 아이콘 자리라 세로로 찍힌다).
| 자리 | 내용 |
|---|---|
여행 홈 카드(FeaturedTripCard, 「오늘 · 오사카」 줄 아래) |
border rounded-lg px-3 py-2.5 링크 두 줄 — Wallet 15 「예산 80만 중 41.2만」 / 우측 「하루 9.7만」 → 경비 · SquareCheckBig 15 「준비 18/24」 / 우측 text-destructive TriangleAlert + 「기한 지난 것 1개」 → 준비. 예산을 안 정했으면 예산 줄 자체를 숨긴다(§7) |
| (v2.3) 없어진다. 월 예산 화면이 사라진다 | |
(v2.3) 없어진다. 붙일 원장이 없다 — attach/detach도 함께 폐기 |
- 체크 토글 — 즉시 반영, 정렬 위치는 그대로
-
완료 숨기기 —
Switch. 켜면 체크된 항목을 리스트에서 빼되 헤더의9/12와 전체 진행률은 그대로. 숨기는 것과 진행률은 다른 일이다 - 그룹 접기 — 헤더 버튼 전체가 토글. 준비는 분류별 + 묶음별 한 겹 더(#1358), 경비는 날짜별(기본 오늘만)
- 순서 바꾸기(준비) — 마우스는 손잡이, 손가락은 400ms 롱프레스로 정렬 모드(#1364). 끌기의 대안으로 위/아래 버튼. 분류 카드 안에서만 움직이고, 다른 묶음의 줄에 놓으면 그 묶음이 된다. 묶음 소제목도 같은 손짓으로 옮긴다(#1366) — 단 「묶음 없음」은 고정이다
- 붙박이 입력줄 — Enter로 추가하고 입력만 비운다(포커스 유지, 시트를 열고 닫지 않는다). 분류는 방금 적은 것을 이어받고, 추가된 분류는 자동으로 펼친다
- 삭제 — 누르는 즉시 요청(#1432). 줄은 먼저 빠지고 실패하면 돌아온다. 실행취소 없음
- 오프라인 — 볼 수는 있고 적을 수는 없다. 큐잉하지 않는다(§6.2)
| 값 | 파라미터 |
|---|---|
| 완료 숨기기 (v2.2) | ?hideDone=1 |
| 선택된 여행 (v2.2) | 경로의 :id — URL이 소유한다. localStorage의 travel.lastTripId는 여행 id가 없는 진입에서만 쓰는 폴백이지 진실이 아니다 |
접힘/펼침은 URL에 넣지 않는다 — 분류가 넷, 날짜가 서른이라 파라미터가 화면보다 커진다. 묶음(#1358)도 같다. 새로고침하면 기본값(준비: 예약·짐 · 묶음은 전부 펼침 / 경비: 오늘)으로 돌아간다.
- ✅ 구현 완료 (#1344 — #1349 · #1352 · #1353 · #1354). 아래 설명은 나가 있는 화면 그대로다. 구현하며 갈린 지점 하나는 「기본 여행 판정」 절에 적었다
2026-09-06 핸드오프 2판. 일정 보드·준비·경비는 모두 여행 하나에 매달린 화면인데, 사이드바에서 그 여행이 어디서 정해지는지 보이지 않으면 항목을 눌러 빈 화면에 도착한다. 1판(사이드바에 「준비」·「경비」만 추가)의 구멍이 여기였다.
드롭다운 스위처를 만들지 않는다(D-36). 프레임
3a가 확정이고2a(드롭다운) ·3b(드롭다운 + 브레드크럼)는 채택하지 않은 기록이다.2b(여행 미지정 폴백)는3a의 폴백으로 함께 채택한다.
v2.2 1판은 전부 구현돼 머지됐다(#1336~#1343). 이 절은 그 위를 고치는 후속 작업이다.
| 지금 나가 있는 것 | 2판에서 바뀌는 것 | |
|---|---|---|
| 사이드바 | 평평한 항목 7개 — 홈 · 여행 목록 · 일정 보드 · 준비 · 경비 · 도구 · 설정 | 여행 트리. 「여행」 라벨 아래 진행 중·예정 여행이 한 줄씩, 선택된 여행만 보드·준비·경비를 편다 |
| 여행 결정 |
ongoing ?? next, 없으면 /travel/trips로 보낸다(#1337) |
진행 중 → 예정 → 마지막 본 여행 → 폴백 화면. 목록으로 튕기지 않는다 |
| 여행 바꾸기 | 사이드바에 자리가 없다 — 목록으로 가서 다시 들어와야 한다 | 여행 행 클릭 한 번, 보던 탭 유지 |
| 스코프 표시 | 「준비 / 출발까지 49일」 — 여행 이름이 화면에 없다 | 브레드크럼 「여행 › 일본 가을 › 준비」 + 준비 상단 안내 한 줄 |
| 요약 API |
ongoing · next · recentCompleted
|
trips[] · completedCount 추가 (API §2.1) |
| 순서 | 내용 | 비고 |
|---|---|---|
| 1 |
여행 무관 — 홈(/travel) · 여행 목록(/travel/trips) |
기존 그대로 |
| 2 | 섹션 라벨 「여행」 |
text-caption font-semibold text-muted-foreground mx-3 mt-2 mb-1.5 — 링크 워크스페이스의 「태그」 라벨과 같은 자리·같은 스타일
|
| 3 | 여행 트리 — 진행 중·예정 여행 하나에 한 줄 | 선택된 여행 하나만 펼친다 |
| 4 | 「여행 만들기」(Plus) · 「다녀온 여행 N개」(Plane → /travel/trips) |
h-8 px-3 text-[13px] text-muted-foreground |
| 5 |
border-t border-border mx-2 후 도구 · 설정
|
기존 그대로 |
여행 행(부모) — button 전체가 토글. flex h-[34px] w-full items-center justify-between gap-1.5 rounded-md px-2.5 text-[13px]
- 좌:
ChevronDown(선택) /ChevronRight(미선택) 14px + 제목(truncate) - 우: D-day 또는
4일차—text-caption tabular-nums, 선택이면text-primary font-semibold, 아니면text-muted-foreground - 선택
bg-muted text-foreground font-semibold/ 미선택text-foreground/70 hover:bg-muted
하위 항목(자식) — ml-3 pl-3.5 border-l border-border, 각 항목 h-8 rounded-md px-2.5 text-[13px] font-medium, 아이콘 15px. 일정 보드(CalendarDays) · 준비(SquareCheckBig) · 경비(Wallet). 현재 항목 bg-primary/10 text-primary.
-
여행 행을 누르면 같은 탭을 유지한 채 그 여행으로 간다 (
/travel/trips/:id/prep→/travel/trips/:other/prep). 두 여행의 준비를 오가는 것이 클릭 한 번이다 - 다른 여행은 한 줄로 접힌다 — 사이드바가 항상 같은 높이·같은 모양을 유지한다
-
사이드바에 다녀온 여행을 늘어놓지 않는다. 시간이 갈수록 길어지면 사이드바가 목록 화면이 된다 — 「다녀온 여행 N개」 한 줄로 접어
/travel/trips로 보낸다. 여행 목록 화면은 다녀온 여행까지 전부 보여준다(줄이는 것은 사이드바에서만이다) - 진행 중·예정이 6개를 넘으면 토글 부분만 드롭다운으로 바꾼다(
3b가 그 대비다). 현실적으로 생기지 않는 상태다
워크스페이스 스위처(사이드바 최상단)는 손대지 않는다. 그것은 일상·여행·링크를 가르는 다른 층위다. (v2.3) 가계부가 빠지면서 4칸 드롭다운은 3칸 세그먼트로 돌아간다(제거 1단계) — 이 절이 정한 여행 트리는 그 아래에서 그대로다. 여기서 펼치는 것은 여행 워크스페이스 안의 여행이다.
모바일에서는 사이드바가 닫혀 있다. PageHeader 위에 text-[13px] text-muted-foreground 한 줄:
여행 › 일본 가을 › 준비
구분자는 ChevronRight 13px. 「여행」은 여행 목록으로, 여행 이름은 그 여행의 보드로 가는 링크다.
진행 중 → 다음 예정 → 마지막으로 본 여행(localStorage: travel.lastTripId) → 폴백 화면(2b)
-
useTravelSummary의ongoing?.id ?? next?.id에 마지막 본 여행을 폴백으로 더한다. 여행 선택이 바뀔 때마다 저장한다 - 저장된 id가 더 이상 없을 수 있다(삭제·다른 기기·시크릿 창). 요약에 없는 id면 조용히 버리고 다음 폴백으로 내려간다 — 죽은 id로 화면을 열지 않는다
이 판정은 사이드바만 돌린다 (#1353에서 정함). 사이드바가 여행 링크를 만들 때 쓰고, 넷 다 실패했을 때 폴백 화면으로 보낸다. 폴백 화면은 판정을 다시 돌리지 않는다 — 두 가지 때문이다.
- 폴백에서도 자동으로 넘기면 그게 D-38이 금지한 **「조용한 리다이렉트」**다. 지운 여행의 링크로 들어온 사람에게 다른 여행의 준비를 열어 주면, 그 화면을 자기가 찾던 것으로 읽는다
trips[]가 비어 있지 않으면 서버가ongoing이나next를 반드시 채운다(API §2.1). 폴백에서 판정을 돌리면 카드 리스트가 영영 안 뜨는 죽은 코드가 된다URL이 여행을 말해 줄 때만
lastTripId에 저장한다. 기본 여행까지 저장하면 「마지막으로 본 여행」이 한 번도 안 고른 여행을 가리킨다.
여행이 정해지지 않은 채 들어왔을 때(딥링크, 여행 삭제 직후). 빈 화면도, 조용한 리다이렉트도 아니다.
- PageHeader
title="준비"·description="어느 여행의 준비인가요?" - 여행 카드 리스트 — 진행 중·예정만. 각 행
bg-card rounded-xl px-4 py-3.5 ring-1 ring-foreground/10링크: 상태 칩(success/info) · 제목 · 「기간 · 준비 18/24 · 경비 41.2만」 · 기한 경고 · D-day ·ChevronRight - 하단 「한 번 고르면 그 여행을 기억합니다」 + 「여행 만들기」(outline sm)
- 여행이 하나도 없으면 같은 자리를
EmptyState로 — 「준비 목록은 여행마다 따로 있어요. 여행을 먼저 만들면 여기에 목록이 생깁니다.」
준비 화면 상단에 그 사실을 한 줄로 남긴다 — bg-accent text-accent-foreground rounded-lg px-3 py-2.5 text-[13px] + MapPin 15px:
준비 목록은 여행마다 따로입니다. 사이드바에서 여행을 바꾸면 이 화면도 그 여행의 목록으로 바뀝니다.
「지난 여행에서 가져오기」를 만들지 않는다는 결정(확정 명세 §15)이 이 한 줄을 필요하게 만든다 — 목록이 여행마다 비어서 시작하는 이유를 화면이 말해주지 않으면 버그로 읽힌다.