Repository navigation
Study Planner Usecase
범위: 학습 자료 등록 / 노트 작성(인라인 하위 페이지) / 카드 추가 → 첫 복습 / 복습 허브 + 복습 세션 / 복습 캘린더 / 자료 관리. v2.2 변경: 노트를 Notion 인라인 하위 페이지 방식으로 (본문
/페이지로 하위 노트). v2.5 변경: "오늘 복습"을 복습 허브(/planner/reviews)로 확장 — 현황(지금/밀림/앞으로/오늘 완료) + 앞으로·완료 목록(필터·무한 스크롤) + 여러 진입점. 카드 넘기기는 복습 세션(/planner/reviews/session)으로 분리. UC-09 참조.
| 항목 | 내용 |
|---|---|
| 사용자 | 본인 (단일 사용자) |
| 사용 맥락 | 책/강의를 보면서 학습한 내용을 정리하고, 핵심을 카드로 뽑아 복습 |
| 빈도 | 매일 짧게 (오늘 복습 5~30분), 학습 시 노트/카드 작성 |
| 디바이스 | 데스크탑 위주, 모바일에서도 복습 가능 |
- 학습 노트 트리 — 자료를 보면서 핵심을 중첩 노트로 정리 (Notion처럼)
- 플래시카드 — 노트에서 뽑아낸 핵심을 셀프 테스트 (Anki처럼)
- 자동 복습 사이클 — SM-2가 다음 복습 날짜를 자동으로 잡아줌
- 놓쳐도 OK — 밀린 복습은 자동으로 오늘 합류, 지연 일수만 표시
| 경로 | 화면 |
|---|---|
/home |
메인 |
/planner/materials |
학습 자료 목록 |
/planner/materials/:id |
학습 자료 상세 ([노트] / [카드] 탭) |
/planner/reviews |
복습 허브 (현황 + 앞으로/완료 + 진입점) |
/planner/reviews/session |
복습 세션 (카드 단위 4지선다) |
상황: 이펙티브 자바를 읽으며 "1장" 노트를 쓰다가, 그 안에서 세부 항목을 하위 페이지로 만들어 정리하고 싶다. (Notion처럼 글 흐름 안 끊고)
사용자 시스템
│ │
│ [+ 자료 추가] → 이펙티브 자바/BOOK │
│────────────────────────────────▶│ 학습 자료 생성 (노트 0개)
│ │ /materials/:id?tab=note 이동
│ │
│ [+ 새 노트] → "1장 객체 생성" │
│────────────────────────────────▶│ POST /materials/:id/notes (루트)
│ │
│ 본문 작성: "객체를 만드는 방법..." │
│ │
│ 본문에서 /페이지 입력 │
│────────────────────────────────▶│ POST /materials/:id/notes
│ │ { parentId: 1장.id } → noteId
│ │ 본문에 📄"제목없음" childPage 블록 삽입
│ │
│ 블록 제목을 "정적 팩토리 메서드"로 │
│ 이어서 본문 계속 작성 (흐름 유지) │
│────────────────────────────────▶│
│ │ PATCH /notes/1장 { content } (블록 포함)
│ │ "저장됨 · HH:mm"
│ │
│ 📄 정적 팩토리 블록 클릭 │
│────────────────────────────────▶│ 자식 노트로 진입 → 본문 작성
│ │ PATCH /notes/정적팩토리 { content }
결과: "1장" 본문 안에 "정적 팩토리 메서드" 하위 페이지가 인라인으로 박혔고, 글쓰기 흐름을 끊지 않고 중첩 노트를 만들었다.
상황: 노트에 정리한 핵심 중 외워두고 싶은 부분을 카드로 만든다.
사용자 시스템
│ │
│ [📇 카드 24] 탭으로 전환 │
│────────────────────────────────▶│
│ │ GET /materials/:id/flashcards
│ │
│ [+ 카드 추가] 클릭 │
│ - 앞: "정적 팩토리 메서드의 │
│ 장점 4가지는?" │
│ - 뒤: "이름을 가질 수 있다 ..." │
│────────────────────────────────▶│
│ │ flashcard 생성
│ │ 첫 복습 자동 생성:
│ │ sequence=1, interval=1
│ │ ease=2.50, today+1
│ │
│ ✅ "카드 추가됨. 내일 첫 복습." │
│◀────────────────────────────────│
결과: 카드가 만들어졌고, 내일부터 복습이 시작된다.
상황: 등록한 카드의 첫 복습일이 도래했다.
사용자 시스템
│ │
│ /planner/reviews/today 진입 │
│────────────────────────────────▶│
│ │ GET /reviews/today
│ │ PENDING + scheduled<=today 조회
│ │
│ 카드 앞면 + 답 적는 칸 표시 │
│ "정적 팩토리 메서드의 장점..." │
│ │
│ 떠오르는 답을 적는다 │ (화면 전용 — 서버로 안 감)
│ │
│ ⌘/Ctrl+Enter (또는 [답 보기]) │
│────────────────────────────────▶│
│ │ 뒷면 공개 (내 답 바로 아래)
│ │ 4지선다 버튼 활성화
│ │ 각 버튼 위에 다음 간격 미리보기
│ │
│ 3 키 (GOOD) 선택 │
│────────────────────────────────▶│
│ │ POST /reviews/:id/complete
│ │ { rating: "GOOD" }
│ │
│ │ 현재 review COMPLETED
│ │ SM-2 계산:
│ │ - sequence=2, interval=6
│ │ - new ease ≈ 2.60
│ │ 다음 review 생성 (today+6)
│ │
│ 토스트: "다음 복습은 6일 후" │
│ 다음 카드로 자동 이동 │
결과: 첫 복습 완료. 6일 후 다음 복습이 잡혔다.
상황: 며칠 복습을 못 했다. 5월 17일에 진입했는데 5월 15일 예정 카드가 있다.
사용자 시스템
│ │
│ /planner/reviews/today 진입 │
│────────────────────────────────▶│
│ │ scheduled<=today AND PENDING
│ │ → 밀린 항목도 함께 반환
│ │
│ 상단 라벨: "2일 지연" │
│ │
│ 뒤늦게 평가 (예: GOOD) │
│────────────────────────────────▶│
│ │ 다음 review의 scheduled_at =
│ │ TODAY + new_interval
│ │ (※ 예정일 + interval 아님)
│ │
│ → 과거 누적이 다음 일정을 어지럽히지 │
│ 않음 │
결과: 밀린 복습이 처리되고, 다음 일정은 오늘 기준으로 잡힌다.
상황: 복습 중 헷갈리는 카드가 있다. 노트로 돌아가 맥락을 확인하고 싶다.
사용자 시스템
│ │
│ 오늘 복습 중 자료 정보 클릭 │
│ ("📕 이펙티브 자바") │
│────────────────────────────────▶│
│ │ /planner/materials/:id?tab=note
│ │ 로 이동, 노트 탭 표시
│ │
│ 노트에서 해당 내용 확인 │
│ 필요 시 노트 수정 (자동 저장) │
│ │
│ 뒤로 가기 → 복습 이어서 │
결과: 노트 ↔ 카드 사이를 오가며 학습과 복습을 병행할 수 있다.
상황: 본문에 만든 하위 페이지가 더 이상 필요 없다.
사용자 시스템
│ │
│ 본문에서 📄"싱글턴" 블록 선택 후 삭제 │
│────────────────────────────────▶│ childPage 블록 제거 감지
│ │ "하위 노트(+자손 N개)도 삭제됩니다" 확인
│ 확인 │
│────────────────────────────────▶│ DELETE /notes/싱글턴
│ │ 서브트리 cascade 삭제
│ │ 본문 content에서 블록 제거 후 저장
│ │ 사이드바 트리 갱신
결과: 본문에서 하위 페이지를 지우면 노트도 함께 정리된다.
1차 범위 밖: 노트 이동(부모 변경), childPage 블록 복붙은 인라인 모델에서 본문↔트리 동기화가 복잡해 차기로 미룬다. 잘못 둔 노트는 삭제 후 재생성.
상황: 카드 내용을 잘못 작성했거나, 더 이상 필요 없는 자료를 정리한다.
사용자 시스템
│ │
│ [카드 탭] → [편집] │
│────────────────────────────────▶│ PATCH /flashcards/:id
│ │ (복습 일정은 영향 없음)
│ │
│ [카드 탭] → [삭제] → 확인 │
│────────────────────────────────▶│ DELETE /flashcards/:id
│ │ + review_schedule cascade 삭제
│ │
│ 자료 [⋯] → [삭제] → 확인 │
│ "노트와 카드(24장)가 모두 │
│ 삭제됩니다" │
│────────────────────────────────▶│ DELETE /materials/:id
│ │ + note + flashcards
│ │ + review_schedule
│ │ 모두 cascade 삭제
결과: 데이터를 안전하게 정리할 수 있다.
상황: 이번 달 복습을 얼마나 했고 앞으로 뭐가 밀려있는지 한눈에 보고 싶다.
사용자 시스템
│ │
│ 사이드바 📅 복습 캘린더 클릭 │
│────────────────────────────────▶│
│ │ GET /reviews/calendar
│ │ ?from=..&to=..
│ │ 월간 그리드 렌더링
│ │ 날짜별 상태 색 표시:
│ │ 🔴밀림 🟣오늘 ⚪예정 ✅완료
│ │
│ 5/16 날짜 클릭 │
│────────────────────────────────▶│ 하단 패널에 그날 복습 목록
│ │ (상태별 그룹)
│ │
│ [오늘 복습 하러가기] 클릭 │
│────────────────────────────────▶│ /planner/reviews/today 이동
│ │
│ [▶] 다음 달 이동 │
│────────────────────────────────▶│ GET /reviews/calendar (다음 달 범위)
결과: 지난 복습 이력과 앞으로의 일정을 달력으로 조망하고, 필요하면 바로 오늘 복습으로 진입한다.
상황: 오늘 복습을 하려는데, 지금 뭐가 밀렸고 뭐가 다가오는지 먼저 보고 싶다. "다시" 눌렀던 카드가 10분 뒤 다시 온다는 것도 확인하고 싶다.
사용자 시스템
│ │
│ 사이드바 "복습" → /planner/reviews │
│────────────────────────────────▶│ GET /reviews/summary
│ │ counts{지금18·밀림5·앞으로37·오늘완료9}
│ │ materials[자료별 due/밀림/다음]
│ │ GET /reviews/upcoming (첫 페이지)
│ │
│ 좌 레일에서 현황 한눈에 파악 │
│ 우 메인 "앞으로" 목록: │
│ · 지금 / 10분 후(다시 카드) / │
│ 오늘 20:30 / 내일 ... │ ← 스크롤 시 다음 페이지 fetch
│ │
│ "밀림 5" 배지 클릭 │
│────────────────────────────────▶│ scope=overdue → 목록이 밀림만
│ │ 스코프 칩 "밀린 카드만 보는 중 ✕"
│ │
│ [밀린 것만 5] 시작 │
│────────────────────────────────▶│ /planner/reviews/session?scope=overdue
│ │ GET /reviews/today(지금 due) 로드
│ │ → 밀림만 클라 필터해 세션 큐 구성
│ │ (카드 넘기기·4지선다 = 기존 UC-03)
결과: 복습이 어떻게 돌아가는지(지금/밀림/앞으로/완료)를 한 화면에서 파악하고, 원하는 스코프(전체/밀림/자료별)로 바로 복습을 시작한다. "다시" 카드의 10분 후 재복습도 앞으로 목록에서 확인된다.
자료별 진입: 좌 레일 자료 행(예: "이펙티브 자바 · 6")을 클릭하면 그 자료로 필터되고 시작 배너가 뜬다. [시작] 시
?materialId=로 그 자료 카드만 세션을 돈다.완료 회고: "완료" 탭에서 최근 복습 이력(자료·평가 등급·시각)을 무한 스크롤로 훑는다. 자료·평가로 필터 가능.
- 카드 일괄 입력 — 한 번에 1장씩만 추가. CSV/Anki 임포트는 차기
- 카드 정렬 변경 — 생성순 고정. sort_order 도입은 차기
- 카드 멀티미디어 — 이미지/오디오 없음
- 노트 풀텍스트 검색 — Tiptap 안에서 Ctrl+F만 (브라우저 기본)
- 노트 인라인 카드 — 노트와 카드는 분리. 클릭 한 번에 카드 생성 X
- 노트 즐겨찾기/아이콘/커버 — 트리 + 제목만. Notion 메타는 차기
- 노트의 카드 소속 — 카드는 자료 직속. 특정 노트에 카드를 매다는 건 차기
- 알림 — 복습 알림 없음. 사용자가 직접 진입
- 통계/스트릭 — 학습 기록 시각화 없음
- 노트 ↔ 카드 인라인 연결 (Tiptap 커스텀 노드)
- 카드 태그/덱
- 카드 클로즈(빈칸) 타입
- 노트 검색
- 카테고리/목표
- 알림, 통계, 캘린더