Repository navigation
Lifelog Architecture
일상기록은 완전 독립 도메인이다. 노트/메모의 트리·에디터를 재사용하지 않는다. 재사용하는 것은 딱 하나 — 기존 노트 이미지 업로드 파이프라인(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)
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)로 정의(Hibernatevalidate호환 — Liquibase boolean 이슈 참고). 여기선 status를 VARCHAR enum으로 두어 불리언 회피.
노트 이미지가 이미 이 경로로 동작한다:
- FE
POST /planner/images/upload-url {contentType}→{uploadUrl, publicUrl} - FE가 presigned URL로 바이트를 MinIO에 직접 PUT (BE는 데이터 경로 밖 → 대역폭·비용 이득)
- 공개 URL은
img.orino.dev(MinIOnote-images버킷,download정책 = anonymous read)
일상기록은 같은 메커니즘을 lifelog 전용 엔드포인트로 확장한다. 저장은 기존 note-images 버킷에 lifelog/ prefix로 둔다(신규 버킷·인프라 변경 없이 시작). 버킷 분리는 후속 과제.
피드·지도는 썸네일을 반복 로드한다(원본을 매번 로드하면 낭비). MinIO는 온더플라이 리사이즈를 하지 않으므로:
- MVP: FE가 업로드 직전 canvas로 썸네일을 생성해 원본과 함께 2번 PUT 한다(기존 zero-copy 패턴 유지, BE 무개입). BE는 원본·썸네일 각각의 presigned URL을 발급.
- 후속: 자기호스팅 imgproxy 사이드카로 원본에서 온더플라이 썸네일 → 썸네일 저장 불필요. 규모가 커지면 전환.
ELOG-008의 S3 요청 비용은 AWS S3(Loki·Thanos·Tempo·Longhorn 백업)에서 발생한 것이다. 일상기록 사진은 클러스터 내부 self-hosted MinIO에 저장되므로 GET/PUT 요청에 과금이 없다. 즉 사진이 많은 이 모듈일수록 MinIO 선택이 비용상 안전하다. 용량(20Gi PVC, longhorn)만 모니터링하면 된다.
사진의 촬영시각·GPS는 EXIF에서 온다. FE가 이미 파일을 다루므로(썸네일 생성) FE에서 exifr로 EXIF를 읽어 occurred_at·lat/lng 기본값을 채우고, moment 생성 요청에 메타로 실어 보낸다. BE는 바이트를 안 본다.
- 첫 사진의 EXIF를 기록 기본값으로. 사용자가 언제나 수정 가능.
- EXIF에 GPS가 없으면 위치는 비운다(지도 수동 핀으로 보완).
| 방향 | 용도 | 처리 |
|---|---|---|
| 역(reverse) | 좌표 → 장소명 | 기록 저장/조회 시 place_name 표시 |
| 정(forward/search) | 검색어 → 좌표 | 지도 수동 핀 검색("성산일출봉") |
- BE가 **Nominatim(공개 OSM)**을 프록시한다(브라우저 직접 호출 시 CORS·정책 위반·키 노출 회피).
- Nominatim 사용 정책 준수: 초당 1요청 이하, 식별 User-Agent 필수, 결과 캐시 의무. → BE에 Redis 캐시(좌표 반올림 키, 예: 소수 4자리)를 두고 재호출을 흡수. 단일 사용자·저볼륨이라 공개 인스턴스로 충분.
- place_name은 조회 시 매번 지오코딩하지 않도록 **moment에 저장(denormalize)**한다. 저장 시 1회 확정.
- 후속: 트래픽이 늘면 Nominatim 셀프호스트(무겁다 — planet DB) 검토.
- FE react-leaflet + OSM 래스터 타일. API 키·과금 없음 → orino 비용 지향(Cloudflare 제거·직결 네트워크)과 정렬.
- OSM 타일 사용 정책 준수(식별 가능한 사용, 과도한 프리페치 금지). 단일 사용자 저볼륨이라 공개 타일로 충분.
- 흐름 지도 뷰: 좌표 있는 기록을 핀 + 발생시각 순 polyline으로. bounds 자동 fit.
- 후속: 타일 프록시/셀프호스트 타일 서버, 벡터 타일 전환은 필요 시.
기록 생성
- FE: 사진 선택 → 각 사진 EXIF 읽기 + 썸네일 생성
- FE: 사진별
POST /api/lifelog/images/upload-url(원본·썸네일) → presigned PUT ×2 → MinIO - FE: (위치 있으면)
GET /api/lifelog/geocode/reverse→ place_name - FE:
POST /api/lifelog/moments(본문·occurred_at·위치·기분·태그·photos[objectKey·thumbKey·exif...]) - BE: moment + moment_photo + moment_tag 저장 → 카드 응답
흐름 지도
- FE:
GET /api/lifelog/flows/{id}→ 담긴 moment(좌표 포함) 시간순 - FE: 좌표 있는 것만 Leaflet 핀·polyline 렌더
- 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 저장(조회 시 재계산 안 함)