[Release] 4.0.0 변경사항 배포

[KiSeungMin]

📝 작업 내용

이번 PR에서 작업한 내용을 간략히 설명해주세요

• 소셜 스터디룸 백엔드 도메인과 API를 추가했습니다.
  • 스터디룸 생성, 목록/상세 조회, 이름/썸네일 수정, 삭제, 초대 코드 발급, 초대 코드 참여, 탈퇴, 멤버 강퇴, 개인 주간 목표 설정을 지원합니다.
  • 피드 조회와 피드 반응 API를 추가하고, 문제 등록/풀이 완료 등 기존 학습 활동과 스터디룸 활동 피드를 연동했습니다.
  • 공유 문제 등록, 목록 조회, 삭제, 반응, 댓글 CRUD, 댓글 반응 API를 추가했습니다.
  • 공유 문제 중복 공유를 방지하고, 삭제 시 댓글/반응 잔여 데이터가 남지 않도록 정리 로직을 보강했습니다.
• 스터디룸 챌린지 기능을 추가하고 진행률 집계를 확장했습니다.
  • 개인/그룹 챌린지, 측정 지표, DAILY/WEEKLY/MONTHLY 기간 기준 집계를 지원합니다.
  • periodDays 기반 임의 주기 챌린지를 지원합니다.
  • 주기형 챌린지는 현재 구간 기준으로 진행률을 계산하고, 기간 종료 전 조기 완료 처리되지 않도록 조정했습니다.
  • 챌린지 삭제 권한, 진행 상태, 히스토리 조회, 완료 시각 기록을 보강했습니다.
• 스터디룸 주간 리포트 기능을 추가했습니다.
  • 주간 리포트 생성, 조회, 읽음 처리, 상위 멤버/최장 스트릭/총 문제 수/완료 챌린지 정보를 제공합니다.
  • 리포트 응답에 대표 멤버 프로필 이미지 URL을 포함했습니다.
• 스터디룸 FCM 알림을 추가했습니다.
  • 챌린지 기간 50% 경과, 마감 D-1, 챌린지 달성 완료, 공유 문제 등록, 공유 문제 반응, 공유 문제 댓글 작성 알림을 추가했습니다.
  • Quartz 기반으로 챌린지 예약 알림을 등록/취소하고, 챌린지 완료 시 룸 전체에 즉시 알림을 발송합니다.
• 커스텀 이모지 기반 감정/반응 기능을 추가했습니다.
  • 공통 CustomEmojiValidator와 에러 케이스를 추가했습니다.
  • 복습 완료 시 소감 이모지를 저장하고, 복습노트 상세/썸네일 응답에 노출합니다.
  • 학습 캘린더 날짜별 감정 이모지 등록/수정 API와 응답 필드를 추가했습니다.
  • 스터디룸 피드/공유 문제/댓글 반응 이모지 검증을 커스텀 이모지 키 기반으로 전환했습니다.
• 이미지 업로드 흐름을 Presigned URL 방식으로 확장했습니다.
  • S3 Presigned URL 발급 API를 추가했습니다.
  • 문제 이미지, 풀이 이미지, 스터디룸 썸네일, 사용자 프로필 이미지를 URL 등록 방식으로 저장할 수 있도록 API를 추가했습니다.
  • 기존 멀티파트 업로드는 유지하면서 image/jpg, application/octet-stream 등 업로드 MIME 허용 범위를 보강했습니다.
• 사용자 프로필 이미지 기능을 추가했습니다.
  • 사용자 정보 응답에 프로필 이미지 URL을 포함했습니다.
  • 프로필 이미지 멀티파트 업로드, Presigned URL 등록, 삭제 API를 추가했습니다.
  • 스터디룸 멤버/댓글/챌린지/리포트 응답에 프로필 이미지 URL을 포함했습니다.
• 폴더/썸네일 응답을 보강했습니다.
  • 폴더 썸네일 응답에 problemCount를 추가했습니다.
  • 스터디룸 목록 응답에 멤버 프로필 이미지와 오늘 연습 여부를 추가했습니다.
• 운영 안정성 개선을 반영했습니다.
  • AI 분석 처리 트랜잭션을 분리해 deadlock 및 self-invocation 문제를 완화했습니다.
  • ProblemAnalysis DLQ 처리 시 PROCESSING 상태 고착을 방지했습니다.
  • getUserInfo의 사용자 조회와 last active 갱신 트랜잭션을 통합했습니다.
  • Discord Webhook 전송을 RabbitMQ 비동기 처리로 전환했습니다.
  • Sentry 4xx ApplicationException 노이즈 필터링을 추가했습니다.
  • 오답노트 여러 장 등록 시 Hibernate JDBC batch 설정을 추가했습니다.
  • refresh_token 컬럼 인덱스를 추가했습니다.
• 랜딩 페이지에 스터디룸 섹션과 스크린샷 이미지를 추가하고, 간격/갤러리 배치를 개선했습니다.
• 에이전트 작업 문서와 PR/이슈 자동화 가이드를 갱신했습니다.

👤 사용자 영향

• 사용자는 스터디룸을 만들고 초대 코드로 멤버를 초대해 함께 학습 활동을 공유할 수 있습니다.
• 스터디룸 안에서 목표, 챌린지, 피드, 공유 문제, 댓글, 반응, 주간 리포트를 사용할 수 있습니다.
• 챌린지와 공유 문제 활동에 대한 FCM 알림을 받을 수 있습니다.
• 학습 캘린더와 복습노트에 커스텀 이모지 기반 감정 기록이 표시됩니다.
• 프로필 이미지가 사용자 정보, 스터디룸 멤버, 댓글, 리포트 등에 표시됩니다.
• 기존 문제/풀이/스터디룸/프로필 이미지 업로드는 Presigned URL 방식으로 확장되어 모바일 앱에서 대용량 이미지 업로드 부담을 줄일 수 있습니다.
• 기존 Flutter 앱에는 응답 필드 추가가 포함되므로, 구버전 앱이 unknown field를 무시하는 구조인지 최종 확인이 필요합니다.

🔌 API 호환성

• 요청/응답 DTO 변경 없음

• 기존 Flutter 앱 버전과 호환 확인

• breaking change 있음

• 신규 API가 다수 추가되었습니다.

  • /api/study-room, /api/study-rooms
  • /api/study-room/{roomId}/feed
  • /api/study-room/{roomId}/challenges
  • /api/study-room/{roomId}/shared-problems, /api/study-rooms/{roomId}/shared-problems
  • /api/study-room/{roomId}/weekly-reports
  • /api/fileUpload/presigned-urls
  • /api/learning-calendar/mood
  • /api/users/me/profile-image, /api/users/me/profile-image-url
  • /api/problems/{problemId}/imageData/urls
  • /api/problem-solves/{problemSolveId}/image-urls

• 기존 API 응답에 필드가 추가되었습니다.

  • 사용자 응답: profileImageUrl
  • 학습 캘린더 응답: moodEmojiKey
  • 복습노트 응답: lastSessionMoodEmojiKey
  • 폴더/썸네일 응답: problemCount
  • 스터디룸 관련 응답: 멤버 프로필 이미지, 오늘 연습 여부, 통계/리포트 정보

• 기존 계약에 대한 주의사항

  • 요청/응답 DTO 변경은 있으나 대부분 신규 필드 추가와 신규 API 추가입니다.
  • Flutter 구버전에서 추가 응답 필드 무시가 가능한지 확인이 필요합니다.
  • 스터디룸 공유 문제 중복 등록은 409 ALREADY_SHARED_PROBLEM으로 응답합니다.

🗄️ DB migration

• 없음

• 있음: migration 파일과 기존 데이터 호환성 확인

• 추가된 migration

  • V6__add_study_room_schema.sql
  • V7__add_custom_emoji_fields.sql
  • V8__add_study_room_challenge_period.sql
  • V9__widen_study_room_reaction_emoji.sql
  • V10__add_shared_problem_comment.sql
  • V11__add_comment_reactions_and_user_profile_image.sql
  • V12__add_challenge_period_days.sql
  • V13__drop_study_session.sql
  • V14__delete_session_started_feeds.sql
  • V15__add_challenge_completed_at.sql
  • V16__add_weekly_report_profile_image_urls.sql
  • V17__add_refresh_token_index.sql

• 주요 schema 영향

  • 스터디룸, 멤버, 초대 코드, 피드, 반응, 챌린지, 공유 문제, 댓글, 주간 리포트 테이블이 추가됩니다.
  • practice_note.last_session_mood_emoji_key, user.profile_image_url, study_room_challenge.period, study_room_challenge.period_days, study_room_challenge.completed_at, 주간 리포트 프로필 이미지 컬럼이 추가됩니다.
  • 스터디룸 반응 이모지 컬럼 길이가 VARCHAR(80)으로 확장됩니다.
  • study_session 테이블은 제거되고, 기존 SESSION_STARTED 피드는 삭제됩니다.
  • refresh_token.refresh_token(255) 인덱스가 추가됩니다.

• 배포 전 확인 필요

  • 운영 DB에 study_session 테이블 또는 SESSION_STARTED 피드가 의미 있는 데이터로 사용 중인지 확인해야 합니다.
  • Flyway migration 순서가 운영 DB의 현재 version과 충돌하지 않는지 확인해야 합니다.
  • refresh_token 인덱스 생성 시간이 운영 DB 크기에서 허용 가능한지 확인해야 합니다.

🔐 인증/권한

• 영향 없음

• 사용자별 데이터 소유권 검증 확인

• 관리자/특수 권한 영향 확인

• 스터디룸 API는 멤버 여부, 방장 권한, 작성자 권한을 기준으로 접근을 제한합니다.

• 스터디룸 이름/썸네일 수정, 삭제, 멤버 강퇴 등은 방장 권한 검증이 필요합니다.

• 공유 문제 댓글 수정/삭제, 공유 문제 삭제, 반응 등록은 멤버십과 작성자/방장 정책을 기준으로 동작합니다.

• 사용자 프로필 이미지 변경/삭제는 본인 계정 기준으로 처리됩니다.

✅ 검증 결과

• git log --oneline --no-merges b642e7c6..develop로 기준 커밋 이후 커밋 범위를 확인했습니다.
• git diff --stat b642e7c6..develop 기준 158 files changed, 8959 insertions(+), 178 deletions(-) 변경을 확인했습니다.
• git diff --name-status b642e7c6..develop로 변경 파일 범위를 확인했습니다.
• PR 메시지 작성 시점에는 테스트를 직접 실행하지 않았습니다. 실제 PR 제출 전 아래 검증을 권장합니다.
  • ./gradlew test
  • 스터디룸 API 통합 테스트 전체
  • Flyway migration 적용 검증
  • RabbitMQ/Quartz/FCM 알림 흐름 스테이징 검증
  • Flutter 구버전 앱 응답 파싱 호환성 확인
• 변경에 포함된 테스트
  • 스터디룸 생성/초대/참여/탈퇴/멤버 관리/목표 설정 통합 테스트
  • 스터디룸 피드/반응 통합 테스트
  • 스터디룸 챌린지 API 및 서비스 테스트
  • 공유 문제/댓글/댓글 반응 통합 테스트
  • 주간 리포트 통합 테스트
  • 학습 캘린더 감정 이모지 테스트
  • 복습노트 소감 이모지 테스트
  • 폴더 썸네일 problemCount 관련 테스트
  • 사용자 프로필 이미지 관련 테스트

🚀 배포 리스크

• DB migration이 많고 신규 테이블/컬럼/인덱스/데이터 삭제가 포함되어 있어, 운영 배포 전 Flyway dry-run 또는 스테이징 적용 확인이 필요합니다.
• V13__drop_study_session.sql, V14__delete_session_started_feeds.sql는 데이터 삭제 성격이 있으므로 운영 데이터 사용 여부를 반드시 확인해야 합니다.
• RabbitMQ 기반 Discord Webhook, ProblemAnalysis DLQ, FCM 알림, Quartz 예약 작업이 포함되어 있어 큐/스케줄러 설정 누락 시 일부 알림이 지연되거나 발송되지 않을 수 있습니다.
• 스터디룸 API는 신규 도메인 범위가 크므로 권한 검증 누락이 사용자 데이터 노출로 이어질 수 있습니다. 멤버십/방장/작성자 권한 흐름을 스테이징에서 재확인해야 합니다.
• Presigned URL 방식은 클라이언트 업로드 순서와 URL 등록 API 호출 순서가 맞아야 하므로, Flutter 앱 배포 버전과 백엔드 배포 순서를 맞춰야 합니다.
• 기존 응답 DTO에 필드가 추가되어 구버전 Flutter 앱에서 JSON 파싱 방식이 엄격하면 호환성 문제가 생길 수 있습니다.
• refresh_token 인덱스 생성은 DB 크기에 따라 배포 중 lock 또는 지연 가능성이 있습니다.

↩️ 롤백/대응 방법

• 애플리케이션 배포 문제만 발생한 경우, DB migration 적용 여부를 확인한 뒤 이전 서버 버전으로 롤백합니다.
• migration 적용 후 롤백이 필요한 경우 신규 테이블/컬럼/인덱스와 데이터 삭제 migration 영향 때문에 단순 서버 롤백만으로는 완전 복구되지 않을 수 있습니다.
• 배포 전 운영 DB 백업을 확보하고, 특히 study_session 테이블 및 SESSION_STARTED 피드 삭제 전 데이터 사용 여부를 확인합니다.
• 알림 장애가 발생하면 RabbitMQ consumer, Quartz scheduler, FCM 설정을 우선 확인하고, 핵심 학습/문제 풀이 API와 분리해서 대응합니다.
• Presigned URL 업로드 장애가 발생하면 기존 멀티파트 업로드 API 유지 여부를 확인해 클라이언트에서 임시 우회할 수 있습니다.
• 스터디룸 기능에서 권한/데이터 노출 문제가 발견되면 스터디룸 관련 엔드포인트를 우선 제한하거나, 해당 Flutter 진입점을 비활성화하는 방식으로 사용자 노출을 줄입니다.

스크린샷 (선택)

• 랜딩 페이지 스터디룸 섹션 이미지가 추가되었습니다.
• API PR 본문에는 별도 스크린샷 생략 가능