Skip to content

Lifelog Architecture

wcorn edited this page Aug 7, 2026 · 3 revisions

시스템 아키텍처: 일상기록 (Lifelog)

유스케이스 · 데이터 모델 · API 설계 · 결정 기록

1. 개요

일상기록은 완전 독립 도메인이다. 노트/메모의 트리·에디터를 재사용하지 않는다. 재사용하는 것은 딱 하나 — 기존 노트 이미지 업로드 파이프라인(presigned PUT → MinIO).

[FE React]
  ├─ 피드/작성/흐름/지도 UI
  ├─ 사진: EXIF 추출(exifr) + 썸네일 생성(canvas) → presigned PUT로 MinIO 직접 업로드
  └─ 지도: react-leaflet + OSM 타일
        │  (인증 API)                         (바이트는 BE 미경유)
        ▼                                            │
[orino BE / orino-app-api]                           │
  ├─ Moment/Flow CRUD (RDB)                           │
  ├─ presigned URL 발급 (AWS SDK v2 S3Presigner) ─────┤
  └─ 역/정 지오코딩 프록시 + 캐시(Redis) → Nominatim   │
        │                                             ▼
[MySQL]  moment·moment_photo·flow·flow_moment·moment_tag   [MinIO note-images 버킷 · lifelog/ prefix]
[Redis]  geocode 캐시                                       (img.orino.dev 공개 read)

2. 코드 배치 (기존 멀티모듈 컨벤션)

BE는 멀티모듈(orino-app-api / orino-domain-rdb / orino-domain-redis / orino-common / orino-core-web).

계층 위치 내용
엔티티 orino-domain-rdb → ds.project.orino.domain.planner.lifelog Moment, MomentPhoto, MomentTag, Flow, FlowMoment + Mood/FlowStatus enum + Repository ✅(#950)
애플리케이션 orino-app-api → ds.project.orino.planner.lifelog Controller · Service · DTO (moment / flow / geocode / image 하위 패키지) ✅(#951 #952 #953 #954)
마이그레이션 orino-app-api/src/main/resources/db/changelog/changes/ 046-create-lifelog-tables.yaml ✅(#950)

패키지는 기존 관례대로 planner 우산 아래 둔다(domain.planner.note·orino.planner.image처럼 앱의 모든 기능이 planner 하위에 있다).

  • 멤버 스코프: 단일 사용자지만 기존 도메인 컨벤션(Note·Dataset)을 따라 모든 최상위 엔티티(moment·flow)에 member_id를 둔다. 조회는 findByIdAndMemberId 등 멤버 스코프로 건다.
  • 응답/에러: CustomResponseCode(성공)·ErrorCode(GLB-ERR-XXX, CustomException) 컨벤션 준수.
  • 불리언 컬럼: Liquibase에서 BIT(1)로 정의(Hibernate validate 호환 — Liquibase boolean 이슈 참고). 여기선 status를 VARCHAR enum으로 두어 불리언 회피.

3. 사진 파이프라인 (핵심)

3.1 기존 자산 재사용

노트 이미지가 이미 이 경로로 동작한다:

  • FE POST /planner/images/upload-url {contentType} → {uploadUrl, publicUrl}
  • FE가 presigned URL로 바이트를 MinIO에 직접 PUT (BE는 데이터 경로 밖 → 대역폭·비용 이득)
  • 공개 URL은 img.orino.dev(MinIO note-images 버킷, download 정책 = anonymous read)

일상기록은 같은 메커니즘을 lifelog 전용 엔드포인트로 확장한다. 저장은 기존 note-images 버킷에 lifelog/ prefix로 둔다(신규 버킷·인프라 변경 없이 시작). 버킷 분리는 후속 과제.

3.2 원본 + 썸네일 (2-key)

피드·지도는 썸네일을 반복 로드한다(원본을 매번 로드하면 낭비). MinIO는 온더플라이 리사이즈를 하지 않으므로:

  • MVP: FE가 업로드 직전 canvas로 썸네일을 생성해 원본과 함께 2번 PUT 한다(기존 zero-copy 패턴 유지, BE 무개입). BE는 원본·썸네일 각각의 presigned URL을 발급.
  • 후속: 자기호스팅 imgproxy 사이드카로 원본에서 온더플라이 썸네일 → 썸네일 저장 불필요. 규모가 커지면 전환.

3.3 💡 비용 정정 — MinIO는 S3 요청료와 무관

ELOG-008의 S3 요청 비용은 AWS S3(Loki·Thanos·Tempo·Longhorn 백업)에서 발생한 것이다. 일상기록 사진은 클러스터 내부 self-hosted MinIO에 저장되므로 GET/PUT 요청에 과금이 없다. 즉 사진이 많은 이 모듈일수록 MinIO 선택이 비용상 안전하다. 용량(20Gi PVC, longhorn)만 모니터링하면 된다.

3.4 EXIF 추출

사진의 촬영시각·GPS는 EXIF에서 온다. FE가 이미 파일을 다루므로(썸네일 생성) FE에서 exifr로 EXIF를 읽어 occurred_at·lat/lng 기본값을 채우고, moment 생성 요청에 메타로 실어 보낸다. BE는 바이트를 안 본다.

  • 첫 사진의 EXIF를 기록 기본값으로. 사용자가 언제나 수정 가능.
  • EXIF에 GPS가 없으면 위치는 비운다(지도 수동 핀으로 보완).

4. 지오코딩

방향 용도 처리
역(reverse) 좌표 → 장소명 기록 저장/조회 시 place_name 표시
정(forward/search) 검색어 → 좌표 지도 수동 핀 검색("성산일출봉")
  • BE가 **Nominatim(공개 OSM)**을 프록시한다(브라우저 직접 호출 시 CORS·정책 위반·키 노출 회피).
  • Nominatim 사용 정책 준수: 초당 1요청 이하, 식별 User-Agent 필수, 결과 캐시 의무. → BE에 Redis 캐시(좌표 반올림 키, 예: 소수 4자리)를 두고 재호출을 흡수. 단일 사용자·저볼륨이라 공개 인스턴스로 충분.
  • place_name은 조회 시 매번 지오코딩하지 않도록 **moment에 저장(denormalize)**한다. 저장 시 1회 확정.
  • 후속: 트래픽이 늘면 Nominatim 셀프호스트(무겁다 — planet DB) 검토.

5. 지도 렌더링

  • FE react-leaflet + OSM 래스터 타일. API 키·과금 없음 → orino 비용 지향(Cloudflare 제거·직결 네트워크)과 정렬.
  • OSM 타일 사용 정책 준수(식별 가능한 사용, 과도한 프리페치 금지). 단일 사용자 저볼륨이라 공개 타일로 충분.
  • 흐름 지도 뷰: 좌표 있는 기록을 핀 + 발생시각 순 polyline으로. bounds 자동 fit.
  • 후속: 타일 프록시/셀프호스트 타일 서버, 벡터 타일 전환은 필요 시.

6. 데이터 흐름 요약

기록 생성

  1. FE: 사진 선택 → 각 사진 EXIF 읽기 + 썸네일 생성
  2. FE: 사진별 POST /api/lifelog/images/upload-url(원본·썸네일) → presigned PUT ×2 → MinIO
  3. FE: (위치 있으면) GET /api/lifelog/geocode/reverse → place_name
  4. FE: POST /api/lifelog/moments (본문·occurred_at·위치·기분·태그·photos[objectKey·thumbKey·exif...])
  5. BE: moment + moment_photo + moment_tag 저장 → 카드 응답

흐름 지도

  1. FE: GET /api/lifelog/flows/{id} → 담긴 moment(좌표 포함) 시간순
  2. FE: 좌표 있는 것만 Leaflet 핀·polyline 렌더

7. 테스트 전략 (컨벤션 준수)

  • BE: MockMvc + TestContainers(MySQL 8.4.4). Moment/Flow CRUD, N:M 담기/빼기/정렬, 피드 커서 페이지네이션, 태그 자동완성. 지오코딩은 Nominatim 클라이언트를 인터페이스로 두고 테스트에서 스텁(외부 네트워크 미의존).
  • FE: RTL + MSW(API 응답만 목). 피드 렌더·작성 플로우·흐름 담기·지도 토글. EXIF/썸네일은 순수 로직만 단위 테스트. 훅/컨텍스트 통째 목 금지, 프로덕션 컴포넌트 그대로.
  • 로컬 실증: bootRun + 실제 MinIO(presigned 업로드 왕복) + 브라우저에서 사진 업로드·지도 핀 확인.

8. 결정 요약 (상세는 결정 기록)

  • 흐름 = 수동 컬렉션(N:M), 자동 클러스터링 미채택(MVP)
  • 사진 = MinIO(self-hosted) + FE 썸네일 2-key, imgproxy는 후속
  • EXIF·썸네일은 FE에서(BE zero-copy 유지)
  • 지오코딩·지도 = 공개 Nominatim/OSM + BE 캐시, 셀프호스트는 후속
  • place_name·occurred_at은 denormalize 저장(조회 시 재계산 안 함)

Clone this wiki locally