다크 모드
리캡 생성
정보
리캡 생성은 룹에 업로드된 사진과 영상을 AI가 분석하여 제목, 본문, 썸네일, 블록 형태의 콘텐츠로 구성된 추억 기록물을 자동으로 만들어주는 기능입니다.
기능 소개
- 룹에 업로드된 미디어(사진, 영상)를 사용자가 선택하면, AI가 이를 분석하여 리캡을 생성합니다.
- 리캡은 제목, 미리보기 텍스트, 썸네일, 블록 형태의 본문(텍스트 블록 + 이미지 블록)으로 구성됩니다.
- 리캡 본문에 포함된 텍스트 블록은 완료 후 참여자가 수정할 수 있습니다.
- 사진은 촬영 시간 기준으로 자동 정렬되어 시간 순서대로 리캡에 배치됩니다.
- 음식/음료 사진이 감지되면 "오늘의 메뉴" 섹션이 자동으로 추가됩니다.
- 리캡에 좋아요를 누르거나 공유 링크를 생성할 수 있습니다.
- 리캡 생성이 완료되거나 실패하면 생성을 요청한 사용자에게 알림이 발송됩니다.
- 사용자의 언어 설정에 따라 한국어, 일본어, 영어로 생성됩니다.
- 일부 사진 분석에 실패하더라도 나머지 사진으로 리캡 생성이 계속 진행됩니다.
- 리캡 생성이 실패하면 시스템이 자동으로 최대 3번까지 재시도합니다.
- 생성 이력(RecapCreationHistory)이 기록되어 재시도 횟수와 에러를 추적할 수 있습니다.
동작 규칙
- 회원 참여자만 요청 가능: 리캡 생성은 해당 룹의 회원 참여자(Participant)만 요청할 수 있습니다. 비회원 참여자(Guest Participant)는 요청할 수 없습니다.
- 미디어 선택 필수: 리캡 생성 시 사용자가 사용할 미디어(사진 또는 영상)를 직접 선택합니다. 최소 1개 이상의 미디어를 선택해야 하며, 선택한 미디어는 해당 룹에 속해 있어야 합니다.
- 하나의 룹에 하나의 리캡: 이미 리캡이 존재하는 룹에는 추가 리캡을 생성할 수 없습니다.
- 상태 흐름: 리캡은 생성 중(PROCESSING) → 완료(COMPLETED) 또는 실패(FAILED) 순서로 진행됩니다. 생성 중에는 진행 상태가 표시됩니다.
- 완료/실패 알림: 리캡 생성이 완료되거나 실패하면 생성을 요청한 사용자에게 알림이 발송됩니다. 완료 알림에는 딥링크와 썸네일 이미지가 포함됩니다.
- 메타데이터 활용: 리캡 생성 시 미디어에 태그된 사용자 정보, 미디어 댓글, 룹의 장소/일시/참여자 이름 등 풍부한 맥락 정보가 AI에게 전달됩니다.
- 다국어 지원: 리캡은 한국어, 일본어, 영어를 지원하며, 사용자의 언어 설정에 따라 자동으로 해당 언어로 생성됩니다. 언어 설정이 없는 경우 타임존 기반으로 자동 추론됩니다 (Asia/Seoul → 한국어, Asia/Tokyo → 일본어, 그 외 → 영어).
- 생성 이력 추적: 모든 리캡 생성 시도는 RecapCreationHistory에 기록됩니다. 실패 시 에러 원인이 기록되며, 재시도 횟수를 추적할 수 있습니다.
- 실패 시 재시도 가능: 리캡 생성이 실패한 경우 사용자가 다시 생성을 요청할 수 있습니다. 재시도는 실패 상태의 리캡에 대해서만 가능합니다. 재시도 이력도 RecapCreationHistory에 함께 기록됩니다.
- 텍스트 수정 가능: 완료된 리캡의 텍스트 블록은 룹의 회원 참여자가 수정할 수 있습니다. 이미지 블록은 수정 대상이 아닙니다.
- 사진 자동 정렬: 촬영 시간 정보가 있는 사진은 시간 순서대로 자동 정렬됩니다. 촬영 시간이 없는 사진은 원래 순서를 유지합니다.
- 부분 실패 허용: 일부 사진의 분석이 실패하더라도 분석에 성공한 사진으로 리캡 생성이 계속 진행됩니다. 모든 사진 분석이 실패한 경우에만 리캡 생성이 실패합니다.
- 자동 재시도: 리캡 생성이 실패하면 시스템이 자동으로 최대 3번까지 재시도합니다. 모든 재시도가 실패하면 최종적으로 실패 상태가 됩니다.
사용자 흐름
리캡 생성 요청 (정상 흐름)
룹 상세 화면 진입
사용자가 미디어가 업로드된 룹의 상세 화면에 진입합니다.
미디어 선택 및 리캡 생성 요청
리캡에 사용할 미디어(사진, 영상)를 선택하고 생성을 요청합니다. 시스템이 리캡 상태를 생성 중(PROCESSING)으로 설정합니다.
AI 분석 및 생성
AI가 선택된 미디어와 룹의 맥락 정보(장소, 일시, 참여자, 태그, 댓글 등)를 분석하여 블록 형태의 콘텐츠(텍스트 + 이미지)를 생성합니다. 사진은 촬영 시간 기준으로 자동 정렬되어 시간 순서대로 배치되며, 음식/음료 사진이 감지되면 "오늘의 메뉴" 섹션이 자동으로 추가됩니다. 생성에는 시간이 소요됩니다.
리캡 완료 및 알림
리캡 생성이 완료되면 상태가 완료(COMPLETED)로 변경되고, 생성을 요청한 사용자에게 알림이 발송됩니다.
리캡 확인
사용자가 알림을 통해 또는 룹 상세 화면에서 완성된 리캡을 확인합니다.
리캡 생성 실패 및 재시도
생성 실패 발생
AI 분석 과정에서 오류가 발생하면 리캡 상태가 실패(FAILED)로 변경됩니다. 에러 원인이 RecapCreationHistory에 기록됩니다.
실패 안내
생성을 요청한 사용자에게 리캡 생성이 실패했다는 알림이 발송됩니다.
재시도
사용자가 실패한 리캡의 재생성을 요청합니다. 이전 생성 시 사용한 동일한 미디어로 다시 시도되며, 새로운 생성 이력이 RecapCreationHistory에 기록됩니다.
관련 문서
변경 이력
| 날짜 | 변경 내용 |
|---|---|
| 2026-03-11 | truloop-story 서비스 기반 상세 규칙 보강: 사진 자동 정렬, 다국어 지원 상세, 부분 실패 허용, 자동 재시도, 메뉴 섹션 자동 추가 |
| 2026-03-10 | 소스 코드 기반으로 정확도 개선: 알림 대상(요청자에게만), 미디어 선택 방식, 리캡 구성 요소, 메타데이터 활용, 텍스트 수정 기능, 하나의 룹에 하나의 리캡 규칙 등 반영 |
| 2026-03-09 | 최초 작성 |