다크 모드
업로드 흐름
정보
미디어 업로드는 룹 참여자가 사진이나 영상을 룹에 공유하는 기능입니다. 업로드 즉시 응답을 받고, 최적화는 백그라운드에서 자동으로 진행됩니다.
기능 소개
- 룹 참여자가 사진(이미지)과 영상(동영상)을 룹에 업로드할 수 있습니다.
- 업로드는 즉시 완료되며, 최적화 변환은 백그라운드에서 처리됩니다.
- 동일 요청의 중복 처리를 방지하는 멱등성(idempotency) 메커니즘이 적용되어 있습니다.
- 업로드된 미디어는 AI 콘텐츠 생성(리캡, 포스터)의 기반 데이터가 됩니다.
- 업로드 시 사진의 EXIF 정보(촬영 시각, 위치, 카메라 정보)가 자동으로 추출됩니다.
동작 규칙
- 회원 전용: 미디어 업로드는 가입한 회원만 가능합니다. 비회원 참여자(Guest Participant)는 업로드할 수 없습니다.
- 즉시 응답: 사용자가 파일을 업로드하면 원본이 저장된 직후 즉시 응답을 받습니다. 이미지/영상 최적화가 완료될 때까지 기다릴 필요가 없습니다.
- 멱등성 보장: 클라이언트가 동일한 요청을 중복으로 보내더라도 한 번만 처리됩니다. 네트워크 오류 등으로 재시도가 발생해도 같은 미디어가 두 번 생성되지 않습니다.
- 파일 크기 제한: 개별 파일의 최대 크기는 2GB입니다. 이를 초과하는 파일은 업로드가 거부됩니다.
- 지원 형식:
- 사진: JPG, JPEG, PNG, GIF, WebP, BMP, TIFF
- 영상: MP4, MOV, AVI, MKV, WebM, M4V, FLV
- 지원되지 않는 형식은 업로드가 거부됩니다.
- 알림 발송: 미디어 업로드가 처리되면, 업로드한 본인을 제외한 룹의 다른 참여자에게 알림이 발송됩니다. 여러 미디어를 업로드한 경우 일괄(batch) 알림으로 발송됩니다.
- 룹 소속 필수: 미디어는 반드시 특정 룹에 소속되어야 합니다. 룹에 참여하지 않은 사용자는 해당 룹에 미디어를 업로드할 수 없습니다.
- 메타데이터 자동 추출: 사진 업로드 시 EXIF 데이터(촬영 시각, GPS 위치, 카메라 제조사/모델 등)가 자동으로 추출되어 저장됩니다. 영상도 촬영 시각, 위치, 기기 정보 등이 추출됩니다.
사용자 흐름
사진 업로드
룹 선택
사용자가 미디어를 업로드할 룹에 진입합니다.
사진 선택
갤러리에서 업로드할 사진을 선택합니다.
업로드 시작
선택한 사진이 서버에 전송됩니다. 원본 파일이 저장되면 즉시 업로드 완료 응답을 받습니다.
백그라운드 최적화
서버에서 원본 이미지를 공개용(WebP)과 썸네일(WebP)로 자동 변환합니다. 사용자는 이 과정을 기다릴 필요가 없습니다.
알림 발송
업로드가 처리되면 룹의 다른 참여자에게 미디어 업로드 알림이 발송됩니다.
영상 업로드
룹 선택
사용자가 미디어를 업로드할 룹에 진입합니다.
영상 선택
갤러리에서 업로드할 영상을 선택합니다.
업로드 시작
선택한 영상이 서버에 전송됩니다. 원본 파일이 저장되면 즉시 업로드 완료 응답을 받습니다.
백그라운드 처리
서버에서 영상의 썸네일(WebP) 추출과 최적화 변환이 동시에 진행됩니다. 썸네일이 먼저 준비되면 다른 참여자가 미리보기를 볼 수 있고, 최적화 영상은 이후에 제공됩니다.
알림 발송
업로드가 처리되면 룹의 다른 참여자에게 미디어 업로드 알림이 발송됩니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-10 | 코드 검증: 중복 방지를 멱등성 메커니즘으로 수정, 지원 형식 목록 추가, 영상 업로드 흐름 추가, 메타데이터 자동 추출 설명 추가, 알림 발송을 batch 방식으로 수정 |
| 2026-03-09 | 최초 작성 |