Skip to content

Lifelog Data Model

wcorn edited this page Jul 23, 2026 · 2 revisions

데이터 모델: 일상기록 (Lifelog)

유스케이스 · 아키텍처 · API 설계

Liquibase 마이그레이션: 046-create-lifelog-tables.yaml(구현: #950). 불리언은 BIT(1) 회피(상태는 VARCHAR enum), 시각은 엔티티 Instant / DB DATETIME(6). 단일 사용자지만 기존 도메인 컨벤션(Note·Dataset)대로 member_id 스코프 포함한다.

1. ERD

flow 1 ──< flow_moment >── N moment 1 ──< moment_photo
                                      1 ──< moment_tag

flow_moment: flow 와 moment 의 N:M 조인 (한 기록이 여러 흐름에)
  • moment — 순간 기록 1건 (SSOT)
  • moment_photo — 기록에 붙은 사진 0..N (MinIO key)
  • moment_tag — 기록 태그 0..N (denormalized)
  • flow — 수동 컬렉션(흐름)
  • flow_moment — 흐름↔기록 N:M + 흐름 내 정렬

2. 테이블

2.1 moment

컬럼 타입 제약 설명
id BIGINT PK, AI
member_id BIGINT NOT NULL 소유 멤버(스코프)
occurred_at DATETIME(6) NOT NULL 발생시각(정렬 키). EXIF 촬영시각 우선 → 없으면 작성시각
body TEXT NULL 본문
mood VARCHAR(20) NULL 기분 키(예: happy,calm,tired,sad,excited)
lat DECIMAL(10,7) NULL 위도
lng DECIMAL(10,7) NULL 경도
place_name VARCHAR(255) NULL 역지오코딩 결과(denormalize, 저장 시 확정)
created_at DATETIME(6) NOT NULL JPA Auditing @CreatedDate
updated_at DATETIME(6) NOT NULL JPA Auditing @LastModifiedDate

인덱스:

  • idx_moment_member_occurred (member_id, occurred_at DESC, id DESC) — 멤버 피드 커서 페이지네이션
  • (lat, lng는 저볼륨이라 별도 공간 인덱스 없이 흐름 단위 조회로 처리)

2.2 moment_photo

컬럼 타입 제약 설명
id BIGINT PK, AI
moment_id BIGINT FK→moment(id), NOT NULL, ON DELETE CASCADE
object_key VARCHAR(512) NOT NULL MinIO 원본 key (lifelog/moments/{momentId}/{uuid}.jpg)
thumb_key VARCHAR(512) NULL 썸네일 key
width INT NULL 원본 px
height INT NULL 원본 px
exif_taken_at DATETIME(6) NULL EXIF 촬영시각(원본 보존)
exif_lat DECIMAL(10,7) NULL EXIF GPS 위도
exif_lng DECIMAL(10,7) NULL EXIF GPS 경도
sort_order INT NOT NULL, DEFAULT 0 기록 내 사진 순서
created_at DATETIME(6) NOT NULL

인덱스: idx_photo_moment (moment_id, sort_order)

object_key만 저장하고 공개 URL은 img.orino.dev + key로 조립(호스트 하드코딩 회피, 환경별 base URL 설정).

2.3 moment_tag

컬럼 타입 제약 설명
id BIGINT PK, AI
moment_id BIGINT FK→moment(id), NOT NULL, ON DELETE CASCADE
name VARCHAR(50) NOT NULL 태그명(정규화 안 함, 단순 저장)

인덱스:

  • idx_tag_moment (moment_id)
  • idx_tag_name (name) — 자동완성 SELECT DISTINCT name ... WHERE name LIKE ?
  • uq_moment_tag (moment_id, name) — 같은 기록에 동일 태그 중복 방지

MVP는 별도 tag 마스터 테이블 없이 denormalize. 태그 자동완성은 DISTINCT name으로 충분. 태그 관리(이름 변경·병합)가 필요해지면 정규화 승격.

2.4 flow

컬럼 타입 제약 설명
id BIGINT PK, AI
member_id BIGINT NOT NULL 소유 멤버(스코프)
title VARCHAR(255) NOT NULL 흐름 제목("제주 여행 2박3일")
description TEXT NULL 설명
cover_object_key VARCHAR(512) NULL 커버 이미지 key(비우면 담긴 첫 사진으로 대체 표시)
started_at DATETIME(6) NULL 기간 시작(수동 또는 담긴 기록 최소 occurred_at으로 유도)
ended_at DATETIME(6) NULL 기간 끝(수동 또는 최대 occurred_at)
status VARCHAR(20) NOT NULL, DEFAULT ACTIVE ACTIVE / ARCHIVED
created_at DATETIME(6) NOT NULL
updated_at DATETIME(6) NOT NULL

인덱스: idx_flow_member_status_started (member_id, status, started_at DESC)

2.5 flow_moment (N:M 조인)

컬럼 타입 제약 설명
id BIGINT PK, AI 대리키(기존 조인 테이블 컨벤션 — dataset_merge 등)
flow_id BIGINT FK→flow(id), NOT NULL, ON DELETE CASCADE
moment_id BIGINT FK→moment(id), NOT NULL, ON DELETE CASCADE
sort_order INT NOT NULL, DEFAULT 0 흐름 내 수동 정렬(기본은 occurred_at 순, 조정 시 사용)
added_at DATETIME(6) NOT NULL 담은 시각(@CreatedDate)
  • 자연키 (flow_id, moment_id)는 유니크 인덱스 uq_flow_moment로 보장 → 담기 멱등. (복합 PK 대신 대리키+유니크: 기존 조인 테이블 컨벤션 준수)
  • 인덱스: idx_flow_moment_moment (moment_id) — "이 기록이 담긴 흐름" 역조회

3. 삭제 규칙 (중요)

동작 결과
moment 삭제 그 기록의 moment_photo·moment_tag·flow_moment 행이 CASCADE 삭제 → 모든 흐름에서도 빠진다. MinIO 원본은 정리 대상으로 표시(§ 아래)
flow 삭제 flow_moment 행만 CASCADE 삭제. 담겼던 moment 자체는 보존 (흐름은 관점일 뿐 소유자 아님)
flow에서 기록 빼기 해당 flow_moment 1행만 삭제. moment 보존

3.1 MinIO 오브젝트 정리

DB CASCADE는 MinIO 오브젝트를 지우지 않는다. MVP 방침:

  • moment/사진 삭제 시 BE가 해당 object_key·thumb_key를 best-effort로 MinIO delete 호출.
  • 실패해도 DB 정합성은 유지(고아 오브젝트는 용량만 차지). 주기적 orphan 스윕(후속, 저우선)으로 회수.

4. 정렬·페이지네이션 규칙

  • 피드: ORDER BY occurred_at DESC, id DESC, 커서 = (occurred_at, id).
  • 흐름 상세: 기본 occurred_at ASC(서사=시간순). 사용자가 순서를 바꾸면 flow_moment.sort_order ASC 우선.
  • 지도 경로: occurred_at ASC로 polyline 연결(좌표 있는 것만).

5. 관련 문서

Clone this wiki locally