Repository navigation
Memo Data Model
wcorn edited this page Jul 6, 2026
·
2 revisions
⚠️ [통합됨] 2026-07-06 — 메모는 노트와 단일 도메인으로 병합되었습니다 (#740, PR #741).note.material_id를 nullable로 완화해 자료 종속 노트(material_id 있음)와 독립 노트(NULL)를 한 테이블/도메인으로 통합했다. API/api/notes, 라우트/notes, 사이드바 "노트". 아래 설계 문서는 분리 시절(Epic #718)의 기록이다.
범위: 단일 테이블
memo. Study Plannernote테이블에서material_id를 제거하고 최상위 트리로 독립시킨 구조다.
┌──────────┐ ┌──────────┐
│ member │──1:N──▶│ memo │──┐
└──────────┘ └──────────┘ │ self-FK (parent_id, ON DELETE CASCADE)
▲────────┘
-
memo는 멤버에 1:N으로 속하고,parent_id로 자기 자신을 참조하는 트리다(Notion 스타일). - 최상위 메모는
parent_id = NULL. 그 아래로 무제한 중첩된다. -
member_id는 부모를 통해 추적 가능하지만, 조회 성능을 위해 비정규화 컬럼으로 유지한다(노트와 동일).
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| 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컬럼은 Hibernatevalidate와의 정합성을 위해 컬럼 정의를JSON으로 명시한다.BOOLEAN류 함정은 없으나, 마이그레이션 검증 규칙은 DB 마이그레이션 준수.
| 연산 | 방식 |
|---|---|
| 트리 조회 |
WHERE member_id = ? ORDER BY parent_id, sort_order 전량 로드 후 조립 |
| 생성 | 부모 지정 시 그 부모의 자식으로, 미지정 시 최상위. sort_order는 형제 최대값+1 |
| 이동 |
parent_id 변경. 대상의 자손을 새 부모로 지정 시 400(순환 방지) |
| 정렬 | 같은 부모 내 sort_order 재배치 |
| 삭제 | 자신 + 하위 CASCADE |
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)| 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 구현을 그대로 미러링할 수 있다.