Repository navigation
Memo Usecase
wcorn edited this page Aug 7, 2026
·
3 revisions
⚠️ [통합됨] 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). 아래는 분리 시절의 기록이다. 결정 근거는 결정 기록 참고.
| 액터 | 설명 |
|---|---|
| 사용자 | 단일 사용자(본인). JWT로 orino에 로그인된 상태 |
| orino BE | 메모 트리 CRUD·자동 저장 처리. 외부 의존 없음(순수 orino RDB) |
- orino에 로그인되어 있다 (JWT 유효).
- 외부 연동(Google 등) 없이 동작한다 — 메모는 orino 내부에만 존재한다.
| 구분 | 노트 (Study Planner) | 메모 (Memo) |
|---|---|---|
| 소속 | 학습 자료(material)에 종속 | 종속 없음, 최상위 |
| 진입 | 자료 상세 → [노트] 탭 | 사이드바 → [메모] 독립 페이지 |
| 용도 | 특정 자료 학습 정리 | 잡생각·아이디어·할일·범용 기록 |
| 트리 |
note.parent_id (자료 안에서 중첩) |
memo.parent_id (전역 트리) |
메모는 "이 자료에 대한 필기"가 아니라 "무엇에 대해서든 적어두는 공간"이다. 트리 구조·에디터·자동 저장 UX는 노트와 동일하게 느껴지되, 데이터는 완전히 독립적이다.
- 최상위 메모:
parent_id = NULL. 사이드바 최상단 목록. - 하위 메모: 부모 메모 아래로 무제한 중첩. 부모 삭제 시 하위도 함께 삭제(CASCADE).
- 형제 정렬:
sort_order로 같은 부모 아래 순서 유지.
- 사이드바에서 [메모] 진입 (
/memo). - [+ 새 메모] 클릭 → 최상위에 "제목 없음" 빈 메모가 생성되고 에디터가 열린다.
- 제목·본문을 입력한다. 입력이 멈추면 2초 뒤 자동 저장되고, 헤더에 저장 상태("저장됨")가 표시된다.
- 트리에서 특정 메모의 [+ 하위 추가] 클릭.
- 그 메모 아래 자식 메모가 생성되고 트리가 펼쳐진다.
- 하위 메모를 선택해 편집한다.
- 트리에서 메모를 클릭 → 우측 에디터에 본문이 로드된다.
- 편집 시 자동 저장(2초 debounce). 저장 실패 시 재시도·에러 표시.
- 트리에서 메모의 [삭제] → 확인 다이얼로그.
- 확인 시 해당 메모와 모든 하위 메모가 함께 삭제된다.
- 삭제된 메모가 열려 있었다면 에디터는 빈 상태(안내 문구)로 돌아간다.
- 메모를 다른 부모 아래로 이동(부모 변경) 또는 형제 간 순서 변경.
- BE가
parent_id·sort_order를 갱신한다. 순환 참조(자기 자신·자손을 부모로) 는 막는다.
- 메모가 하나도 없으면 트리 대신 "첫 메모를 만들어보세요" 안내 + [+ 새 메모] CTA.
- 메모를 아직 선택하지 않았으면 에디터 영역에 "왼쪽에서 메모를 선택하거나 새로 만드세요" 안내.
| 상황 | 처리 |
|---|---|
| 미인증 요청 | 401 → 로그인 페이지 리다이렉트 |
| 존재하지 않는/타인 메모 접근 | 404 |
| 순환 참조 이동(자기 자손을 부모로) | 400 (거부) |
| 자동 저장 중 네트워크 실패 | 저장 상태 "저장 실패" 표시 + 재시도 |
| 빈 doc으로 덮어쓰기 | 노트와 동일하게 빈 doc 저장은 방지(마지막 유효 본문 보존) |