Repository navigation
Study Planner UI Design
범위: 메인 진입 카드 + 학습 자료 목록 + 자료 상세(노트 탭 / 카드 탭) + 복습 허브 + 복습 세션(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.
| 경로 | 화면 | 비고 |
|---|---|---|
/home |
메인 (홈) | 진입 카드 |
/planner/materials |
학습 자료 목록 | |
/planner/materials/:id |
학습 자료 상세 | [노트] / [카드] 탭 |
/planner/reviews |
복습 허브 | 현황 + 앞으로/완료 목록 + 진입점 (v2.5) |
/planner/reviews/session |
복습 세션 | 카드 단위 4지선다 평가 (허브에서 진입, 스코프 쿼리) |
/planner/reviews/today |
(리다이렉트) | → /planner/reviews (구 라우트 호환) |
/planner/calendar |
복습 캘린더 | 월간 달력 (투두메이트 스타일) |
┌─────────────────┐
│ 🏠 홈 │ /home
│ 📚 학습 자료 │ /planner/materials
│ 📝 복습 ⓢ │ /planner/reviews ← 뱃지: 지금 할 복습 수
│ 📅 복습 캘린더 │ /planner/calendar
└─────────────────┘
뱃지는 GET /api/planner/reviews/summary의 counts.now(지금 할 것). 0이면 표시 안 함. (v2.5 전에는 /reviews/today 길이를 썼다.)
┌──────────────────────────────────────────────┐
│ 안녕하세요! │
│ │
│ ┌──────────────────┐ ┌──────────────────┐ │
│ │ 📝 │ │ 📚 │ │
│ │ 오늘 복습 │ │ 학습 자료 │ │
│ │ 3 건 │ │ 5 개 │ │
│ │ [시작하기] │ │ [둘러보기] │ │
│ └──────────────────┘ └──────────────────┘ │
└──────────────────────────────────────────────┘
구성 요소:
- "오늘 복습" 카드: 오늘 + 밀린 복습 수. 클릭 시
/planner/reviews/today - "학습 자료" 카드: ACTIVE 자료 수. 클릭 시
/planner/materials
API: GET /api/planner/reviews/today (개수만), GET /api/planner/materials?status=ACTIVE (개수만)
빈 상태: "오늘 복습 0건 — 모두 완료했어요!" / "등록된 학습 자료가 없습니다 + [추가] 버튼"
┌─────────────────────────────────────────────┐
│ 학습 자료 [+ 자료 추가] │
├─────────────────────────────────────────────┤
│ 📕 이펙티브 자바 · BOOK │
│ 카드 24장 · 오늘 복습 3개 │
│ ───────────────────────────────────────── │
│ 🎬 React 강의 · LECTURE │
│ 카드 8장 · 오늘 복습 0개 │
│ ───────────────────────────────────────── │
│ ... │
└─────────────────────────────────────────────┘
구성 요소:
- 자료 카드: 아이콘(type별), 제목, 카드 수, 오늘 복습 수
- 카드 클릭 시
/planner/materials/:id로 이동 - 우상단 [+ 자료 추가] 버튼 → 다이얼로그
다이얼로그 (자료 추가):
- 입력: 제목 (text, 1~200자), 유형 (select: 책/강의/문제집/MOOC)
- [취소] [추가] → 생성 후 상세 화면(노트 탭)으로 자동 이동
빈 상태: 중앙에 "아직 등록된 학습 자료가 없습니다" + 큰 [+ 첫 자료 추가] 버튼
┌─────────────────────────────────────────────┐
│ ← 뒤로 │
├─────────────────────────────────────────────┤
│ 📕 이펙티브 자바 [⋯ 편집/삭제] │
│ BOOK · 카드 24장 · 오늘 복습 3개 │
├─────────────────────────────────────────────┤
│ [📝 노트] [📇 카드 24] │ ← 탭 전환
└─────────────────────────────────────────────┘
탭 두 개. URL 쿼리스트링으로 상태 보존 (?tab=note / ?tab=cards, 기본 note).
좌측 사이드바 트리(네비게이션) + 우측 에디터 2-pane. 하위 노트는 본문에서 /페이지로 만든다.
┌─────────────────────────────────────────────────────────┐
│ ...(자료 헤더)... │
│ [📝 노트] [📇 카드 24] │
├──────────────────┬──────────────────────────────────────┤
│ 노트 [+ 새노트] │ 저장됨 · 12:34 │
│ ────────────── ├──────────────────────────────────────┤
│ ▾ 1장 객체 생성 │ 제목: [ 1장 객체 생성 ] │
│ 📄 정적 팩토리 │ ───────────────────────────────── │
│ 📄 싱글턴 │ 객체를 만드는 방법 정리. │
│ ▸ 2장 객체 파괴 │ │
│ │ 📄 정적 팩토리 메서드 ← childPage │
│ │ 📄 싱글턴 ← childPage │
│ │ │
│ │ 이어서 본문 계속 작성... /페이지 │
└──────────────────┴──────────────────────────────────────┘
↑ 트리(네비) ↑ 본문 안에 하위 노트가 블록으로 박힘
인라인 하위 페이지 (핵심 UX):
- 본문 작성 중
/페이지입력(슬래시 커맨드) 또는 툴바 [+ 페이지] →-
POST /materials/:id/notes { parentId: 현재노트 }→ noteId 수신 - 본문 커서 위치에
childPage블록(📄 + 제목) 삽입 - 글쓰기 흐름 안 끊고 본문 계속 작성
-
-
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 블록 탭 → 자식으로 진입, [← 뒤로]로 복귀.
┌─────────────────────────────────────────────┐
│ ...(자료 헤더)... │
│ [📝 노트] [📇 카드 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, 1
1000자), 뒷면 (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/flashcardsPOST /api/planner/materials/:id/flashcardsPATCH /api/planner/flashcards/:idDELETE /api/planner/flashcards/:id
빈 상태: 중앙에 "아직 카드가 없습니다" + 큰 [+ 첫 카드 추가] 버튼
상세 헤더의 [⋯] 메뉴 → 자료 편집 / 삭제 다이얼로그.
자료 편집 다이얼로그: 제목, 유형, 상태 (ACTIVE/COMPLETED). 자료 삭제 확인: "노트와 카드(24장)가 모두 삭제됩니다. 계속하시겠어요?"
"오늘 복습"을 대체하는 복습 랜딩. 주 행동(복습 시작)을 잃지 않으면서 현황 파악 + 앞으로/완료 조회 + 여러 진입점을 한 화면에 통합한다. 레이아웃은 사이드바 분할형(좌 레일 = 요약·시작·자료별 / 우 메인 = 앞으로·완료 목록). 좁아지면(≈≤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(종류 칩 표시 여부).
허브의 시작 액션에서 진입하는 카드 넘기기 화면(구 "오늘 복습"). 스코프/자료 쿼리(?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 (답 공개 후에만). 공개 시 입력칸에서 포커스를 빼기 때문에 숫자가 입력으로 흘러들지 않는다
평가 처리:
- 클릭/키 입력 →
POST /reviews/:id/complete { rating } - 응답:
{ completed, nextReview, buriedReviewIds } - 토스트:
다음 복습은 N일 후 (5/23)1.5초 -
짝 카드 bury (v2.4):
buriedReviewIds가 비어있지 않으면, 해당 review들을 현재 세션 큐에서 제거(오늘 안 나오게). 큐 진행 카운터(3 / 7)의 분모도 함께 줄인다. 밀린 게 있으면 보조 토스트짝 카드는 다른 날 복습해요. - 다음 카드로 이동 (또는 마지막이면 완료 화면)
API:
-
GET /api/planner/reviews/today— 진입 시 전체(지금 due) 불러와서 클라이언트 큐 관리. 스코프(전체/밀림)·자료 필터는 이 세트에서 클라이언트가 걸러 큐를 구성(세션 BE 무변경, Open Items §0D.3) -
POST /api/planner/reviews/:id/complete— 카드별
완료 화면:
🎉 오늘 복습 7개 모두 완료!
오늘도 수고하셨어요.
[홈으로] [학습 자료 보기]
빈 상태 (진입 시 0건): "오늘은 복습할 카드가 없어요! 🌱" + [홈으로]
같은 오늘 복습 큐에 순서 카드(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 기본 키보드 센서 사용(입력칸은 드래그 영역 밖이라 서로 뺏기지 않는다).
투두메이트(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건): 달력은 그대로 표시하되 "이 달에는 복습 일정이 없어요" 안내.
모바일: 월 그리드 유지(칸 작아짐, 점만 표시). 날짜 탭 → 하단 시트로 그날 목록.
디자인 시스템을 따른다. 주요 적용:
- 카드 컴포넌트: shadcn/ui
<Card> - 다이얼로그: shadcn/ui
<Dialog> - 진행률 바 / 카운터:
<Progress>+ 텍스트 - 다크모드 대응
- 폰트: Pretendard
- Primary:
#8b00ff - 강조 색상: AGAIN
text-red-500/ HARDtext-orange-500/ GOODtext-primary/ EASYtext-green-500
- 학습 자료 목록: "아직 등록된 학습 자료가 없습니다"
- 카드 탭: "아직 카드가 없습니다"
- 노트 탭 (트리 0개): "아직 노트가 없습니다" + [+ 첫 노트 만들기]
- 노트 본문 (선택 안 됨): "왼쪽에서 노트를 선택하거나 새로 만드세요"
- 노트 본문 (빈 노트): Tiptap placeholder "학습한 내용을 정리해보세요..."
- 오늘 복습 (0건): "오늘은 복습할 카드가 없어요! 🌱"
- 자료 생성:
✅ 자료를 만들었어요 - 카드 추가:
✅ 카드가 추가되었어요. 첫 복습은 내일. - 노트 저장 실패:
⚠️ 저장 실패 (재시도)(헤더 상태 영역) - 복습 평가:
다음 복습은 N일 후 (M/D)
- 사이드바: 햄버거 메뉴
- 자료 상세: 탭 동일. 노트 탭은 2-pane 대신 트리 → 에디터 드릴다운 (에디터에서 [← 노트 목록])
- 오늘 복습 카드: 화면 폭에 맞춰 풀스크린. 버튼 4개를 2x2 그리드로 배치
- 캘린더 (일/주/월 뷰)
- 통계, 히트맵, 스트릭
- 카테고리/목표 화면
- 카드 일괄 입력 (CSV/Anki 임포트)
- 노트 검색 페이지
- 노트 즐겨찾기/아이콘/커버
- 노트 ↔ 카드 인라인 연결
- 알림 설정