Repository navigation
Memo UI Design
wcorn edited this page Jul 11, 2026
·
3 revisions
⚠️ [통합됨] 2026-07-06 — 메모는 노트와 단일 도메인으로 병합되었습니다 (#740, PR #741).note.material_id를 nullable로 완화해 자료 종속 노트(material_id 있음)와 독립 노트(NULL)를 한 테이블/도메인으로 통합했다. API/api/notes, 라우트/notes, 사이드바 "노트". 아래 설계 문서는 분리 시절(Epic #718)의 기록이다.
범위: 독립 메모 페이지 한 장(
/memo). 좌측 트리 사이드바 + 우측 Tiptap 에디터의 2-pane. Study Planner 노트 탭(트리 사이드바 + 에디터)의 레이아웃·컴포넌트를 재사용한다.
- 주 메뉴(사이드바)에 [메모] 항목 추가.
- 아이콘:
StickyNote(lucide) 또는NotebookPen. - 위치: 기존 메뉴(홈 / 학습 자료 / 오늘 복습 / 캘린더 / 주간 계획표 / 루틴 / 연동 설정) 흐름에 자연스럽게 배치(학습 자료 인접 권장).
- 아이콘:
┌───────────────────────────────────────────────────────────┐
│ PageHeader: 메모 [저장됨 · 방금] │
├──────────────┬────────────────────────────────────────────┤
│ 메모 트리 │ │
│ [+ 새 메모] │ Tiptap 에디터 │
│ │ (선택한 메모 본문) │
│ ▸ 아이디어 │ │
│ · orino… ⋯ │ 제목: [orino 개선] │
│ ▸ 장보기 ⋯ │ ──────────────────────── │
│ │ 본문 블록… │
│ │ │
└──────────────┴────────────────────────────────────────────┘
-
좌: 트리 사이드바 — 최상위 메모부터 중첩 표시. 각 노드 hover 시
⋯메뉴([+ 하위 추가], [삭제]). 상단 [+ 새 메모]로 최상위 생성. -
우: 에디터 — 선택한 메모의 제목 인풋 + Tiptap 본문. 노트 에디터(
NoteEditor) 공유.NoteEditor에 추가되는 Table 확장 + Import도 메모에 자동 반영 — 데이터 Import. - 저장 상태 표시 — 헤더 우측에 "저장됨 / 저장 중… / 저장 실패". 레이아웃을 밀지 않도록 고정 폭 영역(주간 계획표 #712/#714 교훈 승계).
| 동작 | 결과 |
|---|---|
| [+ 새 메모] | 최상위 빈 메모 생성 → 트리 추가 + 에디터 자동 선택·포커스 |
| 노드 [+ 하위 추가] | 해당 메모 자식 생성, 트리 펼침 |
| 노드 클릭 | 우측 에디터에 본문 로드 |
| 제목/본문 편집 | 2초 debounce 자동 저장, 저장 상태 갱신 |
| 노드 [삭제] | 확인 다이얼로그 → 자신+하위 삭제. 열려있던 메모면 에디터 빈 상태로 |
| (M2) 드래그 이동 | 부모 변경/정렬. 순환 이동은 드롭 불가 표시 |
| 상태 | 표시 |
|---|---|
| 메모 없음 | 트리 대신 "첫 메모를 만들어보세요" + [+ 새 메모] CTA |
| 미선택 | 에디터 영역 "왼쪽에서 메모를 선택하거나 새로 만드세요" |
| 로딩 | 트리/본문 스켈레톤 |
| 저장 실패 | 헤더 상태 "저장 실패" + 재시도. 본문 유실 없음 |
- 데스크탑: 2-pane 동시 표시.
- 모바일: 트리 → 선택 시 에디터 전체화면 전환(뒤로 가기로 트리 복귀). 노트 탭 모바일 패턴 재사용.
-
디자인 시스템: 다크모드, 브랜드 퍼플 primary, Pretendard, 공통
PageHeader·다이얼로그 푸터·상태/빈 상태 컴포넌트 재사용. - 삭제 확인은 공통 다이얼로그 컴포넌트 사용.
| 컴포넌트 | 출처 |
|---|---|
| Tiptap 에디터 |
features/note/NoteEditor (API 바인딩 일반화 후 공유) |
| 트리 사이드바 |
features/note/NoteTreeSidebar 패턴 참고 → 메모용 신규 |
| 저장 상태 | features/note/SaveStatusIndicator |
| PageHeader / 다이얼로그 | 공통 디자인 시스템 |