Skip to content

Memo UI Design

wcorn edited this page Jul 11, 2026 · 3 revisions

화면 설계: 메모 (Memo)

⚠️ [통합됨] 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 노트 탭(트리 사이드바 + 에디터)의 레이아웃·컴포넌트를 재사용한다.

1. 진입점

  • 주 메뉴(사이드바)에 [메모] 항목 추가.
    • 아이콘: StickyNote(lucide) 또는 NotebookPen.
    • 위치: 기존 메뉴(홈 / 학습 자료 / 오늘 복습 / 캘린더 / 주간 계획표 / 루틴 / 연동 설정) 흐름에 자연스럽게 배치(학습 자료 인접 권장).

2. 화면 레이아웃 (/memo)

┌───────────────────────────────────────────────────────────┐
│  PageHeader: 메모                       [저장됨 · 방금]     │
├──────────────┬────────────────────────────────────────────┤
│ 메모 트리     │                                            │
│ [+ 새 메모]   │        Tiptap 에디터                       │
│              │        (선택한 메모 본문)                   │
│ ▸ 아이디어    │                                            │
│   · orino… ⋯ │        제목: [orino 개선]                  │
│ ▸ 장보기  ⋯  │        ────────────────────────           │
│              │        본문 블록…                          │
│              │                                            │
└──────────────┴────────────────────────────────────────────┘
  • 좌: 트리 사이드바 — 최상위 메모부터 중첩 표시. 각 노드 hover 시 ⋯ 메뉴([+ 하위 추가], [삭제]). 상단 [+ 새 메모]로 최상위 생성.
  • 우: 에디터 — 선택한 메모의 제목 인풋 + Tiptap 본문. 노트 에디터(NoteEditor) 공유. NoteEditor에 추가되는 Table 확장 + Import도 메모에 자동 반영 — 데이터 Import.
  • 저장 상태 표시 — 헤더 우측에 "저장됨 / 저장 중… / 저장 실패". 레이아웃을 밀지 않도록 고정 폭 영역(주간 계획표 #712/#714 교훈 승계).

3. 상호작용

동작 결과
[+ 새 메모] 최상위 빈 메모 생성 → 트리 추가 + 에디터 자동 선택·포커스
노드 [+ 하위 추가] 해당 메모 자식 생성, 트리 펼침
노드 클릭 우측 에디터에 본문 로드
제목/본문 편집 2초 debounce 자동 저장, 저장 상태 갱신
노드 [삭제] 확인 다이얼로그 → 자신+하위 삭제. 열려있던 메모면 에디터 빈 상태로
(M2) 드래그 이동 부모 변경/정렬. 순환 이동은 드롭 불가 표시

4. 상태별 화면

상태 표시
메모 없음 트리 대신 "첫 메모를 만들어보세요" + [+ 새 메모] CTA
미선택 에디터 영역 "왼쪽에서 메모를 선택하거나 새로 만드세요"
로딩 트리/본문 스켈레톤
저장 실패 헤더 상태 "저장 실패" + 재시도. 본문 유실 없음

5. 반응형

  • 데스크탑: 2-pane 동시 표시.
  • 모바일: 트리 → 선택 시 에디터 전체화면 전환(뒤로 가기로 트리 복귀). 노트 탭 모바일 패턴 재사용.

6. 디자인 시스템 준수

  • 디자인 시스템: 다크모드, 브랜드 퍼플 primary, Pretendard, 공통 PageHeader·다이얼로그 푸터·상태/빈 상태 컴포넌트 재사용.
  • 삭제 확인은 공통 다이얼로그 컴포넌트 사용.

7. 재사용 컴포넌트

컴포넌트 출처
Tiptap 에디터 features/note/NoteEditor (API 바인딩 일반화 후 공유)
트리 사이드바 features/note/NoteTreeSidebar 패턴 참고 → 메모용 신규
저장 상태 features/note/SaveStatusIndicator
PageHeader / 다이얼로그 공통 디자인 시스템

Clone this wiki locally