Skip to content

Memo Data Model

wcorn edited this page Jul 6, 2026 · 2 revisions

데이터 모델링: 메모 (Memo)

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

범위: 단일 테이블 memo. Study Planner note 테이블에서 material_id를 제거하고 최상위 트리로 독립시킨 구조다.

1. ERD

┌──────────┐        ┌──────────┐
│  member  │──1:N──▶│   memo   │──┐
└──────────┘        └──────────┘  │ self-FK (parent_id, ON DELETE CASCADE)
                          ▲────────┘
  • memo는 멤버에 1:N으로 속하고, parent_id로 자기 자신을 참조하는 트리다(Notion 스타일).
  • 최상위 메모는 parent_id = NULL. 그 아래로 무제한 중첩된다.
  • member_id는 부모를 통해 추적 가능하지만, 조회 성능을 위해 비정규화 컬럼으로 유지한다(노트와 동일).

2. 테이블: memo

컬럼 타입 제약 설명
id BIGINT PK, AUTO_INCREMENT
member_id BIGINT NOT NULL, FK → member(id) 소유자(비정규화)
parent_id BIGINT FK → memo(id), NULL, ON DELETE CASCADE 부모 메모. NULL이면 최상위
title VARCHAR(200) NOT NULL, default '제목 없음' 메모 제목
sort_order INT NOT NULL 같은 부모 아래 형제 정렬 순서
content JSON NOT NULL Tiptap 문서 JSON. 기본값 {"type":"doc","content":[]}
created_at DATETIME(6) NOT NULL, updatable=false JPA Auditing
updated_at DATETIME(6) NOT NULL JPA Auditing

인덱스

인덱스 컬럼 용도
PK id
idx_memo_member_parent_sort (member_id, parent_id, sort_order) 멤버 트리 조회·형제 정렬

주의: content JSON 컬럼은 Hibernate validate와의 정합성을 위해 컬럼 정의를 JSON으로 명시한다. BOOLEAN류 함정은 없으나, 마이그레이션 검증 규칙은 DB 마이그레이션 준수.

3. 트리 연산

연산 방식
트리 조회 WHERE member_id = ? ORDER BY parent_id, sort_order 전량 로드 후 조립
생성 부모 지정 시 그 부모의 자식으로, 미지정 시 최상위. sort_order는 형제 최대값+1
이동 parent_id 변경. 대상의 자손을 새 부모로 지정 시 400(순환 방지)
정렬 같은 부모 내 sort_order 재배치
삭제 자신 + 하위 CASCADE

4. Liquibase 마이그레이션

DB 마이그레이션 가이드에 따라 Liquibase changeset으로 관리한다. 현재 최신 changeset은 030-day-plan-block-minutes.yaml → 신규 changeset은 031-create-memo.yaml.

# 031-create-memo.yaml (개요)
- createTable: memo
    - id           BIGINT PK AUTO_INCREMENT
    - member_id    BIGINT NOT NULL
    - parent_id    BIGINT NULL
    - title        VARCHAR(200) NOT NULL DEFAULT '제목 없음'
    - sort_order   INT NOT NULL
    - content      JSON NOT NULL
    - created_at   DATETIME(6) NOT NULL
    - updated_at   DATETIME(6) NOT NULL
- addForeignKeyConstraint: memo.member_id  → member(id)
- addForeignKeyConstraint: memo.parent_id  → memo(id)  ON DELETE CASCADE
- createIndex: idx_memo_member_parent_sort (member_id, parent_id, sort_order)

5. 노트 테이블과의 대비

note memo
material_id NOT NULL (없음)
parent_id self-FK, CASCADE self-FK, CASCADE
title / sort_order / content 동일 동일
소유 추적 member_id 비정규화 member_id 비정규화

note의 material_id만 걷어낸 형태이므로, 엔티티·리포지토리·서비스는 note 구현을 그대로 미러링할 수 있다.

Clone this wiki locally