Skip to content

Lifelog Usecase

wcorn edited this page Aug 7, 2026 · 2 revisions

유스케이스: 일상기록 (Lifelog)

모듈 8. 지금 순간을 계속 기록(일기+인스타)하고, 흩어진 기록을 **하나의 흐름(예: 제주 여행)**으로 엮어 다시 읽는 공간.

핵심 결정: 흐름 묶기 = 수동 컬렉션 · 기록 1건 = 리치 혼합 카드 · 사진 = MVP부터(MinIO) · 위치+지도 뷰 처음부터. 근거는 결정 기록.

상태: 구현 완료 (2026-07-24) — Epic #949 (#950~#958). 문서 안의 "MVP / 후속" 표기는 의도적으로 뒤로 미룬 항목이지 미구현 잔여가 아니다.

1. 액터

액터 설명
사용자 단일 사용자(본인). JWT로 orino에 로그인된 상태
orino BE Moment/Flow CRUD, presigned 업로드 URL 발급, 역지오코딩 프록시·캐시
MinIO 사진 원본·썸네일 저장(self-hosted, img.orino.dev 공개 서빙)
Nominatim (OSM) 좌표↔장소명 변환(역/정 지오코딩). BE가 캐시를 두고 호출

2. 사전 조건

  • orino에 로그인되어 있다 (JWT 유효).
  • 사진은 브라우저에서 presigned URL로 MinIO에 직접 업로드된다(BE는 바이트를 거치지 않음, 기존 노트 이미지 파이프라인 재사용).

3. 핵심 개념: 노트/메모와의 경계

구분 노트·메모 (모듈 2·7) 일상기록 (모듈 8)
조직 축 주제(parent_id 트리) 시간(occurred_at 피드)
단위 문서(페이지) 순간 카드(Moment)
묶음 계층(부모-자식) 흐름(Flow) = 수동 컬렉션(N:M)
성격 의도적 정리 순간 포착 + 사후 서사화

노트가 "무엇에 대해 정리"라면, 일상기록은 "언제 무엇을 겪었나"를 쌓고, 나중에 흐름으로 엮어 다시 읽는 공간이다. 트리·에디터를 재사용하지 않는 완전 독립 도메인이다.

4. 도메인 용어

용어 의미
Moment (기록) 순간 하나. 사진(다중)·본문·발생시각·위치·기분·태그를 담는 리치 카드
Flow (흐름) 사용자가 수동으로 만든 기록 컬렉션(예: "제주 여행"). 담긴 기록을 시간순 서사·지도로 본다
발생시각 (occurred_at) 그 순간이 실제로 일어난 시각. 사진 EXIF 촬영시각 우선 → 없으면 작성시각. 피드·흐름 정렬 키
위치 (place) 좌표(lat/lng) + 장소명(place_name). EXIF GPS 자동 추출 또는 지도 수동 핀

5. 핵심 시나리오

UC-1. 순간 기록하기 (사진 중심)

  1. 사이드바 [일상기록] → 피드(/lifelog)에서 [+ 기록].
  2. 사진을 선택/드래그(다중). 업로드 중 각 사진 EXIF에서 촬영시각·GPS를 읽어 발생시각·위치를 자동 채운다.
  3. 본문을 적고(선택), 기분·태그를 고른다(선택). 위치가 자동 채워졌으면 역지오코딩으로 장소명이 표시된다.
  4. [기록] → 피드 최상단(역시간순)에 카드가 나타난다.

사진이 없어도 기록 가능(텍스트만). 사진이 여러 장이면 첫 장의 EXIF를 기본값으로 쓰고 사용자가 수정할 수 있다.

UC-2. 순간 기록하기 (텍스트만, 지금 이 순간)

  1. [+ 기록] → 본문만 입력. 발생시각은 현재 시각으로 자동.
  2. 필요하면 지도에서 핀을 찍어 위치를 붙인다(정지오코딩 검색으로 장소 찾기 가능).
  3. 저장 → 피드에 즉시 반영.

UC-3. 피드 훑어보기

  1. /lifelog 피드는 역시간순 무한 스크롤.
  2. 카드에 사진(그리드/캐러셀)·본문·발생시각·장소칩·기분·태그가 보인다.
  3. 카드 우측 메뉴: 흐름에 담기 · 편집 · 삭제.

UC-4. 흐름 만들기 (여행을 하나로)

  1. /lifelog/flows → [+ 새 흐름] → 제목("제주 여행 2박3일")·설명 입력.
  2. [기록 담기] → 피드/기간 필터에서 여러 기록을 선택해 담는다. (한 기록은 여러 흐름에 동시 소속 가능 — N:M)
  3. 흐름 상세로 이동하면 담긴 기록이 발생시각 순으로 자동 정렬된 서사로 보인다. 필요하면 수동으로 순서를 조정한다.

UC-5. 흐름을 지도로 보기

  1. 흐름 상세 상단 [타임라인 ↔ 지도] 토글 → 지도 뷰.
  2. 담긴 기록의 좌표가 지도 위 핀으로, 발생시각 순으로 이어진 **경로(polyline)**가 그려진다.
  3. 핀 클릭 → 미니 카드(대표 사진·본문·시각). "그날 어디를 어떤 순서로 다녔나"가 한눈에.

좌표가 없는 기록은 지도에 뜨지 않고 타임라인에만 남는다(경고 없이 자연스럽게).

UC-6. 기록 편집·삭제

  1. 카드/상세 메뉴에서 편집 → 사진 추가·삭제·순서변경, 본문·시각·위치·기분·태그 수정.
  2. 삭제 → 확인 후 제거. 기록 삭제 시 그 기록이 담긴 모든 흐름에서도 함께 빠진다(조인 CASCADE). 사진 원본은 MinIO 정리 정책에 따라 처리(§ Architecture 참고).

UC-7. 흐름 편집·삭제

  1. 흐름 제목·설명·커버 수정, 상태(진행중/보관).
  2. 흐름 삭제는 흐름과 소속관계만 제거하고, 담겼던 기록(Moment) 자체는 남긴다. (흐름은 "관점"일 뿐, 기록의 소유자가 아니다)

6. 경계·범위 외 (MVP)

  • 자동 흐름 제안(시간/위치 클러스터링) — 후속. MVP는 수동 컬렉션만.
  • 지도 자체 셀프호스팅(타일 서버·Nominatim 셀프호스트) — 후속. MVP는 공개 OSM/Nominatim + 캐시.
  • 공유/공개 링크 — 없음(단일 사용자 원칙).
  • 영상·오디오 첨부 — 후속. MVP는 이미지만.
  • 전문 검색(본문 풀텍스트) — 후속. MVP는 태그·기간 필터.

7. 관련 문서

Clone this wiki locally