Skip to content

Study Planner Usecase

wcorn edited this page Aug 2, 2026 · 12 revisions

사용 시나리오: Study Planner (v2.5)

범위: 학습 자료 등록 / 노트 작성(인라인 하위 페이지) / 카드 추가 → 첫 복습 / 복습 허브 + 복습 세션 / 복습 캘린더 / 자료 관리. v2.2 변경: 노트를 Notion 인라인 하위 페이지 방식으로 (본문 /페이지로 하위 노트). v2.5 변경: "오늘 복습"을 복습 허브(/planner/reviews)로 확장 — 현황(지금/밀림/앞으로/오늘 완료) + 앞으로·완료 목록(필터·무한 스크롤) + 여러 진입점. 카드 넘기기는 복습 세션(/planner/reviews/session)으로 분리. UC-09 참조.

1. 페르소나

항목 내용
사용자 본인 (단일 사용자)
사용 맥락 책/강의를 보면서 학습한 내용을 정리하고, 핵심을 카드로 뽑아 복습
빈도 매일 짧게 (오늘 복습 5~30분), 학습 시 노트/카드 작성
디바이스 데스크탑 위주, 모바일에서도 복습 가능

2. 핵심 가치

  1. 학습 노트 트리 — 자료를 보면서 핵심을 중첩 노트로 정리 (Notion처럼)
  2. 플래시카드 — 노트에서 뽑아낸 핵심을 셀프 테스트 (Anki처럼)
  3. 자동 복습 사이클 — SM-2가 다음 복습 날짜를 자동으로 잡아줌
  4. 놓쳐도 OK — 밀린 복습은 자동으로 오늘 합류, 지연 일수만 표시

3. 라우트

경로 화면
/home 메인
/planner/materials 학습 자료 목록
/planner/materials/:id 학습 자료 상세 ([노트] / [카드] 탭)
/planner/reviews 복습 허브 (현황 + 앞으로/완료 + 진입점)
/planner/reviews/session 복습 세션 (카드 단위 4지선다)

4. 시나리오

UC-01: 학습 자료 등록 + 노트 작성 (인라인 하위 페이지)

상황: 이펙티브 자바를 읽으며 "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장" 본문 안에 "정적 팩토리 메서드" 하위 페이지가 인라인으로 박혔고, 글쓰기 흐름을 끊지 않고 중첩 노트를 만들었다.


UC-02: 카드 추가 → 복습 시작

상황: 노트에 정리한 핵심 중 외워두고 싶은 부분을 카드로 만든다.

사용자                            시스템
  │                                 │
  │  [📇 카드 24] 탭으로 전환          │
  │────────────────────────────────▶│
  │                                 │  GET /materials/:id/flashcards
  │                                 │
  │  [+ 카드 추가] 클릭                │
  │  - 앞: "정적 팩토리 메서드의      │
  │         장점 4가지는?"            │
  │  - 뒤: "이름을 가질 수 있다 ..."   │
  │────────────────────────────────▶│
  │                                 │  flashcard 생성
  │                                 │  첫 복습 자동 생성:
  │                                 │   sequence=1, interval=1
  │                                 │   ease=2.50, today+1
  │                                 │
  │  ✅ "카드 추가됨. 내일 첫 복습."   │
  │◀────────────────────────────────│

결과: 카드가 만들어졌고, 내일부터 복습이 시작된다.


UC-03: 오늘의 복습 (4지선다 평가)

상황: 등록한 카드의 첫 복습일이 도래했다.

사용자                            시스템
  │                                 │
  │  /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일 후 다음 복습이 잡혔다.


UC-04: 밀린 복습 처리

상황: 며칠 복습을 못 했다. 5월 17일에 진입했는데 5월 15일 예정 카드가 있다.

사용자                            시스템
  │                                 │
  │  /planner/reviews/today 진입      │
  │────────────────────────────────▶│
  │                                 │  scheduled<=today AND PENDING
  │                                 │  → 밀린 항목도 함께 반환
  │                                 │
  │  상단 라벨: "2일 지연"             │
  │                                 │
  │  뒤늦게 평가 (예: GOOD)            │
  │────────────────────────────────▶│
  │                                 │  다음 review의 scheduled_at =
  │                                 │   TODAY + new_interval
  │                                 │  (※ 예정일 + interval 아님)
  │                                 │
  │  → 과거 누적이 다음 일정을 어지럽히지  │
  │     않음                           │

결과: 밀린 복습이 처리되고, 다음 일정은 오늘 기준으로 잡힌다.


UC-05: 노트와 카드 함께 보기

상황: 복습 중 헷갈리는 카드가 있다. 노트로 돌아가 맥락을 확인하고 싶다.

사용자                            시스템
  │                                 │
  │  오늘 복습 중 자료 정보 클릭         │
  │  ("📕 이펙티브 자바")               │
  │────────────────────────────────▶│
  │                                 │  /planner/materials/:id?tab=note
  │                                 │  로 이동, 노트 탭 표시
  │                                 │
  │  노트에서 해당 내용 확인            │
  │  필요 시 노트 수정 (자동 저장)       │
  │                                 │
  │  뒤로 가기 → 복습 이어서            │

결과: 노트 ↔ 카드 사이를 오가며 학습과 복습을 병행할 수 있다.


UC-06: 하위 노트 삭제

상황: 본문에 만든 하위 페이지가 더 이상 필요 없다.

사용자                            시스템
  │                                 │
  │  본문에서 📄"싱글턴" 블록 선택 후 삭제 │
  │────────────────────────────────▶│  childPage 블록 제거 감지
  │                                 │  "하위 노트(+자손 N개)도 삭제됩니다" 확인
  │  확인                            │
  │────────────────────────────────▶│  DELETE /notes/싱글턴
  │                                 │  서브트리 cascade 삭제
  │                                 │  본문 content에서 블록 제거 후 저장
  │                                 │  사이드바 트리 갱신

결과: 본문에서 하위 페이지를 지우면 노트도 함께 정리된다.

1차 범위 밖: 노트 이동(부모 변경), childPage 블록 복붙은 인라인 모델에서 본문↔트리 동기화가 복잡해 차기로 미룬다. 잘못 둔 노트는 삭제 후 재생성.


UC-07: 카드 / 자료 수정 / 삭제

상황: 카드 내용을 잘못 작성했거나, 더 이상 필요 없는 자료를 정리한다.

사용자                            시스템
  │                                 │
  │ [카드 탭] → [편집]                 │
  │────────────────────────────────▶│  PATCH /flashcards/:id
  │                                 │  (복습 일정은 영향 없음)
  │                                 │
  │ [카드 탭] → [삭제] → 확인          │
  │────────────────────────────────▶│  DELETE /flashcards/:id
  │                                 │  + review_schedule cascade 삭제
  │                                 │
  │ 자료 [⋯] → [삭제] → 확인          │
  │ "노트와 카드(24장)가 모두             │
  │   삭제됩니다"                     │
  │────────────────────────────────▶│  DELETE /materials/:id
  │                                 │  + note + flashcards
  │                                 │  + review_schedule
  │                                 │  모두 cascade 삭제

결과: 데이터를 안전하게 정리할 수 있다.


UC-08: 복습 캘린더로 일정 보기

상황: 이번 달 복습을 얼마나 했고 앞으로 뭐가 밀려있는지 한눈에 보고 싶다.

사용자                            시스템
  │                                 │
  │  사이드바 📅 복습 캘린더 클릭        │
  │────────────────────────────────▶│
  │                                 │  GET /reviews/calendar
  │                                 │   ?from=..&to=..
  │                                 │  월간 그리드 렌더링
  │                                 │  날짜별 상태 색 표시:
  │                                 │   🔴밀림 🟣오늘 ⚪예정 ✅완료
  │                                 │
  │  5/16 날짜 클릭                   │
  │────────────────────────────────▶│  하단 패널에 그날 복습 목록
  │                                 │  (상태별 그룹)
  │                                 │
  │  [오늘 복습 하러가기] 클릭          │
  │────────────────────────────────▶│  /planner/reviews/today 이동
  │                                 │
  │  [▶] 다음 달 이동                 │
  │────────────────────────────────▶│  GET /reviews/calendar (다음 달 범위)

결과: 지난 복습 이력과 앞으로의 일정을 달력으로 조망하고, 필요하면 바로 오늘 복습으로 진입한다.


UC-09: 복습 허브에서 현황 파악 → 복습 시작 (v2.5)

상황: 오늘 복습을 하려는데, 지금 뭐가 밀렸고 뭐가 다가오는지 먼저 보고 싶다. "다시" 눌렀던 카드가 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=로 그 자료 카드만 세션을 돈다.

완료 회고: "완료" 탭에서 최근 복습 이력(자료·평가 등급·시각)을 무한 스크롤로 훑는다. 자료·평가로 필터 가능.


5. 비-시나리오 (의도적으로 안 함)

  • 카드 일괄 입력 — 한 번에 1장씩만 추가. CSV/Anki 임포트는 차기
  • 카드 정렬 변경 — 생성순 고정. sort_order 도입은 차기
  • 카드 멀티미디어 — 이미지/오디오 없음
  • 노트 풀텍스트 검색 — Tiptap 안에서 Ctrl+F만 (브라우저 기본)
  • 노트 인라인 카드 — 노트와 카드는 분리. 클릭 한 번에 카드 생성 X
  • 노트 즐겨찾기/아이콘/커버 — 트리 + 제목만. Notion 메타는 차기
  • 노트의 카드 소속 — 카드는 자료 직속. 특정 노트에 카드를 매다는 건 차기
  • 알림 — 복습 알림 없음. 사용자가 직접 진입
  • 통계/스트릭 — 학습 기록 시각화 없음

6. 추후 개선

  • 노트 ↔ 카드 인라인 연결 (Tiptap 커스텀 노드)
  • 카드 태그/덱
  • 카드 클로즈(빈칸) 타입
  • 노트 검색
  • 카테고리/목표
  • 알림, 통계, 캘린더

Clone this wiki locally