Skip to content

Study Planner UI Design

wcorn edited this page Aug 23, 2026 · 26 revisions

UI 설계: Study Planner (v2.5)

범위: 메인 진입 카드 + 학습 자료 목록 + 자료 상세(노트 탭 / 카드 탭) + 복습 허브 + 복습 세션(4지선다) + 복습 캘린더. v2.2 변경: 노트 탭을 Notion 인라인 하위 페이지 방식으로 — 본문 /페이지로 하위 노트 생성, 본문 안 childPage 블록. v2.3 변경: 카드에 종류(기본/순서)를 도입. 카드 추가·편집 다이얼로그에 종류 토글 + 순서 카드 항목 에디터(드래그 정렬, 3~7개) 추가. 복습 세션에 순서 카드 복습 UI(셔플 배열 → 드래그 재정렬 → 정답 확인 → 색 비교 → 4지선다) 추가. v2.4 변경: 카드 추가 다이얼로그(BASIC)에 "양방향" 옵션 추가 — 켜면 정·역방향 카드 2개가 서로 다른 주기로 생성된다. 짝 카드는 sibling burying으로 같은 날 함께 나오지 않으며, 복습 중 짝이 다른 날로 밀리면 토스트로 알린다. v2.5 변경: "오늘 복습" → "복습" 허브(/planner/reviews). 현황(지금/밀림/앞으로/오늘 완료) + 앞으로·완료 목록(필터 + 무한 스크롤) + 여러 진입점(전체/밀림/자료별 복습 시작)을 한 화면에 통합. 카드 넘기기는 복습 세션(/planner/reviews/session)으로 분리. 조회/표시 확장이며 복습 로직·평가는 그대로. 디자인 레퍼런스: 복습 허브 핸드오프(orino-fe 컴포넌트로 재현). 결정은 Open Items §0-D.

1. 화면 구성

경로 화면 비고
/home 메인 (홈) 진입 카드
/planner/materials 학습 자료 목록
/planner/materials/:id 학습 자료 상세 [노트] / [카드] 탭
/planner/reviews 복습 허브 현황 + 앞으로/완료 목록 + 진입점 (v2.5)
/planner/reviews/session 복습 세션 카드 단위 4지선다 평가 (허브에서 진입, 스코프 쿼리)
/planner/reviews/today (리다이렉트) → /planner/reviews (구 라우트 호환)
/planner/calendar 복습 캘린더 월간 달력 (투두메이트 스타일)

2. 사이드바

┌─────────────────┐
│  🏠 홈          │ /home
│  📚 학습 자료    │ /planner/materials
│  📝 복습 ⓢ      │ /planner/reviews  ← 뱃지: 지금 할 복습 수
│  📅 복습 캘린더  │ /planner/calendar
└─────────────────┘

뱃지는 GET /api/planner/reviews/summary의 counts.now(지금 할 것). 0이면 표시 안 함. (v2.5 전에는 /reviews/today 길이를 썼다.)

3. 화면 상세

3.1 메인 (홈) /home

┌──────────────────────────────────────────────┐
│  안녕하세요!                                    │
│                                              │
│  ┌──────────────────┐ ┌──────────────────┐  │
│  │  📝              │ │  📚              │  │
│  │  오늘 복습        │ │  학습 자료       │  │
│  │  3 건            │ │  5 개            │  │
│  │  [시작하기]      │ │  [둘러보기]      │  │
│  └──────────────────┘ └──────────────────┘  │
└──────────────────────────────────────────────┘

구성 요소:

  • "오늘 복습" 카드: 오늘 + 밀린 복습 수. 클릭 시 /planner/reviews/today
  • "학습 자료" 카드: ACTIVE 자료 수. 클릭 시 /planner/materials

API: GET /api/planner/reviews/today (개수만), GET /api/planner/materials?status=ACTIVE (개수만)

빈 상태: "오늘 복습 0건 — 모두 완료했어요!" / "등록된 학습 자료가 없습니다 + [추가] 버튼"


3.2 학습 자료 목록 /planner/materials

┌─────────────────────────────────────────────┐
│  학습 자료                       [+ 자료 추가] │
├─────────────────────────────────────────────┤
│  📕 이펙티브 자바              · BOOK         │
│  카드 24장 · 오늘 복습 3개                    │
│  ─────────────────────────────────────────  │
│  🎬 React 강의                · LECTURE      │
│  카드 8장 · 오늘 복습 0개                     │
│  ─────────────────────────────────────────  │
│  ...                                        │
└─────────────────────────────────────────────┘

구성 요소:

  • 자료 카드: 아이콘(type별), 제목, 카드 수, 오늘 복습 수
  • 카드 클릭 시 /planner/materials/:id로 이동
  • 우상단 [+ 자료 추가] 버튼 → 다이얼로그

다이얼로그 (자료 추가):

  • 입력: 제목 (text, 1~200자), 유형 (select: 책/강의/문제집/MOOC)
  • [취소] [추가] → 생성 후 상세 화면(노트 탭)으로 자동 이동

빈 상태: 중앙에 "아직 등록된 학습 자료가 없습니다" + 큰 [+ 첫 자료 추가] 버튼


3.3 학습 자료 상세 /planner/materials/:id

┌─────────────────────────────────────────────┐
│  ← 뒤로                                       │
├─────────────────────────────────────────────┤
│  📕 이펙티브 자바              [⋯ 편집/삭제] │
│  BOOK · 카드 24장 · 오늘 복습 3개             │
├─────────────────────────────────────────────┤
│  [📝 노트]  [📇 카드 24]                      │  ← 탭 전환
└─────────────────────────────────────────────┘

탭 두 개. URL 쿼리스트링으로 상태 보존 (?tab=note / ?tab=cards, 기본 note).

3.3.1 [노트 탭] — Notion 인라인 하위 페이지

좌측 사이드바 트리(네비게이션) + 우측 에디터 2-pane. 하위 노트는 본문에서 /페이지로 만든다.

┌─────────────────────────────────────────────────────────┐
│  ...(자료 헤더)...                                        │
│  [📝 노트]  [📇 카드 24]                                  │
├──────────────────┬──────────────────────────────────────┤
│  노트   [+ 새노트] │              저장됨 · 12:34            │
│  ──────────────  ├──────────────────────────────────────┤
│  ▾ 1장 객체 생성  │  제목: [ 1장 객체 생성             ]   │
│    📄 정적 팩토리 │  ─────────────────────────────────   │
│    📄 싱글턴      │  객체를 만드는 방법 정리.              │
│  ▸ 2장 객체 파괴  │                                      │
│                  │  📄 정적 팩토리 메서드   ← childPage   │
│                  │  📄 싱글턴              ← childPage   │
│                  │                                      │
│                  │  이어서 본문 계속 작성... /페이지       │
└──────────────────┴──────────────────────────────────────┘
   ↑ 트리(네비)        ↑ 본문 안에 하위 노트가 블록으로 박힘

인라인 하위 페이지 (핵심 UX):

  • 본문 작성 중 /페이지 입력(슬래시 커맨드) 또는 툴바 [+ 페이지] →
    1. POST /materials/:id/notes { parentId: 현재노트 } → noteId 수신
    2. 본문 커서 위치에 childPage 블록(📄 + 제목) 삽입
    3. 글쓰기 흐름 안 끊고 본문 계속 작성
  • childPage 블록 클릭 → 자식 노트로 진입 (URL: ?note=childId)
  • 자식 노트에서 제목 바꾸면 → 부모 본문 블록 라벨 + 사이드바 라벨 즉시 갱신
  • 본문에서 childPage 블록 삭제 → "하위 노트 N개도 함께 삭제됩니다" 확인 → DELETE /notes/:childId
  • 1차 제외: childPage 블록 복붙(복제 차단), 본문 간 이동(부모 변경) — 차기

사이드바 트리 (좌, 네비게이션):

  • GET /materials/:id/notes로 parent_id 기준 트리 로드
  • 중첩 들여쓰기 + 펼침(▾)/접힘(▸). 노트 클릭 → 해당 노트로 진입
  • 상단 [+ 새노트] → 루트 노트 생성 (parentId: null)
  • 하위 생성은 본문 /페이지로 (사이드바엔 [+ 하위] 버튼 없음)
  • 본문에서 하위 추가/삭제/제목변경 시 트리 갱신

에디터 (우):

  • 상단 제목 입력 → PATCH /notes/:noteId { title }
  • 본문 Tiptap: StarterKit + TaskList + TaskItem + Placeholder + ChildPage 커스텀 노드 + Table(Table/Row/Header/Cell — 데이터 Import)
  • / 슬래시 커맨드: 최소 /페이지만 우선 (다른 블록은 툴바 + 마크다운 단축키). 툴바에 [Import](엑셀→표) — 데이터 Import
  • 노트 전환 시 editor.commands.setContent로 교체

자동 저장:

  • 본문 입력 → 2초 debounce → PATCH /notes/:noteId { content } (childPage 노드 포함)
  • 제목 입력 → debounce → PATCH /notes/:noteId { title }
  • 저장 상태 (우상단): 저장 중... / 저장됨 · HH:mm / 저장 실패 (재시도)

API:

  • GET /api/planner/materials/:id/notes — 트리 로드
  • GET /api/planner/notes/:noteId — 본문 로드
  • POST /api/planner/materials/:id/notes — 생성 (루트/자식)
  • PATCH /api/planner/notes/:noteId — 제목/본문 저장
  • DELETE /api/planner/notes/:noteId — 서브트리 삭제

빈 상태 (노트 0개): 사이드바 "아직 노트가 없습니다" + [+ 새 노트], 본문 영역은 "노트를 만들어 시작하세요".

모바일: 2-pane 대신 트리 ↔ 에디터 드릴다운. childPage 블록 탭 → 자식으로 진입, [← 뒤로]로 복귀.

3.3.2 [카드 탭]

┌─────────────────────────────────────────────┐
│  ...(자료 헤더)...                            │
│  [📝 노트]  [📇 카드 24]                      │
├─────────────────────────────────────────────┤
│  카드 24장                    [+ 카드 추가]   │
│  ─────────────────────────────────────────  │
│  📇 #1                                       │
│  앞: 정적 팩토리 메서드의 장점 4가지는?         │
│  뒤: 이름을 가질 수 있다 / 인스턴스 통제 ...  │
│  다음 복습: 5/23 (6일 후) · 2회차              │
│  [편집] [삭제]                                │
│  ─────────────────────────────────────────  │
│  📇 #2                                       │
│  앞: ...                                     │
│  ...                                         │
└─────────────────────────────────────────────┘

구성 요소:

  • 카드 리스트: 기본 정렬 생성순. 기본은 접힘 + 한 줄 — 앞면(truncate)과 다음 복습일이 같은 줄에 오고, 행을 클릭해야 뒷면(또는 순서 항목)이 펼쳐진다
  • 각 카드 우측 [편집] 버튼 (삭제는 편집 다이얼로그 안)
  • 우상단 [+ 카드 추가] 버튼 → 다이얼로그

탐색 (v2.6, #992) — 42장만 되어도 스크롤로는 확인이 어렵고, 수백~수천 장이면 도달 자체가 불가능해 도입.

  • 접기 + 밀도: 체감 문제의 주범은 "개수"가 아니라 "한 장의 높이"다. 다만 접기만으로는 부족했다 — 행마다 Card로 감싸면 Card의 py-4(32px) + CardContent의 py-3(24px)로 패딩만 56px이 붙어, 내용(한 줄 20px)보다 여백이 더 커진다. 실측 96px/행
    • → 행마다 카드로 감싸는 대신 목록 컨테이너 하나 + divide-y 구분선, 앞면·복습일을 한 줄로. 실측 33px/행(10행 1032px → 330px, 한 화면 5행 → 15행)
    • 좁은 화면에선 복습일을 숨긴다(sm: 이상에서만 노출). 펼치면 어차피 보인다
  • 양방향 짝 병합: siblingGroupId가 같은 2장을 ⇄ 양방향 배지가 붙은 한 행으로 합친다(리스트 길이 절반). 펼치면 두 방향이 각각의 다음 복습일 + [편집]과 함께 나온다
    • 페이지 경계에 짝이 걸쳐 한 장만 로드된 동안은 단독 행으로 보이고, 다음 페이지가 도착하면 자연히 합쳐진다(무한 스크롤이라 최종 상태는 항상 묶인 형태)
  • 검색·필터 바: 검색 입력(300ms 디바운스) + 종류 · 복습 상태 · 정렬 셀렉트. 스크롤을 빠르게 만드는 것보다 "전부 내려서 확인"이라는 행위 자체를 없애는 것이 목적
  • 무한 스크롤: 30장씩 커서 페이징. 하단 sentinel이 보이면 다음 페이지를 이어 붙인다
  • 빈 상태 구분: 필터 때문에 비었으면 "조건에 맞는 카드가 없어요" + [필터 초기화], 카드가 아예 없으면 "아직 카드가 없습니다" + [첫 카드 추가]
  • #N 번호 없음: 필터·정렬이 걸리면 번호가 전체 기준이 아니게 되어 오해를 준다. 종류 배지(⇄ 양방향 / 순서)로 대체

가상 스크롤은 도입하지 않는다. 서버 페이징으로 DOM 증가가 이미 제한되고, 둘 다 넣으면 복잡도만 늘어난다.

다이얼로그 (카드 추가 / 편집) — 상단에 카드 종류 토글 [ 기본 | 순서 ] (v2.3):

기본(BASIC) 모드:

  • 입력: 앞면 (textarea, rows=3, 11000자), 뒷면 (textarea, rows=4, 11000자)
  • 각 textarea에 글자 수 카운터 n / 1000
  • 양방향 옵션 (v2.4, 추가 모드 전용): 뒷면 아래 체크박스 ☐ 양방향 — 역방향 카드도 함께 만들기 (앞↔뒤)
    • 켜면 저장 시 (앞→뒤)·(뒤→앞) 카드 2개를 생성(요청에 bidirectional: true). 짝은 서로 다른 주기로 시작해 같은 날 겹치지 않는다.
    • 앞·뒤가 모두 채워졌을 때만 활성. 편집 모드에는 없음(이미 만들어진 카드는 독립이므로)
    • 추가 후 토스트: 양방향 카드 2장이 추가되었어요.

순서(ORDERING) 모드 — 앞면(지시문) + 항목 에디터:

┌──────────────────────────────────────────────┐
│  카드 종류   [ 기본 ]  [ ● 순서 ]              │
│  ──────────────────────────────────────────  │
│  지시문                                        │
│  [ kubectl apply 실행 이후 순서대로 배열     ] │
│  ──────────────────────────────────────────  │
│  항목 (정답 순서로 입력) · 5 / 7               │
│  ⠿ 1  [ apiserver 인증/인가            ]  🗑   │
│  ⠿ 2  [ etcd 저장                      ]  🗑   │
│  ⠿ 3  [ controller 감지                ]  🗑   │
│  ⠿ 4  [ scheduler 노드 선택            ]  🗑   │
│  ⠿ 5  [ kubelet 파드 생성              ]  🗑   │
│  [ + 항목 추가 ]                               │
│  ──────────────────────────────────────────  │
│                        [취소]  [저장]          │
└──────────────────────────────────────────────┘
  • 입력 순서 = 정답 순서 (0번이 1단계). 안내 문구로 명시
  • 항목 행: 드래그 핸들(⠿) + 번호 + 텍스트 입력(1~1000자) + 삭제(🗑)
  • 항목 재정렬은 편집 화면에서도 드래그(@dnd-kit)로. 핸들만 잡기
  • 항목 수 카운터 n / 7. 3개 미만이면 저장 비활성, 7개 도달 시 [+ 항목 추가] 비활성
  • 신규 항목의 id는 FE가 생성(nanoid). 저장 페이로드는 화면 순서대로 items 배열

공통:

  • [취소] [저장] (편집인 경우 [저장] / [삭제] 추가)
  • 저장 활성 조건: 종류별 검증 통과(BASIC=앞/뒤 채움, ORDERING=지시문+항목 3~7개) + dirty
  • 추가 시 토스트: 카드가 추가되었어요. 첫 복습은 내일.

API:

  • GET /api/planner/materials/:id/flashcards
  • POST /api/planner/materials/:id/flashcards
  • PATCH /api/planner/flashcards/:id
  • DELETE /api/planner/flashcards/:id

빈 상태: 중앙에 "아직 카드가 없습니다" + 큰 [+ 첫 카드 추가] 버튼

3.3.3 자료 편집 / 삭제

상세 헤더의 [⋯] 메뉴 → 자료 편집 / 삭제 다이얼로그.

자료 편집 다이얼로그: 제목, 유형, 상태 (ACTIVE/COMPLETED). 자료 삭제 확인: "노트와 카드(24장)가 모두 삭제됩니다. 계속하시겠어요?"


3.4 복습 허브 /planner/reviews (v2.5)

"오늘 복습"을 대체하는 복습 랜딩. 주 행동(복습 시작)을 잃지 않으면서 현황 파악 + 앞으로/완료 조회 + 여러 진입점을 한 화면에 통합한다. 레이아웃은 사이드바 분할형(좌 레일 = 요약·시작·자료별 / 우 메인 = 앞으로·완료 목록). 좁아지면(≈≤830px) 레일이 위로 스택. orino-fe(shadcn+Tailwind v4+OKLCH) 컴포넌트로 재현하며, 상태색은 시맨틱 토큰(success/warning/info/destructive)만 쓴다.

┌──────────────────────────────────────────────────────────────────┐
│  복습                                        ● 마지막 동기화 방금 전 │
│  오늘 할 복습부터 앞으로 · 완료까지 한 곳에서                          │
├──────────────────────────────────────────────────────────────────┤
│ ┌───── 이펙티브 자바 · 오늘 6장 복습을 시작합니다        [닫기] ┐   │ ← 시작 배너(조건부)
│ └──────────────────────────────────────────────────────────┘   │
├────────────────────────┬─────────────────────────────────────────┤
│  ┌ 지금 복습 ─────────┐ │  [ 앞으로 37 ] [ 완료 9 ]                 │ ← 세그먼트 탭
│  │ 18 장 · 약 12분    │ │  ─────────────────────────────────────  │
│  │ [ 전체 복습 시작 ] │ │  [전체 자료▾] [전체 기간▾] [전체 종류▾]   │ ← 필터
│  │ [ 밀린 것만 5    ] │ │  ┌ 밀린 카드만 보는 중 ✕ ┐ (조건부 스코프칩)│
│  └────────────────────┘ │  ─────────────────────────────────────  │
│  ● 지금 할 것       18  │  [양방향] 빌더 패턴을 선택하는 기준은?      │
│  ● 밀림              5  │           이펙티브 자바      [밀림]   지금  │
│  ● 앞으로           37  │  [양방향] 정적 팩터리 vs 생성자             │
│  ● 오늘 완료         9  │           이펙티브 자바             10분 후 │
│  ───────────────────   │  [순서]   LRU 페이지 교체 순서              │
│  자료별 · 눌러서 복습    │           운영체제·공룡책        오늘 20:30 │
│  이펙티브 자바   ● 6    │  [기본]   퀵정렬의 최악 시간복잡도          │
│  알고리즘 문제   ● 5    │           알고리즘 문제풀이       내일 07/12 │
│  운영체제·공룡책    4    │  ─────────────────────────────────────  │
│  SQL 튜닝           –   │  스크롤하면 예정된 복습을 계속 불러옵니다     │
└────────────────────────┴─────────────────────────────────────────┘

좌 레일 (현황 + 진입):

  • CTA 서브패널: 지금 복습 18장 · 약 12분 + [전체 복습 시작](primary, 전폭) + [밀린 것만 5](outline). 수치는 summary.counts.now / overdue / estimatedMinutes
  • 상태 4행(클릭 = 스코프 진입, 활성 행 --accent 하이라이트): 지금 할 것(점 primary) · 밀림(warning) · 앞으로(info, 기본 활성) · 오늘 완료(success). 우측 큰 수 = summary counts
  • 자료별 목록: 자료명 · (밀림 있으면 warning 점) · 오늘 due 수 또는 –(due 0). 행 클릭 = 그 자료로 필터 + 시작 배너. summary.materials[]

우 메인 (조회):

  • 세그먼트 탭(Tabs): 앞으로 N / 완료 K. 탭별로 필터 세트·목록 전환
  • 필터(Select): 앞으로 = 자료·기간(오늘/3일)·종류(기본/순서/양방향), 완료 = 자료·평가(다시/어려움/양호/쉬움)
  • 스코프 칩(조건부): 상태 배지로 필터되면 밀린 카드만 보는 중 ✕ / 오늘 예정만 보는 중 ✕. ✕로 해제
  • 앞으로 행: 종류 칩(기본/순서/양방향) + 앞면(ellipsis) + 자료명 + (밀림 pill=warning) + 예정 라벨. 예정이 지금/10분 후면 primary 강조, 그 외 muted
  • 완료 행: 앞면 + 자료명 + 평가 Badge(다시=destructive / 어려움=warning / 양호=success / 쉬움=info) + 복습 시각
  • 무한 스크롤: 두 목록 모두 커서 기반. 하단 안내 "스크롤하면 계속 불러옵니다" / "최근 복습 순 · 스크롤하면 계속"
  • 빈 상태(EmptyState): 필터 결과 0 → "조건에 맞는 … 없어요" + [필터 초기화]

인터랙션 (조회 ↔ 진입 통합, Open Items §0D.2):

  • 상태 배지 클릭: 지금 할 것→앞으로 탭 scope=today / 밀림→scope=overdue(+스코프칩) / 앞으로→scope=all / 오늘 완료→완료 탭
  • 자료 행 클릭: 그 자료로 필터 + 시작 배너 (due 0은 no-op)
  • [전체 복습 시작]→ scope=all 세션 진입 / [밀린 것만]→ scope=overdue 세션 진입
  • 필터는 클라이언트 즉시 반영(현재 페이지 로드분), 스크롤 시 서버에서 다음 페이지 fetch

시작 배너(조건부): 시작 액션 시 상단에 이펙티브 자바 · 오늘 6장 복습을 시작합니다 등(Alert variant="info"). [닫기]로 해제.

클라이언트 상태: tab(upcoming/done), scope(all/today/overdue), fMat, fWhen, fType, fGrade, banner.

데이터:

  • 요약 수치·자료별: GET /api/planner/reviews/summary (서버 집계)
  • 앞으로 목록: GET /api/planner/reviews/upcoming?scope&materialId&when&type&cursor&size
  • 완료 목록: GET /api/planner/reviews/completed?materialId&grade&cursor&size
  • 예정/완료 시각 라벨(지금/10분 후/오늘 20:30/어제 22:10)은 FE가 scheduledAt·completedAt으로 포맷

옵션(props): defaultTab(upcoming/done, 진입 기본 탭), showCardType(종류 칩 표시 여부).


3.5 복습 세션 /planner/reviews/session

허브의 시작 액션에서 진입하는 카드 넘기기 화면(구 "오늘 복습"). 스코프/자료 쿼리(?scope=all|overdue&materialId=)로 대상 카드를 정한다. 세션 큐·평가·burying은 기존 그대로 — 진입 시 GET /reviews/today(지금 due)를 받아 스코프/자료를 클라이언트에서 필터해 큐를 돈다(Open Items §0D.3).

┌─────────────────────────────────────────────┐
│  복습  3 / 7                                  │ ← 진행 카운터
├─────────────────────────────────────────────┤
│  📕 이펙티브 자바 · 2회차 · 2일 지연           │
├─────────────────────────────────────────────┤
│                                              │
│       정적 팩토리 메서드의 장점 4가지는?      │   ← 앞면
│                                              │
│  내 답                                        │
│  ┌────────────────────────────────────────┐  │ ← 답 적는 칸 (자동 포커스)
│  │ 떠오르는 대로 적어보세요                 │  │
│  │ (⌘/Ctrl+Enter로 답 보기)                │  │
│  └────────────────────────────────────────┘  │
│                                              │
│               [ 답 보기 ]                     │
│                                              │
└─────────────────────────────────────────────┘

답 보기 클릭 후:

┌─────────────────────────────────────────────┐
│  복습  3 / 7                                  │
├─────────────────────────────────────────────┤
│  📕 이펙티브 자바 · 2회차 · 2일 지연           │
├─────────────────────────────────────────────┤
│       정적 팩토리 메서드의 장점 4가지는?       │
│  ─────────────────────────────────────────  │
│  내 답                                        │ ← 내가 적은 것 (읽기 전용)
│  · 이름을 가질 수 있다                        │
│  · 인스턴스 통제                              │
│  ─────────────────────────────────────────  │
│  정답                                         │ ← 바로 아래에서 비교
│  · 이름을 가질 수 있다                        │
│  · 인스턴스 통제                              │
│  · 반환 타입 다형성                           │
│  · 매번 새 인스턴스 X                         │
├─────────────────────────────────────────────┤
│   1d        4d         6d         8d         │ ← 다음 간격 미리보기
│  ┌──────┐ ┌──────┐  ┌──────┐  ┌──────┐      │
│  │Again │ │Hard  │  │Good  │  │Easy  │      │
│  │  1   │ │  2   │  │  3   │  │  4   │      │
│  └──────┘ └──────┘  └──────┘  └──────┘      │
└─────────────────────────────────────────────┘

구성 요소:

  • 상단: 진행 카운터 + 자료 정보 + 회차 + 지연 라벨
  • 카드 앞면 (큰 폰트, 중앙 정렬, white-space: pre-wrap)
  • 초기 상태: 답 적는 칸 + "답 보기" 버튼
  • 답 공개 후: 내가 적은 답(읽기 전용) + 뒷면 표시 + 4지선다 버튼 활성화
  • 버튼 위에 다음 간격 미리보기(일수) 표시
  • 버튼 색상: AGAIN 빨강 / HARD 주황 / GOOD primary(#8b00ff) / EASY 초록

답 적는 칸 (#999): 머릿속으로만 떠올리면 답을 본 순간 "아 이거였지"가 되어 자기평가가 유리한 쪽으로 기운다. 적게 해서 리트리벌을 강제하고, 공개 후엔 적은 내용을 정답 바로 위에 읽기 전용으로 남겨 나란히 놓고 채점하게 한다. 순서 카드(§3.5.1)에도 동일하게 들어간다.

  • 저장하지 않는다 — 화면 전용 상태. 채점하면 다음 카드에서 비워진다. BE 무변경
  • 강제하지 않는다 — 빈칸이어도 답을 볼 수 있다(칸의 존재 자체가 넛지). 안 적었으면 공개 후 "내 답" 블록은 뜨지 않는다
  • 카드가 뜨면 자동 포커스해 바로 타이핑. 단 터치 기기(pointer: coarse)는 제외 — 질문을 읽기도 전에 가상 키보드가 화면을 덮는다(#994와 같은 이유)

키보드 단축키:

  • ⌘/Ctrl + Enter: 답 공개 — 입력칸에 포커스가 있는 기본 흐름의 단축키(Enter는 줄바꿈이라 쓸 수 없다)
  • Space 또는 Enter: 답 공개 — 입력칸 밖에 포커스가 있을 때만(터치 기기, 입력칸을 벗어난 경우)
  • 1 / 2 / 3 / 4: AGAIN / HARD / GOOD / EASY (답 공개 후에만). 공개 시 입력칸에서 포커스를 빼기 때문에 숫자가 입력으로 흘러들지 않는다

평가 처리:

  1. 클릭/키 입력 → POST /reviews/:id/complete { rating }
  2. 응답: { completed, nextReview, buriedReviewIds }
  3. 토스트: 다음 복습은 N일 후 (5/23) 1.5초
  4. 짝 카드 bury (v2.4): buriedReviewIds가 비어있지 않으면, 해당 review들을 현재 세션 큐에서 제거(오늘 안 나오게). 큐 진행 카운터(3 / 7)의 분모도 함께 줄인다. 밀린 게 있으면 보조 토스트 짝 카드는 다른 날 복습해요.
  5. 다음 카드로 이동 (또는 마지막이면 완료 화면)

API:

  • GET /api/planner/reviews/today — 진입 시 전체(지금 due) 불러와서 클라이언트 큐 관리. 스코프(전체/밀림)·자료 필터는 이 세트에서 클라이언트가 걸러 큐를 구성(세션 BE 무변경, Open Items §0D.3)
  • POST /api/planner/reviews/:id/complete — 카드별

완료 화면:

🎉 오늘 복습 7개 모두 완료!
오늘도 수고하셨어요.

[홈으로]  [학습 자료 보기]

빈 상태 (진입 시 0건): "오늘은 복습할 카드가 없어요! 🌱" + [홈으로]

3.5.1 순서 카드(ORDERING) 복습 (v2.3)

같은 오늘 복습 큐에 순서 카드(type: "ORDERING")가 섞여 온다. 카드 종류에 따라 본문만 분기하고, 상단 진행 카운터·자료 헤더·4지선다 버튼은 그대로 재사용한다.

① 배열 단계 (마운트 시 items를 셔플):

┌─────────────────────────────────────────────┐
│  복습  4 / 7                                  │
├─────────────────────────────────────────────┤
│  📕 쿠버네티스 정리 · 1회차                     │
├─────────────────────────────────────────────┤
│  kubectl apply 실행 이후 순서대로 배열          │   ← 지시문(front)
│                                              │
│   ⠿  etcd 저장                               │  ← 드래그로 재정렬
│   ⠿  kubelet 파드 생성                        │     (핸들 ⠿만 잡기)
│   ⠿  apiserver 인증/인가                      │
│   ⠿  scheduler 노드 선택                      │
│   ⠿  controller 감지                          │
│                                              │
│           [ 정답 확인 ]                        │
└─────────────────────────────────────────────┘

② 공개 단계 ([정답 확인] → revealed=true, 드래그 잠금):

┌─────────────────────────────────────────────┐
│  kubectl apply 실행 이후 순서대로 배열          │
│  ─────── 내 배열 ───────                      │
│   🟩 apiserver 인증/인가                      │  ← 위치 정답 = 초록
│   🟥 kubelet 파드 생성                        │  ← 위치 오답 = 빨강
│   🟥 controller 감지                          │
│   🟩 scheduler 노드 선택                      │
│   🟥 etcd 저장                                │
│  ─────── 정답 순서 ───────                    │
│   1. apiserver 인증/인가                      │
│   2. etcd 저장                                │
│   3. controller 감지                          │
│   4. scheduler 노드 선택                      │
│   5. kubelet 파드 생성                        │
├─────────────────────────────────────────────┤
│   1d        4d         6d         8d         │
│  [Again 1] [Hard 2]  [Good 3]  [Easy 4]      │  ← 기존 4지선다 그대로
└─────────────────────────────────────────────┘

구성 요소 / 규칙:

  • 셔플: 마운트 시 딱 1회(Fisher–Yates). 결과가 정답과 같으면 재셔플. 렌더마다 다시 섞지 않음

  • 드래그: @dnd-kit sortable. 핸들(⠿)만 잡기, 8px 이동 임계값(탭 오인 방지), arrayMove로 재배열. revealed면 드래그 무시

  • 색 표시 = 채점 아님: 공개 시 각 위치가 정답과 맞는지 초록/빨강으로만 표시. 점수·정답률은 계산도 표시도 안 함. 맞았는지 판단·평가 선택은 사용자 몫

  • 그 아래 정답 순서를 번호 리스트로 표시

  • 평가는 기존과 동일한 4지선다(AGAIN/HARD/GOOD/EASY) → POST /reviews/:id/complete. 정답/오답이 버튼을 자동 선택하지 않음

  • 항목 1개면 셔플 스킵(단, 최소 3개라 실질적으로 항상 셔플)

  • 답 적는 칸(#999)은 BASIC과 동일하게 들어간다 — 드래그로 배열한 근거를 적어두고 공개 후 비교한다

키보드: [정답 확인]은 BASIC의 "답 보기"와 동일 — 입력칸 안에서 ⌘/Ctrl+Enter, 입력칸 밖에서 Space/Enter. 공개 후 1/2/3/4 평가. 드래그 재정렬의 키보드 조작은 @dnd-kit 기본 키보드 센서 사용(입력칸은 드래그 영역 밖이라 서로 뺏기지 않는다).


3.6 복습 캘린더 /planner/calendar

투두메이트(TodoMate) 스타일의 월간 달력. 각 날짜 칸에 그날 예정/완료된 복습이 상태별 색 막대로 쌓여 보인다.

┌───────────────────────────────────────────────────────────┐
│  복습 캘린더            [◀]  2026년 5월  [▶]   [오늘]        │
├──────┬──────┬──────┬──────┬──────┬──────┬──────────────────┤
│  일   │  월   │  화   │  수   │  목   │  금   │  토              │
├──────┼──────┼──────┼──────┼──────┼──────┼──────────────────┤
│      │      │      │      │  1   │  2   │  3               │
│      │      │      │      │ ✅✅ │ ✅   │ ⚪⚪             │
├──────┼──────┼──────┼──────┼──────┼──────┼──────────────────┤
│  4   │  5   │  6   │  7   │  8   │  9   │  10              │
│ ✅   │ 🔴🔴 │ 🟣🟣 │ ⚪   │      │ ⚪⚪ │                  │
│      │      │ +2   │      │      │      │                  │
├──────┼──────┼──────┼──────┼──────┼──────┼──────────────────┤
│ ...                                                        │
└───────────────────────────────────────────────────────────┘
  🔴 밀림   🟣 오늘   ⚪ 예정   ✅ 완료              ← 범례

날짜 클릭 시 하단 패널(또는 우측 패널):

┌───────────────────────────────────────────────────────────┐
│  5월 16일 (금) · 복습 5건                            [✕]    │
│  ─────────────────────────────────────────────────────    │
│  🟣 오늘                                                    │
│   · 이펙티브 자바 · "정적 팩토리..." · 2회차                 │
│   · React 강의 · "useEffect..." · 1회차                    │
│  🔴 밀림 (5/14 예정)                                        │
│   · 알고리즘 · "이분탐색..." · 3회차                         │
│  ✅ 완료                                                    │
│   · 이펙티브 자바 · "equals..." · GOOD                      │
│  ─────────────────────────────────────────────────────    │
│  [오늘 복습 하러가기] (오늘/밀림 있을 때만)                   │
└───────────────────────────────────────────────────────────┘

구성 요소:

  • 헤더: 이전/다음 달 이동, 현재 연·월, [오늘] 버튼(이번 달로 점프)
  • 월간 그리드 (6주 × 7일). 앞뒤 달 일부 날짜는 흐리게
  • 각 날짜 칸: 그날 복습 항목을 상태별 색 점/막대로 표시. 많으면 일부만 + +N
    • 오늘 날짜 칸은 테두리 강조
  • 범례: 🔴밀림 / 🟣오늘 / ⚪예정 / ✅완료
  • 날짜 클릭 → 하단/우측 패널에 그날 복습 목록 (상태별 그룹). [오늘 복습 하러가기]로 /planner/reviews/today 이동

상태 분류 (각 항목의 scheduledAt와 오늘 비교):

  • COMPLETED → ✅ 완료 (회색)
  • PENDING + DATE(scheduledAt) < today → 🔴 밀림 (red-500)
  • PENDING + DATE(scheduledAt) = today → 🟣 오늘 (primary)
  • PENDING + DATE(scheduledAt) > today → ⚪ 예정 (muted)

데이터 로드:

  • 월 이동 시 GET /api/planner/reviews/calendar?from=<그리드 첫날>&to=<그리드 마지막날>
  • FE에서 날짜별 그룹핑 + 상태 분류 + 카운트 계산

보기 전용: 캘린더에서 직접 평가하지 않는다. 실제 복습은 [오늘 복습 하러가기] → 오늘 복습 화면에서.

빈 상태 (해당 월 복습 0건): 달력은 그대로 표시하되 "이 달에는 복습 일정이 없어요" 안내.

모바일: 월 그리드 유지(칸 작아짐, 점만 표시). 날짜 탭 → 하단 시트로 그날 목록.

4. 디자인 가이드

디자인 시스템을 따른다. 주요 적용:

  • 카드 컴포넌트: shadcn/ui <Card>
  • 다이얼로그: shadcn/ui <Dialog>
  • 진행률 바 / 카운터: <Progress> + 텍스트
  • 다크모드 대응
  • 폰트: Pretendard
  • Primary: #8b00ff
  • 강조 색상: AGAIN text-red-500 / HARD text-orange-500 / GOOD text-primary / EASY text-green-500

4.1 빈 상태 카피

  • 학습 자료 목록: "아직 등록된 학습 자료가 없습니다"
  • 카드 탭: "아직 카드가 없습니다"
  • 노트 탭 (트리 0개): "아직 노트가 없습니다" + [+ 첫 노트 만들기]
  • 노트 본문 (선택 안 됨): "왼쪽에서 노트를 선택하거나 새로 만드세요"
  • 노트 본문 (빈 노트): Tiptap placeholder "학습한 내용을 정리해보세요..."
  • 오늘 복습 (0건): "오늘은 복습할 카드가 없어요! 🌱"

4.2 에러 / 토스트

  • 자료 생성: ✅ 자료를 만들었어요
  • 카드 추가: ✅ 카드가 추가되었어요. 첫 복습은 내일.
  • 노트 저장 실패: ⚠️ 저장 실패 (재시도) (헤더 상태 영역)
  • 복습 평가: 다음 복습은 N일 후 (M/D)

4.3 모바일

  • 사이드바: 햄버거 메뉴
  • 자료 상세: 탭 동일. 노트 탭은 2-pane 대신 트리 → 에디터 드릴다운 (에디터에서 [← 노트 목록])
  • 오늘 복습 카드: 화면 폭에 맞춰 풀스크린. 버튼 4개를 2x2 그리드로 배치

5. 범위에 없는 화면 (차기 이후)

  • 캘린더 (일/주/월 뷰)
  • 통계, 히트맵, 스트릭
  • 카테고리/목표 화면
  • 카드 일괄 입력 (CSV/Anki 임포트)
  • 노트 검색 페이지
  • 노트 즐겨찾기/아이콘/커버
  • 노트 ↔ 카드 인라인 연결
  • 알림 설정

Clone this wiki locally