Repository navigation
Lifelog Data Model
wcorn edited this page Jul 23, 2026
·
2 revisions
Liquibase 마이그레이션:
046-create-lifelog-tables.yaml(구현: #950). 불리언은BIT(1)회피(상태는 VARCHAR enum), 시각은 엔티티Instant/ DBDATETIME(6). 단일 사용자지만 기존 도메인 컨벤션(Note·Dataset)대로member_id스코프 포함한다.
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 + 흐름 내 정렬
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| 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는 저볼륨이라 별도 공간 인덱스 없이 흐름 단위 조회로 처리)
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| 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 설정).
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| 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으로 충분. 태그 관리(이름 변경·병합)가 필요해지면 정규화 승격.
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| 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)
| 컬럼 | 타입 | 제약 | 설명 |
|---|---|---|---|
| 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)— "이 기록이 담긴 흐름" 역조회
| 동작 | 결과 |
|---|---|
| moment 삭제 | 그 기록의 moment_photo·moment_tag·flow_moment 행이 CASCADE 삭제 → 모든 흐름에서도 빠진다. MinIO 원본은 정리 대상으로 표시(§ 아래) |
| flow 삭제 |
flow_moment 행만 CASCADE 삭제. 담겼던 moment 자체는 보존 (흐름은 관점일 뿐 소유자 아님) |
| flow에서 기록 빼기 | 해당 flow_moment 1행만 삭제. moment 보존 |
DB CASCADE는 MinIO 오브젝트를 지우지 않는다. MVP 방침:
- moment/사진 삭제 시 BE가 해당
object_key·thumb_key를 best-effort로 MinIO delete 호출. - 실패해도 DB 정합성은 유지(고아 오브젝트는 용량만 차지). 주기적 orphan 스윕(후속, 저우선)으로 회수.
-
피드:
ORDER BY occurred_at DESC, id DESC, 커서 =(occurred_at, id). -
흐름 상세: 기본
occurred_at ASC(서사=시간순). 사용자가 순서를 바꾸면flow_moment.sort_order ASC우선. - 지도 경로: occurred_at ASC로 polyline 연결(좌표 있는 것만).