feat(report): 월간 리포트 V2 비교·소셜·이미지 다양화 및 조회 계약 확장

[1Seob]

📝 요약(Summary)

월간 리포트 V2에 직전 완료 리포트 기반 감정 비교, 월간 소셜 반응 랭킹, 이미지 화풍·색상 다양화 기능을 추가했습니다.

V1/V2 리포트가 혼재하는 환경에서 클라이언트가 올바른 상세 API를 선택할 수 있도록 월간 리포트 조회 응답도 locator 기반으로 개편했습니다.

월간 감정 비교

• 현재 생성 월보다 이전인 가장 최근 완료 V2 리포트를 비교 대상으로 선택
• BASELINE과 COMPARISON 프롬프트 분기
• 직전 리포트 기간·감정 통계·분석 내용을 비교 입력으로 조립
• 비교 결과를 emotion_comparison JSONB 스냅샷으로 저장
• COMPARISON 응답의 요약·감정 변화·강조 표현 검증 추가
• dev/prod 배포 workflow에 MONTHLY_V2_COMPARISON_PROMPT 환경 변수 연동

월간 소셜 요약

• 내 DailyReport에 받은 좋아요와 댓글·대댓글을 월 단위로 집계
• 친구 상태, 탈퇴, 차단 및 삭제된 댓글·좋아요 필터링
• 좋아요·댓글 합계와 참여 친구 수를 기준으로 노출 여부 계산
• 횟수 내림차순 및 가나다순 동점 처리
• 좋아요·댓글 랭킹을 각각 최대 3명까지 생성
• 공동 1위 강조 및 화면 배치 순서 계산
• 생성 결과를 social_summary JSONB로 저장하고 V2 조회 응답에 추가

월간 리포트 조회 계약

• GET /api/v2/monthly-report에서 report, previousReport locator 반환
• locator에 reportId, version, month, status 제공
• V2 우선, V1 fallback 방식으로 월별 리포트 탐색
• 기존 단일 조회를 GET /api/v2/monthly-report/current로 이동하고 Swagger에서 숨김
• 버전에 따라 다음 상세 API를 호출하도록 Swagger 문서화
  • V1: GET /api/v1/monthly-report/{reportId}
  • V2: GET /api/v2/monthly-report/{reportId}
• V1 상세 조회의 소유권 검증 보완

이미지 화풍 및 색상 다양화

• 이미지 화풍 8종과 색상 팔레트 8종 추가
• 최근 완료 리포트 3개의 화풍·팔레트를 후보에서 제외
• 사용자·리포트·대상 월 기반 결정적 선택 적용
• 선택 결과를 image_prompt_variant, image_color_palette에 저장해 재시도 시 재사용
• 화풍과 팔레트를 MonthlyImageVisualPreset으로 통합
• 공통 안전 제약, 화풍 지침, 색상 지침을 조립하는 prompt composer 구현
• 기본 라벤더·핑크·베이지·파스텔 색감으로 수렴하지 않도록 제약 추가
• 화풍 8종 × 팔레트 8종의 64개 프롬프트 조합 지원
• 기존 중복 이미지 prompt loader 제거

데이터베이스 변경

• monthly_reports_v2.emotion_comparison 추가
• monthly_reports_v2.social_summary 추가
• monthly_reports_v2.image_prompt_variant 추가
• monthly_reports_v2.image_color_palette 추가
• 기존 데이터와 호환되도록 신규 이미지 설정 컬럼은 nullable로 구성

테스트

• 비교 대상 선택 및 비교 입력 조립
• BASELINE/COMPARISON 프롬프트 분기와 응답 검증
• 소셜 집계·필터링·랭킹·노출 조건
• V1/V2 locator 우선순위, 미완료 상태 및 연도 경계
• 이미지 화풍·팔레트 결정성 및 최근 이력 제외
• 이미지 설정 저장·재사용 및 부분 상태 보완
• listener 성공·실패·환불 경로
• 전체 64개 이미지 프롬프트 조합 고유성
• 팔레트별 핵심 색상 표현

.\gradlew.bat test 전체 테스트 93개 통과

🔗 Related Issue

• Closes:

💬 공유사항

✅ PR Checklist

PR이 다음 요구 사항을 충족하는지 확인하세요.

• PR 제목을 커밋 메시지 컨벤션에 맞게 작성했습니다.

[coldsunn]

고생하셨어요!! 머지 고고~