Skip to content

Planner UI Design

wcorn edited this page Jul 24, 2026 · 2 revisions

화면 설계: Planner (Google Calendar 연동)

범위: 통합 캘린더(월/주/일), 일정 생성/편집 다이얼로그, Google 연동 설정, 미연동 CTA. 디자인 토큰·다크모드는 디자인 시스템 준수. 월 그리드는 기존 복습 캘린더의 monthGridDays 유틸/CalendarCell을 재사용·확장한다.

1. 화면 목록

화면 경로 설명
플래너 (통합 캘린더) /planner/calendar 월/주/일 뷰 전환. 일정+할일+복습 통합
연동 설정 /integrations (또는 캘린더 헤더 내) Google 연결/해제 상태

경로 결정: 기존 복습 전용 캘린더를 통합 뷰로 승격하고 메뉴를 단순화한다(복습 전용 화면 제거, API는 오버레이로 재사용). 결정 기록 §3.

2. 통합 캘린더 — 공통 레이아웃

┌─────────────────────────────────────────────────────────────┐
│  ◀  2026년 6월  ▶      [월][주][일]      [오늘]   [+ 일정]   ⚙ │
├─────────────────────────────────────────────────────────────┤
│  (미연동 시) ⚠ Google 캘린더가 연결되지 않았습니다  [Google 연결] │
├─────────────────────────────────────────────────────────────┤
│                        뷰 영역 (월/주/일)                       │
└─────────────────────────────────────────────────────────────┘
  범례:  🟦 일정   ☑ 할 일   🟣 오늘복습 🔴 밀림 ⚪ 예정 ✅ 완료
  • 우상단 [+ 일정]: 일정 생성 다이얼로그.
  • 헤더 ⚙: 연동 설정 진입.
  • 미연동 배너는 캘린더 상단에 노출, 복습은 그대로 표시.

3. 월 뷰 (기존 복습 캘린더 확장)

 일   월   화   수   목   금   토
┌────┬────┬────┬────┬────┬────┬────┐
│  1 │  2 │  3 │ ...                  │
│🟦회의│    │☑과제│                     │   ← 일정/할일/복습 칩(최대 N개 + "+3")
│✅복습│    │🟣복습│                     │
└────┴────┴────┴────┴────┴────┴────┘
  • 셀: monthGridDays로 6주(42일) 그리드. 항목은 소스별 칩(일정 🟦 / 할일 ☑ / 복습 상태색).
  • 셀 빈 공간 클릭 → 그날 종일 일정 생성 다이얼로그.
  • 칩 클릭 → 일정이면 편집, 복습이면 그날 상세 패널.
  • 항목 초과 시 "+N" → 그날 상세 패널.

4. 주 뷰

        월6/8  화6/9  수6/10 ...
 종일 │ 🟦여행 ───────▶                  │   ← 종일/복습/할일 레인
─────┼──────────────────────────────────┤
 09  │        🟦스탠드업                  │
 10  │ 🟦회의 │                           │   ← 시간축 24h, 시간대 일정 블록
 ... │        │      🟦치과               │
  • 좌측 시간축(0–24h), 7일 컬럼. 시간대 일정은 블록으로 배치(겹침 시 분할 레이아웃).
  • 상단 종일 레인: 종일 일정 + 복습 + due 할 일.
  • 빈 시간대 클릭/드래그 → 해당 시간 일정 생성(드래그 리사이즈는 차기).

5. 일 뷰

  • 주 뷰와 동일 컴포넌트, 단일 날짜 컬럼. 하루 시간축 + 종일 레인.

6. 일정 생성/편집 다이얼로그

┌──────────────── 일정 ────────────────┐
│ 제목  [____________________________]  │
│ □ 종일                                │
│ 시작  [2026-06-10] [14:00]            │
│ 종료  [2026-06-10] [15:00]            │
│ 장소  [____________________________]  │  (선택)
│ 메모  [____________________________]  │  (선택)
│                                        │
│ (반복 일정인 경우) ⓘ 이 일정만 수정    │
│                  [취소]  [삭제]  [저장] │
└────────────────────────────────────────┘
  • 생성: 빈 폼. 편집: 기존 값 채움 + [삭제].
  • 저장/삭제 시 낙관적 갱신(react-query invalidate) → Google 반영.
  • 반복 일정 편집 1차: "이 일정만" 단일 인스턴스 patch. 전체/이후 옵션은 차기.
  • 미연동 상태에서 [+ 일정] → "Google 연결이 필요합니다" 안내 + 연결 버튼.

7. 할 일 UI

  • 캘린더: due 날짜 칸에 ☑ 칩으로 표시, 체크박스 토글로 완료(취소선).
  • (선택) 사이드 To-do 리스트 패널: 제목 입력으로 추가, 마감일 지정, 삭제.

8. 그날 상세 패널 (날짜 클릭)

┌──── 6월 11일 ────┐
│ 일정                │
│  🟦 14:00 치과     │ → 클릭 편집
│ 할 일               │
│  ☑ 리포트 제출      │
│ 복습 (읽기 전용)     │
│  🟣 이펙티브 자바 3건│ → [오늘 복습 하러가기]
└────────────────────┘
  • 복습 항목은 평가 불가(읽기 전용). 기존 오늘 복습 화면(/planner/reviews/today)으로 연결.

9. 연동 설정

┌──── Google 연동 ────┐
│ 상태: 연결됨          │
│ 계정: me@gmail.com   │
│ 연결일: 2026-06-15   │
│            [연결 해제] │
└──────────────────────┘
  • 미연동: "연결되지 않음" + [Google 연결] → 동의 흐름.
  • ?google=connected/?google=error 복귀 시 토스트.

10. 상태/예외 UX

상태 표시
미연동 상단 배너 + 연결 CTA, 복습만 표시
부분 실패(partial) 상단 경고 배너("일정을 불러오지 못했습니다"), 다른 소스는 정상
재연동 필요(invalid_grant) "Google 연동이 만료되었습니다 [다시 연결]"
로딩 스켈레톤 그리드

11. 비기능 / 반응형

  • 데스크탑: 월/주/일 전부. 모바일: 월·일 우선(주 뷰는 가로 스크롤).
  • 키보드: T(오늘), ←/→(이전/다음 기간), M/W/D(뷰 전환) — 선택.
  • 다크모드 준수, 복습 상태색은 기존 bucketStyles 일관 유지.

12. 범위 외 (UI)

  • 드래그로 일정 이동/리사이즈
  • 여러 캘린더 토글/색상 매핑
  • 일정 알림 설정 UI
  • 미니 캘린더 사이드 위젯

Clone this wiki locally