Skip to content

Memo Usecase

wcorn edited this page Aug 7, 2026 · 3 revisions

유스케이스: 메모 (Memo, 독립 메모장)

⚠️ [통합됨] 2026-07-06 — 메모는 노트와 단일 도메인으로 병합되었습니다 (#740, PR #741). note.material_id를 nullable로 완화해 자료 종속 노트(material_id 있음)와 독립 노트(NULL)를 한 테이블/도메인으로 통합했다. API /api/notes, 라우트 /notes, 사이드바 "노트". 아래 설계 문서는 분리 시절(Epic #718)의 기록이다.

범위: 학습 자료와 무관하게 아무 때나 적는 독립 메모장. Notion 스타일 트리(무제한 중첩) + Tiptap 블록 에디터 + 자동 저장. Study Planner 노트의 에디터 엔진을 재활용하되, material_id 종속이 없는 별도 memo 도메인으로 다룬다.

상태: 폐기(노트로 흡수, #740). 아래는 분리 시절의 기록이다. 결정 근거는 결정 기록 참고.

1. 액터

액터 설명
사용자 단일 사용자(본인). JWT로 orino에 로그인된 상태
orino BE 메모 트리 CRUD·자동 저장 처리. 외부 의존 없음(순수 orino RDB)

2. 사전 조건

  • orino에 로그인되어 있다 (JWT 유효).
  • 외부 연동(Google 등) 없이 동작한다 — 메모는 orino 내부에만 존재한다.

3. 핵심 개념: 노트와 메모의 분리

구분 노트 (Study Planner) 메모 (Memo)
소속 학습 자료(material)에 종속 종속 없음, 최상위
진입 자료 상세 → [노트] 탭 사이드바 → [메모] 독립 페이지
용도 특정 자료 학습 정리 잡생각·아이디어·할일·범용 기록
트리 note.parent_id (자료 안에서 중첩) memo.parent_id (전역 트리)

메모는 "이 자료에 대한 필기"가 아니라 "무엇에 대해서든 적어두는 공간"이다. 트리 구조·에디터·자동 저장 UX는 노트와 동일하게 느껴지되, 데이터는 완전히 독립적이다.

4. 트리 구조

  • 최상위 메모: parent_id = NULL. 사이드바 최상단 목록.
  • 하위 메모: 부모 메모 아래로 무제한 중첩. 부모 삭제 시 하위도 함께 삭제(CASCADE).
  • 형제 정렬: sort_order로 같은 부모 아래 순서 유지.

5. 핵심 시나리오

UC-1. 새 메모 작성

  1. 사이드바에서 [메모] 진입 (/memo).
  2. [+ 새 메모] 클릭 → 최상위에 "제목 없음" 빈 메모가 생성되고 에디터가 열린다.
  3. 제목·본문을 입력한다. 입력이 멈추면 2초 뒤 자동 저장되고, 헤더에 저장 상태("저장됨")가 표시된다.

UC-2. 하위 메모 만들기

  1. 트리에서 특정 메모의 [+ 하위 추가] 클릭.
  2. 그 메모 아래 자식 메모가 생성되고 트리가 펼쳐진다.
  3. 하위 메모를 선택해 편집한다.

UC-3. 메모 열람·편집

  1. 트리에서 메모를 클릭 → 우측 에디터에 본문이 로드된다.
  2. 편집 시 자동 저장(2초 debounce). 저장 실패 시 재시도·에러 표시.

UC-4. 메모 삭제

  1. 트리에서 메모의 [삭제] → 확인 다이얼로그.
  2. 확인 시 해당 메모와 모든 하위 메모가 함께 삭제된다.
  3. 삭제된 메모가 열려 있었다면 에디터는 빈 상태(안내 문구)로 돌아간다.

UC-5. 트리 이동·정렬 (M2)

  1. 메모를 다른 부모 아래로 이동(부모 변경) 또는 형제 간 순서 변경.
  2. BE가 parent_id·sort_order를 갱신한다. 순환 참조(자기 자신·자손을 부모로) 는 막는다.

6. 빈 상태

  • 메모가 하나도 없으면 트리 대신 "첫 메모를 만들어보세요" 안내 + [+ 새 메모] CTA.
  • 메모를 아직 선택하지 않았으면 에디터 영역에 "왼쪽에서 메모를 선택하거나 새로 만드세요" 안내.

7. 예외·경계

상황 처리
미인증 요청 401 → 로그인 페이지 리다이렉트
존재하지 않는/타인 메모 접근 404
순환 참조 이동(자기 자손을 부모로) 400 (거부)
자동 저장 중 네트워크 실패 저장 상태 "저장 실패" 표시 + 재시도
빈 doc으로 덮어쓰기 노트와 동일하게 빈 doc 저장은 방지(마지막 유효 본문 보존)

Clone this wiki locally