Skip to content

Day Plan UI Design

wcorn edited this page Jun 27, 2026 · 3 revisions

화면 설계: 주간 계획표 (Weekly Plan)

범위: 독립 페이지 한 장 — 일~토 × 시간축 그리드에서 시간 블록을 직접 만들고/옮기고/지운다. 캘린더 오버레이·편집 모달(반복)·미러 토글 없음.

상태: 구현 완료 (2026-06-27, WP0 #633 · WP1 #636). 디자인 시스템을 따른다(#8b00ff 포인트, Pretendard, 다크모드, 모바일/데스크탑 반응형).

구현 노트 (설계 대비): ① 블록 편집은 "인라인 팝오버" 대신 모달(요일·라벨·색·시작/종료·삭제)로 구현 — 요일 변경까지 한 폼에서 처리. ② 리사이즈/이동은 모달의 시간 입력으로 수행(드래그 리사이즈/몸통 이동은 차기). ③ 빈 영역은 시간 칸 클릭=1시간 생성 / 세로 드래그=구간 생성(30분 스냅). ④ 저장은 권장안대로 명시적 [저장] 버튼 + 미저장 표시. ⑤ 모바일은 1일 뷰 + 요일 탭.

1. 화면 목록

화면 경로 설명
주간 계획표 /planner/plan 일~토 시간 그리드. 블록 생성·이동·리사이즈·삭제. 이 한 장이 전부

옛 설계의 "플랜 관리 목록 + 편집 모달 + 일/주 배경 레이어 + 설정 미러 토글"은 전부 제거, 이 페이지로 대체.

2. 주간 그리드 (데스크탑)

┌─ 주간 계획표 ───────────────────────────────────────[ 저장 ]┐
│        일      월      화      수      목      금      토       │
│  06 ┊                                                          │
│  07 ┊                                                          │
│  08 ┊        ▓ 기상   ▓ 기상  ▓ 기상  ▓ 기상  ▓ 기상         │
│  09 ┊                                                          │
│  10 ┊        ▓ 개인PJ  ▓ 개인PJ ▓ 개인PJ ▓ 개인PJ ▓ 개인PJ      │
│  11 ┊                                                          │
│  12 ┊        ░ 점심   ░ 점심   ░ 점심   ░ 점심   ░ 점심  ▓ 운동  │
│  13 ┊        ▒ 공부   ▒ 공부   ▒ 공부   ▒ 공부   ▒ 공부         │
│  …                                                            │
└──────────────────────────────────────────────────────────────┘
   드래그로 블록 생성 · 블록 클릭=수정 · 가장자리 드래그=리사이즈
  • 세로축 = 시간, 가로축 = 요일(일~토). Google Calendar 주간 뷰와 유사한 직접조작 그리드.
  • 표시 시간 범위는 기본 06:0024:00 같은 합리적 윈도우, 위/아래 스크롤로 확장(전체 024 접근 가능).
  • 시간 눈금은 30분/1시간 단위 스냅(드래그·리사이즈 시).

3. 블록 상호작용

동작 결과
빈 영역 드래그(세로) 그 요일·시간 구간에 새 블록 생성 → 즉시 라벨 입력 + 색 선택
블록 클릭/탭 인라인 팝오버: 라벨·색·시작/종료 시간 수정, 삭제
블록 가장자리 드래그 시작 또는 종료 시각 조정(길이 변경)
블록 몸통 드래그 같은 요일 내 시간 이동(요일 간 이동은 v1 선택 — 미지원 시 삭제 후 재생성)
삭제 블록 제거
  • 시간 역전 차단: 리사이즈/입력으로 종료 ≤ 시작이 되면 인라인 차단(저장 불가).
  • 겹침: 같은 요일 블록이 시간상 겹쳐도 허용(의도 템플릿). 겹친 블록은 나란히 분할 렌더. 약한 경고만(선택).
  • 색: 디자인 토큰 팔레트(violet/sky/amber/emerald 등)에서 선택. 블록별로 다름.

4. 저장

  • 전량 교체: 현재 그리드 상태 전체를 PUT /api/planner/plan으로 저장(API §4).
  • 방식 택1(구현 시 결정, 결정 기록 §3): ①명시적 [저장] 버튼(dirty 표시) ②디바운스 자동 저장. 권장: 명시적 저장 버튼 + 미저장 변경 표시(실수 방지·요청 절감).
  • react-query: GET /plan로 로드, PUT /plan mutation + 성공 시 invalidate(또는 낙관적 갱신).

5. 상태 / 반응형

상태 처리
로딩 그리드 스켈레톤(요일 헤더 + 시간 눈금)
빈 상태 그리드 위 안내: "빈 한 주입니다. 시간대를 드래그해 블록을 추가하세요"
저장 중 [저장] 버튼 스피너, 그리드 인터랙션 잠금(짧게)
저장 실패 토스트 경고 + 재시도. 로컬 편집 상태 유지
모바일 한 화면에 7개 컬럼은 좁음 → 요일 1일 뷰 + 좌우 스와이프/요일 탭 권장. 블록 생성은 [+]·탭 후 시간 입력 폼
  • 공유 프리미티브(Popover·FormField·Select·색 토큰·Toaster) 재사용(FE 아키텍처).
  • 모바일 7컬럼 동시 표시는 가독성 한계 → 1일 뷰 전환을 기본 권장(구현 시 확정, 결정 기록 §3).

Clone this wiki locally