docs(ranking): cold-start fallback 작업 기록을 갱신한다

docs/20260529_메인_홈_추천_API/plan-task.md

@@ -4,7 +4,7 @@
 
 **Goal:** `/api/v2/home/recommendations` 하위에 메인 홈 추천 통합 조회, 섹션별 전체보기, 콘텐츠 조회 이력 기록, 추천 크리에이터 동시 팔로우 API를 제공한다.
 
-**Architecture:** 공개 API 조립은 `kr.co.vividnext.sodalive.v2.api.home`에 두고, 추천 정책/점수/스냅샷/조회 이력/팔로우 기능은 `kr.co.vividnext.sodalive.v2.recommend`에 둔다. `v2.api.home`은 `v2.recommend`의 application use case만 호출하며, `v2.recommend`는 API DTO에 의존하지 않는다.
+**Architecture:** 공개 API 조립은 `kr.co.vividnext.sodalive.v2.api.home`에 두고, 추천 정책/점수/스냅샷/조회 이력/팔로우 기능은 `kr.co.vividnext.sodalive.v2.recommendation`에 둔다. `v2.api.home`은 `v2.recommendation`의 application use case만 호출하며, `v2.recommendation`는 API DTO에 의존하지 않는다.
 
 **Tech Stack:** Kotlin, Spring Boot 2.7.14, Java 17, Spring Data JPA, QueryDSL, native SQL, JUnit 5, Gradle Wrapper
 
@@ -24,6 +24,8 @@
 - 페이징 방식: 기존 Spring `Pageable`을 우선 사용하고 응답에는 `items`, `page`, `size`, `hasNext`를 포함한다.
 - 시간 응답: `LocalDateTime` 저장값을 기존 관례처럼 KST 기준 저장값으로 보고 UTC ISO 문자열(`...Z`)로 변환한다.
 - 스냅샷 일 배치는 KST 매일 06:00:00에 실행하고, 스냅샷 기준 시각은 전날 23:59:59 KST 의미를 코드에서 명확히 계산한다. 스케줄러는 `@Scheduled(cron = "0 0 6 * * *", zone = "Asia/Seoul")`로 등록한다.
+- 다중 서버 인스턴스에서 스냅샷 일 배치가 중복 실행되지 않도록 기존 Redisson 기반 분산 lock을 사용한다.
+- 추천 스냅샷 lock key는 `lock:recommendation-snapshot-refresh`로 고정하고, lock 획득 실패 인스턴스는 정상 skip한다.
 - 저장소에는 DB migration 디렉터리가 없으므로 신규 스냅샷/조회 이력 엔티티 추가 시 운영 DB DDL 반영은 배포 절차에서 별도 수행한다. 코드 구현 task에는 JPA 엔티티/리포지토리와 통합 테스트를 포함하고, Phase 7 완료 후 신규 엔티티 테이블 생성 SQL을 문서 산출물로 작성한다.
 - 조회 구현은 JPA/QueryDSL 우선, native SQL 제한 사용의 하이브리드 전략으로 진행한다. 단순 조회/상세 조립/대상 활성 조건은 JPA 또는 QueryDSL로 표현하고, CTE/window function/`union all`/DB-side exact scoring처럼 SQL 고급 기능이 필요한 추천 산정에만 native SQL을 사용한다. native SQL 사용 시에는 H2 MySQL mode와 Kotlin 정책 산식 parity를 포함한 repository 통합 테스트를 반드시 둔다.
 - 이번 범위에서는 기존 홈/콘텐츠 홈/라이브/AI 캐릭터 API의 공개 스키마를 변경하지 않고, 앱 다국어 문구 번역, ML 개인화, A/B 테스트 플랫폼, 관리자 화면, 추천 결과 수동 편집 기능은 구현하지 않는다. 응답 enum은 앱 다국어 처리를 위해 안정적인 영문 code로 유지한다.
@@ -35,29 +37,29 @@
 ### 신규 API 조립 계층
 - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/HomeRecommendationController.kt`
 - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/HomeRecommendationResponse.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/HomeRecommendationPageResponse.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/FollowRecommendedCreatorsRequest.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/HomeRecommendationResponse.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/HomeRecommendationPageResponse.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/FollowRecommendedCreatorsRequest.kt`
 
 ### 신규 추천 기능 계층
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendationScorePolicy.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/CreatorDebutPolicy.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendedActivityType.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendedSectionType.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryService.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowService.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/CreatorContentViewHistoryPort.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/RecommendationSnapshotPort.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/CreatorContentViewHistory.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/CreatorContentViewHistoryRepository.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/RecommendationSnapshot.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/RecommendationSnapshotRepository.kt`
-- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/scheduler/RecommendationSnapshotScheduler.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicy.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/CreatorDebutPolicy.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendedActivityType.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendedSectionType.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryService.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowService.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/CreatorContentViewHistoryPort.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/RecommendationSnapshotPort.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistory.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistoryRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshot.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshotRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/scheduler/RecommendationSnapshotScheduler.kt`
 
 ### 기존 코드 연결
 - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`
@@ -66,12 +68,12 @@
   - 기존 공개 스키마는 유지하고 인증 회원 정보를 서비스로 전달하는 기존 흐름만 활용한다.
 
 ### 테스트
-- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendationScorePolicyTest.kt`
-- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/CreatorDebutPolicyTest.kt`
-- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
-- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryServiceTest.kt`
-- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowServiceTest.kt`
-- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicyTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/CreatorDebutPolicyTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryServiceTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowServiceTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
 - Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt`
 
 ---
@@ -80,32 +82,32 @@
 
 - [x] **Task 1.1: 추천 점수/신규 부스트 정책 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendationScorePolicy.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendationScorePolicyTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicy.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicyTest.kt`
   - RED: `shouldApplyCreatorNewBoostByDebutDays`, `shouldApplyAiCharacterNewBoostByCreatedDays`, `shouldCalculateDebutCreatorScore`, `shouldCalculateAiChatScore`, `shouldCalculateCheerScore`, `shouldCalculateCommunityScore`, `shouldCalculateFirstAudioRecencyScore` 테스트를 먼저 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.domain.RecommendationScorePolicyTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendationScorePolicyTest`
   - GREEN: PRD 산식과 부스트 값을 그대로 구현한다. AI 캐릭터 신규 부스트는 캐릭터 생성일 기준 10일 이내 1.5, 20일 이내 1.3, 30일 이내 1.2, 그 외 1을 적용한다. 첫 오디오 최신성 점수는 `release_date` 기준 3일 이내 100, 7일 이내 80, 14일 이내 60, 21일 이내 40, 30일 이내 20을 적용한다.
   - REFACTOR: 산식별 public 함수명과 파라미터가 PRD 용어를 반영하는지 정리한다.
   - 기대 결과: 모든 산식/부스트/최신성 점수 테스트가 PASS이고 소수 계산 오차는 `assertEquals(expected, actual, 0.0001)` 범위 안에 들어간다.
 
 - [x] **Task 1.2: 데뷔일/신규 크리에이터 판정 정책 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/CreatorDebutPolicy.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/CreatorDebutPolicyTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/CreatorDebutPolicy.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/CreatorDebutPolicyTest.kt`
   - RED: 첫 공개 콘텐츠 일시와 첫 라이브 일시 중 빠른 값을 데뷔일로 선택하는 테스트, 데뷔 후 30일 이내만 true인 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.domain.CreatorDebutPolicyTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.domain.CreatorDebutPolicyTest`
   - GREEN: `resolveDebutAt(firstContentPublishedAt, firstLiveAt)`와 `isNewCreator(debutAt, now)`를 구현한다.
   - REFACTOR: 기존 `ExplorerService.getCreatorDetail`의 `debutDateTime` 계산과 비교해 의미가 어긋나지 않는지 확인한다.
   - 기대 결과: 콘텐츠만 있는 경우, 라이브만 있는 경우, 둘 다 있는 경우, 둘 다 없는 경우가 모두 명확히 검증된다.
 
 - [x] **Task 1.3: 섹션/활동 enum과 내부 응답 모델 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendedActivityType.kt`
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendedSectionType.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendedActivityType.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendedSectionType.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
   - RED: `LIVE_REPLAY` 테마 콘텐츠가 `AUDIO`가 아니라 `LIVE_REPLAY`로 분류되는 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`
   - GREEN: 내부 모델에 `LIVE`, `AUDIO`, `COMMUNITY`, `LIVE_REPLAY` enum을 추가하고 활동 분류 함수를 구현한다.
   - REFACTOR: enum 값은 앱 다국어 처리를 위해 영문 code와 동일하게 유지한다.
   - 기대 결과: 활동 타입 응답 문자열이 PRD의 enum 후보와 일치한다.
@@ -114,111 +116,121 @@
 
 - [x] **Task 2.1: 추천 스냅샷 엔티티/리포지토리 추가**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/RecommendationSnapshotPort.kt`
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/RecommendationSnapshot.kt`
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/RecommendationSnapshotRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/RecommendationSnapshotPort.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshot.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshotRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: 섹션 타입, 대상 id, 점수, 기준 시각, 랜덤 tie-breaker를 저장하고 기준 시각별 최신 스냅샷만 읽는 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: `RecommendationSnapshot` JPA 엔티티와 `findTop...`, `deleteBySectionTypeAndSnapshotAt` 계열 리포지토리 메서드를 구현하고, application service가 의존할 `RecommendationSnapshotPort`를 둔다.
   - REFACTOR: 스냅샷 조회가 없으면 빈 배열을 반환하도록 service 경계에서 처리한다.
   - 기대 결과: 스냅샷 없음이 예외가 아니라 빈 결과로 검증된다.
 
 - [x] **Task 2.2: 스냅샷 갱신 서비스 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: AI 캐릭터, 최근 응원, 인기 커뮤니티 점수를 전날 23:59:59 기준으로 생성하는 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: 최근 7일 집계와 신규 부스트를 적용해 `AI_CHARACTER`, `CHEER_CREATOR`, `POPULAR_COMMUNITY` 스냅샷을 저장한다. AI 캐릭터의 `followIncrease`는 팔로우 대상/관계 정의가 확정되지 않아 이번 스프린트에서 제외하고 0으로 집계한다.
   - REFACTOR: 무거운 QueryDSL 집계는 repository에 두고 점수 산식은 `RecommendationScorePolicy`만 사용한다.
   - 기대 결과: 동일 점수 항목은 `randomTieBreaker`가 저장되어 조회 시 랜덤 tie-breaker 정렬에 사용할 수 있다.
 
 - [x] **Task 2.3: 매일 06:00 KST 스케줄러 추가**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/scheduler/RecommendationSnapshotScheduler.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/scheduler/RecommendationSnapshotScheduler.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: KST 매일 06:00:00 cron과 `Asia/Seoul` zone이 선언되는지 reflection 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: 스케줄러가 KST 06:00:00 cron으로 `RecommendationSnapshotRefreshService.refreshDailySnapshots()`를 호출하도록 구현한다.
   - REFACTOR: 스케줄러에는 집계 로직을 두지 않고 호출만 남긴다.
   - 기대 결과: KST 매일 06:00에 전날 23:59:59 KST 기준 집계가 실행되는 계약이 테스트로 고정된다.
 
+- [x] **Task 2.3.1: 일 스냅샷 스케줄러 Redisson lock 적용**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/scheduler/RecommendationSnapshotScheduler.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
+  - RED: Redisson lock 획득 성공 시 `RecommendationSnapshotRefreshService.refreshDailySnapshots()`를 1회 호출하고, 획득 실패 시 호출하지 않는 테스트를 작성한다. lock key가 `lock:recommendation-snapshot-refresh`인지도 검증한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
+  - GREEN: 기존 `RedissonClient` bean을 스케줄러에 주입하고 `tryLock`으로 lock을 획득한 인스턴스만 refresh service를 호출한다. lock 획득 실패는 정상 skip으로 처리한다.
+  - REFACTOR: DB 기반 scheduler lock 테이블은 추가하지 않고, 기존 `AudioContentReleaseScheduledTask`의 Redisson lock 패턴을 참고하되 스케줄러에는 lock 획득/해제와 service 호출만 둔다.
+  - 기대 결과: 여러 서버 인스턴스에서 같은 cron이 동시에 실행돼도 클러스터 전체에서 한 인스턴스만 추천 스냅샷을 갱신한다.
+
 - [x] **Task 2.4: Phase 2 스냅샷 집계 통합 검증과 경계 보강**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/scheduler/RecommendationSnapshotScheduler.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/RecommendationSnapshotPort.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/scheduler/RecommendationSnapshotScheduler.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/RecommendationSnapshotPort.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: QueryDSL 집계 통합 테스트를 추가해 AI 캐릭터 최근 채팅 수/활성 사용자 수, 최근 응원 `CHANNEL_DONATION` 후원 금액/후원 수와 팬 Talk 수, 인기 커뮤니티 좋아요/댓글/팔로워 수가 Phase 2 요구와 일치하는지 검증한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: 스케줄러 cron을 KST 06:00:00 `Asia/Seoul` zone으로 수정하고, 최근 응원 후원 금액/후원 수는 `CanUsage.CHANNEL_DONATION`만 집계한다.
   - REFACTOR: `RecommendationSnapshotPort`가 persistence entity를 직접 노출하지 않도록 application/domain 경계 DTO 또는 모델을 도입해 `port.out` 의존 경계를 정리한다.
   - 기대 결과: Phase 2 집계 의미가 DB 기반 테스트로 고정되고, 스케줄러 timezone 계약과 `port.out` 경계 정리가 문서/테스트/구현에 함께 반영된다.
 
 - [x] **Task 2.5: 크리에이터 신규 부스트 실제 데뷔일 적용**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: 최근 응원/인기 커뮤니티 신규 부스트가 단순 `Member.createdAt`이 아니라 실제 데뷔일을 사용하도록 실패 테스트를 추가한다. 실제 데뷔일은 첫 공개 콘텐츠 일시와 첫 라이브 일시 중 빠른 값이며, 둘 다 없는 경우는 스냅샷 후보에서 제외되는 실패 테스트를 추가한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: 최근 응원/인기 커뮤니티 후보 DTO가 실제 데뷔일을 담도록 QueryDSL 집계를 수정하고, service는 신규 부스트 계산 시 해당 데뷔일만 사용한다.
   - REFACTOR: 데뷔일 의미는 `CreatorDebutPolicy.resolveDebutAt(...)`과 일치하도록 중복 계산을 최소화한다.
   - 기대 결과: 최근 응원/인기 커뮤니티 신규 부스트가 `Member.createdAt`이 아니라 실제 데뷔일 기준으로 계산된다.
 
 - [x] **Task 2.6: AI 캐릭터 최근 채팅 수를 AI 발화 수로 고정**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
   - RED: AI 캐릭터 최근 채팅 수가 최근 7일 안에 해당 AI 캐릭터가 발화한 채팅 메시지 수만 세도록 실패 테스트를 추가한다. 사용자 메시지, 다른 캐릭터 메시지, 비활성 메시지, 기간 밖 메시지는 제외되는지 fixture로 검증한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
   - GREEN: QueryDSL where/join 조건을 보강해 `recentChatCount`가 AI 발화 메시지 수만 반환하도록 구현한다.
   - REFACTOR: 테스트 이름과 후보 DTO 필드 설명이 PRD의 "AI가 발화한 채팅 수" 의미를 드러내도록 정리한다.
   - 기대 결과: AI 캐릭터 추천 점수의 `최근 발생한 AI 채팅 수` 입력값이 AI 발화 수로 고정된다.
 
 - [x] **Task 2.7: AI 캐릭터 채팅 활성 사용자 수를 중복 없는 채팅 사용자 수로 고정**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
   - RED: 최근 활성 사용자 수가 최근 7일 안에 해당 AI 캐릭터와 1회 이상 채팅한 중복 없는 사용자 수로 계산되도록 실패 테스트를 추가한다. 같은 사용자의 다중 메시지는 1명으로 세고, 다른 캐릭터와만 채팅한 사용자는 제외한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
   - GREEN: QueryDSL 집계가 캐릭터별 distinct 사용자 수를 반환하도록 구현한다.
   - REFACTOR: 활성 사용자 수 집계는 Task 2.6의 AI 발화 수 집계와 의미가 섞이지 않도록 별도 테스트 케이스로 유지한다.
   - 기대 결과: AI 캐릭터 추천 점수의 `최근 활성 사용자 수` 입력값이 중복 없는 채팅 사용자 수로 고정된다.
 
 - [x] **Task 2.8: 스냅샷 최종 저장 수를 점수순으로 제한**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
   - RED: 스냅샷 저장 결과가 최종 점수 내림차순과 `randomTieBreaker` 기준으로 AI 캐릭터 최대 20개, 최근 응원이 많은 크리에이터 최대 16개, 인기 커뮤니티 최대 20개만 저장되는 실패 테스트를 추가한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
   - GREEN: repository 조회에서 최종 점수와 `randomTieBreaker`를 계산하고, 점수 정렬 이후 동점자 랜덤 노출 여지를 위한 섹션별 최종 저장 수를 적용한다. service는 기준 시각 계산과 snapshot replace만 담당한다.
   - REFACTOR: `GENRE_CREATOR`는 Phase 2 스냅샷 갱신 대상이 아니라 Task 4.2의 조회 이력 기반 추천임을 문서/테스트 경계로 유지한다.
   - 기대 결과: application/service가 전체 후보를 메모리로 불러와 점수를 계산하지 않고, DB에서 정확한 최종 top 후보를 동점자 랜덤 정렬까지 반영해 반환하고 저장한다.
 
 - [x] **Task 2.9: DB-side exact scoring으로 스냅샷 후보 산정 전환**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendationScoreSpec.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendationScorePolicy.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/domain/RecommendationScorePolicyTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScoreSpec.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicy.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicyTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: `RecommendationScoreSpec` 공유 산식과 DB-scored snapshot 조회 계약이 없으면 컴파일/테스트가 실패하도록 테스트를 작성한다. native SQL을 사용하는 쿼리는 Kotlin `RecommendationScorePolicy` 기대값과 DB score를 비교하고, 부스트 경계일, null aggregate, 비활성/제외 row, `score desc, randomTieBreaker asc` 정렬, 최종 점수 계산 이후 limit 적용, H2 MySQL mode parameter binding 호환성을 함께 검증한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.domain.RecommendationScorePolicyTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendationScorePolicyTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: DB 조회에서 모든 적격 후보의 최종 score와 `randomTieBreaker`를 계산한 뒤 `score desc, randomTieBreaker asc` 정렬과 섹션별 최종 limit을 적용한다. service는 기준 시각 계산과 snapshot replace만 담당하고 Kotlin-side score 재계산과 service-side limit을 제거한다.
   - REFACTOR: DB score expression과 Kotlin `RecommendationScorePolicy`가 `RecommendationScoreSpec`의 가중치/부스트 구간 상수를 공유하도록 정리하고, 최근 응원/인기 커뮤니티 집계는 aggregate CTE 기반으로 중복 계산을 줄인다.
   - 기대 결과: candidate pre-limit 없이 DB에서 정확한 최종 top 후보를 산정하고, 20/16/20 저장 상한은 최종 점수 계산과 동점 랜덤 정렬 이후 적용되는 저장 limit으로만 유지된다.
@@ -227,37 +239,37 @@
 
 - [x] **Task 3.1: 라이브/배너/활동 크리에이터 조회 구현**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
   - RED: 라이브 최신순 20개, 활성 배너 orders 정렬 최대 20개, 동일 `orders` 배너의 랜덤 tie-breaker 정렬, 크리에이터당 최신 활동 1개만 반환하는 테스트를 작성한다. 라이브 노출 정보는 크리에이터 닉네임/프로필 이미지/라이브 번호를 포함하고, 활동 크리에이터 노출 정보는 크리에이터 프로필 이미지/닉네임/활동 타입/UTC 활동 시간/이동 대상 id를 포함하며 라이브 활동의 이동 대상 id는 nullable임을 검증한다. 배너는 비활성 이벤트 대상 `EVENT`, 비활성 크리에이터 대상 `CREATOR`, 비활성 시리즈 대상 `SERIES`, 비활성 시리즈 소유 회원 대상 `SERIES`가 제외되고, `LINK` 배너는 별도 대상 엔티티 검증 없이 배너 자체 활성 상태만으로 노출되는 repository 테스트를 함께 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
-  - GREEN: `LiveRoom`, `AudioContentBanner`, `AudioContent`, `CreatorCommunity` 기반 QueryDSL 조회를 구현한다. application service는 `HomeRecommendationQueryPort`에만 의존하고 persistence 구현체가 port를 구현한다. 배너는 기존 콘텐츠 홈 배너의 앱 이동 필드를 유지하고, 동일 `orders` 값은 후보군 축소 후 랜덤화하거나 랜덤 tie-breaker를 적용한다. 배너 대상 활성 조건은 service 후처리가 아니라 repository 조회 조건으로 고정한다. 활동 타입 enum 값은 `LIVE`, `AUDIO`, `COMMUNITY`, `LIVE_REPLAY` 영문 code 그대로 유지한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
+  - GREEN: `LiveRoom`, `AudioContentBanner`, `AudioContent`, `CreatorCommunity` 기반 QueryDSL 조회를 구현한다. application service는 `HomeRecommendationQueryPort`에만 의존하고 persistence 구현체가 port를 구현한다. 배너는 기존 콘텐츠 홈 배너의 앱 이동 필드를 유지하고, 동일 `orders` 값은 후보군 축소 후 랜덤화하거나 랜덤 tie-breaker를 적용한다. 배너 대상 활성 조건은 service 후처리가 아니라 repository 조회 조건으로 고정한다. 활동 타입 enum 값은 `LIVE`, `AUDIO`, `COMMUNITY`, `LIVE_REPLAY` 영문 code 그대로 유지한다. 최근 활동 `COMMUNITY`의 이동 대상 id는 커뮤니티 게시글 id가 아니라 해당 게시글 작성자 크리에이터 id를 사용한다.
   - REFACTOR: 차단 관계, 비활성 회원, 비활성 콘텐츠/배너 제외 조건을 공통 private 조건 함수로 정리한다. 단순 조회와 대상 활성 조건은 QueryDSL/JPA 우선으로 표현하고, native SQL은 SQL 고급 기능이 필요한 쿼리에만 남긴다.
   - 기대 결과: 특정 섹션 데이터가 부족해도 service가 가능한 개수만 반환한다.
 
 - [x] **Task 3.2: 최근 데뷔/첫 오디오 콘텐츠 조회 구현**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
   - RED: 데뷔 후 30일 이내 추천 점수순, 최근 데뷔 크리에이터 노출 정보의 프로필 이미지/닉네임, 첫 오디오 콘텐츠 3번째 이내 활성 콘텐츠만 인정, 최신성 점수 구간별 정렬, 예약 공개 콘텐츠 제외 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`
   - GREEN: 데뷔일 계산, 최근 7일/30일 집계, `release_date` 기준 최신성 점수, 동점 랜덤 정렬을 구현한다.
   - REFACTOR: 데뷔일 계산은 `CreatorDebutPolicy`, 산식은 `RecommendationScorePolicy`만 호출하도록 중복 제거한다.
   - 기대 결과: 앞선 비활성 콘텐츠가 3개 이상이면 이후 활성 콘텐츠가 제외된다.
 
 - [x] **Task 3.3: AI 캐릭터/응원/인기 커뮤니티 스냅샷 조회 구현**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
   - RED: 스냅샷 기준 AI 캐릭터 10개, AI 캐릭터 응답의 캐릭터 이름/소개/전체 채팅 수/오리지널 작품명 조건, 최근 응원 8명과 크리에이터 프로필 이미지/닉네임, 인기 커뮤니티 10개와 크리에이터 프로필 이미지/닉네임/UTC 시간/좋아요 수/댓글 수/커뮤니티 내용, 스냅샷 없음 빈 배열 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`
   - GREEN: `RecommendationSnapshotRepository`에서 최신 스냅샷을 읽고 대상 엔티티 상세 정보를 조립한다. AI 캐릭터 작품명은 오리지널 작품 캐릭터인 경우에만 채우고, 인기 커뮤니티는 스냅샷에 저장된 점수/랜덤 tie-breaker 순서를 유지한다.
   - REFACTOR: 비활성/노출 제한 캐릭터, 커뮤니티 비공개/유료/핀/성인 조건을 repository 조건으로 고정한다.
   - 기대 결과: AI 캐릭터 노출 필드가 PRD와 일치하고, 인기 커뮤니티는 크리에이터당 1개만 반환하며 동일 점수는 스냅샷 생성 시 저장한 랜덤 tie-breaker 기준으로 노출된다.
@@ -266,13 +278,13 @@
 
 - [x] **Task 4.1: 콘텐츠 조회 이력 엔티티/서비스 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/CreatorContentViewHistoryPort.kt`
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/CreatorContentViewHistory.kt`
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/CreatorContentViewHistoryRepository.kt`
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryService.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryServiceTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/CreatorContentViewHistoryPort.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistory.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistoryRepository.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryServiceTest.kt`
   - RED: 인증 회원의 콘텐츠 상세 진입 시 memberId/contentId/genreId/viewedAt이 저장되는 테스트와 비회원은 저장하지 않는 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.CreatorContentViewHistoryServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryServiceTest`
   - GREEN: 이력 저장 service와 repository를 구현한다. application service는 `CreatorContentViewHistoryPort`에만 의존하고 persistence 구현체가 port를 구현한다.
   - REFACTOR: 동일 회원/콘텐츠의 연속 중복 저장 허용 여부는 추천 이력으로 보존하며, 집계 시 distinct 장르 기준으로 처리한다.
   - 기대 결과: 조회 이력 저장 실패가 콘텐츠 상세 조회 자체를 실패시키지 않도록 호출부에서 예외 전파 범위를 제한한다.
@@ -280,11 +292,11 @@
 - [x] **Task 4.2: 장르 기반 크리에이터 추천 조회 구현**
   - 선행 조건: Task 4.1의 `CreatorContentViewHistory` 엔티티/리포지토리/저장 service가 준비되어 있어야 한다.
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
   - RED: 조회 이력 콘텐츠의 `content_theme` 기준 랜덤 5개, 부족분 랜덤 보충, 테마별 8명, 한 응답의 5개 테마 안에서 크리에이터 중복 제거, 서로 다른 조회 시점에서는 같은 크리에이터 재노출 허용, 팔로우 크리에이터 제외, 활성 크리에이터/활성 콘텐츠가 없어 빈 그룹이 되는 테마 제외, 크리에이터 프로필 이미지/닉네임/id 노출 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`
   - GREEN: `CreatorContentViewHistory.contentId`와 `content.theme_id` 매핑을 기반으로 후보 테마/크리에이터를 조회한다. 기존 응답 필드명은 공개 스키마 호환을 위해 `genreId`, `genreName`을 유지하되 값은 `content_theme.id`, `content_theme.theme`을 담는다.
   - REFACTOR: 성인 콘텐츠 테마는 `MemberContentPreference.isAdultContentVisible == true` 회원에게만 포함되도록 조건을 공통화한다.
   - 기대 결과: 비회원 또는 조회 이력 없는 회원도 조회 가능한 테마 중 랜덤 5개를 받고, 활성 크리에이터/활성 콘텐츠가 없는 빈 그룹은 제외한 뒤 다른 테마로 보충된다.
@@ -299,21 +311,34 @@
   - REFACTOR: 기존 `GetAudioContentDetailResponse` 스키마와 Controller URL/응답은 변경하지 않는다.
   - 기대 결과: 기존 상세 조회 테스트가 모두 통과하고 응답 JSON 필드가 바뀌지 않는다.
 
+- [x] **Task 4.4: 장르 기반 크리에이터 추천 본인 제외 보정**
+  - Files:
+    - Modify: `docs/20260529_메인_홈_추천_API/prd.md`
+    - Modify: `docs/20260529_메인_홈_추천_API/plan-task.md`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
+  - RED: 조회자가 크리에이터인 경우 본인만 있는 장르는 제외하고, 8명 중 본인이 포함된 장르는 본인을 제외한 뒤 대체 크리에이터가 있으면 8명을 채우며, 대체 크리에이터가 없거나 장르 전체가 8명 미만이면 조회 가능한 크리에이터만 응답하는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeRequesterOnlyGenreFromGenreCreatorRecommendations --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldBackfillCreatorAfterExcludingRequesterFromGenreCreatorRecommendations --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldReturnAvailableCreatorsAfterExcludingRequesterFromGenreCreatorRecommendations`
+  - GREEN: 장르 후보 eligibility, fallback 후보 count, 실제 장르별 크리에이터 조회 SQL에서 `memberId`가 있는 경우 조회자 본인 크리에이터를 제외한다.
+  - REFACTOR: 공개 API 응답 스키마와 service의 장르별 중복 제거/보충 정책은 유지하고, repository 후보 산정과 응답 크리에이터 목록이 같은 eligibility 기준을 쓰는지 회귀 테스트로 확인한다.
+  - 기대 결과: 본인만 있는 장르는 응답하지 않고, 본인을 제외한 추천 가능 크리에이터가 있으면 최대 8명까지 응답하며, 8명 미만이면 가능한 만큼만 응답한다.
+
 ### Phase 5: 추천 크리에이터 동시 팔로우
 
 - [x] **Task 5.1: 팔로우 use case 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowService.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowServiceTest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowServiceTest.kt`
   - RED: mock 없이 실제 Spring/JPA 흐름으로 신규 팔로우 id와 이미 팔로우/본인 id 등 제외 id를 구분하는 테스트, 존재하지 않는 id/크리에이터가 아닌 id 포함 시 전체 실패 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendedCreatorFollowServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendedCreatorFollowServiceTest`
   - GREEN: `MemberRepository`, `CreatorFollowingRepository`를 사용해 전체 입력을 검증하고, 이미 팔로우 중인 id와 본인 id는 서버 내부에서 제외하며 신규 팔로우만 저장한다. 과거 언팔로우로 비활성화된 팔로우 이력은 신규 row를 만들지 않고 다시 활성화한다.
   - REFACTOR: 섹션별 분기 없이 팔로우 처리 로직은 `followCreators(member, creatorIds)` 하나로 유지한다.
   - 기대 결과: 존재하지 않는 id 또는 크리에이터가 아닌 id가 하나라도 있으면 신규 저장이 발생하지 않고, 이미 팔로우 중인 id와 본인 id는 실패가 아니라 서버 내부 제외 대상으로 처리된다. 동일 회원과 동일 크리에이터의 팔로우 row는 중복 저장되지 않는다.
 
 - [x] **Task 5.2: 팔로우 API DTO/Controller 연결**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/FollowRecommendedCreatorsRequest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/FollowRecommendedCreatorsRequest.kt`
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/HomeRecommendationController.kt`
     - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt`
   - RED: mock 없이 `@SpringBootTest`와 실제 repository를 사용해 비로그인 요청은 Spring Security에서 거부되고, 로그인 요청은 `creatorIds`를 service에 전달해 신규 팔로우만 저장하며 결과를 `ApiResponse.ok`로 반환하는 controller 테스트를 작성한다. `creatorIds` null/empty/50개 초과 요청은 실패하고 신규 저장하지 않는 테스트를 포함한다.
@@ -329,7 +354,7 @@
   - TDD 예외 사유: 운영 DB 반영 SQL 문서 산출물 작성 task라 제품 코드 테스트를 새로 작성하지 않는다.
   - 대체 검증 방법:
     - `rg -n "uk_creator_following_member_creator|creator_following|duplicate_count|ALTER TABLE|alter table" docs/20260529_메인_홈_추천_API/alter-existing-tables.sql src/main/kotlin/kr/co/vividnext/sodalive/member/following/CreatorFollowing.kt`
-    - `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest`
+    - `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest`
   - GREEN: 동일 회원과 동일 크리에이터의 팔로우 row를 중복 저장하지 않도록 `creator_following(member_id, creator_id)` 유니크 제약을 JPA entity에 명시하고, 운영 DB 반영 전 중복 데이터 점검/정리 및 `ALTER TABLE` 절차를 문서화한다.
   - 기대 결과: 테스트 H2 schema와 운영 DB 반영 절차가 같은 유니크 제약명 `uk_creator_following_member_creator`를 사용하며, 기존 중복 row가 있어도 배포 전 정리 절차를 검토할 수 있다.
 
@@ -337,7 +362,7 @@
 
 - [x] **Task 6.1: 홈 통합 응답 DTO와 facade 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/HomeRecommendationResponse.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/HomeRecommendationResponse.kt`
     - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
     - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt`
   - RED: 통합 조회가 섹션별 기본 limit(20/20/10/10/10/10/5x8/8/10)을 service에 전달하고, 인증 회원의 팔로우 제외/콘텐츠 조회 이력/본인인증 여부를 service 조건으로 전달하는 테스트를 작성한다.
@@ -358,7 +383,7 @@
 
 - [x] **Task 6.3: 커뮤니티를 제외한 섹션별 전체보기 API 작성**
   - Files:
-    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/HomeRecommendationPageResponse.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/HomeRecommendationPageResponse.kt`
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/HomeRecommendationController.kt`
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
     - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt`
@@ -393,15 +418,15 @@
 
 - [x] **Task 6.6: 전체보기 DB 레벨 페이징과 실제 데이터 페이징 테스트 보강**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/HomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
     - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt`
   - RED: facade 메모리 `drop/take` 방식으로는 실제 DB 데이터에서 `page`, `size`, `hasNext`가 정확히 보장되지 않는 실패 테스트를 추가하고, 라이브/최근 데뷔/첫 오디오/AI 캐릭터 전체보기의 실제 데이터 페이징 테스트를 추가한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest`
   - GREEN: 전체보기 조회 port/repository/service가 Spring `Pageable`과 동일한 의미의 `page`, `size`, `offset`, `limit + 1` 조회를 DB 레벨에서 적용하도록 변경하고, facade는 repository 결과를 재페이징하지 않고 `items`, `page`, `size`, `hasNext` 응답 조립만 담당한다.
   - REFACTOR: 홈 통합 조회의 고정 노출 수 조회와 전체보기 페이징 조회를 분리해, 전체보기 때문에 홈 통합 조회 쿼리 의미가 바뀌지 않도록 유지한다.
   - 기대 결과: 전체보기 API는 facade 메모리 페이징이 아니라 DB 레벨 페이징을 사용하고, 실제 데이터 기반 테스트로 각 섹션의 `items`, `page`, `size`, `hasNext` 계산이 검증된다.
@@ -431,10 +456,10 @@
 
 - [x] **Task 7.1: repository 조건 회귀 테스트 보강**
   - Files:
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
   - RED: 차단 관계 양방향 제외, 커뮤니티 성인 노출 조건, 본인인증 여부 조건이 필요한 추천 필터, 팔로우 크리에이터 제외, 비활성 회원 제외 테스트를 추가한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`
   - GREEN: 누락 조건을 QueryDSL where 조건 또는 service 필터에 추가한다.
   - REFACTOR: 같은 차단/성인 조건이 여러 쿼리에 반복되면 repository private 함수로만 정리한다.
   - 기대 결과: PRD Edge Case와 회원 조건이 테스트 이름으로 추적된다.
@@ -443,16 +468,16 @@
   - Files:
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
     - Test: `src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt`
     - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryServiceTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowServiceTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: 메인 홈 API 성공/실패와 응답 시간, 섹션별 빈 응답 여부, 전체보기 조회 수, 추천 섹션별 클릭률 기록 지점, 동시 팔로우 요청/성공 수, 콘텐츠 조회 이력 기록 성공/실패, 콘텐츠 상세 조회 흐름에서 `CreatorContentViewHistoryService.recordView(...)` 실패가 `runCatching`으로 삼켜지더라도 구조화 로그 또는 metric으로 관측되는지, 일 배치 집계 성공/실패와 소요 시간을 관측할 수 있는 로그 또는 metric 호출 테스트를 작성한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest --tests kr.co.vividnext.sodalive.v2.recommend.application.CreatorContentViewHistoryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: 프로젝트에 이미 사용하는 metric 클라이언트가 있으면 해당 클라이언트를 사용하고, 없으면 구조화 로그로 PRD Metrics 항목을 관측 가능하게 남긴다. 콘텐츠 조회 이력 저장 실패는 상세 조회 응답 실패로 전파하지 않되, 실패 원인과 `memberId`, `contentId`를 추적 가능한 형태로 남긴다.
   - REFACTOR: 지표 기록 때문에 공개 응답 스키마나 비즈니스 분기가 바뀌지 않도록 application 경계에서만 정리한다.
   - 기대 결과: PRD Metrics 항목이 구현 코드의 로그/metric 지점으로 추적되고 테스트에서 호출 여부를 확인할 수 있다. 특히 콘텐츠 상세 조회의 이력 저장 실패가 사용자 응답을 깨지 않으면서도 운영자가 감지 가능한 신호로 남는다.
@@ -482,39 +507,39 @@
 - [x] **Task 7.5: 공통 차단 필터 전체 추천 섹션 적용 보완**
   - Files:
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
   - RED: 라이브, 최근 활동, 최근 데뷔, 첫 오디오, 최근 응원 상세, 인기 커뮤니티 상세가 회원과 크리에이터의 양방향 활성 차단 관계를 제외하는 테스트를 추가한다. 커뮤니티 성인 노출, 본인인증 기반 성인 노출 조건, 팔로우 제외, 비활성 회원 제외 회귀 테스트 이름을 명시적으로 유지한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`
   - GREEN: facade/service/port/repository에 `memberId` 조회 컨텍스트를 전파하고, QueryDSL/native SQL 조회에 양방향 `block_member` 제외 조건을 적용한다.
   - 기대 결과: 장르 추천뿐 아니라 요청된 모든 홈 추천 섹션에서 내가 차단했거나 나를 차단한 크리에이터의 데이터가 제외된다.
 
 - [x] **Task 7.6: 운영 성공 로그 after-commit 기록 보완**
   - Files:
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshService.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/CreatorContentViewHistoryServiceTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendedCreatorFollowServiceTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/RecommendationSnapshotRefreshServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt`
   - RED: 조회 이력 저장, 추천 크리에이터 동시 팔로우, 일 스냅샷 갱신 성공 로그가 트랜잭션 커밋 전에는 기록되지 않고 커밋 후 기록되는 테스트를 추가한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.CreatorContentViewHistoryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`
   - GREEN: 성공 로그는 `TransactionSynchronizationManager`의 `afterCommit`으로 등록하고, 트랜잭션 동기화가 없는 단위 실행에서는 기존처럼 즉시 기록한다. 실패 로그와 skip 로그는 기존 동작을 유지한다.
   - 기대 결과: 트랜잭션이 커밋되기 전 성공 로그가 먼저 남아 운영 지표를 오염시키지 않는다.
 
 - [x] **Task 7.7: 홈 배너 차단 필터 누락 보완**
   - Files:
     - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryService.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/port/out/HomeRecommendationQueryPort.kt`
-    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
-    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommend/application/HomeRecommendationQueryServiceTest.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
   - RED: 홈 배너 `CREATOR` 대상 크리에이터와 `SERIES` 대상 시리즈 소유자가 회원과 양방향 활성 차단 관계인 경우 제외되는 테스트를 추가한다. `EVENT`와 `LINK` 배너는 기존 활성 조건 기준으로 유지한다.
-  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromHomeBanners`
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromHomeBanners`
   - GREEN: 홈 통합 조회에서 배너 조회에도 `memberId`를 전달하고, 배너 조회 포트/서비스/repository가 `CREATOR`의 `bannerCreator.id`, `SERIES`의 `seriesOwner.id` 기준으로 양방향 `block_member` 제외 조건을 적용한다.
   - 기대 결과: 홈 배너 섹션에서도 차단 관계 크리에이터 또는 시리즈 소유자의 추천 데이터가 노출되지 않는다.
 
@@ -529,12 +554,12 @@
 - Feature E: Task 1.1, Task 1.2, Task 3.2, Task 6.3에서 데뷔일/점수/동점 랜덤 정렬/프로필 이미지와 닉네임 노출/전체보기를 검증한다.
 - Feature F: Task 1.1, Task 3.2, Task 6.3에서 첫 오디오 콘텐츠 판정, 최신성 점수 구간, 예약 공개 제외를 검증한다.
 - Feature G: Task 1.1, Task 2.2, Task 2.6, Task 2.7, Task 2.8, Task 2.9, Task 3.3, Task 6.3에서 AI 캐릭터 점수, 캐릭터 생성일 기준 신규 부스트, 스냅샷, AI 채팅 집계 범위, DB-side exact scoring, 응답 필드, 오리지널 작품명 조건, 전체보기를 검증한다.
-- Feature H: Task 4.1, Task 4.2, Task 4.3에서 장르 조회 이력, 조회 이력 없을 때 랜덤 장르, 부족분 랜덤 보충, 한 응답 내 크리에이터 중복 제거, 조회 시점별 재노출 허용, 팔로우 제외, 성인 장르 조건, 크리에이터 프로필 이미지/닉네임/id 노출을 검증한다.
+- Feature H: Task 4.1, Task 4.2, Task 4.3, Task 4.4에서 장르 조회 이력, 조회 이력 없을 때 랜덤 장르, 부족분 랜덤 보충, 한 응답 내 크리에이터 중복 제거, 조회 시점별 재노출 허용, 팔로우 제외, 조회자 본인 크리에이터 제외, 성인 장르 조건, 크리에이터 프로필 이미지/닉네임/id 노출을 검증한다.
 - Feature I: Task 5.1, Task 5.2에서 장르의 크리에이터와 최근 응원이 많은 크리에이터가 공통 동시 팔로우 use case를 재사용하고, 이미 팔로우 중인 id와 본인 id는 서버 내부에서 제외하며, 비활성 팔로우 이력은 재활성화하고, 존재하지 않는 id/크리에이터가 아닌 id는 전체 실패로 처리하는지 검증한다.
-- Feature J: Task 1.1, Task 2.2, Task 2.4, Task 2.5, Task 2.8, Task 2.9, Task 3.3, Task 5.1, Task 5.2에서 최근 응원 점수/스냅샷 조회, 8명 limit, 크리에이터 프로필 이미지/닉네임 노출, `CHANNEL_DONATION` 기준 후원 금액/후원 수, 팬 Talk 수, 최근 7일 집계, 데뷔일 기준 신규 부스트, DB-side exact scoring, 해당 섹션의 동시 팔로우를 검증한다.
+- Feature J: Task 1.1, Task 2.2, Task 2.3.1, Task 2.4, Task 2.5, Task 2.8, Task 2.9, Task 3.3, Task 5.1, Task 5.2에서 최근 응원 점수/스냅샷 조회, 스냅샷 일 배치 클러스터 단일 실행, 8명 limit, 크리에이터 프로필 이미지/닉네임 노출, `CHANNEL_DONATION` 기준 후원 금액/후원 수, 팬 Talk 수, 최근 7일 집계, 데뷔일 기준 신규 부스트, DB-side exact scoring, 해당 섹션의 동시 팔로우를 검증한다.
 - Feature K: Task 1.1, Task 2.2, Task 2.5, Task 2.8, Task 2.9, Task 3.3, Task 7.1에서 인기 커뮤니티 점수/조건/홈 통합 응답 노출 필드(크리에이터 프로필 이미지, 닉네임, UTC 시간, 좋아요 수, 댓글 수, 내용)/댓글 불가 게시글 댓글 수 0점 계산, 데뷔일 기준 신규 부스트, 최근 7일 집계, DB-side exact scoring을 검증한다.
 - Metrics: Task 7.2에서 메인 홈 API 성공률/응답 시간, 섹션별 빈 응답 비율, 전체보기 API 조회 수, 추천 섹션별 클릭률, 동시 팔로우 요청/성공 수, 콘텐츠 조회 이력 기록 성공률, 일 배치 집계 성공/실패 수와 스냅샷 생성 소요 시간의 로그 또는 metric 기록 지점을 검증한다.
-- Technical Constraints/Non-Goals: Phase 1~7에서 `v2.api.home`/`v2.recommend` 패키지 경계, `port.out` 의존 방향, 신규 v2 endpoint 분리, 기존 공개 스키마 유지, 서버 다국어 번역/ML 개인화/A-B 테스트/관리자 화면/수동 편집 제외 조건을 검증한다. 응답 enum 영문 code 안정성은 Task 1.3과 Task 3.1에서, `RecommendationSnapshotPort`의 persistence entity 노출 정리는 Task 2.4에서, 점수 기반 스냅샷의 `RecommendationScoreSpec` 공유 산식과 candidate pre-limit 금지는 Task 2.9에서, JPA/QueryDSL 우선 및 native SQL 제한 사용 전략은 Task 2.9와 Task 3.1에서, 신규 엔티티 테이블 생성 SQL 문서화는 Task 7.4에서 검증한다.
+- Technical Constraints/Non-Goals: Phase 1~7에서 `v2.api.home`/`v2.recommendation` 패키지 경계, `port.out` 의존 방향, 신규 v2 endpoint 분리, 기존 공개 스키마 유지, 서버 다국어 번역/ML 개인화/A-B 테스트/관리자 화면/수동 편집 제외 조건을 검증한다. 응답 enum 영문 code 안정성은 Task 1.3과 Task 3.1에서, `RecommendationSnapshotPort`의 persistence entity 노출 정리는 Task 2.4에서, 점수 기반 스냅샷의 `RecommendationScoreSpec` 공유 산식과 candidate pre-limit 금지는 Task 2.9에서, JPA/QueryDSL 우선 및 native SQL 제한 사용 전략은 Task 2.9와 Task 3.1에서, 신규 엔티티 테이블 생성 SQL 문서화는 Task 7.4에서 검증한다.
 
 ---
 
@@ -549,43 +574,46 @@
 - 2026-05-30: `sourceSection` 제거 후 `./gradlew tasks --all`을 실행했다. sandbox 기본 권한에서는 동일한 `.gradle` lock 파일 권한 문제로 실패했고, 권한 승인 후 재실행해 `BUILD SUCCESSFUL in 718ms`를 확인했다.
 - 2026-05-30: PRD와 plan-task를 대조해 본인인증 조건, 동일 orders 배너 랜덤 정렬, AI 캐릭터 응답 필드/캐릭터 생성일 기준 부스트, 첫 오디오 최신성 점수 구간, 댓글 불가 커뮤니티 점수 계산, Metrics 관측 지점, `port.out` 의존 경계 보강이 필요함을 확인하고 관련 task와 Coverage Check에 반영했다.
 - 2026-05-30: 문서 보강 후 `./gradlew tasks --all`을 실행했다. sandbox 기본 권한에서는 동일한 `.gradle` lock 파일 권한 문제로 실패했고, 권한 승인 후 재실행해 `BUILD SUCCESSFUL in 789ms`를 확인했다.
-- 2026-05-30: Phase 1 Task 1.1 RED/GREEN을 진행했다. `RecommendationScorePolicyTest`는 구현 전 `Unresolved reference: RecommendationScorePolicy`로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.domain.RecommendationScorePolicyTest`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-05-30: Phase 1 Task 1.2 RED/GREEN을 진행했다. `CreatorDebutPolicyTest`는 구현 전 `Unresolved reference: CreatorDebutPolicy`로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.domain.CreatorDebutPolicyTest`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-05-30: Phase 1 Task 1.3 RED/GREEN을 진행했다. `HomeRecommendationQueryServiceTest`는 구현 전 `RecommendedActivityType`, `RecommendedSectionType`, `HomeRecommendationQueryService` 미구현으로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-05-30: Phase 1 최종 검증으로 `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. Kotlin LSP는 이 환경에 `kotlin-lsp`가 설치되어 있지 않아 실행하지 못했고, Gradle 컴파일/테스트/ktlint로 대체 확인했다.
-- 2026-05-30: Phase 2 Task 2.1~2.3 RED/GREEN을 진행했다. `RecommendationSnapshotRefreshServiceTest`는 구현 전 `RecommendationSnapshot`, `RecommendationSnapshotPort`, `HomeRecommendationQueryPort`, `RecommendationSnapshotRefreshService`, `RecommendationSnapshotScheduler` 미구현으로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-05-30: Phase 2 검증으로 `./gradlew clean test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. 병렬 Gradle 실행 중에는 KAPT 임시 stub 파일 경합이 발생해 이후 검증은 순차 실행으로 고정했다. Kotlin LSP는 이 환경에 `kotlin-lsp`가 설치되어 있지 않아 실행하지 못했고, Gradle 컴파일/테스트/ktlint로 대체 확인했다.
+- 2026-05-30: Phase 1 Task 1.1 RED/GREEN을 진행했다. `RecommendationScorePolicyTest`는 구현 전 `Unresolved reference: RecommendationScorePolicy`로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendationScorePolicyTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-30: Phase 1 Task 1.2 RED/GREEN을 진행했다. `CreatorDebutPolicyTest`는 구현 전 `Unresolved reference: CreatorDebutPolicy`로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.domain.CreatorDebutPolicyTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-30: Phase 1 Task 1.3 RED/GREEN을 진행했다. `HomeRecommendationQueryServiceTest`는 구현 전 `RecommendedActivityType`, `RecommendedSectionType`, `HomeRecommendationQueryService` 미구현으로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-30: Phase 1 최종 검증으로 `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. Kotlin LSP는 이 환경에 `kotlin-lsp`가 설치되어 있지 않아 실행하지 못했고, Gradle 컴파일/테스트/ktlint로 대체 확인했다.
+- 2026-05-30: Phase 2 Task 2.1~2.3 RED/GREEN을 진행했다. `RecommendationSnapshotRefreshServiceTest`는 구현 전 `RecommendationSnapshot`, `RecommendationSnapshotPort`, `HomeRecommendationQueryPort`, `RecommendationSnapshotRefreshService`, `RecommendationSnapshotScheduler` 미구현으로 실패했고, 구현 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-30: Phase 2 검증으로 `./gradlew clean test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. 병렬 Gradle 실행 중에는 KAPT 임시 stub 파일 경합이 발생해 이후 검증은 순차 실행으로 고정했다. Kotlin LSP는 이 환경에 `kotlin-lsp`가 설치되어 있지 않아 실행하지 못했고, Gradle 컴파일/테스트/ktlint로 대체 확인했다.
 - 2026-05-30: 기본 구현체 명명 규칙을 접미사 `Impl` 대신 접두사 `Default`로 변경했다. `HomeRecommendationQueryRepositoryImpl`은 `DefaultHomeRecommendationQueryRepository`로 바꿨고, PRD와 구현 계획에 AI 캐릭터 `followIncrease`는 팔로우 대상/관계 정의 확정 전까지 이번 스프린트 산식과 집계에서 제외한다고 기록했다.
 - 2026-05-30: 구현 전 문서 보강으로 기본 구현체 명명 규칙을 `docs/agent-guides/코드스타일.md`에 반영하고, 당시 스냅샷 일 배치 기준을 PRD/Task 2.3~2.4에 기록했다. 이후 Phase 2 권고 보강에서 스케줄은 KST 06:00 `Asia/Seoul` zone으로 변경했다. QueryDSL 집계 통합 테스트, `RecommendationSnapshotPort` 경계 정리, 최근 응원 `CHANNEL_DONATION` 기준 후원 금액/후원 수 검증은 Task 2.4로 추가했다.
-- 2026-05-30: Phase 2 Task 2.4 RED/GREEN을 진행했다. RED에서 `RecommendationSnapshotRefreshServiceTest`는 기존 KST cron/JVM timezone 기준 계산으로 실패했고, `DefaultHomeRecommendationQueryRepositoryTest`는 최근 응원 후원 금액이 `CHANNEL_DONATION` 외 사용처까지 포함되어 `expected: <150> but was: <3150>`으로 실패했다. GREEN 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`, `./gradlew ktlintCheck`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-30: Phase 2 Task 2.4 RED/GREEN을 진행했다. RED에서 `RecommendationSnapshotRefreshServiceTest`는 기존 KST cron/JVM timezone 기준 계산으로 실패했고, `DefaultHomeRecommendationQueryRepositoryTest`는 최근 응원 후원 금액이 `CHANNEL_DONATION` 외 사용처까지 포함되어 `expected: <150> but was: <3150>`으로 실패했다. GREEN 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`, `./gradlew ktlintCheck`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다.
 - 2026-05-30: Phase 2 재점검을 진행했다. `RecommendationSnapshotRefreshServiceTest`와 `DefaultHomeRecommendationQueryRepositoryTest`는 각각 재실행 시 `BUILD SUCCESSFUL`로 통과했지만, 최근 응원/인기 커뮤니티 신규 부스트가 실제 데뷔일이 아니라 `Member.createdAt`에 의존하는 점, AI 캐릭터 최근 채팅 수의 participant 범위가 명확히 고정되지 않은 점, 스냅샷 후보 전체 저장은 과도한 데이터 저장으로 이어질 수 있다는 점을 확인했다. 해당 보완사항은 Task 2.5~2.8과 Coverage Check에 나누어 반영했고, 실제 데뷔일이 없는 크리에이터는 Task 2.5에서 스냅샷 후보 제외로 확정하고 테스트로 검증했다.
-- 2026-05-30: Phase 2 Task 2.5~2.8 보강을 진행했다. `DefaultHomeRecommendationQueryRepositoryTest`와 `RecommendationSnapshotRefreshServiceTest`에 실제 데뷔일 기준 후보, AI 발화 수, 중복 없는 활성 사용자 수, 섹션별 스냅샷 저장 상한(20/16/20) 검증을 추가했다. 첫 실행은 `AudioContent.theme` fixture 누락과 QueryDSL alias 문제로 실패했고, 보정 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-05-30: Phase 2 Task 2.5~2.8 최종 검증으로 `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. Kotlin LSP는 이 환경에 `kotlin-lsp`가 설치되어 있지 않아 실행하지 못했고, Gradle 컴파일/테스트/ktlint로 대체 확인했다.
+- 2026-05-30: Phase 2 Task 2.5~2.8 보강을 진행했다. `DefaultHomeRecommendationQueryRepositoryTest`와 `RecommendationSnapshotRefreshServiceTest`에 실제 데뷔일 기준 후보, AI 발화 수, 중복 없는 활성 사용자 수, 섹션별 스냅샷 저장 상한(20/16/20) 검증을 추가했다. 첫 실행은 `AudioContent.theme` fixture 누락과 QueryDSL alias 문제로 실패했고, 보정 후 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-30: Phase 2 Task 2.5~2.8 최종 검증으로 `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. Kotlin LSP는 이 환경에 `kotlin-lsp`가 설치되어 있지 않아 실행하지 못했고, Gradle 컴파일/테스트/ktlint로 대체 확인했다.
 - 2026-05-30: Phase 2 권고 보강으로 스냅샷 스케줄을 KST 06:00 `Asia/Seoul` zone으로 변경했다. 최종 점수 계산 전 후보 사전 제한은 정확한 top 후보를 누락할 수 있어 적용하지 않는다. AI 20개, 최근 응원 16개, 인기 커뮤니티 20개 저장 상한은 최종 점수와 동점 랜덤 정렬 이후 repository에서 적용하는 최종 limit으로 유지한다.
 - 2026-05-30: 사용자 피드백에 따라 service가 전체 후보를 모두 불러와 점수를 계산하는 구조를 DB-side exact scoring으로 전환하기로 확정했다. PRD와 Task 2.9에 `RecommendationScoreSpec` 공유 산식, DB 최종 점수 계산 후 정렬/limit, candidate pre-limit 금지, service scoring 제거 요구사항을 반영했다. 기존 20/16/20 저장 상한은 동점자 랜덤 노출 여지를 위한 최종 저장 limit으로 유지하되, 최종 점수 계산 전 후보 제한 의미로는 사용하지 않도록 명확히 했다.
 - 2026-05-31: Phase 2 Task 2.9 RED/GREEN을 진행했다. RED에서 `RecommendationScoreSpec`과 DB-scored snapshot 조회 계약 미구현으로 `RecommendationScorePolicyTest`, `DefaultHomeRecommendationQueryRepositoryTest`, `RecommendationSnapshotRefreshServiceTest` 컴파일이 실패했다. GREEN에서 `RecommendationScoreSpec`을 추가하고, AI/최근 응원/인기 커뮤니티 스냅샷 조회가 DB에서 최종 score와 `randomTieBreaker`를 계산한 뒤 `score desc, randomTieBreaker asc` 정렬과 최종 limit을 적용하도록 변경했다. `RecommendationSnapshotRefreshService`에서는 Kotlin-side score 재계산과 service-side limit을 제거했다.
-- 2026-05-31: Phase 2 Task 2.9 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.domain.RecommendationScorePolicyTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-31: Phase 2 Task 2.9 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendationScorePolicyTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다.
 - 2026-05-31: Phase 2 Task 2.9 리뷰 후속으로 `RecommendationScoreSpec`에 신규 부스트 일수 상수를 추가하고, `RecommendationScorePolicy`와 native SQL boost window가 같은 상수를 쓰도록 정리했다. 최근 응원/인기 커뮤니티 native SQL은 후보 행마다 donation/comment/follower/debut 집계를 반복하지 않도록 aggregate CTE 기반으로 변경했고, 데뷔일은 콘텐츠 공개일과 라이브 시작일을 `union all`한 이벤트 집계에서 `min(debut_at)`으로 계산해 DB-side exact scoring 의미를 유지했다. PRD/plan-task의 동일 점수 정렬 문구는 스냅샷 저장 `randomTieBreaker` 기준으로 맞췄다.
-- 2026-05-31: 리뷰 후속 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.domain.RecommendationScorePolicyTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. 중간에 H2 native SQL 타입 추론 문제와 ktlint line length 오류가 있었고, 데뷔일 CTE를 `union all` 이벤트 집계로 단순화하고 긴 `setParameter` 호출을 줄바꿈해 해결했다.
-- 2026-05-31: Phase 3 Task 3.1 RED/GREEN을 진행했다. RED에서 `HomeRecommendationQueryServiceTest`와 `DefaultHomeRecommendationQueryRepositoryTest`는 라이브/배너/최근 활동 크리에이터 조회 record, port 메서드, service 메서드, repository 쿼리 미구현으로 컴파일 실패했다. GREEN에서 라이브 최신순 20개, 활성 배너 orders 정렬/동일 orders 랜덤 tie-breaker/최대 20개, 크리에이터당 최신 활동 1개와 `LIVE`/`AUDIO`/`COMMUNITY`/`LIVE_REPLAY` 분류를 구현했고, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-05-31: Phase 3 Task 3.1 추가 검증으로 `./gradlew ktlintCheck`와 `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`를 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. 중간에 테스트 코드 line length ktlint 오류가 있었고, 긴 fixture 호출을 줄바꿈해 해결했다.
-- 2026-05-31: Phase 3 Task 3.2 RED/GREEN을 진행했다. RED에서 `HomeRecommendationQueryServiceTest`와 `DefaultHomeRecommendationQueryRepositoryTest`는 최근 데뷔 크리에이터/첫 오디오 콘텐츠 record, port 메서드, service 메서드, repository 쿼리 미구현으로 컴파일 실패했다. GREEN에서 실제 데뷔일 30일 이내 최근 데뷔 크리에이터 점수/랜덤 tie-breaker 정렬, 첫 3개 업로드 이내 활성 공개 오디오 콘텐츠 판정, 비활성 선행 콘텐츠 경계, 예약 공개 제외, `release_date` 최신성 점수 정렬을 구현했고, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-05-31: Phase 3 Task 3.3 RED/GREEN을 진행했다. RED에서 `HomeRecommendationQueryServiceTest`와 `DefaultHomeRecommendationQueryRepositoryTest`는 AI 캐릭터/최근 응원/인기 커뮤니티 상세 record, port 메서드, service 메서드, repository 상세 조회 미구현으로 `compileTestKotlin`이 실패했다. GREEN에서 `RecommendationSnapshotPort.findLatestSnapshots(sectionType)` 기반 최신 스냅샷 조회, AI 캐릭터 10개/최근 응원 8명/인기 커뮤니티 10개 limit, 스냅샷 순서 보존, 누락 상세 필터링, 인기 커뮤니티 크리에이터 중복 제거, 커뮤니티 비노출 조건 필터링, AI 캐릭터 원작명 조건부 응답과 전체 AI 발화 수 조립을 구현했다. `./gradlew test --rerun-tasks --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`와 `./gradlew ktlintCheck`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-31: 리뷰 후속 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendationScorePolicyTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. 중간에 H2 native SQL 타입 추론 문제와 ktlint line length 오류가 있었고, 데뷔일 CTE를 `union all` 이벤트 집계로 단순화하고 긴 `setParameter` 호출을 줄바꿈해 해결했다.
+- 2026-05-31: Phase 3 Task 3.1 RED/GREEN을 진행했다. RED에서 `HomeRecommendationQueryServiceTest`와 `DefaultHomeRecommendationQueryRepositoryTest`는 라이브/배너/최근 활동 크리에이터 조회 record, port 메서드, service 메서드, repository 쿼리 미구현으로 컴파일 실패했다. GREEN에서 라이브 최신순 20개, 활성 배너 orders 정렬/동일 orders 랜덤 tie-breaker/최대 20개, 크리에이터당 최신 활동 1개와 `LIVE`/`AUDIO`/`COMMUNITY`/`LIVE_REPLAY` 분류를 구현했고, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-31: Phase 3 Task 3.1 추가 검증으로 `./gradlew ktlintCheck`와 `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`를 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. 중간에 테스트 코드 line length ktlint 오류가 있었고, 긴 fixture 호출을 줄바꿈해 해결했다.
+- 2026-05-31: Phase 3 Task 3.2 RED/GREEN을 진행했다. RED에서 `HomeRecommendationQueryServiceTest`와 `DefaultHomeRecommendationQueryRepositoryTest`는 최근 데뷔 크리에이터/첫 오디오 콘텐츠 record, port 메서드, service 메서드, repository 쿼리 미구현으로 컴파일 실패했다. GREEN에서 실제 데뷔일 30일 이내 최근 데뷔 크리에이터 점수/랜덤 tie-breaker 정렬, 첫 3개 업로드 이내 활성 공개 오디오 콘텐츠 판정, 비활성 선행 콘텐츠 경계, 예약 공개 제외, `release_date` 최신성 점수 정렬을 구현했고, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-31: Phase 3 Task 3.3 RED/GREEN을 진행했다. RED에서 `HomeRecommendationQueryServiceTest`와 `DefaultHomeRecommendationQueryRepositoryTest`는 AI 캐릭터/최근 응원/인기 커뮤니티 상세 record, port 메서드, service 메서드, repository 상세 조회 미구현으로 `compileTestKotlin`이 실패했다. GREEN에서 `RecommendationSnapshotPort.findLatestSnapshots(sectionType)` 기반 최신 스냅샷 조회, AI 캐릭터 10개/최근 응원 8명/인기 커뮤니티 10개 limit, 스냅샷 순서 보존, 누락 상세 필터링, 인기 커뮤니티 크리에이터 중복 제거, 커뮤니티 비노출 조건 필터링, AI 캐릭터 원작명 조건부 응답과 전체 AI 발화 수 조립을 구현했다. `./gradlew test --rerun-tasks --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`와 `./gradlew ktlintCheck`가 `BUILD SUCCESSFUL`로 통과했다.
 - 2026-05-31: Phase 3에는 `CreatorContentViewHistory` 엔티티/리포지토리/저장 서비스가 아직 구현되어 있지 않아 장르 기반 크리에이터 추천 조회를 포함하지 않았다. 해당 산출물은 Phase 4 Task 4.1 범위이므로, 장르 기반 크리에이터 추천 조회는 조회 이력 저장 모델이 준비된 뒤 Phase 4 Task 4.2에서 별도 RED/GREEN으로 진행한다.
-- 2026-05-31: Phase 3 리뷰 후속으로 인기 커뮤니티 추천이 상위 10개 스냅샷을 먼저 자른 뒤 크리에이터 중복을 제거해 10개 미만으로 내려갈 수 있는 문제를 보완했다. RED에서 상위 스냅샷 중복 제거 후 뒤 후보로 기본 10개를 채우는 테스트가 실패했고, GREEN에서 인기 커뮤니티만 최신 스냅샷 후보 20개를 읽은 뒤 상세 조립/크리에이터 중복 제거 후 최종 10개를 반환하도록 수정했다. 후속 검증으로 `./gradlew test --rerun-tasks --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-05-31: Phase 3 리뷰 후속으로 인기 커뮤니티 추천이 상위 10개 스냅샷을 먼저 자른 뒤 크리에이터 중복을 제거해 10개 미만으로 내려갈 수 있는 문제를 보완했다. RED에서 상위 스냅샷 중복 제거 후 뒤 후보로 기본 10개를 채우는 테스트가 실패했고, GREEN에서 인기 커뮤니티만 최신 스냅샷 후보 20개를 읽은 뒤 상세 조립/크리에이터 중복 제거 후 최종 10개를 반환하도록 수정했다. 후속 검증으로 `./gradlew test --rerun-tasks --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`, `./gradlew ktlintCheck`, `./gradlew test`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다.
 - 2026-05-31: 사용자 피드백에 따라 신규 엔티티 테이블 생성 SQL은 Phase 7 완료 후 최종 엔티티 구조 기준으로 작성하도록 계획을 보강했다. `RecommendationSnapshot`, `CreatorContentViewHistory` 등 이번 작업에서 새로 생성된 엔티티의 운영 DB DDL을 `docs/20260529_메인_홈_추천_API/create-new-entity-tables.sql` 산출물로 남기는 Task 7.4를 추가했다.
 - 2026-05-31: PRD와 plan-task를 재대조해 큰 기능 흐름은 반영되어 있었으나 일부 PRD 세부 항목의 task 추적성이 약한 점을 확인했다. 라이브/활동/최근 데뷔/최근 응원/인기 커뮤니티/장르 크리에이터 노출 필드, `LINK` 배너 자체 활성 상태 기준, 활동 enum 영문 code 안정성, 한 응답 내 장르 크리에이터 중복 제거와 조회 시점별 재노출 허용, 추천 섹션별 클릭률 metric, Non-Goals 범위를 관련 task와 Coverage Check에 보강했다.
-- 2026-05-31: Phase 2/3 재점검 후속으로 배너 대상 활성 조건과 스냅샷 데뷔일 계산의 빈 `channel_name` 라이브 제외 누락을 확인했다. RED에서 `DefaultHomeRecommendationQueryRepositoryTest`에 회귀 테스트를 추가했고 `shouldExcludeHomeBannersWithInactiveTargetsExceptLink`, `shouldExcludeBlankChannelNameLiveFromSnapshotDebutAt`가 실패했다. GREEN에서 `findHomeBanners`에 `EVENT`/`CREATOR`/`SERIES` 대상 활성 조건을 추가하고, 최근 응원/인기 커뮤니티 데뷔일 CTE에 `lr.channel_name <> ''` 조건을 추가했다. 리뷰 중 PRD의 인기 커뮤니티 성인 노출 조건은 항상 제외가 아니라 `MemberContentPreference.isAdultContentVisible == true` 회원에게 노출 허용임을 재확인해, 스냅샷 산정은 성인 게시글도 후보로 유지하고 상세 조회에서 `includeAdultCommunities`로 필터링하도록 수정했다. 추가 코드 리뷰에서 기존 홈 배너가 `tabId = 1`일 때 `tab is null`만 조회하는 계약을 확인해, `findHomeBanners`에 `cb.tab_id is null` 조건과 탭 전용 배너 제외 회귀 테스트를 보강했다. 후속 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommend.*'`, `./gradlew ktlintCheck`가 모두 `BUILD SUCCESSFUL`로 통과했다. 병렬 Gradle test 실행 중 XML 결과 파일 쓰기 충돌로 한 번 실패했으나, 동일 명령 단독 재실행 시 성공해 테스트 assertion 실패가 아님을 확인했다.
+- 2026-05-31: Phase 2/3 재점검 후속으로 배너 대상 활성 조건과 스냅샷 데뷔일 계산의 빈 `channel_name` 라이브 제외 누락을 확인했다. RED에서 `DefaultHomeRecommendationQueryRepositoryTest`에 회귀 테스트를 추가했고 `shouldExcludeHomeBannersWithInactiveTargetsExceptLink`, `shouldExcludeBlankChannelNameLiveFromSnapshotDebutAt`가 실패했다. GREEN에서 `findHomeBanners`에 `EVENT`/`CREATOR`/`SERIES` 대상 활성 조건을 추가하고, 최근 응원/인기 커뮤니티 데뷔일 CTE에 `lr.channel_name <> ''` 조건을 추가했다. 리뷰 중 PRD의 인기 커뮤니티 성인 노출 조건은 항상 제외가 아니라 `MemberContentPreference.isAdultContentVisible == true` 회원에게 노출 허용임을 재확인해, 스냅샷 산정은 성인 게시글도 후보로 유지하고 상세 조회에서 `includeAdultCommunities`로 필터링하도록 수정했다. 추가 코드 리뷰에서 기존 홈 배너가 `tabId = 1`일 때 `tab is null`만 조회하는 계약을 확인해, `findHomeBanners`에 `cb.tab_id is null` 조건과 탭 전용 배너 제외 회귀 테스트를 보강했다. 후속 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest`, `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.recommendation.*'`, `./gradlew ktlintCheck`가 모두 `BUILD SUCCESSFUL`로 통과했다. 병렬 Gradle test 실행 중 XML 결과 파일 쓰기 충돌로 한 번 실패했으나, 동일 명령 단독 재실행 시 성공해 테스트 assertion 실패가 아님을 확인했다.
 - 2026-05-31: 사용자 피드백에 따라 여러 크리에이터 동시 팔로우에서 본인 크리에이터 id는 전체 실패 조건에서 제외하고, 이미 팔로우 중인 id와 동일하게 처리 제외 대상으로 보도록 PRD와 plan-task를 수정했다.
 - 2026-06-01: 사용자 피드백에 따라 동시 팔로우 공개 응답은 성공/실패 여부만 제공하도록 단순화했다. 이미 팔로우 중인 id와 본인 id는 실패 사유로 보지 않고 서버 내부에서 제외하며, 테스트는 mock 없이 실제 Spring/JPA 흐름으로 검증하도록 조정한다.
-- 2026-05-31: Phase 4 구현 중 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.CreatorContentViewHistoryServiceTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`, `./gradlew test --tests kr.co.vividnext.sodalive.content.AudioContentServiceTest`를 실행해 모두 `BUILD SUCCESSFUL`을 확인했다.
+- 2026-05-31: Phase 4 구현 중 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryServiceTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`, `./gradlew test --tests kr.co.vividnext.sodalive.content.AudioContentServiceTest`를 실행해 모두 `BUILD SUCCESSFUL`을 확인했다.
 - 2026-06-01: Phase 6 Task 6.1~6.3을 진행했다. `HomeRecommendationResponse`/`HomeRecommendationPageResponse` API DTO와 `HomeRecommendationFacade`(섹션별 기본 limit 20/20/10/10/10/10/5x8/8/10 전달, 회원의 성인 노출 여부=`member.auth != null`와 `memberId`를 장르/커뮤니티 조회 조건으로 전달, KST→UTC ISO 변환, cloud-front host 이미지 URL 조립)를 추가했다. `HomeRecommendationController`에 통합 조회 `GET /api/v2/home/recommendations`와 전체보기 5개(`/lives`, `/debut-creators`, `/first-audio-contents`, `/ai-characters`, `/communities`)를 추가했고 size 기본값 20/최대 50으로 정규화했다. `SecurityConfig`에 해당 GET endpoint 6개 `permitAll`을 추가해 비회원 접근을 허용했다. `HomeRecommendationControllerTest`에 통합 조회(비회원/회원), 페이징 응답 형식, size 상한 테스트를 추가했고 `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest`가 12/12 통과했다. ktlint는 이 환경 셸 PATH에 Java가 없어 직접 실행하지 못했고 IDE 인스펙션으로 신규 파일 무경고를 확인했다(컨트롤러의 `@AuthenticationPrincipal` SpEL 문자열 경고는 기존 팔로우 endpoint와 동일한 false positive).
 - 2026-06-01: Phase 6 Task 6.4 리뷰 보완을 진행했다. RED에서 `HomeRecommendationControllerTest`에 세부 전체보기 비회원 거부와 음수 `page` 보정 테스트를 추가했고 기존 구현은 `shouldRejectAnonymousSectionPages`, `shouldNormalizeNegativePageToZero` 2건 실패로 확인했다. GREEN에서 `SecurityConfig`는 통합 조회 `GET /api/v2/home/recommendations`만 `permitAll`로 유지하고 전체보기 5개는 회원 인증 대상으로 변경했다. `HomeRecommendationController`는 전체보기 요청에서 인증 회원을 요구하고 `page < 0`을 0으로 보정하며, `HomeRecommendationFacade`는 성인 노출 여부를 `MemberContentPreferenceService.initializeDefaultPreference(member).isAdultContentVisible`와 기존 `isAdultVisibleByPolicy(...)`로 계산하도록 수정했다. 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest`를 실행해 `BUILD SUCCESSFUL`을 확인했다.
-- 2026-06-01: Phase 7 Task 7.1 RED/GREEN을 진행했다. RED에서 `DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromGenreCreatorRecommendations`가 양방향 차단 크리에이터를 제외하지 못해 실패했고, GREEN에서 장르 추천 테마 후보/크리에이터 조회 native SQL에 `block_member` 양방향 활성 차단 제외 조건을 추가했다. 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromGenreCreatorRecommendations`가 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-06-01: Phase 7 Task 7.2 RED/GREEN을 진행했다. RED에서 홈 통합/전체보기 성공, 콘텐츠 조회 이력 저장/스킵, 추천 크리에이터 동시 팔로우 성공/실패, 일 스냅샷 갱신 성공, 콘텐츠 상세 조회 이력 기록 실패 관측 로그 테스트 9건이 로그 이벤트 키 미존재로 실패했다. GREEN에서 기존 프로젝트 관례대로 신규 metric dependency 없이 `LoggerFactory` 구조화 로그를 추가했고, 콘텐츠 상세 조회의 `CreatorContentViewHistoryService.recordView(...)` 실패는 응답 실패로 전파하지 않고 `memberId`, `contentId`, 원인을 로그로 남기도록 했다. 검증으로 Phase 7 대상 테스트 묶음 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest --tests kr.co.vividnext.sodalive.v2.recommend.application.CreatorContentViewHistoryServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.content.AudioContentServiceTest`가 `BUILD SUCCESSFUL`로 통과했다. 추천 섹션별 클릭률은 별도 클릭 ingress가 없어 이번 범위에서는 응답/impression 관측 로그만 추가했다.
+- 2026-06-01: Phase 7 Task 7.1 RED/GREEN을 진행했다. RED에서 `DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromGenreCreatorRecommendations`가 양방향 차단 크리에이터를 제외하지 못해 실패했고, GREEN에서 장르 추천 테마 후보/크리에이터 조회 native SQL에 `block_member` 양방향 활성 차단 제외 조건을 추가했다. 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromGenreCreatorRecommendations`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-06-01: Phase 7 Task 7.2 RED/GREEN을 진행했다. RED에서 홈 통합/전체보기 성공, 콘텐츠 조회 이력 저장/스킵, 추천 크리에이터 동시 팔로우 성공/실패, 일 스냅샷 갱신 성공, 콘텐츠 상세 조회 이력 기록 실패 관측 로그 테스트 9건이 로그 이벤트 키 미존재로 실패했다. GREEN에서 기존 프로젝트 관례대로 신규 metric dependency 없이 `LoggerFactory` 구조화 로그를 추가했고, 콘텐츠 상세 조회의 `CreatorContentViewHistoryService.recordView(...)` 실패는 응답 실패로 전파하지 않고 `memberId`, `contentId`, 원인을 로그로 남기도록 했다. 검증으로 Phase 7 대상 테스트 묶음 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendedCreatorFollowServiceTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.content.AudioContentServiceTest`가 `BUILD SUCCESSFUL`로 통과했다. 추천 섹션별 클릭률은 별도 클릭 ingress가 없어 이번 범위에서는 응답/impression 관측 로그만 추가했다.
 - 2026-06-01: Phase 7 리뷰 지적에 따라 홈 통합 조회와 라이브 전체보기 조회 실패 로그 테스트를 추가하고, `HomeRecommendationFacade`에서 실패 시 `home_recommendations_query_failure`, `home_recommendations_page_query_failure` 로그를 남긴 뒤 예외를 재전파하도록 보강했다. 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest.shouldLogHomeRecommendationFailure --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest.shouldLogHomeRecommendationPageFailure`가 `BUILD SUCCESSFUL`로 통과했다.
 - 2026-06-01: Phase 7 재리뷰 지적에 따라 최근 데뷔/첫 오디오/AI 캐릭터 전체보기 실패도 `home_recommendations_page_query_failure` 로그를 남긴 뒤 예외를 재전파하도록 보강했다. 검증으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.HomeRecommendationControllerTest.shouldLogOtherHomeRecommendationPageFailures`가 `BUILD SUCCESSFUL`로 통과했고, 이후 `./gradlew ktlintCheck`는 `BUILD SUCCESSFUL in 16s`, `./gradlew test`는 `BUILD SUCCESSFUL in 54s`로 통과했다.
 - 2026-06-01: Phase 7 Task 7.4로 신규 엔티티 테이블 생성 SQL `docs/20260529_메인_홈_추천_API/create-new-entity-tables.sql`을 작성했다. 최종 JPA 엔티티 기준으로 `recommendation_snapshot`, `creator_content_view_history` 두 신규 테이블만 포함했고, 기존 테이블 변경은 `alter-existing-tables.sql` 범위로 유지했다. 검증으로 `rg -n "CREATE TABLE|create table|recommendation_snapshot|creator_content_view_history" docs/20260529_메인_홈_추천_API/create-new-entity-tables.sql`와 `./gradlew tasks --all`이 모두 성공했다.
 - 2026-06-01: Phase 7 Task 7.3 전체 검증을 순차 실행했다. `./gradlew ktlintCheck`는 처음에 신규 로그 호출의 긴 라인과 리뷰 보완 후 테스트 import 순서로 실패했고 줄바꿈/import 정리 후 통과했다. 최종 재리뷰 보완 후 `./gradlew ktlintCheck`는 `BUILD SUCCESSFUL in 16s`, `./gradlew test`는 `BUILD SUCCESSFUL in 54s`로 통과했고, `./gradlew tasks --all`은 앞선 Task 7.4 검증에서 `BUILD SUCCESSFUL in 1s`로 통과했다.
 - 2026-06-01: Phase 7 Task 7.5~7.6 보완을 진행했다. 라이브/최근 활동/최근 데뷔/첫 오디오/최근 응원/인기 커뮤니티에 회원 `memberId` 조회 컨텍스트를 전달하고 양방향 활성 차단 관계를 제외하도록 수정했다. 커뮤니티 성인 노출, 본인인증 기반 성인 노출 조건, 팔로우 제외, 비활성 회원 제외 회귀 테스트 이름을 명시적으로 유지하고, 조회 이력/동시 팔로우/스냅샷 성공 로그는 트랜잭션 커밋 후 기록되도록 보완했다. 검증으로 Phase 7 대상 테스트 묶음, `./gradlew ktlintCheck`, `./gradlew test`가 모두 `BUILD SUCCESSFUL`로 통과했다.
-- 2026-06-01: 리뷰 게이트 Context Mining에서 홈 배너 `CREATOR`/`SERIES` 대상의 차단 필터 누락을 발견해 Phase 7 Task 7.7로 보완했다. 홈 통합 조회의 배너 조회에도 `memberId`를 전달하고, 배너 repository 조회에서 `CREATOR`는 대상 크리에이터, `SERIES`는 시리즈 소유자 기준 양방향 활성 `block_member` 제외 조건을 적용했다. 회귀 테스트 `DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromHomeBanners`와 `HomeRecommendationQueryServiceTest`를 추가/보강했고, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromHomeBanners --tests kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-06-01: 리뷰 게이트 Context Mining에서 홈 배너 `CREATOR`/`SERIES` 대상의 차단 필터 누락을 발견해 Phase 7 Task 7.7로 보완했다. 홈 통합 조회의 배너 조회에도 `memberId`를 전달하고, 배너 repository 조회에서 `CREATOR`는 대상 크리에이터, `SERIES`는 시리즈 소유자 기준 양방향 활성 `block_member` 제외 조건을 적용했다. 회귀 테스트 `DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromHomeBanners`와 `HomeRecommendationQueryServiceTest`를 추가/보강했고, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeBidirectionalBlockedCreatorsFromHomeBanners --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`가 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-06-06: 사용자 피드백에 따라 장르 기반 크리에이터 추천에서 조회자가 크리에이터인 경우 본인을 제외하도록 PRD와 Task 4.4를 보강했다. RED에서 `DefaultHomeRecommendationQueryRepositoryTest.shouldExcludeRequesterOnlyGenreFromGenreCreatorRecommendations`, `shouldBackfillCreatorAfterExcludingRequesterFromGenreCreatorRecommendations`, `shouldReturnAvailableCreatorsAfterExcludingRequesterFromGenreCreatorRecommendations` 3건이 실패했고, GREEN에서 장르 후보 eligibility, fallback 후보 count, 실제 크리에이터 조회 native SQL에 `(:memberId is null or m.id <> :memberId)` 조건을 추가했다. service 경계에는 `HomeRecommendationQueryServiceTest.shouldReturnAvailableCreatorsWhenGenreCreatorCountIsUnderLimit`를 추가해 8명 미만이면 가능한 만큼 응답하는 정책을 고정했다. 검증으로 신규 RED 테스트 재실행, service 단일 테스트, `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest --tests kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryServiceTest`, `./gradlew ktlintCheck`, `./gradlew tasks --all`, `./gradlew test`가 모두 `BUILD SUCCESSFUL`로 통과했다.
+- 2026-06-08: 홈 추천 API DTO 패키지 경계를 정리했다. 기존 `HomeRecommendationResponse`, `HomeRecommendationPageResponse`, `FollowRecommendedCreatorsRequest` 3개 DTO를 `kr.co.vividnext.sodalive.v2.api.home.dto.recommendation` 하위로 이동하고, Controller/Facade 및 DTO 테스트 import를 갱신했다. 기존 추천 API DTO 이동은 홈 추천 API 문서 범위에만 기록하며, 크리에이터 랭킹 문서는 변경하지 않았다. 검증으로 후속 focused test와 compile/test를 실행한다.
+- 2026-06-08: 홈 추천 기능 본체 패키지를 단수 동사형 `recommend`에서 명사형 `recommendation` 기준인 `kr.co.vividnext.sodalive.v2.recommendation`으로 변경했다. `src/main`/`src/test` 디렉터리, Kotlin package/import, 문서의 파일 경로와 Gradle `--tests` 필터를 새 패키지명으로 맞췄다. `/api/v2/home/recommendations`, `v2.api.home`, `v2.api.home.dto.recommendation`, 클래스명과 API 스키마는 변경하지 않았다. 검증으로 stale reference 검색, `ktlintCheck`, 추천 패키지 테스트, 홈 API 테스트, 전체 테스트를 실행한다.

docs/20260529_메인_홈_추천_API/prd.md

@@ -118,7 +118,7 @@
 - 라이브 다시듣기는 콘텐츠 업로드 시 `다시듣기` 테마로 올린 경우를 의미한다.
 - 노출 정보는 크리에이터 프로필 이미지, 닉네임, 활동 타입, UTC 기반 활동 시간, 이동 대상 id를 포함한다.
 - 라이브 활동은 별도 이동 대상 id가 필요하지 않다.
-- 라이브 외 활동은 콘텐츠 id 또는 커뮤니티 게시글 id를 내려준다.
+- 라이브 외 활동은 오디오/라이브 다시듣기 콘텐츠 id를 내려주며, 커뮤니티 활동은 커뮤니티 게시글 작성자 크리에이터 id를 내려준다.
 - 크리에이터당 최신 활동 1개만 노출한다.
 
 #### Edge Cases
@@ -188,11 +188,15 @@
 - 같은 크리에이터가 서로 다른 조회 시점의 여러 장르 섹션에 노출될 수는 있다.
 - 한 번에 조회되는 5개 장르 안에서는 같은 크리에이터가 중복 노출되지 않아야 한다.
 - 사용자가 팔로우한 크리에이터는 제외한다.
+- 조회하는 사용자가 크리에이터이면 본인은 장르의 크리에이터 추천에서 제외한다.
 - 성인 콘텐츠 장르는 `MemberContentPreference.isAdultContentVisible == true`인 회원에게만 노출한다.
 - 노출 정보는 크리에이터 프로필 이미지, 닉네임, id를 포함한다.
 - 콘텐츠 조회 데이터는 콘텐츠 상세 진입 시점에 기록한다.
 
 #### Edge Cases
+- 조회하는 크리에이터 본인만 있는 장르는 후보에서 제외한다.
+- 장르의 크리에이터 8명 중 조회자 본인이 포함되어 있으면 본인을 제외하고 다른 추천 가능한 크리에이터로 채운다.
+- 본인을 제외한 뒤 대체 가능한 크리에이터가 없으면 남은 추천 가능한 크리에이터만 내려준다.
 - 장르별 추천 가능한 크리에이터가 8명 미만이면 가능한 만큼만 내려준다.
 
 ### Feature I. 여러 크리에이터 동시 팔로우
@@ -248,10 +252,10 @@
 - Kotlin, Spring Boot 2.7.14, Java 17, Gradle Wrapper 구조를 유지한다.
 - 신규 구현 코드는 `kr.co.vividnext.sodalive.v2` 하위에 둔다.
 - 신규 코드는 클라이언트 공개 API 조립 계층과 재사용 가능한 추천 기능 계층을 분리한다.
-- 클라이언트에 공개되는 메인 홈 API 조립 계층은 `kr.co.vividnext.sodalive.v2.api.home` 하위에 둔다.
-- 홈 API 외부에서도 재사용 가능한 추천, 점수 계산, 노출 정책, 스냅샷, 캐시, 콘텐츠 조회 이력 기능은 `kr.co.vividnext.sodalive.v2.recommend` 하위에 둔다.
-- 의존 방향은 `v2.api.home`에서 `v2.recommend`를 호출하는 방향으로만 둔다. `v2.recommend`는 `v2.api.home`의 DTO나 application service에 의존하지 않는다.
-- `v2.api.home`과 `v2.recommend` 모두 필요한 범위에서 경량 헥사고날 아키텍처를 적용하고, 기본 하위 패키지는 `application`, `domain`, `port`, `adapter`, `dto`를 사용한다.
+- 클라이언트에 공개되는 메인 홈 API 조립 계층은 `kr.co.vividnext.sodalive.v2.api.home` 하위에 두고, 홈 추천 API DTO는 `kr.co.vividnext.sodalive.v2.api.home.dto.recommendation` 하위에 둔다.
+- 홈 API 외부에서도 재사용 가능한 추천, 점수 계산, 노출 정책, 스냅샷, 캐시, 콘텐츠 조회 이력 기능은 `kr.co.vividnext.sodalive.v2.recommendation` 하위에 둔다.
+- 의존 방향은 `v2.api.home`에서 `v2.recommendation`를 호출하는 방향으로만 둔다. `v2.recommendation`는 `v2.api.home`의 DTO나 application service에 의존하지 않는다.
+- `v2.api.home`과 `v2.recommendation` 모두 필요한 범위에서 경량 헥사고날 아키텍처를 적용하고, 기본 하위 패키지는 `application`, `domain`, `port`, `adapter`, `dto`를 사용한다.
 - Controller는 `adapter.in.web`, application service/use case는 `application`, repository/cache/scheduler 구현은 `adapter.out.*`, application이 외부 조회/저장 구현에 의존하는 계약은 `port.out`에 둔다.
 - `port.in`은 여러 adapter에서 같은 use case를 재사용하거나 진입 계약을 명확히 해야 할 때만 둔다.
 - 정책, 점수 계산, 노출 조건, 스냅샷 모델처럼 인프라 의존이 없는 코드는 `domain`에 둔다.
@@ -262,6 +266,9 @@
 - 홈 추천 조회에는 공통 차단 필터를 적용해 내가 차단했거나 나를 차단한 크리에이터의 데이터를 제외한다.
 - 커뮤니티 게시글 조회에는 비공개 제외, 유료 글 제외, 핀 고정 글 제외, 성인 노출 조건(`MemberContentPreference.isAdultContentVisible`)을 공통 적용한다.
 - 일 1회 갱신 섹션은 조회 시점마다 무거운 집계를 하지 않도록 집계 테이블 또는 스냅샷 엔티티를 신규로 둔다.
+- 일 1회 스냅샷 갱신 스케줄러는 다중 서버 인스턴스에서 동시에 실행되더라도 클러스터 전체에서 한 인스턴스만 실제 갱신을 수행해야 한다.
+- 클러스터 단일 실행은 신규 DB 테이블을 추가하지 않고, 기존 프로젝트에 설정된 Redisson 기반 분산 lock을 우선 사용한다.
+- 추천 스냅샷 lock key는 `lock:recommendation-snapshot-refresh`를 사용하며, lock 획득 실패 인스턴스는 스냅샷 갱신을 정상 skip한다.
 - 랜덤 정렬이 필요한 섹션은 성능을 고려해 후보군 축소 후 랜덤화하거나 스냅샷 생성 시 랜덤 tie-breaker 값을 저장한다. 단, 일 1회 점수 기반 스냅샷은 아래 candidate pre-limit 금지 규칙을 따른다.
 - 일 1회 갱신 스냅샷은 후보를 application/service 메모리로 모두 불러와 점수를 계산하지 않는다. DB 조회에서 모든 적격 후보의 최종 점수와 랜덤 tie-breaker를 계산한 뒤 `score desc, randomTieBreaker asc` 기준으로 정렬하고, 그 이후에만 최종 저장 개수 limit을 적용한다.
 - 최종 점수 계산 전 candidate pre-limit, 랜덤 후보 컷오프, 임의 2배수 선제 제한은 정확한 top 후보를 누락할 수 있으므로 금지한다.

docs/20260608_크리에이터_랭킹/create-ranking-tables.sql

@@ -0,0 +1,61 @@
+-- MySQL 크리에이터 랭킹 스냅샷 테이블
+-- 날짜/시간 표시 컬럼은 TIMESTAMP를 사용한다.
+-- 같은 기간 재생성 시 삭제 기준:
+--   delete from creator_ranking_snapshot
+--   where aggregation_start_at_utc = :aggregationStartAtUtc
+--     and aggregation_end_at_utc = :aggregationEndAtUtc;
+
+create table creator_ranking_snapshot (
+    id bigint not null auto_increment comment '크리에이터 랭킹 스냅샷 ID',
+    aggregation_start_at_utc timestamp not null comment '집계 시작 시각(UTC, 포함)',
+    aggregation_end_at_utc timestamp not null comment '집계 종료 시각(UTC, 미포함)',
+    creator_id bigint not null comment '크리에이터 회원 ID(member.id)',
+    nickname varchar(100) not null comment '스냅샷 생성 시점 크리에이터 닉네임',
+    profile_image_url varchar(500) null comment '스냅샷 생성 시점 크리에이터 프로필 이미지 URL',
+    final_score double not null comment '최종 랭킹 점수',
+    content_live_score double not null comment '콘텐츠/라이브 카테고리 점수',
+    engagement_score double not null comment '참여 반응 카테고리 점수',
+    support_score double not null comment '응원 카테고리 점수',
+    fan_loyalty_score double not null comment '팬 충성도 카테고리 점수',
+    live_can_amount bigint not null comment '라이브 계열 사용 캔 합계',
+    content_purchase_can_amount bigint not null comment '콘텐츠 구매 사용 캔 합계',
+    content_like_count bigint not null comment '콘텐츠 좋아요 수',
+    content_comment_count bigint not null comment '콘텐츠 댓글 및 대댓글 수',
+    channel_donation_can_amount bigint not null comment '채널 후원 사용 캔 합계',
+    channel_donation_count bigint not null comment '채널 후원 건수',
+    fan_talk_count bigint not null comment '최상위 팬 Talk 수',
+    final_follower_count bigint not null comment '집계 종료 시점 활성 팔로우 수',
+    follow_increase bigint not null comment '집계 기간 팔로우 증가 수',
+    created_at timestamp not null default current_timestamp comment '생성 시각',
+    updated_at timestamp not null default current_timestamp on update current_timestamp comment '수정 시각',
+    primary key (id)
+) engine=InnoDB default charset=utf8mb4 comment='크리에이터 랭킹 주간 스냅샷';
+
+create index idx_creator_ranking_snapshot_period_score
+    on creator_ranking_snapshot (aggregation_end_at_utc, final_score desc);
+
+create index idx_creator_ranking_snapshot_replace_period
+    on creator_ranking_snapshot (aggregation_start_at_utc, aggregation_end_at_utc);
+
+create index idx_creator_ranking_snapshot_period_creator
+    on creator_ranking_snapshot (aggregation_start_at_utc, aggregation_end_at_utc, creator_id);
+
+create table creator_ranking_snapshot_job (
+    id bigint not null auto_increment comment '크리에이터 랭킹 스냅샷 생성 job ID',
+    aggregation_start_at_utc timestamp not null comment '집계 시작 시각(UTC, 포함)',
+    aggregation_end_at_utc timestamp not null comment '집계 종료 시각(UTC, 미포함)',
+    trigger_type varchar(20) not null comment '실행 트리거(SCHEDULED, MANUAL)',
+    status varchar(20) not null comment 'job 상태(PENDING, PROCESSING, DONE, FAILED)',
+    last_error text null comment '마지막 실패 사유',
+    processing_started_at timestamp null comment '처리 시작 시각',
+    processed_at timestamp null comment '처리 완료 시각',
+    created_at timestamp not null default current_timestamp comment '생성 시각',
+    updated_at timestamp not null default current_timestamp on update current_timestamp comment '수정 시각',
+    primary key (id)
+) engine=InnoDB default charset=utf8mb4 comment='크리에이터 랭킹 스냅샷 생성 job 이력';
+
+create index idx_creator_ranking_snapshot_job_period_status
+    on creator_ranking_snapshot_job (aggregation_start_at_utc, aggregation_end_at_utc, status);
+
+create index idx_creator_ranking_snapshot_job_status_created_at
+    on creator_ranking_snapshot_job (status, created_at);

docs/20260608_크리에이터_랭킹/plan-task.md

@@ -0,0 +1,507 @@
+# 크리에이터 랭킹 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:subagent-driven-development` 또는 `superpowers:executing-plans`로 task 단위 구현을 진행한다. 각 단계는 체크박스(`- [ ]`)로 진행 상태를 갱신한다.
+
+**Goal:** 홈 내부 랭킹 탭에서 `GET /api/v2/home/rankings/creators`로 KST 기준 지난 주 크리에이터 랭킹 상위 20명을 조회한다.
+
+**Architecture:** 공개 endpoint는 home 하위 URL을 사용하고, 클라이언트 API 표면(Controller, API 조합 Facade, DTO)은 기존 홈 API 관례에 맞춰 `kr.co.vividnext.sodalive.v2.api.home` 하위에 둔다. 랭킹 기능 본체(domain/application/port/persistence/scheduler)는 추천 기능과 분리된 `kr.co.vividnext.sodalive.v2.ranking` 하위에 둔다. 주간 스냅샷 생성 작업이 KST 기간을 UTC DB 조회 조건으로 변환해 원천 데이터를 집계하고, 조회 API는 최신 완료 주차 스냅샷을 우선 읽어 응답을 조립한다. 단, 스냅샷 테이블이 완전히 비어 있는 초기 상태에서만 제한적 원천 데이터 fallback 집계를 시도할 수 있다.
+
+**Tech Stack:** Kotlin, Spring Boot 2.7.14, Java 17, Spring Data JPA, QueryDSL 또는 native SQL, JUnit 5, Gradle Wrapper
+
+---
+
+## 0. 구현 전 확정 사항
+
+- API endpoint: `GET /api/v2/home/rankings/creators`
+- 랭킹 기능 본체 패키지: `kr.co.vividnext.sodalive.v2.ranking`
+- 홈 공개 API 조립 패키지: `kr.co.vividnext.sodalive.v2.api.home`
+- 집계 기간: 조회/스냅샷 생성 시점 기준 KST 지난 주 월요일 00:00:00 이상, 이번 주 월요일 00:00:00 미만
+- DB 조회 기간: KST 집계 기간을 UTC 기준 `LocalDateTime` 또는 프로젝트 표준 시간 타입으로 변환한 기간
+- 스냅샷 생성 스케줄 후보: 매주 월요일 KST 07:30, `@Scheduled(cron = "0 30 7 * * MON", zone = "Asia/Seoul")`
+- 다중 서버 인스턴스에서 스냅샷 스케줄러가 중복 실행되지 않도록 기존 Redisson 기반 분산 lock을 사용한다.
+- 랭킹 스냅샷 lock key는 `lock:creator-ranking-snapshot-refresh`로 고정하고, lock 획득 실패 인스턴스는 정상 skip한다.
+- 조회 API는 스냅샷 기반 응답을 기본으로 하며, 스냅샷 테이블이 완전히 비어 있는 초기 상태에서만 제한적 원천 데이터 fallback 집계를 시도할 수 있다.
+- 스냅샷 테이블에 과거 스냅샷이 하나라도 있으면 원천 데이터 fallback을 시도하지 않고 기존 최신 완료 주차 스냅샷 기준 응답을 유지한다.
+- 스냅샷 생성 직전 집계 시작/종료 시각을 포함한 job 이력을 생성하고, 스케줄 실행과 관리자 수동 생성 모두 성공/실패 상태를 기록한다.
+- 관리자는 날짜 범위를 직접 선택해 스냅샷 생성 job을 만들 수 있으며, 실패한 job은 관리자 전용 재시도 API로 대기 상태로 되돌려 재처리할 수 있어야 한다.
+- 스냅샷은 현재 누적 저장하며, 보존 기간/정리 배치는 운영 데이터 규모 확인 후 별도 결정한다.
+- API 응답은 `showRankChange`, `items[].rank`, `items[].rankChange`, `items[].isNew`, `items[].creatorId`, `items[].nickname`, `items[].profileImageUrl`만 포함한다.
+- API 응답에는 집계 기간 날짜와 `finalScore`를 포함하지 않는다.
+- raw value 방식으로 계산하며 0~100 정규화는 하지 않는다.
+- 스냅샷 저장 대상은 20위 점수보다 높은 후보와 20위 점수에 동점인 후보 전체로 제한한다.
+- 동점자는 조회 시 랜덤 정렬로 상위 20명을 추출하고, 별도 `randomTieBreaker`는 저장하지 않는다.
+- 직전 완료 주차 스냅샷이 없으면 `showRankChange=false`, `rankChange=null`, `isNew=false`로 응답한다.
+- 비활성 및 탈퇴 크리에이터는 랭킹에 노출하지 않는다.
+- 차단 관계가 있으면 row는 유지하되 `creatorId=0`, `nickname=""`, `profileImageUrl=기본 이미지 URL`로 마스킹한다.
+- 신규 팔로우 수는 `CreatorFollowing.createdAt` 기준, 언팔로우 수는 `CreatorFollowing.isActive == false` 및 `CreatorFollowing.updatedAt` 기준으로 계산한다.
+
+---
+
+## 1. 파일 구조 계획
+
+### 신규 ranking domain/application
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingPeriodPolicy.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScorePolicy.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScoreSpec.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingSnapshotCandidate.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingItem.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshService.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryService.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingAggregationPort.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingSnapshotPort.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingBlockPort.kt`
+
+### 신규 홈 API 조립 계층
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/CreatorRankingController.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeCreatorRankingFacade.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/ranking/CreatorRankingResponse.kt`
+
+### 신규 scheduler / persistence
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/scheduler/CreatorRankingSnapshotScheduler.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshot.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingBlockRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotJob.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotJobRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotJobRepository.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingSnapshotJobPort.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobService.kt`
+
+### 신규 관리자 API
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobController.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobService.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobResponse.kt`
+- Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobRequest.kt`
+
+### 문서 산출물
+- Create: `docs/20260608_크리에이터_랭킹/create-ranking-tables.sql`
+- Modify: `docs/20260608_크리에이터_랭킹/plan-task.md`
+
+### 테스트
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingPeriodPolicyTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScorePolicyTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshServiceTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepositoryTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepositoryTest.kt`
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/CreatorRankingControllerTest.kt`
+
+---
+
+### Phase 1: 기간/점수 도메인 정책
+
+- [x] **Task 1.1: KST 주간 기간 산출과 UTC 조회 기간 변환 정책 작성**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingPeriodPolicy.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingPeriodPolicyTest.kt`
+  - RED: 월요일 KST 기준 지난 주 기간, 월/연도 경계, 서버 timezone UTC와 무관한 기간 산출, KST 2026-06-01 00:00:00~2026-06-08 00:00:00이 UTC 2026-05-31 15:00:00~2026-06-07 15:00:00으로 변환되는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingPeriodPolicyTest`
+  - GREEN: `CreatorRankingPeriodPolicy.resolveLastCompletedWeek(now: ZonedDateTime)`와 `toUtcRange(period)`를 구현한다.
+  - REFACTOR: 기간 경계는 종료 미만(`< end`) 조건으로 사용할 수 있도록 `startInclusiveUtc`, `endExclusiveUtc` 명칭을 유지한다.
+  - 기대 결과: KST 기준 기간 산출과 UTC 변환이 테스트로 고정된다.
+
+- [x] **Task 1.2: raw value 기반 점수 정책 작성**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScoreSpec.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScorePolicy.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScorePolicyTest.kt`
+  - RED: 콘텐츠/라이브 점수, 참여 반응 점수, 응원 점수, 팬 충성도 점수, 최종 점수 산식 테스트를 작성한다. 0~100 정규화 없이 캔/건수/팔로우 원천값이 그대로 가중합되는지 검증한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingScorePolicyTest`
+  - GREEN: 가중치 상수와 `calculateContentLiveScore`, `calculateEngagementScore`, `calculateSupportScore`, `calculateFanLoyaltyScore`, `calculateFinalScore`를 구현한다.
+  - REFACTOR: 소수 계산 비교는 `assertEquals(expected, actual, 0.0001)` 기준을 사용한다.
+  - 기대 결과: PRD의 raw value 정책과 음수 팔로우 증가 반영이 테스트로 고정된다.
+
+- [x] **Task 1.3: 스냅샷 후보/응답 내부 모델 작성**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingSnapshotCandidate.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingItem.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt`
+  - RED: `rankChange` 양수/음수/null과 `isNew`를 담을 수 있는 내부 item 모델이 없으면 컴파일 실패하는 테스트 골격을 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest`
+  - GREEN: 스냅샷 후보와 조회 item 내부 모델을 작성한다.
+  - REFACTOR: API DTO와 domain model을 분리해 Controller가 persistence entity에 의존하지 않도록 한다.
+  - 기대 결과: 이후 service/controller task가 같은 타입을 재사용할 수 있다.
+
+### Phase 2: 스냅샷 저장소와 DDL
+
+- [x] **Task 2.1: 랭킹 스냅샷 엔티티/리포지토리 추가**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshot.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotRepository.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepository.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingSnapshotPort.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepositoryTest.kt`
+  - RED: 같은 집계 기간의 스냅샷 replace, 최신 완료 주차 조회, 직전 완료 주차 조회, 20위 경계 동점 후보 저장 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotRepositoryTest`
+  - GREEN: 스냅샷 엔티티에 `aggregationStartAtUtc`, `aggregationEndAtUtc`, `creatorId`, `finalScore`, 카테고리별 점수, 원천 지표, `createdAt`을 저장한다. 저장 전 같은 기간 row를 삭제하고 새 후보를 저장한다.
+  - REFACTOR: 스냅샷 조회 port는 domain model만 반환하고 JPA entity를 application 계층으로 노출하지 않는다.
+  - 기대 결과: 같은 기간 재생성 시 중복 노출되지 않고 최신/직전 주차를 구분해 조회할 수 있다.
+
+- [x] **Task 2.2: 운영 DB 반영용 스냅샷 DDL 문서 작성**
+  - Files:
+    - Create: `docs/20260608_크리에이터_랭킹/create-ranking-tables.sql`
+    - Modify: `docs/20260608_크리에이터_랭킹/plan-task.md`
+  - RED: 테스트 작성 예외. `TDD 예외 사유`: SQL 운영 반영 문서 작성 task로, 실행 대상 DB가 현재 workspace에 없다.
+  - 대체 검증 방법: `rg -n "creator_ranking_snapshot|aggregation_start_at_utc|creator_id|final_score" docs/20260608_크리에이터_랭킹/create-ranking-tables.sql`
+  - GREEN: `creator_ranking_snapshot` 테이블 생성 SQL, 기간/점수 조회용 index, 같은 기간 재생성 시 삭제 기준을 문서에 작성한다.
+  - REFACTOR: 컬럼명은 JPA entity와 1:1로 대응하도록 정리한다.
+  - 기대 결과: 운영 배포 전 DB 테이블 생성 SQL을 검토할 수 있다.
+
+### Phase 3: 원천 지표 집계 repository
+
+- [x] **Task 3.1: 콘텐츠/라이브 캔 집계 구현**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingAggregationPort.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepositoryTest.kt`
+  - RED: `CanUsage.DONATION`, `LIVE`, `SPIN_ROULETTE`는 라이브 계열 캔으로, `ORDER_CONTENT`는 콘텐츠 구매 캔으로 집계되고 환불 row가 제외되는 repository 통합 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest`
+  - GREEN: KST에서 변환한 UTC 기간으로 `UseCan` 계열 데이터를 조회하고 크리에이터별 캔 합계를 반환한다.
+  - REFACTOR: can usage 조건은 private 함수 또는 enum set으로 분리해 산식과 조회 조건이 섞이지 않도록 한다.
+  - 기대 결과: 콘텐츠/라이브 카테고리의 원천 지표가 정확히 집계된다.
+
+- [x] **Task 3.2: 콘텐츠 좋아요/댓글 반응 집계 구현**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepositoryTest.kt`
+  - RED: 활성 콘텐츠 좋아요 수, 댓글+대댓글 수, 크리에이터 본인 댓글/대댓글 제외, 비활성/삭제 정책 제외를 검증하는 repository 통합 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest`
+  - GREEN: `AudioContentLike`, `AudioContentComment`, `AudioContent`를 기준으로 크리에이터별 좋아요/댓글 원천 지표를 반환한다.
+  - REFACTOR: 댓글 작성자가 콘텐츠 소유 크리에이터와 같은 경우 제외하는 조건을 테스트 fixture 이름에 드러나게 정리한다.
+  - 기대 결과: 참여 반응 점수 입력값이 PRD 조건과 일치한다.
+
+- [x] **Task 3.3: 채널 후원/팬 Talk 응원 집계 구현**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepositoryTest.kt`
+  - RED: `CanUsage.CHANNEL_DONATION` 캔 합계와 건수, 환불 제외, `CreatorCheers` 최상위 row만 팬 Talk로 집계하고 답글은 제외하는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest`
+  - GREEN: 채널 후원 원천 지표와 팬 Talk 원천 지표를 크리에이터별로 반환한다.
+  - REFACTOR: 팬 Talk 답글 제외 조건은 `parent is null` 또는 기존 엔티티 구조에 맞는 조건으로 명확히 둔다.
+  - 기대 결과: 응원 점수 입력값이 캔/건수/최상위 팬 Talk 기준으로 집계된다.
+
+- [x] **Task 3.4: 팔로우 최종 수/증가 수 집계 구현**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepositoryTest.kt`
+  - RED: 최종 팔로우 수는 기간 종료 시점 활성 row, 신규 팔로우 수는 `createdAt` 기간 내, 언팔로우 수는 `isActive=false` 및 `updatedAt` 기간 내, 기간 내 재팔로우는 신규/언팔로우 이벤트로 별도 복원하지 않는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest`
+  - GREEN: `CreatorFollowing` 기준 최종 팔로우 수와 팔로우 증가 수를 반환한다.
+  - REFACTOR: 현재 row만으로 계산하는 정책 한계를 테스트명과 주석 한 줄로 남긴다.
+  - 기대 결과: 팬 충성도 점수 입력값이 PRD의 `createdAt`/`updatedAt` 정책과 일치한다.
+
+- [x] **Task 3.5: 랭킹 후보 통합 집계와 비활성/탈퇴 제외 구현**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepositoryTest.kt`
+  - RED: 여러 원천 지표를 크리에이터별로 합쳐 후보를 만들고, 비활성/탈퇴 크리에이터와 최종 점수 1점 미만 후보가 제외되는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest`
+  - GREEN: 원천 지표 aggregate를 크리에이터 id 기준으로 합쳐 `CreatorRankingSnapshotCandidate`를 반환한다.
+  - REFACTOR: 복잡한 집계가 QueryDSL로 과도해지면 native SQL을 사용하되, 테스트로 H2 호환성을 고정한다.
+  - 기대 결과: 스냅샷 생성 서비스가 별도 원천 조회를 여러 번 조합하지 않고 후보 목록을 받을 수 있다.
+
+### Phase 4: 스냅샷 생성 서비스와 스케줄러
+
+- [x] **Task 4.1: 주간 스냅샷 생성 서비스 구현**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshServiceTest.kt`
+  - RED: KST 기간 산출, UTC 조회 기간 전달, raw value 점수 계산, 20위 점수 경계 동점 후보 전체 저장, 같은 기간 replace를 검증하는 service 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest`
+  - GREEN: aggregation port에서 후보를 조회하고 score policy로 점수를 계산한 뒤 저장 대상 후보만 snapshot port에 저장한다.
+  - REFACTOR: service는 계산 흐름만 담당하고 DB 조회 조건/저장 구현은 port 뒤로 숨긴다.
+  - 기대 결과: 스냅샷 저장 대상이 “20위 초과 점수 + 20위 동점 전체” 규칙을 만족한다.
+
+- [x] **Task 4.2: 매주 월요일 07:30 KST 스케줄러 추가**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/scheduler/CreatorRankingSnapshotScheduler.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshServiceTest.kt`
+  - RED: scheduler method에 `@Scheduled(cron = "0 30 7 * * MON", zone = "Asia/Seoul")`가 선언되어 있는지 reflection 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest`
+  - GREEN: 스케줄러가 `CreatorRankingSnapshotRefreshService.refreshLastCompletedWeek()`를 호출하도록 구현한다.
+  - REFACTOR: 스케줄러에는 기간/점수/DB 로직을 두지 않는다.
+  - 기대 결과: 주간 스냅샷 생성 트리거가 KST 기준으로 고정된다.
+
+- [x] **Task 4.3: 주간 스냅샷 스케줄러 Redisson lock 적용**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/scheduler/CreatorRankingSnapshotScheduler.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshServiceTest.kt`
+  - RED: Redisson lock 획득 성공 시 `CreatorRankingSnapshotRefreshService.refreshLastCompletedWeek()`를 1회 호출하고, 획득 실패 시 호출하지 않는 테스트를 작성한다. lock key가 `lock:creator-ranking-snapshot-refresh`인지도 검증한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest`
+  - GREEN: 기존 `RedissonClient` bean을 스케줄러에 주입하고 `tryLock`으로 lock을 획득한 인스턴스만 refresh service를 호출한다. lock 획득 실패는 정상 skip으로 처리한다.
+  - REFACTOR: DB 기반 scheduler lock 테이블은 추가하지 않고, 기존 `AudioContentReleaseScheduledTask`의 Redisson lock 패턴을 참고하되 스케줄러에는 lock 획득/해제와 service 호출만 둔다.
+  - 기대 결과: 여러 서버 인스턴스에서 같은 cron이 동시에 실행돼도 클러스터 전체에서 한 인스턴스만 주간 랭킹 스냅샷을 생성한다.
+
+### Phase 5: 조회 서비스, 순위 변화, 차단 마스킹
+
+- [x] **Task 5.1: 최신/직전 스냅샷 기반 조회 서비스 구현**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt`
+  - RED: 최신 완료 주차 스냅샷 없음 빈 결과, 직전 주차 없음 `showRankChange=false`, 직전 주차 있음 `rankChange` 양수/음수/null 및 `isNew` 계산 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest`
+  - GREEN: 최신 스냅샷 후보를 최종 점수 내림차순과 동점 랜덤 정렬로 최대 20명 선정하고, 직전 스냅샷 순위와 비교해 순위 변화를 계산한다.
+  - REFACTOR: 동점 랜덤으로 인해 같은 동점 구간의 순위 변화가 조회마다 달라질 수 있음을 테스트에서 허용 범위로 표현한다.
+  - 기대 결과: 홈 API Facade가 사용할 `showRankChange`와 item 목록이 ranking application service에서 완성된다.
+
+- [x] **Task 5.2: 차단 관계 마스킹 port 구현**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingBlockPort.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingBlockRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt`
+  - RED: 조회자와 랭킹 크리에이터 사이에 차단 관계가 있으면 row는 유지되고 `creatorId=0`, `nickname=""`, `profileImageUrl=기본 이미지 URL`로 마스킹되는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest`
+  - GREEN: block port로 차단 대상 creator id를 조회하고, service에서 응답 item을 마스킹한다.
+  - REFACTOR: 기본 이미지 URL은 기존 프로젝트 상수/설정이 있으면 재사용하고, 없으면 ranking service 내부 상수로 분리한다.
+  - 기대 결과: 차단 관계가 있어도 순위 row 수는 유지되고 개인 식별 정보만 가려진다.
+
+### Phase 6: 홈 API endpoint, Facade, DTO
+
+- [x] **Task 6.1: 랭킹 조회 DTO, 홈 API Facade, Controller 추가**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/ranking/CreatorRankingResponse.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeCreatorRankingFacade.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/CreatorRankingController.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/CreatorRankingControllerTest.kt`
+  - RED: `GET /api/v2/home/rankings/creators`가 `showRankChange`, `items[].rank`, `rankChange`, `isNew`, `creatorId`, `nickname`, `profileImageUrl`만 반환하고 날짜와 `finalScore`를 반환하지 않는 controller 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.CreatorRankingControllerTest`
+  - GREEN: controller, API Facade, response DTO를 구현하고 Facade가 `CreatorRankingQueryService`를 호출해 홈 API 응답으로 변환한다.
+  - REFACTOR: URL과 클라이언트 API 표면은 `v2.api.home` 하위에 두고, 랭킹 DTO는 `v2.api.home.dto.ranking` 하위에 둔다. 랭킹 계산/조회 본체는 `v2.ranking`에 유지한다.
+  - 기대 결과: 클라이언트 홈 랭킹 탭에서 사용할 공개 API 계약이 테스트로 고정된다.
+
+- [x] **Task 6.2: 인증/비인증 조회와 차단 마스킹 연결**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/CreatorRankingController.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeCreatorRankingFacade.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/CreatorRankingControllerTest.kt`
+  - RED: 비회원 조회는 기본 랭킹을 반환하고, 인증 회원 조회는 차단 관계 마스킹을 적용하는 controller 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.CreatorRankingControllerTest`
+  - GREEN: 기존 인증 주입 패턴을 확인해 member nullable 흐름을 service에 전달한다.
+  - REFACTOR: 기존 API 응답 wrapper 관례와 상태 코드를 맞춘다.
+  - 기대 결과: 인증 여부에 따라 차단 마스킹만 달라지고 endpoint 계약은 동일하다.
+
+### Phase 7: 관측/문서/회귀 검증
+
+- [x] **Task 7.1: 스냅샷 생성/조회 로그 추가**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt`
+  - RED: 스냅샷 생성 성공/실패, 후보 수, 저장 수, 조회 성공/실패 로그가 남는지 output capture 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest`
+  - GREEN: 기존 프로젝트 관례대로 `LoggerFactory` 기반 구조화 로그를 추가한다.
+  - REFACTOR: 로그에 개인정보를 직접 남기지 않고 creator id/count/period만 남긴다.
+  - 기대 결과: PRD metrics 확인에 필요한 최소 로그가 남는다.
+
+- [x] **Task 7.2: 전체 ranking 테스트와 포맷 검증**
+  - Files:
+    - Verify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/**`
+    - Verify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/**`
+    - Verify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/**`
+    - Verify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/**`
+    - Modify: `docs/20260608_크리에이터_랭킹/plan-task.md`
+  - RED: 테스트 작성 예외. `TDD 예외 사유`: 구현 완료 후 회귀 검증 task다.
+  - 대체 검증 방법:
+    - `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*' --tests 'kr.co.vividnext.sodalive.v2.api.home.*'`
+    - `./gradlew ktlintCheck`
+    - `./gradlew test`
+  - GREEN: 실패하는 테스트가 있으면 해당 phase task로 돌아가 수정하고, 모든 명령을 통과시킨다.
+  - REFACTOR: plan-task 하단 검증 기록에 실행 명령, 목적, 결과를 누적한다.
+  - 기대 결과: ranking 기능 본체와 홈 API 조립 계층 테스트, 포맷, 전체 회귀 테스트가 통과한다.
+
+### Phase 8: 스냅샷 job 이력과 스케줄 기록
+
+- [x] **Task 8.1: 스냅샷 job 이력 모델/DDL 추가**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotJob.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotJobRepository.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotJobRepository.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingSnapshotJobPort.kt`
+    - Modify: `docs/20260608_크리에이터_랭킹/create-ranking-tables.sql`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotJobRepositoryTest.kt`
+  - RED: 집계 시작/종료 시각, 실행 트리거, 상태(`PENDING`, `PROCESSING`, `DONE`, `FAILED`), 실패 사유, 처리 시작/완료 시각을 저장하고 조회할 수 있는 repository 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotJobRepositoryTest`
+  - GREEN: 기존 `charge_event_job` 관례를 참고해 스냅샷 job entity/repository/port와 운영 반영용 DDL을 작성한다.
+  - REFACTOR: 컬럼명은 관리자 목록과 worker 처리에 필요한 최소 필드로 제한하고 공개 API DTO와 분리한다.
+  - 기대 결과: 스냅샷 생성 이력이 기간/상태 기준으로 추적 가능해진다.
+
+- [x] **Task 8.2: 스케줄 실행 전 job 생성과 성공/실패 기록 연결**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/scheduler/CreatorRankingSnapshotScheduler.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobServiceTest.kt`
+  - RED: 스케줄러가 스냅샷 생성 직전 집계 기간을 포함한 `SCHEDULED` job을 만들고, refresh 성공 시 `DONE`, 예외 발생 시 `FAILED`와 실패 사유를 기록하는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobServiceTest`
+  - GREEN: 스케줄러는 lock 획득 후 job service를 통해 job 생성/실행/상태 기록을 위임하고, refresh service는 기존 스냅샷 생성 책임을 유지한다.
+  - REFACTOR: lock 획득 실패는 job 실패로 기록하지 않고 기존 정상 skip 정책을 유지한다.
+  - 기대 결과: 매주 스케줄 실행 여부와 성공/실패가 관리자에서 추적 가능한 job 이력으로 남는다.
+
+### Phase 9: 관리자 수동 생성과 실패 job 재시도 API
+
+- [x] **Task 9.1: 관리자 날짜 범위 수동 생성 API 추가**
+  - Files:
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobController.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobService.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobRequest.kt`
+    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobResponse.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobControllerTest.kt`
+  - RED: `POST /admin/rankings/creators/snapshot-jobs`가 관리자 권한에서 날짜 범위를 받아 `MANUAL` job을 생성하고, 비관리자 요청은 거부되는 controller/service 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.admin.ranking.creator.AdminCreatorRankingSnapshotJobControllerTest`
+  - GREEN: 기존 관리자 API 관례대로 `@PreAuthorize("hasRole('ADMIN')")`와 `ApiResponse.ok(...)`를 사용해 수동 생성 job id와 상태를 반환한다.
+  - REFACTOR: 날짜 범위 validation은 KST 주차/UTC 변환 정책과 중복되지 않도록 application service에 모은다.
+  - 기대 결과: 운영자가 별도 DB 확인 없이 필요한 날짜 범위의 스냅샷 생성을 요청할 수 있다.
+
+- [x] **Task 9.2: 관리자 job 목록/실패 job 재시도 API 추가**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobController.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobControllerTest.kt`
+  - RED: `GET /admin/rankings/creators/snapshot-jobs`가 날짜 범위/상태/실패 사유/재시도 가능 여부를 반환하고, `POST /admin/rankings/creators/snapshot-jobs/{jobId}/retry`가 `FAILED` job만 `PENDING`으로 되돌리는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.admin.ranking.creator.AdminCreatorRankingSnapshotJobControllerTest`
+  - GREEN: 기존 `AdminChargeEventJobController`/`AdminChargeEventJobService` 패턴을 참고해 관리자 목록과 재시도 API를 구현한다.
+  - REFACTOR: `PENDING`, `PROCESSING`, `DONE` 상태 job은 재시도 대상으로 변경하지 않고 명확한 실패 응답을 반환한다.
+  - 기대 결과: 실패한 스냅샷 job을 관리자 버튼/API로 재시도할 수 있다.
+
+### Phase 10: 스냅샷 완전 공백 fallback
+
+- [x] **Task 10.1: 스냅샷 테이블 완전 공백 여부 조회 port 추가**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingSnapshotPort.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepository.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotRepository.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepositoryTest.kt`
+  - RED: 스냅샷 row가 하나도 없을 때만 true를 반환하고, 과거 주차 스냅샷이 하나라도 있으면 false를 반환하는 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotRepositoryTest`
+  - GREEN: snapshot port에 `isSnapshotTableEmpty()` 또는 동등한 메서드를 추가해 조회 서비스가 fallback 조건을 판단할 수 있게 한다.
+  - REFACTOR: “최신 주차 스냅샷 없음”과 “테이블 완전 공백”을 서로 다른 조건으로 유지한다.
+  - 기대 결과: cold-start fallback이 과거 스냅샷 존재 시 실행되지 않도록 조건이 고정된다.
+
+- [x] **Task 10.2: 조회 API cold-start fallback 연결**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt`
+  - RED: 최신 스냅샷이 없고 스냅샷 테이블이 완전히 비어 있을 때만 fallback 집계를 시도하고, 과거 스냅샷이 있으면 fallback을 시도하지 않는 테스트를 작성한다. 공개 응답 스키마가 `showRankChange`와 `items`로 유지되는지도 검증한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest`
+  - GREEN: query service가 snapshot-first 흐름을 유지하면서 완전 공백 상태에서만 제한적 fallback 집계를 호출하고 결과를 기존 ranking result로 변환한다.
+  - REFACTOR: fallback은 장기 실시간 랭킹 경로가 아니라 초기 스냅샷 부재 안전장치임을 service 경계와 테스트명에 드러낸다.
+  - 기대 결과: 초기 운영 상태에서는 빈 화면을 줄이고, 운영 중에는 기존 스냅샷 기반 정책을 유지한다.
+
+- [x] **Task 10.3: fallback/job 관측 로그와 회귀 검증**
+  - Files:
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryService.kt`
+    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobService.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt`
+    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobServiceTest.kt`
+  - RED: fallback 시도/성공/실패와 job 상태 변경 로그가 남는지 output capture 테스트를 작성한다.
+  - 실패 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobServiceTest`
+  - GREEN: 개인정보 없이 period, jobId, trigger, status, count, elapsedMs 중심의 구조화 로그를 추가한다.
+  - REFACTOR: 기존 Phase 7 로그와 이벤트명 충돌이 없도록 prefix를 정리한다.
+  - 기대 결과: 관리자 job과 cold-start fallback 상태를 운영 로그/메트릭으로 추적할 수 있다.
+
+---
+
+## 2. PRD 요구사항 추적
+
+- Feature A: Task 1.1, Task 4.1에서 KST 기간 산출과 UTC DB 조회 변환을 검증한다.
+- Feature B: Task 1.2, Task 3.1, Task 4.1에서 콘텐츠/라이브 raw can 산식을 검증한다.
+- Feature C: Task 1.2, Task 3.2, Task 4.1에서 좋아요/댓글/대댓글 및 크리에이터 본인 댓글 제외를 검증한다.
+- Feature D: Task 1.2, Task 3.3, Task 4.1에서 채널 후원 캔/건수와 최상위 팬 Talk 집계를 검증한다.
+- Feature E: Task 1.2, Task 3.4, Task 4.1에서 최종 팔로우 수와 `createdAt`/`updatedAt` 기반 팔로우 증가 수를 검증한다.
+- Feature F: Task 1.2, Task 4.1, Task 5.1에서 raw value 최종 점수, 1점 미만 제외, 20위 동점 후보 저장, 동점 랜덤 조회를 검증한다.
+- Feature G: Task 5.1, Task 5.2에서 ranking 조회 결과와 차단 마스킹을 검증하고, Task 6.1, Task 6.2에서 홈 API endpoint, 응답 스키마, 인증/비인증 연결을 검증한다. Task 10.1, Task 10.2에서 스냅샷 테이블 완전 공백 상태의 제한적 fallback과 공개 응답 스키마 유지를 검증한다.
+- Feature H: Task 2.1, Task 2.2, Task 4.1, Task 4.2, Task 4.3에서 주간 스냅샷 저장, 스케줄, 클러스터 단일 실행 lock을 검증한다. Task 8.1, Task 8.2에서 스케줄 job 이력과 성공/실패 기록을 검증하고, Task 9.1, Task 9.2에서 관리자 날짜 범위 수동 생성과 실패 job 재시도 API를 검증한다.
+- Feature I: Phase 5의 ranking 기능 본체는 `v2.ranking` 패키지 경계를 유지하고, Phase 6의 클라이언트 API 표면은 `v2.api.home` 하위에 둔다. Phase 8~10의 관리자/job/fallback 기능도 공개 API 응답 DTO를 변경하지 않는다.
+
+---
+
+## 3. 검증 기록
+
+- 2026-06-08: PRD 기준 구현 계획/TASK 문서를 작성했다. 구현 시작 전 문서 산출물이므로 코드 테스트는 실행하지 않았고, 문서 규칙에 따라 `./gradlew tasks --all`로 Gradle 명령 유효성을 확인한다.
+- 2026-06-08: `rg -n "TBD|TODO|작성 예정|fill in|placeholder|similar|위와 동일|적절한|나중" docs/20260608_크리에이터_랭킹/plan-task.md`로 placeholder 문구가 없음을 확인했다.
+- 2026-06-08: `./gradlew tasks --all`은 sandbox 기본 권한에서 `~/.gradle` wrapper lock 파일 접근 권한 문제로 실패했고, 권한 승인 후 재실행해 `BUILD SUCCESSFUL in 778ms`를 확인했다.
+- 2026-06-08: Phase 1 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingPeriodPolicyTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingScorePolicyTest`, `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest` 실행 시 신규 ranking domain 타입 미정의로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-08: Phase 1 GREEN 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingScorePolicyTest`와 `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest`는 `BUILD SUCCESSFUL`을 확인했다. 병렬 실행한 period 단일 테스트 1건은 Kotlin/kapt cache 경합으로 실패해 후속 통합 검증에서 재확인한다.
+- 2026-06-08: Phase 2 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotRepositoryTest`는 production persistence 추가 전 실행했으나 Kotlin daemon heap 오류로 컴파일 단계에서 중단됐다. 당시 테스트가 참조하는 `CreatorRankingSnapshotRepository` 등 production 타입은 미구현 상태였다.
+- 2026-06-08: Phase 2 GREEN 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotRepositoryTest` 재실행 결과 `BUILD SUCCESSFUL in 1m 49s`를 확인했다.
+- 2026-06-08: DDL 대체 검증: `rg -n "creator_ranking_snapshot|aggregation_start_at_utc|creator_id|final_score" docs/20260608_크리에이터_랭킹/create-ranking-tables.sql`로 테이블명, 기간 컬럼, 크리에이터 id, 최종 점수 컬럼 및 index 문구를 확인했다.
+- 2026-06-08: Phase 1~2 ranking 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*'` 재실행 결과 `BUILD SUCCESSFUL in 22s`를 확인했다.
+- 2026-06-08: 포맷 검증: `./gradlew ktlintCheck`는 최초 신규 테스트 긴 줄로 실패했고, 줄바꿈 수정 후 재실행해 `BUILD SUCCESSFUL in 10s`를 확인했다.
+- 2026-06-08: 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 1m 16s`를 확인했다.
+- 2026-06-08: Phase 3 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest` 실행 결과 `DefaultCreatorRankingAggregationRepository` 미구현으로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-08: Phase 3 GREEN 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest` 재실행 결과 `BUILD SUCCESSFUL in 13s`를 확인했다.
+- 2026-06-08: Phase 3 focused 재검증: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest` 재실행 결과 `BUILD SUCCESSFUL in 14s`를 확인했다.
+- 2026-06-08: Phase 3 ranking 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*'` 실행 결과 `BUILD SUCCESSFUL in 12s`를 확인했다.
+- 2026-06-08: Phase 3 포맷 검증: `./gradlew ktlintCheck`는 최초 신규 테스트 긴 줄로 실패했고, 줄바꿈 수정 후 재실행해 `BUILD SUCCESSFUL in 5s`를 확인했다.
+- 2026-06-08: Phase 4 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest` 실행 결과 `CreatorRankingSnapshotRefreshService`, `CreatorRankingSnapshotScheduler` 미구현으로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-08: Phase 4 GREEN 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest` 재실행 결과 `BUILD SUCCESSFUL in 3s`를 확인했다.
+- 2026-06-08: Phase 4 ranking 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*'` 실행 결과 `BUILD SUCCESSFUL in 15s`를 확인했다.
+- 2026-06-08: Phase 4 포맷 검증: `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL in 22s`를 확인했다.
+- 2026-06-08: Phase 4 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 56s`를 확인했다.
+- 2026-06-08: Phase 4 reviewer gate: 스냅샷 생성 서비스/스케줄러/테스트/문서 변경에 대해 strict review를 수행했고 `PASS` 판정을 확인했다.
+- 2026-06-08: Task 4.3 및 07:30 스케줄 변경 focused 검증: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest` 실행 결과 `BUILD SUCCESSFUL in 16s`를 확인했다.
+- 2026-06-08: Task 4.3 ranking 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*'` 실행 결과 `BUILD SUCCESSFUL in 18s`를 확인했다.
+- 2026-06-08: Task 4.3 포맷 검증: `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL in 26s`를 확인했다.
+- 2026-06-08: Phase 5 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest` 실행 결과 `CreatorRankingBlockPort`, `CreatorRankingQueryService` 미구현으로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-08: Phase 5 GREEN 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest` 재실행 결과 `BUILD SUCCESSFUL in 29s`를 확인했다.
+- 2026-06-08: Phase 5 ranking 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*'` 실행 결과 `BUILD SUCCESSFUL in 18s`를 확인했다.
+- 2026-06-08: Phase 5 포맷 검증: `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL in 25s`를 확인했다.
+- 2026-06-08: Phase 5 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 1m 1s`를 확인했다.
+- 2026-06-08: Phase 5 reviewer gate: 조회 서비스/차단 마스킹/테스트/문서 변경에 대해 strict review를 수행했고 `PASS` 판정을 확인했다.
+- 2026-06-08: Phase 6 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.CreatorRankingControllerTest` 실행 결과 신규 endpoint/permit rule 미구현으로 비회원 요청 401, 인증 요청 404 등 신규 controller 테스트 3건 실패를 확인했다.
+- 2026-06-08: Phase 6 GREEN 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.CreatorRankingControllerTest` 재실행 결과 `BUILD SUCCESSFUL in 33s`를 확인했다.
+- 2026-06-08: Phase 6 ranking/API 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*' --tests 'kr.co.vividnext.sodalive.v2.api.home.*'` 실행 결과 `BUILD SUCCESSFUL in 36s`를 확인했다.
+- 2026-06-08: Phase 6 포맷 검증: `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL in 19s`를 확인했다.
+- 2026-06-08: Phase 6 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 1m 10s`를 확인했다.
+- 2026-06-08: Phase 7 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest` 실행 결과 신규 로그 assertion 4건이 이벤트 로그 부재로 실패하는 것을 확인했다.
+- 2026-06-08: Phase 7 GREEN 확인: 동일 focused 테스트 재실행 결과 `BUILD SUCCESSFUL in 40s`를 확인했다.
+- 2026-06-08: Phase 7 ranking/API 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*' --tests 'kr.co.vividnext.sodalive.v2.api.home.*'` 실행 결과 `BUILD SUCCESSFUL in 39s`를 확인했다.
+- 2026-06-08: Phase 7 포맷 검증: `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL in 21s`를 확인했다.
+- 2026-06-08: Phase 7 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 1m 9s`를 확인했다.
+- 2026-06-08: Phase 7 reviewer gate 1차 검토: 스냅샷 생성 성공 로그가 transaction commit 이전에 기록되는 점과 PRD Metrics의 최종 점수 1점 미만 제외 수 관측 누락으로 `FAIL` 판정을 확인했다.
+- 2026-06-08: Phase 7 reviewer 수정 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest` 실행 결과 신규 `lowScoreExcludedCount` 테스트가 fake 미구현으로 `compileTestKotlin` 실패하는 것을 확인했다.
+- 2026-06-08: Phase 7 reviewer 수정 GREEN 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingAggregationRepositoryTest` 실행 결과 `BUILD SUCCESSFUL in 50s`를 확인했다.
+- 2026-06-08: Phase 7 reviewer 수정 후 ranking/API 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*' --tests 'kr.co.vividnext.sodalive.v2.api.home.*'` 실행 결과 `BUILD SUCCESSFUL in 37s`를 확인했다.
+- 2026-06-08: Phase 7 reviewer 수정 후 포맷 검증: `./gradlew ktlintCheck`는 최초 import 순서 위반으로 실패했고, import 정렬 후 재실행해 `BUILD SUCCESSFUL in 18s`를 확인했다.
+- 2026-06-08: Phase 7 reviewer 수정 후 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 1m 28s`를 확인했다.
+- 후속 구현 중 각 task 완료 시 실행 명령, 목적, 결과를 이 섹션에 누적한다.
+- 2026-06-09: 사용자 추가 요구에 따라 PRD와 plan-task에 스냅샷 job 이력, 스케줄 job 기록, 관리자 날짜 범위 수동 생성, 실패 job 관리자 전용 재시도 API, 스냅샷 테이블 완전 공백 시 제한적 fallback 계획을 문서화했다.
+- 2026-06-09: Phase 8 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotJobRepositoryTest --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobServiceTest` 실행 결과 신규 job port/entity/service 미구현으로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-09: Phase 8 GREEN 확인: 동일 focused 테스트 재실행 결과 `BUILD SUCCESSFUL in 15s`를 확인했다.
+- 2026-06-09: Phase 8 스케줄러 연결 검증: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobServiceTest` 실행 결과 `BUILD SUCCESSFUL in 4s`를 확인했다.
+- 2026-06-09: Phase 8 DDL 대체 검증: `rg -n "creator_ranking_snapshot_job|aggregation_start_at_utc|aggregation_end_at_utc|trigger_type|status|processing_started_at|processed_at|last_error" docs/20260608_크리에이터_랭킹/create-ranking-tables.sql`로 job 테이블명, 기간/트리거/상태/처리 시각/실패 사유 컬럼 및 index 문구를 확인했다.
+- 2026-06-09: Phase 8 ranking 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*'` 실행 결과 `BUILD SUCCESSFUL in 19s`를 확인했다.
+- 2026-06-09: Phase 8 포맷 검증: `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL in 14s`를 확인했다.
+- 2026-06-09: Phase 8 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 51s`를 확인했다.
+- 2026-06-09: Phase 8 reviewer gate 1차 검토: repository 테스트가 `PENDING` 저장 상태와 `PROCESSING` 전이를 직접 검증하지 않아 `FAIL` 판정을 확인했다.
+- 2026-06-09: Phase 8 reviewer 수정 후 focused 검증: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotJobRepositoryTest --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobServiceTest` 실행 결과 `BUILD SUCCESSFUL in 16s`를 확인했다.
+- 2026-06-09: Phase 8 reviewer 수정 후 포맷 검증: `./gradlew ktlintCheck`는 최초 unused import로 실패했고, import 제거 후 재실행해 `BUILD SUCCESSFUL in 6s`를 확인했다.
+- 2026-06-09: Phase 8 reviewer 수정 후 ranking 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*'` 실행 결과 `BUILD SUCCESSFUL in 15s`를 확인했다.
+- 2026-06-09: Phase 8 reviewer 수정 후 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 51s`를 확인했다.
+
+- 2026-06-09: Phase 9 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobServiceTest --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotJobRepositoryTest --tests kr.co.vividnext.sodalive.v2.admin.ranking.creator.AdminCreatorRankingSnapshotJobControllerTest` 실행 결과 신규 관리자 API 클래스, `createManualJob`/`findJobs`/`retryFailedJob`, `markPending` 미구현으로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-09: Phase 9 focused GREEN 및 관리자 API 표면 검증: retry 전이 guard 보강 후 동일 focused 테스트 재실행 결과 `BUILD SUCCESSFUL in 1m 21s`를 확인했다. `AdminCreatorRankingSnapshotJobControllerTest`의 `MockMvc` 요청으로 `POST /admin/rankings/creators/snapshot-jobs`, `GET /admin/rankings/creators/snapshot-jobs`, `POST /admin/rankings/creators/snapshot-jobs/{jobId}/retry`의 성공 응답과 비관리자 403/익명 401을 검증했다.
+- 2026-06-09: Phase 9 ranking/admin 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*' --tests 'kr.co.vividnext.sodalive.v2.admin.ranking.creator.*'` 실행 결과 최초 병렬 Gradle 실행 중 Kotlin/kapt cache 경합으로 실패했고, 단독 재실행해 `BUILD SUCCESSFUL in 23s`를 확인했다.
+- 2026-06-09: Phase 9 포맷 검증: `./gradlew ktlintCheck`는 최초 테스트 파일 닫는 brace 앞 공백과 main import 순서 위반으로 실패했고, 정리 후 재실행해 `BUILD SUCCESSFUL in 11s`를 확인했다.
+- 2026-06-09: Phase 9 전체 회귀 검증: retry 전이 guard 보강 후 `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 1m 20s`를 확인했다.
+- 2026-06-09: Phase 10 Task 10.1 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.DefaultCreatorRankingSnapshotRepositoryTest` 실행 결과 `isSnapshotTableEmpty` 미구현으로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-09: Phase 10 Task 10.1 GREEN 확인: 동일 focused 테스트 재실행 결과 `BUILD SUCCESSFUL in 27s`를 확인했다.
+- 2026-06-09: Phase 10 Task 10.2 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest` 실행 결과 `aggregationPort`, `nowProvider` 생성자 파라미터 미구현으로 `compileTestKotlin` 실패를 확인했다.
+- 2026-06-09: Phase 10 Task 10.2 GREEN 확인: 동일 focused 테스트 재실행 결과 `BUILD SUCCESSFUL in 42s`를 확인했다.
+- 2026-06-09: Phase 10 Task 10.3 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobServiceTest` 실행 결과 fallback/job 로그 이벤트 부재로 신규 로그 테스트 4건 실패를 확인했다.
+- 2026-06-09: Phase 10 Task 10.3 GREEN 확인: 동일 focused 테스트 재실행 결과 `BUILD SUCCESSFUL in 10s`를 확인했다.
+- 2026-06-09: Phase 10 ranking/API 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*' --tests 'kr.co.vividnext.sodalive.v2.api.home.*'` 실행 결과 `BUILD SUCCESSFUL in 40s`를 확인했다.
+- 2026-06-09: Phase 10 포맷 검증: `./gradlew ktlintCheck`는 최초 테스트 import 순서 위반으로 실패했고, import 정렬 후 재실행해 `BUILD SUCCESSFUL in 6s`를 확인했다.
+- 2026-06-09: Phase 10 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 59s`를 확인했다.
+- 2026-06-09: Phase 10 reviewer gate 1차 검토: cold-start fallback 경로에서 인증 회원의 차단 크리에이터 마스킹이 누락되어 `FAIL` 판정을 확인했다.
+- 2026-06-09: Phase 10 reviewer 수정 RED 확인: `./gradlew test --tests kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryServiceTest` 실행 결과 fallback 차단 마스킹 신규 테스트 1건 실패를 확인했다.
+- 2026-06-09: Phase 10 reviewer 수정 GREEN 확인: fallback 결과에도 기존 차단 마스킹을 적용한 뒤 동일 focused 테스트 재실행 결과 `BUILD SUCCESSFUL in 6s`를 확인했다.
+- 2026-06-09: Phase 10 reviewer 수정 후 ranking/API 범위 회귀 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.ranking.*' --tests 'kr.co.vividnext.sodalive.v2.api.home.*'` 실행 결과 `BUILD SUCCESSFUL in 30s`를 확인했다.
+- 2026-06-09: Phase 10 reviewer 수정 후 포맷 검증: `./gradlew ktlintCheck` 실행 결과 `BUILD SUCCESSFUL in 15s`를 확인했다.
+- 2026-06-09: Phase 10 reviewer 수정 후 전체 회귀 검증: `./gradlew test` 실행 결과 `BUILD SUCCESSFUL in 56s`를 확인했다.
+- 2026-06-09: Phase 10 reviewer 수정 후 follow-up gate: 목표/보안 검증, 코드 품질 검토, QA focused 검증이 모두 `PASS` 판정을 반환했고 blocking issue가 없음을 확인했다.

docs/20260608_크리에이터_랭킹/prd.md

@@ -0,0 +1,285 @@
+# PRD: 크리에이터 랭킹
+
+## 1. Overview
+지난 주 월요일 00:00:00 KST부터 일요일 23:59:59.999999999 KST까지의 활동 데이터를 기준으로 크리에이터 랭킹 점수를 계산하고, 최종 점수 상위 20명을 조회할 수 있는 기능을 제공한다.
+
+---
+
+## 2. Problem
+- 크리에이터의 매출, 콘텐츠 반응, 응원, 팬 충성도를 한 번에 비교할 수 있는 주간 랭킹 기준이 필요하다.
+- 서버 시스템 timezone이 UTC로 동작하더라도 랭킹 산정 기간은 KST 기준 지난 주 월요일부터 일요일까지로 고정되어야 한다.
+- DB와 서버 timezone은 UTC이므로, KST 기준으로 산출한 랭킹 기간을 UTC 조회 조건으로 변환해 원천 데이터를 조회해야 한다.
+- 계산 산식이 여러 도메인 데이터에 걸쳐 있어 조회 API 내부에 직접 구현하면 테스트와 스냅샷 기반 성능 개선이 어려워진다.
+- 동일한 랭킹 산식을 주간 스냅샷 생성, 운영 조회, 캐시 갱신에서 재사용할 수 있도록 계산 책임과 조회 책임을 분리해야 한다.
+
+---
+
+## 3. Goals
+- KST 기준 지난 주 월요일부터 일요일까지의 주간 크리에이터 랭킹을 계산한다.
+- 최종 점수 기준 상위 20명의 크리에이터를 조회할 수 있다.
+- 랭킹 계산 산식은 독립된 application/domain 컴포넌트로 분리한다.
+- 계산 기간 산출은 서버 기본 timezone에 의존하지 않고 명시적으로 `Asia/Seoul` 기준을 사용한다.
+- KST 기준 집계 시작/종료 시각을 UTC 기준 조회 시작/종료 시각으로 변환한 뒤 DB 데이터를 조회한다.
+- 각 점수 카테고리의 원천 지표와 가중치를 테스트 가능한 형태로 관리한다.
+- 조회 시 매번 무거운 원천 집계를 수행하지 않도록 주간 랭킹 계산 결과를 스냅샷으로 저장한다.
+- 추후 성능 개선을 위해 캐시 저장소를 추가할 수 있는 포트 경계를 둔다.
+
+---
+
+## 4. Non-Goals
+- 이번 PRD에서는 별도 관리자 화면 신규 개발을 포함하지 않는다. 단, 기존 관리자 영역에서 호출할 수 있는 스냅샷 수동 생성/재시도용 관리자 전용 API는 포함한다.
+- 크리에이터 랭킹 산식의 머신러닝 모델화, 개인화, A/B 테스트는 포함하지 않는다.
+- 실시간 랭킹 또는 현재 주 진행 중 랭킹은 포함하지 않는다. 단, 스냅샷 테이블이 완전히 비어 있는 초기 상태에서만 제한적으로 원천 데이터 fallback 집계를 시도할 수 있다.
+- 기존 공개 API 스키마를 임의 변경하지 않는다.
+- 랭킹 결과 수동 보정 기능은 포함하지 않는다.
+- 점수 산식의 가중치를 관리자에서 동적으로 수정하는 기능은 포함하지 않는다.
+
+---
+
+## 5. Target Users
+- 회원: 주간 인기 크리에이터를 탐색하는 사용자
+- 앱 클라이언트: 랭킹 화면에 상위 크리에이터 목록과 순위/순위 변화 정보를 노출하는 클라이언트
+- 운영자: 주간 크리에이터 성과를 확인하고 랭킹 산식의 결과를 검증하는 내부 사용자
+
+---
+
+## 6. User Stories
+- 사용자는 지난 주 기준으로 가장 높은 최종 점수를 받은 크리에이터 20명을 보고 싶다.
+- 사용자는 랭킹 순위, 지난 주 대비 순위 변화, 크리에이터 프로필 이미지, 닉네임을 확인하고 싶다.
+- 앱 클라이언트는 홈 내부 랭킹 탭에서 동일한 API 응답으로 랭킹 화면을 구성하고 크리에이터 상세로 이동하고 싶다.
+- 운영자는 특정 크리에이터의 최종 점수가 어떤 카테고리 점수로 구성되었는지 추적할 수 있어야 한다.
+- 개발자는 시스템 timezone이 UTC여도 KST 기준 집계 기간이 흔들리지 않는지 테스트로 확인하고 싶다.
+
+---
+
+## 7. Core Features
+
+### Feature A. 주간 랭킹 기간 산출
+
+#### Requirements
+- 랭킹 대상 기간은 조회 시점 기준 "지난 주 월요일 00:00:00 KST 이상, 이번 주 월요일 00:00:00 KST 미만"으로 계산한다.
+- 예를 들어 2026-06-08 월요일 KST에 조회하면 대상 기간은 2026-06-01 00:00:00 KST 이상, 2026-06-08 00:00:00 KST 미만이다.
+- 서버 기본 timezone이 UTC여도 기간 산출은 `Asia/Seoul` 기준으로 수행한다.
+- DB와 서버 timezone은 UTC이므로, KST 기준 기간을 UTC 기준 `Instant` 또는 프로젝트 표준 시간 타입으로 변환해 DB 조회 조건에 사용한다.
+- 예를 들어 2026-06-01 00:00:00 KST 이상, 2026-06-08 00:00:00 KST 미만은 2026-05-31 15:00:00 UTC 이상, 2026-06-07 15:00:00 UTC 미만으로 변환해 조회한다.
+
+#### Edge Cases
+- 월요일 00:00:00 KST 직후 조회해도 방금 시작한 이번 주 데이터가 포함되지 않아야 한다.
+- 연도/월 경계를 넘어가는 주차도 동일한 규칙으로 계산한다.
+- DST가 없는 KST 기준을 사용하되, 구현은 `ZoneId.of("Asia/Seoul")`처럼 명시적인 timezone을 사용한다.
+
+### Feature B. 콘텐츠 + 라이브 점수
+
+#### Requirements
+- 콘텐츠 + 라이브 점수는 라이브 계열 매출 합산 지표 70%, 콘텐츠 구매 합산 지표 30%로 계산한다.
+- 라이브 계열 매출 합산 지표는 `CanUsage.DONATION`, `CanUsage.LIVE`, `CanUsage.SPIN_ROULETTE`의 사용 캔 합계로 계산한다.
+- 콘텐츠 구매 합산 지표는 `CanUsage.ORDER_CONTENT` 1종의 사용 캔 합계로 계산한다.
+- 환불된 사용 내역은 점수 계산에서 제외한다.
+- 크리에이터별 기간 내 합계를 원천 지표로 보관하거나 응답 내부 추적이 가능해야 한다.
+
+#### Edge Cases
+- 라이브 또는 콘텐츠 구매 데이터가 없으면 해당 지표는 0점으로 계산한다.
+- 음수 캔 또는 환불 데이터가 섞여 있으면 기존 `UseCan` 환불 정책과 동일한 방식으로 제외한다.
+
+### Feature C. 참여 반응 점수
+
+#### Requirements
+- 참여 반응 점수는 콘텐츠 좋아요 수 50%, 콘텐츠 댓글 수 50%로 계산한다.
+- 콘텐츠 좋아요 수는 기간 내 활성 콘텐츠 좋아요 수를 크리에이터별로 합산한다.
+- 콘텐츠 댓글 수는 기간 내 활성 콘텐츠 댓글과 대댓글 수를 크리에이터별로 합산한다.
+- 해당 콘텐츠의 크리에이터가 직접 작성한 댓글과 대댓글은 콘텐츠 댓글 수에서 제외한다.
+- 비활성 콘텐츠, 삭제 또는 비활성 처리된 좋아요/댓글은 기존 도메인 정책에 맞춰 제외한다.
+
+#### Edge Cases
+- 좋아요 또는 댓글이 없으면 해당 지표는 0점으로 계산한다.
+- 콘텐츠 댓글 수가 없거나 크리에이터 본인 댓글/대댓글만 있으면 댓글 지표는 0점으로 계산한다.
+
+### Feature D. 응원 점수
+
+#### Requirements
+- 응원 점수는 채널 후원 캔 합계 60%, 채널 후원 수 20%, 팬 Talk 수 20%로 계산한다.
+- 채널 후원 캔 합계는 `CanUsage.CHANNEL_DONATION`의 사용 캔 합계로 계산한다.
+- 채널 후원 수는 `CanUsage.CHANNEL_DONATION` 사용 건수로 계산한다.
+- 팬 Talk 수는 기존 `CreatorCheers`의 최상위 등록 수로 계산하고 답글은 포함하지 않는다.
+- 환불된 채널 후원 내역은 점수 계산에서 제외한다.
+
+#### Edge Cases
+- 채널 후원 또는 팬 Talk 데이터가 없으면 해당 지표는 0점으로 계산한다.
+- 팬 Talk 답글이 별도 row로 저장되어 있어도 팬 Talk 수에 포함하지 않는다.
+
+### Feature E. 팬 충성도 점수
+
+#### Requirements
+- 팬 충성도 점수는 최종 팔로우 수 70%, 팔로우 증가 수 30%로 계산한다.
+- 최종 팔로우 수는 랭킹 대상 기간 종료 시점 기준 활성 팔로우 수를 의미한다.
+- 팔로우 증가 수는 랭킹 대상 기간 동안 활성 팔로우 수가 몇 명 증가했는지를 의미한다.
+- 기본 정의는 `기간 내 신규 활성 팔로우 수 - 기간 내 비활성화된 팔로우 수`로 한다.
+- 신규 활성 팔로우 수는 `CreatorFollowing.createdAt`이 랭킹 대상 기간 안에 있는 팔로우만 집계한다.
+- 비활성화된 팔로우 수는 `CreatorFollowing.isActive == false`이고 `CreatorFollowing.updatedAt`이 랭킹 대상 기간 안에 있는 팔로우만 집계한다.
+- 과거 언팔로우 후 기간 내 재팔로우한 경우는 `createdAt`이 과거 시점이므로 신규 증가로 반영하지 않는다.
+- 이번 산식은 현재 `creator_following` row의 `createdAt`, `updatedAt`, `isActive` 기준으로 계산하며, 한 기간 안에서 여러 번 발생한 팔로우/언팔로우 이벤트 히스토리까지 별도로 복원하지 않는다.
+- 팔로우 증가 수가 음수이면 음수 원천 지표와 음수 카테고리 점수를 허용하고, 최종 점수에 그대로 반영한다.
+
+#### Edge Cases
+- 기간 내 재팔로우로 다시 활성화된 팔로우는 최종 팔로우 수에는 포함될 수 있지만 팔로우 증가 수의 신규 생성분에는 포함하지 않는다.
+- 기간 내 언팔로우 후 재팔로우해 최종 상태가 활성인 row는 `isActive == false` 조건에 걸리지 않으므로 비활성화된 팔로우 수에도 포함하지 않는다.
+
+### Feature F. 최종 점수 계산 및 정렬
+
+#### Requirements
+- 최종 점수는 `(콘텐츠/라이브 카테고리 점수 * 0.35) + (참여 반응 점수 * 0.30) + (응원 점수 * 0.25) + (팬 충성도 점수 * 0.10)`으로 계산한다.
+- 최종 점수 1점 이상인 크리에이터만 랭킹에 포함한다.
+- 최종 점수 내림차순으로 최대 20명을 조회한다.
+- 동점자는 랜덤으로 추출한다.
+- 스냅샷에는 최종 점수 1점 이상인 모든 후보를 저장하지 않고, Top 20 산정에 필요한 후보만 저장한다.
+- Top 20 산정에 필요한 후보는 20위 점수보다 높은 후보와 20위 점수에 동점인 후보 전체를 의미한다.
+- 조회 시 스냅샷에 저장된 후보 중 최종 점수 동점자를 랜덤 정렬해 상위 20명을 추출한다.
+- 동점 랜덤 추출을 위한 별도 `randomTieBreaker` 값은 스냅샷에 저장하지 않는다.
+- 각 하위 지표는 0~100 정규화하지 않고 원천 값(raw value)을 그대로 사용한다.
+- 캔 단위 지표는 좋아요, 댓글, 팔로우 같은 개수 지표보다 최종 점수에 더 큰 영향을 줄 수 있으며, 이는 의도된 정책이다.
+
+#### Edge Cases
+- 특정 지표 값이 없으면 해당 원천 값은 0으로 계산한다.
+- 최종 점수가 1점 미만이면 20명이 되지 않아도 응답에서 제외한다.
+
+### Feature G. 랭킹 조회 API
+
+#### Requirements
+- 홈 내부 랭킹 탭에서 주간 크리에이터 랭킹 상위 20명을 조회하는 API를 제공한다.
+- API endpoint는 `GET /api/v2/home/rankings/creators`를 사용한다.
+- API는 최신 완료 주차의 스냅샷을 기준으로 조회하며 별도 query parameter 없이 기본 랭킹을 반환한다.
+- 응답에는 순위 변화 표시 여부, 순위, 지난 주 대비 순위 변화, 신규 진입 여부, 크리에이터 id, 닉네임, 프로필 이미지를 포함한다.
+- `showRankChange`는 `items`와 같은 레벨에 내려주며, 클라이언트가 순위 변화 UI를 표시할지 판단하는 값이다.
+- 각 크리에이터의 순위 변화 값은 `items[].rankChange`에 숫자로 내려준다.
+- 순위가 올라갔으면 양수, 순위가 내려갔으면 음수로 내려준다.
+- 예를 들어 직전 완료 주차 10위, 최신 완료 주차 5위이면 `rankChange`는 `5`다.
+- 예를 들어 직전 완료 주차 1위, 최신 완료 주차 10위이면 `rankChange`는 `-9`다.
+- 직전 완료 주차에는 순위에 없고 최신 완료 주차에 진입한 크리에이터는 `items[].isNew == true`로 내려주며, 클라이언트는 이를 `New`로 표시한다.
+- 신규 진입 크리에이터의 `rankChange`는 비교 가능한 이전 순위가 없으므로 `null`로 내려준다.
+- 응답의 크리에이터 id는 크리에이터 상세 이동에 사용한다.
+- 응답 스키마 예시는 다음과 같다.
+
+```json
+{
+  "showRankChange": true,
+  "items": [
+    {
+      "rank": 1,
+      "rankChange": 5,
+      "isNew": false,
+      "creatorId": 123,
+      "nickname": "creator",
+      "profileImageUrl": "https://cdn.example.com/profile.png"
+    },
+    {
+      "rank": 2,
+      "rankChange": null,
+      "isNew": true,
+      "creatorId": 456,
+      "nickname": "new creator",
+      "profileImageUrl": "https://cdn.example.com/profile-new.png"
+    }
+  ]
+}
+```
+
+- 운영 검증 또는 디버깅이 필요하면 카테고리별 점수와 원천 지표를 내부용 응답 또는 로그로 확인할 수 있어야 한다.
+- 비활성 및 탈퇴 크리에이터는 랭킹에 노출하지 않는다.
+- 조회자와 크리에이터 사이에 차단 관계가 있으면 랭킹 row는 유지하되 응답의 크리에이터 id는 `0`, 닉네임은 빈 문자열로 내려준다.
+- 차단 관계가 있는 크리에이터의 프로필 이미지는 기본 이미지 URL로 내려주고, 이동 대상 id는 `0`으로 내려준다.
+- 인증 사용자 조건이 필요하지 않은 공개 조회를 기본으로 하되, 차단 마스킹 정책은 인증 사용자에게 적용한다.
+- 조회 API는 스냅샷 기반 응답을 기본으로 하며, 공개 API 응답 스키마는 fallback 여부와 관계없이 변경하지 않는다.
+- 스냅샷 테이블이 완전히 비어 있는 초기 상태에서만 조회 API가 제한적으로 원천 데이터 fallback 집계를 시도할 수 있다.
+- 스냅샷 테이블에 과거 스냅샷이 하나라도 있으면 원천 데이터 fallback을 시도하지 않고 최신 완료 주차 스냅샷 기준으로 응답한다.
+
+#### Edge Cases
+- 최종 점수 1점 이상인 랭킹 후보가 20명 미만이면 가능한 만큼만 내려준다.
+- 랭킹 계산 결과가 없으면 빈 배열로 성공 응답한다.
+- 최신 완료 주차 스냅샷이 없고 스냅샷 테이블도 완전히 비어 있으면 제한적 원천 데이터 fallback 집계를 시도한 뒤 결과를 응답한다.
+- 스냅샷 테이블에 과거 스냅샷이 하나라도 있으면 원천 데이터 fallback을 시도하지 않고 기존 최신 완료 주차 스냅샷 기준 응답을 유지한다.
+- 직전 완료 주차 스냅샷이 없으면 `showRankChange`는 `false`로 내려주고, 각 item의 `rankChange`는 `null`, `isNew`는 `false`로 내려준다.
+
+### Feature H. 주간 랭킹 스냅샷
+
+#### Requirements
+- 주간 랭킹은 조회 시 매번 원천 데이터를 집계하지 않고, 계산 결과를 스냅샷으로 저장한 뒤 조회 API는 스냅샷을 읽는다.
+- 스냅샷 생성 기준 기간은 KST 기준 지난 주 월요일 00:00:00 이상, 이번 주 월요일 00:00:00 미만이다.
+- 스냅샷 생성 시 원천 데이터 조회 조건은 KST 집계 기간을 UTC로 변환한 기간을 사용한다.
+- 스냅샷 저장 대상은 20위 점수보다 높은 후보와 20위 점수에 동점인 후보 전체로 제한한다.
+- 최종 점수 1점 이상인 후보가 20명 미만이면 해당 후보만 저장한다.
+- 스냅샷은 크리에이터 id, 최종 점수, 카테고리별 점수, 원천 지표, 집계 시작/종료 시각을 저장한다.
+- 최종 순위는 스냅샷 저장 시 고정하지 않고 조회 시 최종 점수 내림차순과 동점 랜덤 정렬 결과에 따라 부여한다.
+- 순위 변화는 최신 완료 주차 응답에서 부여된 순위와 직전 완료 주차 스냅샷 기준 순위를 비교해 계산한다.
+- 동점 랜덤 정렬 정책 때문에 동점 구간에 포함된 크리에이터의 순위와 순위 변화는 조회 결과마다 달라질 수 있으며, 이는 허용한다.
+- 스냅샷 생성은 이번 주 데이터가 포함되지 않도록 주간 집계 대상 기간이 종료된 뒤 실행한다.
+- 기본 스케줄 후보는 매주 월요일 KST 07:30이며, 스케줄러는 `Asia/Seoul` zone을 명시한다.
+- 다중 서버 인스턴스에서 같은 스케줄이 동시에 실행되더라도 클러스터 전체에서 한 인스턴스만 스냅샷 생성을 수행해야 한다.
+- 클러스터 단일 실행은 신규 DB 테이블을 추가하지 않고, 기존 프로젝트에 설정된 Redisson 기반 분산 lock을 우선 사용한다.
+- 주간 랭킹 스냅샷 lock key는 `lock:creator-ranking-snapshot-refresh`를 사용하며, lock 획득 실패 인스턴스는 스냅샷 생성을 skip한다.
+- 같은 집계 기간에 대해 스냅샷을 재생성할 수 있어야 하며, 재생성 시 기존 같은 기간 스냅샷을 중복 노출하지 않는다.
+- 조회 API는 최신 완료 주차의 스냅샷을 기준으로 응답한다.
+- 스냅샷 생성 직전 집계 시작/종료 시각을 포함한 job 이력을 생성하고, 작업 완료 후 성공/실패 상태와 처리 결과를 기록한다.
+- 스케줄러로 실행되는 주간 스냅샷 생성도 job 이력으로 기록한다.
+- 운영자는 관리자 전용 API를 통해 날짜 범위를 직접 선택해 스냅샷 생성 job을 생성할 수 있어야 한다.
+- 실패한 스냅샷 생성 job은 관리자 전용 재시도 API로 재시도할 수 있어야 하며, 기존 관리자 job 패턴과 같이 실패 상태 job을 대기 상태로 되돌려 worker가 다시 처리하도록 한다.
+- 관리자 전용 job 목록 API는 날짜 범위, 실행 트리거, 상태, 실패 사유, 재시도 가능 여부를 확인할 수 있어야 한다.
+
+#### Edge Cases
+- 최신 완료 주차 스냅샷이 없고 스냅샷 테이블이 완전히 비어 있으면 제한적 원천 데이터 fallback 집계를 시도하고, fallback 성공/실패를 장애 추적용 로그로 남긴다.
+- 스냅샷 테이블에 과거 스냅샷이 하나라도 있으면 원천 데이터 fallback을 시도하지 않고 최신 완료 주차 스냅샷 기준 응답을 유지한다.
+- 스냅샷 생성 중 일부 원천 집계가 실패하면 해당 주차 스냅샷 저장을 실패 처리하고 부분 결과를 공개하지 않는다.
+- Redisson lock 획득 실패는 다른 인스턴스가 같은 작업을 수행 중인 정상 skip으로 처리하고, 스냅샷 생성 실패로 집계하지 않는다.
+- 실패 job 재시도 API는 실패 상태 job만 대상으로 하며, 이미 대기/처리 중/성공 상태인 job은 재시도 대상으로 변경하지 않는다.
+
+### Feature I. 랭킹 계산 컴포넌트 분리
+
+#### Requirements
+- 랭킹 계산과 조회는 Controller나 Facade 내부에 직접 구현하지 않고 별도 application/domain 컴포넌트로 분리한다.
+- 크리에이터 랭킹 기능 본체는 추천 기능과 독립된 성격이므로 `v2.recommendation`가 아니라 별도 `kr.co.vividnext.sodalive.v2.ranking` 하위 패키지에 작성한다.
+- 예시 컴포넌트는 다음 책임을 갖는다.
+  - 기간 계산 정책: KST 기준 지난 주 기간을 산출한다.
+  - 점수 정책: 원천 지표의 raw value에 가중치를 적용해 카테고리/최종 점수를 계산한다.
+  - 집계 포트: `UseCan`, 콘텐츠 반응, `CreatorCheers`, `CreatorFollowing` 원천 데이터를 조회한다.
+  - 스냅샷 생성 서비스: 원천 지표를 집계하고 랭킹 스냅샷을 저장한다.
+  - 조회 서비스: 저장된 스냅샷을 상위 20명 ranking 조회 결과로 조립한다.
+  - 홈 API 조합 Facade: ranking 조회 결과를 클라이언트 공개 응답 DTO로 변환한다.
+- 추후 캐싱을 추가할 수 있도록 조회 서비스는 스냅샷 조회 포트와 캐시 포트를 분리할 수 있는 경계를 둔다.
+
+#### Edge Cases
+- 캐시가 추가되더라도 산식 테스트는 캐시와 분리된 순수 정책 테스트로 유지한다.
+- 조회 API는 스냅샷 기반 응답을 기본으로 하며, 스냅샷 테이블이 완전히 비어 있는 초기 상태를 제외하고 원천 데이터 실시간 계산 fallback을 두지 않는다.
+
+---
+
+## 8. Technical Constraints
+- Kotlin, Spring Boot 2.7.14, Java 17, Gradle Wrapper 구조를 유지한다.
+- 랭킹 계산, 스냅샷 생성, 스냅샷 조회, 차단 마스킹 등 기능 본체는 `kr.co.vividnext.sodalive.v2.ranking` 하위에 작성한다.
+- 클라이언트 endpoint는 홈 내부 랭킹 탭에서 호출하므로 `/api/v2/home/rankings/creators`를 사용한다.
+- 클라이언트 공개 API 표면인 Controller와 API 조합 Facade는 기존 홈 API 관례를 따라 `kr.co.vividnext.sodalive.v2.api.home` 하위에 작성하고, 크리에이터 랭킹 응답 DTO는 `kr.co.vividnext.sodalive.v2.api.home.dto.ranking` 하위에 작성한다.
+- 기존 엔티티 후보는 `UseCan`, `CanUsage`, `AudioContent`, `AudioContentLike`, `AudioContentComment`, `CreatorCheers`, `CreatorFollowing`, `Member` 등이다.
+- 기존 공개 API 스키마는 변경하지 않는다.
+- 계산 기간은 서버 기본 timezone이 아니라 명시적인 KST 기준으로 산출하고, DB 조회 시에는 UTC 기간으로 변환한다.
+- QueryDSL 또는 native SQL 중 기존 성능/패턴에 맞는 방식을 선택하되, 산식 자체는 테스트 가능한 domain/application 정책으로 분리한다.
+- 주간 랭킹 조회는 스냅샷 기반으로 제공한다.
+- 캐싱은 이번 PRD의 필수 구현은 아니지만, 랭킹 조회 서비스가 캐시 포트를 도입할 수 있는 구조여야 한다.
+- 스냅샷 스케줄러는 기존 Redisson 설정을 재사용해 클러스터 단일 실행을 보장하고, 별도 scheduler lock용 DB 테이블은 추가하지 않는다.
+
+---
+
+## 9. Metrics
+- 랭킹 조회 API latency
+- 랭킹 계산 소요 시간
+- 주간 스냅샷 생성 성공/실패 수
+- 주간 스냅샷 생성 지연 시간
+- 스냅샷 job 상태별 수와 실패 job 재시도 수
+- 관리자 수동 생성 job 요청 수와 성공/실패 수
+- 스냅샷 테이블 완전 공백 fallback 시도/성공/실패 수
+- 랭킹 후보 크리에이터 수
+- 최종 점수 1점 미만으로 제외된 크리에이터 수
+- 랭킹 조회 성공/실패 로그 수
+- 캐시 도입 후 cache hit ratio
+
+---
+
+## 10. Open Questions
+현재 PRD 기준 미결정 항목은 없다.

docs/agent-guides/문서유지보수.md

@@ -22,6 +22,9 @@
 - `.editorconfig` 변경 시 포맷 규칙 섹션을 동기화한다.
 - 연속된 하나의 작업에 대해 PRD 또는 구현 계획/TASK 문서가 여러 개 생기지 않도록 기존 문서 재사용 여부를 먼저 확인한다.
 - 문서 변경 후 최소 한 번 `./gradlew tasks --all`로 명령 유효성을 확인한다.
+- 운영 DB 반영용 DDL 문서는 MySQL 기준으로 작성한다.
+- DDL 작성 시 날짜/시간 표시 컬럼은 `TIMESTAMP` 타입을 사용하고, `created_at`은 `TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '생성 시각'`, `updated_at`은 `TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '수정 시각'` 형식을 기본으로 한다.
+- DDL의 모든 컬럼에는 MySQL `COMMENT`를 추가하고, 테이블에도 가능한 경우 `COMMENT`를 남긴다.
 - 불확실한 규칙은 추측으로 채우지 말고 근거 파일 경로를 먼저 확인한다.
 - 에이전트 안내 문구는 한국어 중심으로 유지한다.
 - 커밋 규칙 예시는 팀 컨벤션 변경 시 즉시 업데이트한다.

docs/agent-guides/코드스타일.md

@@ -64,6 +64,11 @@
 - 비동기 처리는 Kotlin Coroutines 패턴을 따른다.
 - `CoroutineScope(Dispatchers.IO)` + `launch` + 예외 처리 패턴을 일관되게 유지한다.
 - 생명주기 종료 시 scope 정리(`@PreDestroy`) 패턴을 참고한다.
+- 다중 서버 인스턴스에서 같은 `@Scheduled` 작업이 동시에 실행될 수 있는 스케줄러는 Redisson 기반 분산 lock을 적용해 클러스터 전체에서 한 인스턴스만 작업을 실행하도록 한다.
+- 스케줄러 분산 lock은 기존 `RedissonClient` bean을 재사용하고, lock key는 작업 목적이 드러나도록 `lock:{job-name}` 형식으로 고정한다.
+- lock 획득 실패는 다른 인스턴스가 처리 중인 정상 skip으로 보고, 작업 본문은 lock을 획득한 경우에만 실행한다.
+- lock 해제는 `finally`에서 `lock.isHeldByCurrentThread` 확인 후 `unlock()`한다.
+- 스케줄러 작업 시간이 예측 가능하면 무기한 watchdog 의존보다 최악 실행 시간에 여유를 더한 명시적 `leaseTime`을 우선 검토한다.
 
 ### 10) 의존성 주입
 - 생성자 주입(primary constructor + `private val`)을 기본으로 사용한다.

src/main/kotlin/kr/co/vividnext/sodalive/configs/SecurityConfig.kt

@@ -102,6 +102,7 @@ class SecurityConfig(
             .antMatchers(HttpMethod.GET, "/api/chat/original/list").permitAll()
             .antMatchers(HttpMethod.POST, "/charge/payverse/webhook").permitAll()
             .antMatchers(HttpMethod.GET, "/api/v2/home/recommendations").permitAll()
+            .antMatchers(HttpMethod.GET, "/api/v2/home/rankings/creators").permitAll()
             // 페이지네이션 하위 경로(/lives, /debut-creators 등)는 인증 필수
             .antMatchers(HttpMethod.GET, "/api/v2/home/recommendations/**").authenticated()
             .anyRequest().authenticated()

src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt

@@ -39,7 +39,7 @@ import kr.co.vividnext.sodalive.member.Member
 import kr.co.vividnext.sodalive.member.block.BlockMemberRepository
 import kr.co.vividnext.sodalive.member.contentpreference.isAdultVisibleByPolicy
 import kr.co.vividnext.sodalive.utils.generateFileName
-import kr.co.vividnext.sodalive.v2.recommend.application.CreatorContentViewHistoryService
+import kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryService
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.cache.annotation.Cacheable

src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobController.kt

@@ -0,0 +1,54 @@
+package kr.co.vividnext.sodalive.v2.admin.ranking.creator
+
+import kr.co.vividnext.sodalive.common.ApiResponse
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import org.springframework.format.annotation.DateTimeFormat
+import org.springframework.security.access.prepost.PreAuthorize
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.PathVariable
+import org.springframework.web.bind.annotation.PostMapping
+import org.springframework.web.bind.annotation.RequestBody
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RequestParam
+import org.springframework.web.bind.annotation.RestController
+import java.time.LocalDateTime
+
+@RestController
+@RequestMapping("/admin/rankings/creators/snapshot-jobs")
+@PreAuthorize("hasRole('ADMIN')")
+class AdminCreatorRankingSnapshotJobController(
+    private val service: AdminCreatorRankingSnapshotJobService
+) {
+    @PostMapping
+    fun createManualJob(
+        @RequestBody request: AdminCreatorRankingSnapshotJobRequest
+    ): ApiResponse<AdminCreatorRankingSnapshotJobResponse> {
+        return ApiResponse.ok(service.createManualJob(request))
+    }
+
+    @GetMapping
+    fun getJobs(
+        @RequestParam
+        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
+        aggregationStartAtUtc: LocalDateTime,
+        @RequestParam
+        @DateTimeFormat(iso = DateTimeFormat.ISO.DATE_TIME)
+        aggregationEndAtUtc: LocalDateTime,
+        @RequestParam(required = false)
+        statuses: List<CreatorRankingSnapshotJobStatus>?
+    ): ApiResponse<List<AdminCreatorRankingSnapshotJobResponse>> {
+        return ApiResponse.ok(
+            service.getJobs(
+                aggregationStartAtUtc = aggregationStartAtUtc,
+                aggregationEndAtUtc = aggregationEndAtUtc,
+                statuses = statuses ?: CreatorRankingSnapshotJobStatus.values().toList()
+            )
+        )
+    }
+
+    @PostMapping("/{jobId}/retry")
+    fun retry(@PathVariable jobId: Long): ApiResponse<Unit> {
+        service.retry(jobId)
+        return ApiResponse.ok(Unit)
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobRequest.kt

@@ -0,0 +1,8 @@
+package kr.co.vividnext.sodalive.v2.admin.ranking.creator
+
+import java.time.LocalDateTime
+
+data class AdminCreatorRankingSnapshotJobRequest(
+    val aggregationStartAtUtc: LocalDateTime,
+    val aggregationEndAtUtc: LocalDateTime
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobResponse.kt

@@ -0,0 +1,34 @@
+package kr.co.vividnext.sodalive.v2.admin.ranking.creator
+
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobRecord
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobTrigger
+import java.time.LocalDateTime
+
+data class AdminCreatorRankingSnapshotJobResponse(
+    val id: Long,
+    val aggregationStartAtUtc: LocalDateTime,
+    val aggregationEndAtUtc: LocalDateTime,
+    val trigger: CreatorRankingSnapshotJobTrigger,
+    val status: CreatorRankingSnapshotJobStatus,
+    val lastError: String?,
+    val retryable: Boolean,
+    val processingStartedAt: LocalDateTime?,
+    val processedAt: LocalDateTime?
+) {
+    companion object {
+        fun from(job: CreatorRankingSnapshotJobRecord): AdminCreatorRankingSnapshotJobResponse {
+            return AdminCreatorRankingSnapshotJobResponse(
+                id = job.id!!,
+                aggregationStartAtUtc = job.aggregationStartAtUtc,
+                aggregationEndAtUtc = job.aggregationEndAtUtc,
+                trigger = job.trigger,
+                status = job.status,
+                lastError = job.lastError,
+                retryable = job.status == CreatorRankingSnapshotJobStatus.FAILED,
+                processingStartedAt = job.processingStartedAt,
+                processedAt = job.processedAt
+            )
+        }
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobService.kt

@@ -0,0 +1,40 @@
+package kr.co.vividnext.sodalive.v2.admin.ranking.creator
+
+import kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobService
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
+import java.time.LocalDateTime
+
+@Service
+@Transactional(readOnly = true)
+class AdminCreatorRankingSnapshotJobService(
+    private val jobService: CreatorRankingSnapshotJobService
+) {
+    @Transactional
+    fun createManualJob(request: AdminCreatorRankingSnapshotJobRequest): AdminCreatorRankingSnapshotJobResponse {
+        return AdminCreatorRankingSnapshotJobResponse.from(
+            jobService.createManualJob(
+                aggregationStartAtUtc = request.aggregationStartAtUtc,
+                aggregationEndAtUtc = request.aggregationEndAtUtc
+            )
+        )
+    }
+
+    fun getJobs(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        statuses: List<CreatorRankingSnapshotJobStatus> = CreatorRankingSnapshotJobStatus.values().toList()
+    ): List<AdminCreatorRankingSnapshotJobResponse> {
+        return jobService.findJobs(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            statuses = statuses
+        ).map(AdminCreatorRankingSnapshotJobResponse::from)
+    }
+
+    @Transactional
+    fun retry(jobId: Long) {
+        jobService.retryFailedJob(jobId)
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/CreatorRankingController.kt

@@ -0,0 +1,22 @@
+package kr.co.vividnext.sodalive.v2.api.home.adapter.`in`.web
+
+import kr.co.vividnext.sodalive.common.ApiResponse
+import kr.co.vividnext.sodalive.member.Member
+import kr.co.vividnext.sodalive.v2.api.home.application.HomeCreatorRankingFacade
+import org.springframework.security.core.annotation.AuthenticationPrincipal
+import org.springframework.web.bind.annotation.GetMapping
+import org.springframework.web.bind.annotation.RequestMapping
+import org.springframework.web.bind.annotation.RestController
+
+@RestController
+@RequestMapping("/api/v2/home/rankings")
+class CreatorRankingController(
+    private val homeCreatorRankingFacade: HomeCreatorRankingFacade
+) {
+    @GetMapping("/creators")
+    fun getCreatorRankings(
+        @AuthenticationPrincipal(expression = "#this == 'anonymousUser' ? null : member") member: Member?
+    ) = run {
+        ApiResponse.ok(homeCreatorRankingFacade.getCreatorRankings(member))
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/adapter/in/web/HomeRecommendationController.kt

@@ -4,8 +4,8 @@ import kr.co.vividnext.sodalive.common.ApiResponse
 import kr.co.vividnext.sodalive.common.SodaException
 import kr.co.vividnext.sodalive.member.Member
 import kr.co.vividnext.sodalive.v2.api.home.application.HomeRecommendationFacade
-import kr.co.vividnext.sodalive.v2.api.home.dto.FollowRecommendedCreatorsRequest
-import kr.co.vividnext.sodalive.v2.recommend.application.RecommendedCreatorFollowService
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.FollowRecommendedCreatorsRequest
+import kr.co.vividnext.sodalive.v2.recommendation.application.RecommendedCreatorFollowService
 import org.springframework.security.core.annotation.AuthenticationPrincipal
 import org.springframework.web.bind.annotation.GetMapping
 import org.springframework.web.bind.annotation.PostMapping

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeCreatorRankingFacade.kt

@@ -0,0 +1,17 @@
+package kr.co.vividnext.sodalive.v2.api.home.application
+
+import kr.co.vividnext.sodalive.member.Member
+import kr.co.vividnext.sodalive.v2.api.home.dto.ranking.CreatorRankingResponse
+import kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingQueryService
+import org.springframework.stereotype.Component
+
+@Component
+class HomeCreatorRankingFacade(
+    private val creatorRankingQueryService: CreatorRankingQueryService
+) {
+    fun getCreatorRankings(member: Member?): CreatorRankingResponse {
+        return CreatorRankingResponse.from(
+            creatorRankingQueryService.getCreatorRankings(viewerMemberId = member?.id)
+        )
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt

@@ -4,29 +4,29 @@ import kr.co.vividnext.sodalive.event.EventItem
 import kr.co.vividnext.sodalive.member.Member
 import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
 import kr.co.vividnext.sodalive.member.contentpreference.isAdultVisibleByPolicy
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeActiveCreatorItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeAiCharacterItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeBannerItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeCreatorItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeFirstAudioContentItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeGenreCreatorGroupItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeLiveItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomePopularCommunityPostItem
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeRecommendationPageResponse
-import kr.co.vividnext.sodalive.v2.api.home.dto.HomeRecommendationResponse
-import kr.co.vividnext.sodalive.v2.api.home.dto.imageUrl
-import kr.co.vividnext.sodalive.v2.api.home.dto.profileImageUrl
-import kr.co.vividnext.sodalive.v2.api.home.dto.toUtcIso
-import kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryService
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeAiCharacterRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeBannerRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeCheerCreatorRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeFirstAudioContentRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeGenreCreatorRecommendationGroup
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeLiveRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomePopularCommunityRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentDebutCreatorRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentlyActiveCreatorRecord
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeActiveCreatorItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeAiCharacterItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeBannerItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeCreatorItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeFirstAudioContentItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeGenreCreatorGroupItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeLiveItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomePopularCommunityPostItem
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeRecommendationPageResponse
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.HomeRecommendationResponse
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.imageUrl
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.profileImageUrl
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.toUtcIso
+import kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryService
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeAiCharacterRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeBannerRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeCheerCreatorRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeFirstAudioContentRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeGenreCreatorRecommendationGroup
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeLiveRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomePopularCommunityRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentDebutCreatorRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentlyActiveCreatorRecord
 import org.slf4j.LoggerFactory
 import org.springframework.beans.factory.annotation.Value
 import org.springframework.stereotype.Component

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/ranking/CreatorRankingResponse.kt

@@ -0,0 +1,42 @@
+package kr.co.vividnext.sodalive.v2.api.home.dto.ranking
+
+import com.fasterxml.jackson.annotation.JsonProperty
+import kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingResult
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingItem
+
+data class CreatorRankingResponse(
+    val showRankChange: Boolean,
+    val items: List<CreatorRankingResponseItem>
+) {
+    companion object {
+        fun from(result: CreatorRankingResult): CreatorRankingResponse {
+            return CreatorRankingResponse(
+                showRankChange = result.showRankChange,
+                items = result.items.map { CreatorRankingResponseItem.from(it) }
+            )
+        }
+    }
+}
+
+data class CreatorRankingResponseItem(
+    val rank: Int,
+    val rankChange: Int?,
+    @JsonProperty("isNew")
+    val isNew: Boolean,
+    val creatorId: Long,
+    val nickname: String,
+    val profileImageUrl: String?
+) {
+    companion object {
+        fun from(item: CreatorRankingItem): CreatorRankingResponseItem {
+            return CreatorRankingResponseItem(
+                rank = item.rank,
+                rankChange = item.rankChange,
+                isNew = item.isNew,
+                creatorId = item.creatorId,
+                nickname = item.nickname,
+                profileImageUrl = item.profileImageUrl
+            )
+        }
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/FollowRecommendedCreatorsRequest.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.api.home.dto
+package kr.co.vividnext.sodalive.v2.api.home.dto.recommendation
 
 data class FollowRecommendedCreatorsRequest(
     val creatorIds: List<Long>?

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/HomeRecommendationPageResponse.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.api.home.dto
+package kr.co.vividnext.sodalive.v2.api.home.dto.recommendation
 
 data class HomeRecommendationPageResponse<T>(
     val items: List<T>,

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/HomeRecommendationResponse.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.api.home.dto
+package kr.co.vividnext.sodalive.v2.api.home.dto.recommendation
 
 import com.fasterxml.jackson.annotation.JsonProperty
 import kr.co.vividnext.sodalive.event.EventItem

src/main/kotlin/kr/co/vividnext/sodalive/v2/chat/service/ChatRoomListService.kt

@@ -4,7 +4,7 @@ import kr.co.vividnext.sodalive.chat.room.ChatMessageType
 import kr.co.vividnext.sodalive.chat.room.repository.ChatRoomRepository
 import kr.co.vividnext.sodalive.common.SodaException
 import kr.co.vividnext.sodalive.member.Member
-import kr.co.vividnext.sodalive.v2.api.home.dto.toUtcIso
+import kr.co.vividnext.sodalive.v2.api.home.dto.recommendation.toUtcIso
 import kr.co.vividnext.sodalive.v2.chat.dto.ChatRoomListItemResponse
 import kr.co.vividnext.sodalive.v2.chat.dto.ChatRoomListPageResponse
 import kr.co.vividnext.sodalive.v2.chat.dto.ChatRoomListQueryDto

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshot.kt

@@ -0,0 +1,68 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.common.BaseEntity
+import java.time.LocalDateTime
+import javax.persistence.Column
+import javax.persistence.Entity
+import javax.persistence.Table
+
+@Entity
+@Table(name = "creator_ranking_snapshot")
+class CreatorRankingSnapshot(
+    @Column(name = "aggregation_start_at_utc", nullable = false, updatable = false)
+    val aggregationStartAtUtc: LocalDateTime,
+
+    @Column(name = "aggregation_end_at_utc", nullable = false, updatable = false)
+    val aggregationEndAtUtc: LocalDateTime,
+
+    @Column(name = "creator_id", nullable = false, updatable = false)
+    val creatorId: Long,
+
+    @Column(name = "nickname", nullable = false, updatable = false, length = 100)
+    val nickname: String,
+
+    @Column(name = "profile_image_url", updatable = false, length = 500)
+    val profileImageUrl: String?,
+
+    @Column(name = "final_score", nullable = false, updatable = false)
+    val finalScore: Double,
+
+    @Column(name = "content_live_score", nullable = false, updatable = false)
+    val contentLiveScore: Double,
+
+    @Column(name = "engagement_score", nullable = false, updatable = false)
+    val engagementScore: Double,
+
+    @Column(name = "support_score", nullable = false, updatable = false)
+    val supportScore: Double,
+
+    @Column(name = "fan_loyalty_score", nullable = false, updatable = false)
+    val fanLoyaltyScore: Double,
+
+    @Column(name = "live_can_amount", nullable = false, updatable = false)
+    val liveCanAmount: Long,
+
+    @Column(name = "content_purchase_can_amount", nullable = false, updatable = false)
+    val contentPurchaseCanAmount: Long,
+
+    @Column(name = "content_like_count", nullable = false, updatable = false)
+    val contentLikeCount: Long,
+
+    @Column(name = "content_comment_count", nullable = false, updatable = false)
+    val contentCommentCount: Long,
+
+    @Column(name = "channel_donation_can_amount", nullable = false, updatable = false)
+    val channelDonationCanAmount: Long,
+
+    @Column(name = "channel_donation_count", nullable = false, updatable = false)
+    val channelDonationCount: Long,
+
+    @Column(name = "fan_talk_count", nullable = false, updatable = false)
+    val fanTalkCount: Long,
+
+    @Column(name = "final_follower_count", nullable = false, updatable = false)
+    val finalFollowerCount: Long,
+
+    @Column(name = "follow_increase", nullable = false, updatable = false)
+    val followIncrease: Long
+) : BaseEntity()

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotJob.kt

@@ -0,0 +1,38 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.common.BaseEntity
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobTrigger
+import java.time.LocalDateTime
+import javax.persistence.Column
+import javax.persistence.Entity
+import javax.persistence.EnumType
+import javax.persistence.Enumerated
+import javax.persistence.Table
+
+@Entity
+@Table(name = "creator_ranking_snapshot_job")
+class CreatorRankingSnapshotJob(
+    @Column(name = "aggregation_start_at_utc", nullable = false)
+    val aggregationStartAtUtc: LocalDateTime,
+
+    @Column(name = "aggregation_end_at_utc", nullable = false)
+    val aggregationEndAtUtc: LocalDateTime,
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "trigger_type", nullable = false, length = 20)
+    val trigger: CreatorRankingSnapshotJobTrigger,
+
+    @Enumerated(EnumType.STRING)
+    @Column(name = "status", nullable = false, length = 20)
+    var status: CreatorRankingSnapshotJobStatus = CreatorRankingSnapshotJobStatus.PENDING,
+
+    @Column(name = "last_error", columnDefinition = "text")
+    var lastError: String? = null,
+
+    @Column(name = "processing_started_at")
+    var processingStartedAt: LocalDateTime? = null,
+
+    @Column(name = "processed_at")
+    var processedAt: LocalDateTime? = null
+) : BaseEntity()

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotJobRepository.kt

@@ -0,0 +1,21 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import org.springframework.data.jpa.repository.JpaRepository
+import org.springframework.data.jpa.repository.Lock
+import org.springframework.data.jpa.repository.Query
+import org.springframework.data.repository.query.Param
+import java.time.LocalDateTime
+import javax.persistence.LockModeType
+
+interface CreatorRankingSnapshotJobRepository : JpaRepository<CreatorRankingSnapshotJob, Long> {
+    @Lock(LockModeType.PESSIMISTIC_WRITE)
+    @Query("select j from CreatorRankingSnapshotJob j where j.id = :jobId")
+    fun findByIdForUpdate(@Param("jobId") jobId: Long): CreatorRankingSnapshotJob?
+
+    fun findAllByAggregationStartAtUtcAndAggregationEndAtUtcAndStatusInOrderByCreatedAtDesc(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        statuses: List<CreatorRankingSnapshotJobStatus>
+    ): List<CreatorRankingSnapshotJob>
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/CreatorRankingSnapshotRepository.kt

@@ -0,0 +1,50 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import org.springframework.data.jpa.repository.JpaRepository
+import org.springframework.data.jpa.repository.Query
+import org.springframework.data.repository.query.Param
+import java.time.LocalDateTime
+
+interface CreatorRankingSnapshotRepository : JpaRepository<CreatorRankingSnapshot, Long> {
+    fun findAllByAggregationStartAtUtcAndAggregationEndAtUtcOrderByFinalScoreDesc(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): List<CreatorRankingSnapshot>
+
+    @Query(
+        value = """
+            select *
+            from creator_ranking_snapshot crs
+            where crs.aggregation_end_at_utc = (
+                select max(latest.aggregation_end_at_utc)
+                from creator_ranking_snapshot latest
+            )
+            order by crs.final_score desc
+        """,
+        nativeQuery = true
+    )
+    fun findLatestSnapshots(): List<CreatorRankingSnapshot>
+
+    @Query(
+        value = """
+            select *
+            from creator_ranking_snapshot crs
+            where crs.aggregation_end_at_utc = (
+                select max(previous.aggregation_end_at_utc)
+                from creator_ranking_snapshot previous
+                where previous.aggregation_end_at_utc < (
+                    select max(latest.aggregation_end_at_utc)
+                    from creator_ranking_snapshot latest
+                )
+            )
+            order by crs.final_score desc
+        """,
+        nativeQuery = true
+    )
+    fun findPreviousCompletedSnapshots(): List<CreatorRankingSnapshot>
+
+    fun deleteByAggregationStartAtUtcAndAggregationEndAtUtc(
+        @Param("aggregationStartAtUtc") aggregationStartAtUtc: LocalDateTime,
+        @Param("aggregationEndAtUtc") aggregationEndAtUtc: LocalDateTime
+    )
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepository.kt

@@ -0,0 +1,203 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingScorePolicy
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingSnapshotCandidate
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationResult
+import org.springframework.stereotype.Repository
+import java.time.LocalDateTime
+import javax.persistence.EntityManager
+
+@Repository
+class DefaultCreatorRankingAggregationRepository(
+    private val entityManager: EntityManager
+) : CreatorRankingAggregationPort {
+    private val scorePolicy = CreatorRankingScorePolicy()
+
+    override fun aggregateCandidates(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotCandidate> {
+        return aggregateCandidateResult(startInclusiveUtc, endExclusiveUtc).candidates
+    }
+
+    override fun aggregateCandidateResult(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): CreatorRankingAggregationResult {
+        val candidates = aggregateAllCandidates(startInclusiveUtc, endExclusiveUtc)
+        val includedCandidates = candidates
+            .filter { candidate -> candidate.finalScore >= MINIMUM_FINAL_SCORE }
+            .sortedWith(compareByDescending<CreatorRankingSnapshotCandidate> { it.finalScore }.thenBy { it.creatorId })
+
+        return CreatorRankingAggregationResult(
+            candidates = includedCandidates,
+            lowScoreExcludedCount = candidates.size - includedCandidates.size
+        )
+    }
+
+    private fun aggregateAllCandidates(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotCandidate> {
+        val rows = entityManager.createNativeQuery(AGGREGATION_SQL)
+            .setParameter("startInclusiveUtc", startInclusiveUtc)
+            .setParameter("endExclusiveUtc", endExclusiveUtc)
+            .resultList
+
+        return rows.map { row -> (row as Array<*>).toCandidate() }
+    }
+
+    private fun Array<*>.toCandidate(): CreatorRankingSnapshotCandidate {
+        val creatorId = this[0].toLong()
+        val nickname = this[1] as String
+        val profileImageUrl = this[2] as String?
+        val liveCanAmount = this[3].toLong()
+        val contentPurchaseCanAmount = this[4].toLong()
+        val contentLikeCount = this[5].toLong()
+        val contentCommentCount = this[6].toLong()
+        val channelDonationCanAmount = this[7].toLong()
+        val channelDonationCount = this[8].toLong()
+        val fanTalkCount = this[9].toLong()
+        val finalFollowerCount = this[10].toLong()
+        val followIncrease = this[11].toLong()
+        val contentLiveScore = scorePolicy.calculateContentLiveScore(liveCanAmount, contentPurchaseCanAmount)
+        val engagementScore = scorePolicy.calculateEngagementScore(contentLikeCount, contentCommentCount)
+        val supportScore = scorePolicy.calculateSupportScore(channelDonationCanAmount, channelDonationCount, fanTalkCount)
+        val fanLoyaltyScore = scorePolicy.calculateFanLoyaltyScore(finalFollowerCount, followIncrease)
+        val finalScore = scorePolicy.calculateFinalScore(contentLiveScore, engagementScore, supportScore, fanLoyaltyScore)
+
+        return CreatorRankingSnapshotCandidate(
+            creatorId = creatorId,
+            nickname = nickname,
+            profileImageUrl = profileImageUrl,
+            finalScore = finalScore,
+            contentLiveScore = contentLiveScore,
+            engagementScore = engagementScore,
+            supportScore = supportScore,
+            fanLoyaltyScore = fanLoyaltyScore,
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount,
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount,
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount,
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+    }
+
+    private fun Any?.toLong(): Long {
+        return (this as Number?)?.toLong() ?: 0L
+    }
+
+    companion object {
+        private const val MINIMUM_FINAL_SCORE = 1.0
+
+        private val AGGREGATION_SQL = """
+            with active_creators as (
+                select id, nickname, profile_image
+                from member
+                where role = 'CREATOR'
+                  and is_active = true
+            ), can_metrics as (
+                select ucc.recipient_creator_id as creator_id,
+                       sum(case when uc.can_usage in ('DONATION', 'LIVE', 'SPIN_ROULETTE') then ucc.can else 0 end) as live_can_amount,
+                       sum(case when uc.can_usage = 'ORDER_CONTENT' then ucc.can else 0 end) as content_purchase_can_amount,
+                       sum(case when uc.can_usage = 'CHANNEL_DONATION' then ucc.can else 0 end) as channel_donation_can_amount,
+                       sum(case when uc.can_usage = 'CHANNEL_DONATION' then 1 else 0 end) as channel_donation_count
+                from use_can_calculate ucc
+                join use_can uc on uc.id = ucc.use_can_id
+                where ucc.recipient_creator_id is not null
+                  and ucc.status = 'RECEIVED'
+                  and uc.is_refund = false
+                  and ucc.created_at >= :startInclusiveUtc
+                  and ucc.created_at < :endExclusiveUtc
+                group by ucc.recipient_creator_id
+            ), like_metrics as (
+                select c.member_id as creator_id,
+                       count(cl.id) as content_like_count
+                from content_like cl
+                join content c on c.id = cl.content_id
+                where c.is_active = true
+                  and cl.is_active = true
+                  and cl.created_at >= :startInclusiveUtc
+                  and cl.created_at < :endExclusiveUtc
+                group by c.member_id
+            ), comment_metrics as (
+                select c.member_id as creator_id,
+                       count(cc.id) as content_comment_count
+                from content_comment cc
+                join content c on c.id = cc.content_id
+                where c.is_active = true
+                  and cc.is_active = true
+                  and cc.member_id <> c.member_id
+                  and cc.created_at >= :startInclusiveUtc
+                  and cc.created_at < :endExclusiveUtc
+                group by c.member_id
+            ), fan_talk_metrics as (
+                select creator_id,
+                       count(id) as fan_talk_count
+                from creator_cheers
+                where is_active = true
+                  and parent_id is null
+                  and created_at >= :startInclusiveUtc
+                  and created_at < :endExclusiveUtc
+                group by creator_id
+            ), final_follower_metrics as (
+                select creator_id,
+                       count(id) as final_follower_count
+                from creator_following
+                where is_active = true
+                  and created_at < :endExclusiveUtc
+                group by creator_id
+            ), new_follow_metrics as (
+                select creator_id,
+                       count(id) as new_follow_count
+                from creator_following
+                where created_at >= :startInclusiveUtc
+                  and created_at < :endExclusiveUtc
+                group by creator_id
+            ), unfollow_metrics as (
+                select creator_id,
+                       count(id) as unfollow_count
+                from creator_following
+                where is_active = false
+                  and updated_at >= :startInclusiveUtc
+                  and updated_at < :endExclusiveUtc
+                group by creator_id
+            )
+            select ac.id as creator_id,
+                   ac.nickname as nickname,
+                   ac.profile_image as profile_image_url,
+                   coalesce(cm.live_can_amount, 0) as live_can_amount,
+                   coalesce(cm.content_purchase_can_amount, 0) as content_purchase_can_amount,
+                   coalesce(lm.content_like_count, 0) as content_like_count,
+                   coalesce(com.content_comment_count, 0) as content_comment_count,
+                   coalesce(cm.channel_donation_can_amount, 0) as channel_donation_can_amount,
+                   coalesce(cm.channel_donation_count, 0) as channel_donation_count,
+                   coalesce(ftm.fan_talk_count, 0) as fan_talk_count,
+                   coalesce(ffm.final_follower_count, 0) as final_follower_count,
+                   coalesce(nfm.new_follow_count, 0) - coalesce(um.unfollow_count, 0) as follow_increase
+            from active_creators ac
+            left join can_metrics cm on cm.creator_id = ac.id
+            left join like_metrics lm on lm.creator_id = ac.id
+            left join comment_metrics com on com.creator_id = ac.id
+            left join fan_talk_metrics ftm on ftm.creator_id = ac.id
+            left join final_follower_metrics ffm on ffm.creator_id = ac.id
+            left join new_follow_metrics nfm on nfm.creator_id = ac.id
+            left join unfollow_metrics um on um.creator_id = ac.id
+            where coalesce(cm.live_can_amount, 0) <> 0
+               or coalesce(cm.content_purchase_can_amount, 0) <> 0
+               or coalesce(lm.content_like_count, 0) <> 0
+               or coalesce(com.content_comment_count, 0) <> 0
+               or coalesce(cm.channel_donation_can_amount, 0) <> 0
+               or coalesce(cm.channel_donation_count, 0) <> 0
+               or coalesce(ftm.fan_talk_count, 0) <> 0
+               or coalesce(ffm.final_follower_count, 0) <> 0
+               or coalesce(nfm.new_follow_count, 0) <> 0
+               or coalesce(um.unfollow_count, 0) <> 0
+        """.trimIndent()
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingBlockRepository.kt

@@ -0,0 +1,40 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import com.querydsl.jpa.impl.JPAQueryFactory
+import kr.co.vividnext.sodalive.member.block.QBlockMember
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingBlockPort
+import org.springframework.stereotype.Repository
+
+@Repository
+class DefaultCreatorRankingBlockRepository(
+    private val queryFactory: JPAQueryFactory
+) : CreatorRankingBlockPort {
+    override fun findBlockedCreatorIds(memberId: Long, creatorIds: Collection<Long>): Set<Long> {
+        if (creatorIds.isEmpty()) {
+            return emptySet()
+        }
+
+        val viewerBlock = QBlockMember("creatorRankingViewerBlock")
+        val creatorBlock = QBlockMember("creatorRankingCreatorBlock")
+        val blockedByViewer = queryFactory
+            .select(viewerBlock.blockedMember.id)
+            .from(viewerBlock)
+            .where(
+                viewerBlock.member.id.eq(memberId)
+                    .and(viewerBlock.blockedMember.id.`in`(creatorIds))
+                    .and(viewerBlock.isActive.isTrue)
+            )
+            .fetch()
+        val blockedByCreator = queryFactory
+            .select(creatorBlock.member.id)
+            .from(creatorBlock)
+            .where(
+                creatorBlock.member.id.`in`(creatorIds)
+                    .and(creatorBlock.blockedMember.id.eq(memberId))
+                    .and(creatorBlock.isActive.isTrue)
+            )
+            .fetch()
+
+        return (blockedByViewer + blockedByCreator).toSet()
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotJobRepository.kt

@@ -0,0 +1,102 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobRecord
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import org.springframework.stereotype.Repository
+import org.springframework.transaction.annotation.Transactional
+import java.time.LocalDateTime
+
+@Repository
+class DefaultCreatorRankingSnapshotJobRepository(
+    private val repository: CreatorRankingSnapshotJobRepository
+) : CreatorRankingSnapshotJobPort {
+    @Transactional
+    override fun save(job: CreatorRankingSnapshotJobRecord): CreatorRankingSnapshotJobRecord {
+        return repository.save(job.toEntity()).toRecord()
+    }
+
+    override fun findById(jobId: Long): CreatorRankingSnapshotJobRecord? {
+        return repository.findById(jobId).orElse(null)?.toRecord()
+    }
+
+    override fun findByPeriodAndStatuses(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        statuses: List<CreatorRankingSnapshotJobStatus>
+    ): List<CreatorRankingSnapshotJobRecord> {
+        return repository.findAllByAggregationStartAtUtcAndAggregationEndAtUtcAndStatusInOrderByCreatedAtDesc(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            statuses = statuses
+        ).map { it.toRecord() }
+    }
+
+    @Transactional
+    override fun markProcessing(jobId: Long, processingStartedAt: LocalDateTime): CreatorRankingSnapshotJobRecord? {
+        val job = repository.findByIdForUpdate(jobId) ?: return null
+        job.status = CreatorRankingSnapshotJobStatus.PROCESSING
+        job.processingStartedAt = processingStartedAt
+        job.lastError = null
+        return job.toRecord()
+    }
+
+    @Transactional
+    override fun markDone(jobId: Long, processedAt: LocalDateTime): CreatorRankingSnapshotJobRecord? {
+        val job = repository.findByIdForUpdate(jobId) ?: return null
+        job.status = CreatorRankingSnapshotJobStatus.DONE
+        job.processedAt = processedAt
+        job.lastError = null
+        return job.toRecord()
+    }
+
+    @Transactional
+    override fun markFailed(jobId: Long, processedAt: LocalDateTime, lastError: String?): CreatorRankingSnapshotJobRecord? {
+        val job = repository.findByIdForUpdate(jobId) ?: return null
+        job.status = CreatorRankingSnapshotJobStatus.FAILED
+        job.processedAt = processedAt
+        job.lastError = lastError?.take(MAX_ERROR_LENGTH)
+        return job.toRecord()
+    }
+
+    @Transactional
+    override fun markPending(jobId: Long): CreatorRankingSnapshotJobRecord? {
+        val job = repository.findByIdForUpdate(jobId) ?: return null
+        if (job.status != CreatorRankingSnapshotJobStatus.FAILED) return job.toRecord()
+
+        job.status = CreatorRankingSnapshotJobStatus.PENDING
+        job.lastError = null
+        job.processingStartedAt = null
+        job.processedAt = null
+        return job.toRecord()
+    }
+
+    private fun CreatorRankingSnapshotJobRecord.toEntity(): CreatorRankingSnapshotJob {
+        return CreatorRankingSnapshotJob(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            trigger = trigger,
+            status = status,
+            lastError = lastError,
+            processingStartedAt = processingStartedAt,
+            processedAt = processedAt
+        )
+    }
+
+    private fun CreatorRankingSnapshotJob.toRecord(): CreatorRankingSnapshotJobRecord {
+        return CreatorRankingSnapshotJobRecord(
+            id = id,
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            trigger = trigger,
+            status = status,
+            lastError = lastError,
+            processingStartedAt = processingStartedAt,
+            processedAt = processedAt
+        )
+    }
+
+    companion object {
+        private const val MAX_ERROR_LENGTH = 1000
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepository.kt

@@ -0,0 +1,95 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotRecord
+import org.springframework.stereotype.Repository
+import org.springframework.transaction.annotation.Transactional
+import java.time.LocalDateTime
+
+@Repository
+class DefaultCreatorRankingSnapshotRepository(
+    private val repository: CreatorRankingSnapshotRepository
+) : CreatorRankingSnapshotPort {
+    override fun findSnapshotsByAggregationPeriod(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotRecord> {
+        return repository.findAllByAggregationStartAtUtcAndAggregationEndAtUtcOrderByFinalScoreDesc(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc
+        ).map { it.toRecord() }
+    }
+
+    override fun findLatestSnapshots(): List<CreatorRankingSnapshotRecord> {
+        return repository.findLatestSnapshots().map { it.toRecord() }
+    }
+
+    override fun findPreviousCompletedSnapshots(): List<CreatorRankingSnapshotRecord> {
+        return repository.findPreviousCompletedSnapshots().map { it.toRecord() }
+    }
+
+    override fun isSnapshotTableEmpty(): Boolean {
+        return repository.count() == 0L
+    }
+
+    @Transactional
+    override fun replaceSnapshots(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        newSnapshots: List<CreatorRankingSnapshotRecord>
+    ) {
+        repository.deleteByAggregationStartAtUtcAndAggregationEndAtUtc(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc
+        )
+        repository.saveAll(newSnapshots.map { it.toEntity() })
+    }
+
+    private fun CreatorRankingSnapshot.toRecord(): CreatorRankingSnapshotRecord {
+        return CreatorRankingSnapshotRecord(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            creatorId = creatorId,
+            nickname = nickname,
+            profileImageUrl = profileImageUrl,
+            finalScore = finalScore,
+            contentLiveScore = contentLiveScore,
+            engagementScore = engagementScore,
+            supportScore = supportScore,
+            fanLoyaltyScore = fanLoyaltyScore,
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount,
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount,
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount,
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+    }
+
+    private fun CreatorRankingSnapshotRecord.toEntity(): CreatorRankingSnapshot {
+        return CreatorRankingSnapshot(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            creatorId = creatorId,
+            nickname = nickname,
+            profileImageUrl = profileImageUrl,
+            finalScore = finalScore,
+            contentLiveScore = contentLiveScore,
+            engagementScore = engagementScore,
+            supportScore = supportScore,
+            fanLoyaltyScore = fanLoyaltyScore,
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount,
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount,
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount,
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/scheduler/CreatorRankingSnapshotScheduler.kt

@@ -0,0 +1,29 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.scheduler
+
+import kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobService
+import org.redisson.api.RedissonClient
+import org.springframework.scheduling.annotation.Scheduled
+import org.springframework.stereotype.Component
+import java.util.concurrent.TimeUnit
+
+@Component
+class CreatorRankingSnapshotScheduler(
+    private val jobService: CreatorRankingSnapshotJobService,
+    private val redissonClient: RedissonClient
+) {
+    @Scheduled(cron = "0 30 7 * * MON", zone = "Asia/Seoul")
+    fun refreshLastCompletedWeek() {
+        val lockName = "lock:creator-ranking-snapshot-refresh"
+        val lock = redissonClient.getLock(lockName)
+
+        try {
+            if (lock.tryLock(0, -1, TimeUnit.SECONDS)) {
+                jobService.refreshLastCompletedWeekByScheduledJob()
+            }
+        } finally {
+            if (lock.isHeldByCurrentThread) {
+                lock.unlock()
+            }
+        }
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryService.kt

@@ -0,0 +1,230 @@
+package kr.co.vividnext.sodalive.v2.ranking.application
+
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingItem
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingPeriodPolicy
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingScorePolicy
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingSnapshotCandidate
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingUtcRange
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingBlockPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotRecord
+import org.slf4j.LoggerFactory
+import org.springframework.beans.factory.annotation.Value
+import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
+import java.time.ZonedDateTime
+
+@Service
+class CreatorRankingQueryService(
+    private val snapshotPort: CreatorRankingSnapshotPort,
+    private val blockPort: CreatorRankingBlockPort,
+    private val aggregationPort: CreatorRankingAggregationPort,
+    private val nowProvider: () -> ZonedDateTime = { ZonedDateTime.now() },
+    @Value("\${cloud.aws.cloud-front.host}")
+    private val cloudFrontHost: String
+) {
+    private val log = LoggerFactory.getLogger(javaClass)
+    private val periodPolicy = CreatorRankingPeriodPolicy()
+    private val scorePolicy = CreatorRankingScorePolicy()
+
+    @Transactional(readOnly = true)
+    fun getCreatorRankings(viewerMemberId: Long?): CreatorRankingResult {
+        val startedAt = System.currentTimeMillis()
+        return runCatching {
+            val latestItems = snapshotPort.findLatestSnapshots().toRankedItems()
+            if (latestItems.isEmpty()) {
+                if (snapshotPort.isSnapshotTableEmpty()) {
+                    val fallbackItems = aggregateColdStartFallback().toRankedItems()
+                    val blockedCreatorIds = findBlockedCreatorIds(viewerMemberId = viewerMemberId, items = fallbackItems)
+                    return@runCatching QueryLogResult(
+                        result = CreatorRankingResult(
+                            showRankChange = false,
+                            items = fallbackItems.map { it.maskIfBlocked(blockedCreatorIds) }
+                        ),
+                        blockedCreatorCount = blockedCreatorIds.size
+                    )
+                }
+                return@runCatching QueryLogResult(
+                    result = CreatorRankingResult(showRankChange = false, items = emptyList()),
+                    blockedCreatorCount = 0
+                )
+            }
+
+            val previousItems = snapshotPort.findPreviousCompletedSnapshots().toRankedItems()
+            val previousRankByCreatorId = previousItems.associate { it.creatorId to it.rank }
+            val showRankChange = previousRankByCreatorId.isNotEmpty()
+            val blockedCreatorIds = findBlockedCreatorIds(viewerMemberId = viewerMemberId, items = latestItems)
+            val items = latestItems.map { item ->
+                val previousRank = previousRankByCreatorId[item.creatorId]
+                item.copy(
+                    rankChange = if (showRankChange && previousRank != null) previousRank - item.rank else null,
+                    isNew = showRankChange && previousRank == null
+                ).maskIfBlocked(blockedCreatorIds)
+            }
+
+            QueryLogResult(
+                result = CreatorRankingResult(showRankChange = showRankChange, items = items),
+                blockedCreatorCount = blockedCreatorIds.size
+            )
+        }.onSuccess { logResult ->
+            log.info(
+                "event=creator_ranking_query_success showRankChange={} itemCount={} blockedCreatorCount={} elapsedMs={}",
+                logResult.result.showRankChange,
+                logResult.result.items.size,
+                logResult.blockedCreatorCount,
+                System.currentTimeMillis() - startedAt
+            )
+        }.onFailure { ex ->
+            log.warn(
+                "event=creator_ranking_query_failure elapsedMs={} error={}",
+                System.currentTimeMillis() - startedAt,
+                ex.message,
+                ex
+            )
+        }.getOrThrow().result
+    }
+
+    private data class QueryLogResult(
+        val result: CreatorRankingResult,
+        val blockedCreatorCount: Int
+    )
+
+    private fun aggregateColdStartFallback(): List<CreatorRankingSnapshotRecord> {
+        val startedAt = System.currentTimeMillis()
+        val period = periodPolicy.resolveLastCompletedWeek(nowProvider())
+        val utcRange = periodPolicy.toUtcRange(period)
+        log.info(
+            "event=creator_ranking_query_cold_start_fallback_attempt " +
+                "aggregationStartAtUtc={} aggregationEndAtUtc={}",
+            utcRange.startInclusiveUtc,
+            utcRange.endExclusiveUtc
+        )
+        return runCatching {
+            aggregationPort.aggregateCandidates(
+                startInclusiveUtc = utcRange.startInclusiveUtc,
+                endExclusiveUtc = utcRange.endExclusiveUtc
+            ).map { it.toSnapshotRecord(utcRange) }
+        }.onSuccess { snapshots ->
+            log.info(
+                "event=creator_ranking_query_cold_start_fallback_success " +
+                    "aggregationStartAtUtc={} aggregationEndAtUtc={} itemCount={} elapsedMs={}",
+                utcRange.startInclusiveUtc,
+                utcRange.endExclusiveUtc,
+                snapshots.size.coerceAtMost(RANKING_LIMIT),
+                System.currentTimeMillis() - startedAt
+            )
+        }.onFailure { ex ->
+            log.warn(
+                "event=creator_ranking_query_cold_start_fallback_failure " +
+                    "aggregationStartAtUtc={} aggregationEndAtUtc={} elapsedMs={} error={}",
+                utcRange.startInclusiveUtc,
+                utcRange.endExclusiveUtc,
+                System.currentTimeMillis() - startedAt,
+                ex.message,
+                ex
+            )
+        }.getOrThrow()
+    }
+
+    private fun List<CreatorRankingSnapshotRecord>.toRankedItems(): List<CreatorRankingItem> {
+        return groupBy { it.finalScore }
+            .toSortedMap(compareByDescending { it })
+            .values
+            .flatMap { it.shuffled() }
+            .take(RANKING_LIMIT)
+            .mapIndexed { index, snapshot -> snapshot.toItem(rank = index + 1) }
+    }
+
+    private fun CreatorRankingSnapshotRecord.toItem(rank: Int): CreatorRankingItem {
+        return CreatorRankingItem(
+            rank = rank,
+            rankChange = null,
+            isNew = false,
+            creatorId = creatorId,
+            nickname = nickname,
+            profileImageUrl = profileImageUrl
+        )
+    }
+
+    private fun CreatorRankingSnapshotCandidate.toSnapshotRecord(utcRange: CreatorRankingUtcRange): CreatorRankingSnapshotRecord {
+        val calculatedContentLiveScore = scorePolicy.calculateContentLiveScore(
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount
+        )
+        val calculatedEngagementScore = scorePolicy.calculateEngagementScore(
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount
+        )
+        val calculatedSupportScore = scorePolicy.calculateSupportScore(
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount
+        )
+        val calculatedFanLoyaltyScore = scorePolicy.calculateFanLoyaltyScore(
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+        val calculatedFinalScore = scorePolicy.calculateFinalScore(
+            contentLiveScore = calculatedContentLiveScore,
+            engagementScore = calculatedEngagementScore,
+            supportScore = calculatedSupportScore,
+            fanLoyaltyScore = calculatedFanLoyaltyScore
+        )
+
+        return CreatorRankingSnapshotRecord(
+            aggregationStartAtUtc = utcRange.startInclusiveUtc,
+            aggregationEndAtUtc = utcRange.endExclusiveUtc,
+            creatorId = creatorId,
+            nickname = nickname,
+            profileImageUrl = profileImageUrl,
+            finalScore = calculatedFinalScore,
+            contentLiveScore = calculatedContentLiveScore,
+            engagementScore = calculatedEngagementScore,
+            supportScore = calculatedSupportScore,
+            fanLoyaltyScore = calculatedFanLoyaltyScore,
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount,
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount,
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount,
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+    }
+
+    private fun findBlockedCreatorIds(viewerMemberId: Long?, items: List<CreatorRankingItem>): Set<Long> {
+        if (viewerMemberId == null) {
+            return emptySet()
+        }
+        return blockPort.findBlockedCreatorIds(
+            memberId = viewerMemberId,
+            creatorIds = items.map { it.creatorId }
+        )
+    }
+
+    private fun CreatorRankingItem.maskIfBlocked(blockedCreatorIds: Set<Long>): CreatorRankingItem {
+        if (!blockedCreatorIds.contains(creatorId)) {
+            return this
+        }
+        return copy(
+            creatorId = MASKED_CREATOR_ID,
+            nickname = MASKED_NICKNAME,
+            profileImageUrl = "$cloudFrontHost/$DEFAULT_PROFILE_IMAGE_PATH"
+        )
+    }
+
+    companion object {
+        private const val RANKING_LIMIT = 20
+        private const val MASKED_CREATOR_ID = 0L
+        private const val MASKED_NICKNAME = ""
+        private const val DEFAULT_PROFILE_IMAGE_PATH = "profile/default-profile.png"
+    }
+}
+
+data class CreatorRankingResult(
+    val showRankChange: Boolean,
+    val items: List<CreatorRankingItem>
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobService.kt

@@ -0,0 +1,108 @@
+package kr.co.vividnext.sodalive.v2.ranking.application
+
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingPeriodPolicy
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobRecord
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobTrigger
+import org.slf4j.LoggerFactory
+import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
+import java.time.LocalDateTime
+import java.time.ZonedDateTime
+
+@Service
+@Transactional(readOnly = true)
+class CreatorRankingSnapshotJobService(
+    private val refreshService: CreatorRankingSnapshotRefreshService,
+    private val jobPort: CreatorRankingSnapshotJobPort,
+    private val nowProvider: () -> ZonedDateTime = { ZonedDateTime.now() }
+) {
+    private val log = LoggerFactory.getLogger(javaClass)
+    private val periodPolicy = CreatorRankingPeriodPolicy()
+
+    @Transactional
+    fun refreshLastCompletedWeekByScheduledJob() {
+        val now = nowProvider()
+        val period = periodPolicy.resolveLastCompletedWeek(now)
+        val utcRange = periodPolicy.toUtcRange(period)
+        val job = jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = utcRange.startInclusiveUtc,
+                aggregationEndAtUtc = utcRange.endExclusiveUtc,
+                trigger = CreatorRankingSnapshotJobTrigger.SCHEDULED,
+                status = CreatorRankingSnapshotJobStatus.PENDING,
+                lastError = null,
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+        val jobId = job.id ?: return
+        jobPort.markProcessing(jobId, LocalDateTime.now())
+        logJobStatusChanged(job, CreatorRankingSnapshotJobStatus.PROCESSING)
+        try {
+            refreshService.refreshLastCompletedWeek(now)
+            jobPort.markDone(jobId, LocalDateTime.now())
+            logJobStatusChanged(job, CreatorRankingSnapshotJobStatus.DONE)
+        } catch (ex: Exception) {
+            jobPort.markFailed(jobId, LocalDateTime.now(), ex.message)
+            logJobStatusChanged(job, CreatorRankingSnapshotJobStatus.FAILED, ex.message)
+            throw ex
+        }
+    }
+
+    @Transactional
+    fun createManualJob(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): CreatorRankingSnapshotJobRecord {
+        return jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = aggregationStartAtUtc,
+                aggregationEndAtUtc = aggregationEndAtUtc,
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.PENDING,
+                lastError = null,
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+    }
+
+    fun findJobs(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        statuses: List<CreatorRankingSnapshotJobStatus> = CreatorRankingSnapshotJobStatus.values().toList()
+    ): List<CreatorRankingSnapshotJobRecord> {
+        return jobPort.findByPeriodAndStatuses(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            statuses = statuses
+        )
+    }
+
+    @Transactional
+    fun retryFailedJob(jobId: Long) {
+        val job = jobPort.findById(jobId) ?: return
+        if (job.status != CreatorRankingSnapshotJobStatus.FAILED) return
+
+        jobPort.markPending(jobId)
+    }
+
+    private fun logJobStatusChanged(
+        job: CreatorRankingSnapshotJobRecord,
+        status: CreatorRankingSnapshotJobStatus,
+        error: String? = null
+    ) {
+        log.info(
+            "event=creator_ranking_snapshot_job_status_changed " +
+                "jobId={} trigger={} status={} aggregationStartAtUtc={} aggregationEndAtUtc={} error={}",
+            job.id,
+            job.trigger,
+            status,
+            job.aggregationStartAtUtc,
+            job.aggregationEndAtUtc,
+            error
+        )
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshService.kt

@@ -0,0 +1,158 @@
+package kr.co.vividnext.sodalive.v2.ranking.application
+
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingPeriodPolicy
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingScorePolicy
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingSnapshotCandidate
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingUtcRange
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationResult
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotRecord
+import org.slf4j.LoggerFactory
+import org.springframework.stereotype.Service
+import org.springframework.transaction.annotation.Transactional
+import org.springframework.transaction.support.TransactionSynchronization
+import org.springframework.transaction.support.TransactionSynchronizationManager
+import java.time.ZonedDateTime
+
+@Service
+class CreatorRankingSnapshotRefreshService(
+    private val aggregationPort: CreatorRankingAggregationPort,
+    private val snapshotPort: CreatorRankingSnapshotPort
+) {
+    private val log = LoggerFactory.getLogger(javaClass)
+    private val periodPolicy = CreatorRankingPeriodPolicy()
+    private val scorePolicy = CreatorRankingScorePolicy()
+
+    @Transactional
+    fun refreshLastCompletedWeek(now: ZonedDateTime) {
+        val startedAt = System.currentTimeMillis()
+        val period = periodPolicy.resolveLastCompletedWeek(now)
+        val utcRange = periodPolicy.toUtcRange(period)
+        runCatching {
+            val aggregationResult = aggregationPort.aggregateCandidateResult(
+                startInclusiveUtc = utcRange.startInclusiveUtc,
+                endExclusiveUtc = utcRange.endExclusiveUtc
+            )
+            val snapshots = aggregationResult.candidates.map { it.toSnapshotRecord(utcRange) }
+                .sortedByDescending { it.finalScore }
+                .takeRankedBoundary(limit = SNAPSHOT_LIMIT)
+
+            snapshotPort.replaceSnapshots(
+                aggregationStartAtUtc = utcRange.startInclusiveUtc,
+                aggregationEndAtUtc = utcRange.endExclusiveUtc,
+                newSnapshots = snapshots
+            )
+            aggregationResult.toLogCounts(storedCount = snapshots.size)
+        }.onSuccess { counts ->
+            afterCommit {
+                log.info(
+                    "event=creator_ranking_snapshot_refresh_success " +
+                        "aggregationStartAtUtc={} aggregationEndAtUtc={} " +
+                        "candidateCount={} storedCount={} lowScoreExcludedCount={} elapsedMs={}",
+                    utcRange.startInclusiveUtc,
+                    utcRange.endExclusiveUtc,
+                    counts.candidateCount,
+                    counts.storedCount,
+                    counts.lowScoreExcludedCount,
+                    System.currentTimeMillis() - startedAt
+                )
+            }
+        }.onFailure { ex ->
+            log.warn(
+                "event=creator_ranking_snapshot_refresh_failure " +
+                    "aggregationStartAtUtc={} aggregationEndAtUtc={} elapsedMs={} error={}",
+                utcRange.startInclusiveUtc,
+                utcRange.endExclusiveUtc,
+                System.currentTimeMillis() - startedAt,
+                ex.message,
+                ex
+            )
+            throw ex
+        }
+    }
+
+    private fun CreatorRankingAggregationResult.toLogCounts(storedCount: Int): RefreshLogCounts {
+        return RefreshLogCounts(
+            candidateCount = candidates.size,
+            storedCount = storedCount,
+            lowScoreExcludedCount = lowScoreExcludedCount
+        )
+    }
+
+    private data class RefreshLogCounts(
+        val candidateCount: Int,
+        val storedCount: Int,
+        val lowScoreExcludedCount: Int
+    )
+
+    private fun afterCommit(action: () -> Unit) {
+        if (!TransactionSynchronizationManager.isSynchronizationActive()) {
+            action()
+            return
+        }
+        TransactionSynchronizationManager.registerSynchronization(
+            object : TransactionSynchronization {
+                override fun afterCommit() = action()
+            }
+        )
+    }
+
+    private fun CreatorRankingSnapshotCandidate.toSnapshotRecord(utcRange: CreatorRankingUtcRange): CreatorRankingSnapshotRecord {
+        val calculatedContentLiveScore = scorePolicy.calculateContentLiveScore(
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount
+        )
+        val calculatedEngagementScore = scorePolicy.calculateEngagementScore(
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount
+        )
+        val calculatedSupportScore = scorePolicy.calculateSupportScore(
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount
+        )
+        val calculatedFanLoyaltyScore = scorePolicy.calculateFanLoyaltyScore(
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+        val calculatedFinalScore = scorePolicy.calculateFinalScore(
+            contentLiveScore = calculatedContentLiveScore,
+            engagementScore = calculatedEngagementScore,
+            supportScore = calculatedSupportScore,
+            fanLoyaltyScore = calculatedFanLoyaltyScore
+        )
+
+        return CreatorRankingSnapshotRecord(
+            aggregationStartAtUtc = utcRange.startInclusiveUtc,
+            aggregationEndAtUtc = utcRange.endExclusiveUtc,
+            creatorId = creatorId,
+            nickname = nickname,
+            profileImageUrl = profileImageUrl,
+            finalScore = calculatedFinalScore,
+            contentLiveScore = calculatedContentLiveScore,
+            engagementScore = calculatedEngagementScore,
+            supportScore = calculatedSupportScore,
+            fanLoyaltyScore = calculatedFanLoyaltyScore,
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount,
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount,
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount,
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+    }
+
+    private fun List<CreatorRankingSnapshotRecord>.takeRankedBoundary(limit: Int): List<CreatorRankingSnapshotRecord> {
+        if (size <= limit) return this
+        val boundaryScore = this[limit - 1].finalScore
+        return filter { it.finalScore >= boundaryScore }
+    }
+
+    companion object {
+        private const val SNAPSHOT_LIMIT = 20
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingItem.kt

@@ -0,0 +1,10 @@
+package kr.co.vividnext.sodalive.v2.ranking.domain
+
+data class CreatorRankingItem(
+    val rank: Int,
+    val rankChange: Int?,
+    val isNew: Boolean,
+    val creatorId: Long,
+    val nickname: String,
+    val profileImageUrl: String?
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingPeriodPolicy.kt

@@ -0,0 +1,42 @@
+package kr.co.vividnext.sodalive.v2.ranking.domain
+
+import java.time.DayOfWeek
+import java.time.LocalDateTime
+import java.time.ZoneId
+import java.time.ZonedDateTime
+import java.time.temporal.TemporalAdjusters
+
+class CreatorRankingPeriodPolicy {
+    fun resolveLastCompletedWeek(now: ZonedDateTime): CreatorRankingPeriod {
+        val nowKst = now.withZoneSameInstant(KST_ZONE)
+        val thisWeekMonday = nowKst.toLocalDate()
+            .with(TemporalAdjusters.previousOrSame(DayOfWeek.MONDAY))
+            .atStartOfDay()
+        return CreatorRankingPeriod(
+            startInclusiveKst = thisWeekMonday.minusWeeks(1),
+            endExclusiveKst = thisWeekMonday
+        )
+    }
+
+    fun toUtcRange(period: CreatorRankingPeriod): CreatorRankingUtcRange {
+        return CreatorRankingUtcRange(
+            startInclusiveUtc = period.startInclusiveKst.atZone(KST_ZONE).withZoneSameInstant(UTC_ZONE).toLocalDateTime(),
+            endExclusiveUtc = period.endExclusiveKst.atZone(KST_ZONE).withZoneSameInstant(UTC_ZONE).toLocalDateTime()
+        )
+    }
+
+    companion object {
+        private val KST_ZONE: ZoneId = ZoneId.of("Asia/Seoul")
+        private val UTC_ZONE: ZoneId = ZoneId.of("UTC")
+    }
+}
+
+data class CreatorRankingPeriod(
+    val startInclusiveKst: LocalDateTime,
+    val endExclusiveKst: LocalDateTime
+)
+
+data class CreatorRankingUtcRange(
+    val startInclusiveUtc: LocalDateTime,
+    val endExclusiveUtc: LocalDateTime
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScorePolicy.kt

@@ -0,0 +1,49 @@
+package kr.co.vividnext.sodalive.v2.ranking.domain
+
+class CreatorRankingScorePolicy {
+    fun calculateContentLiveScore(
+        liveCanAmount: Long,
+        contentPurchaseCanAmount: Long
+    ): Double {
+        return (liveCanAmount * CreatorRankingScoreSpec.CONTENT_LIVE_CAN_WEIGHT) +
+            (contentPurchaseCanAmount * CreatorRankingScoreSpec.CONTENT_PURCHASE_CAN_WEIGHT)
+    }
+
+    fun calculateEngagementScore(
+        contentLikeCount: Long,
+        contentCommentCount: Long
+    ): Double {
+        return (contentLikeCount * CreatorRankingScoreSpec.CONTENT_LIKE_COUNT_WEIGHT) +
+            (contentCommentCount * CreatorRankingScoreSpec.CONTENT_COMMENT_COUNT_WEIGHT)
+    }
+
+    fun calculateSupportScore(
+        channelDonationCanAmount: Long,
+        channelDonationCount: Long,
+        fanTalkCount: Long
+    ): Double {
+        return (channelDonationCanAmount * CreatorRankingScoreSpec.CHANNEL_DONATION_CAN_WEIGHT) +
+            (channelDonationCount * CreatorRankingScoreSpec.CHANNEL_DONATION_COUNT_WEIGHT) +
+            (fanTalkCount * CreatorRankingScoreSpec.FAN_TALK_COUNT_WEIGHT)
+    }
+
+    fun calculateFanLoyaltyScore(
+        finalFollowerCount: Long,
+        followIncrease: Long
+    ): Double {
+        return (finalFollowerCount * CreatorRankingScoreSpec.FINAL_FOLLOWER_COUNT_WEIGHT) +
+            (followIncrease * CreatorRankingScoreSpec.FOLLOW_INCREASE_WEIGHT)
+    }
+
+    fun calculateFinalScore(
+        contentLiveScore: Double,
+        engagementScore: Double,
+        supportScore: Double,
+        fanLoyaltyScore: Double
+    ): Double {
+        return (contentLiveScore * CreatorRankingScoreSpec.CONTENT_LIVE_SCORE_WEIGHT) +
+            (engagementScore * CreatorRankingScoreSpec.ENGAGEMENT_SCORE_WEIGHT) +
+            (supportScore * CreatorRankingScoreSpec.SUPPORT_SCORE_WEIGHT) +
+            (fanLoyaltyScore * CreatorRankingScoreSpec.FAN_LOYALTY_SCORE_WEIGHT)
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScoreSpec.kt

@@ -0,0 +1,21 @@
+package kr.co.vividnext.sodalive.v2.ranking.domain
+
+object CreatorRankingScoreSpec {
+    const val CONTENT_LIVE_CAN_WEIGHT = 0.7
+    const val CONTENT_PURCHASE_CAN_WEIGHT = 0.3
+
+    const val CONTENT_LIKE_COUNT_WEIGHT = 0.5
+    const val CONTENT_COMMENT_COUNT_WEIGHT = 0.5
+
+    const val CHANNEL_DONATION_CAN_WEIGHT = 0.6
+    const val CHANNEL_DONATION_COUNT_WEIGHT = 0.2
+    const val FAN_TALK_COUNT_WEIGHT = 0.2
+
+    const val FINAL_FOLLOWER_COUNT_WEIGHT = 0.7
+    const val FOLLOW_INCREASE_WEIGHT = 0.3
+
+    const val CONTENT_LIVE_SCORE_WEIGHT = 0.35
+    const val ENGAGEMENT_SCORE_WEIGHT = 0.3
+    const val SUPPORT_SCORE_WEIGHT = 0.25
+    const val FAN_LOYALTY_SCORE_WEIGHT = 0.1
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingSnapshotCandidate.kt

@@ -0,0 +1,21 @@
+package kr.co.vividnext.sodalive.v2.ranking.domain
+
+data class CreatorRankingSnapshotCandidate(
+    val creatorId: Long,
+    val nickname: String,
+    val profileImageUrl: String?,
+    val finalScore: Double,
+    val contentLiveScore: Double,
+    val engagementScore: Double,
+    val supportScore: Double,
+    val fanLoyaltyScore: Double,
+    val liveCanAmount: Long,
+    val contentPurchaseCanAmount: Long,
+    val contentLikeCount: Long,
+    val contentCommentCount: Long,
+    val channelDonationCanAmount: Long,
+    val channelDonationCount: Long,
+    val fanTalkCount: Long,
+    val finalFollowerCount: Long,
+    val followIncrease: Long
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingAggregationPort.kt

@@ -0,0 +1,26 @@
+package kr.co.vividnext.sodalive.v2.ranking.port.out
+
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingSnapshotCandidate
+import java.time.LocalDateTime
+
+interface CreatorRankingAggregationPort {
+    fun aggregateCandidates(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotCandidate>
+
+    fun aggregateCandidateResult(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): CreatorRankingAggregationResult {
+        return CreatorRankingAggregationResult(
+            candidates = aggregateCandidates(startInclusiveUtc, endExclusiveUtc),
+            lowScoreExcludedCount = 0
+        )
+    }
+}
+
+data class CreatorRankingAggregationResult(
+    val candidates: List<CreatorRankingSnapshotCandidate>,
+    val lowScoreExcludedCount: Int
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingBlockPort.kt

@@ -0,0 +1,5 @@
+package kr.co.vividnext.sodalive.v2.ranking.port.out
+
+interface CreatorRankingBlockPort {
+    fun findBlockedCreatorIds(memberId: Long, creatorIds: Collection<Long>): Set<Long>
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingSnapshotJobPort.kt

@@ -0,0 +1,46 @@
+package kr.co.vividnext.sodalive.v2.ranking.port.out
+
+import java.time.LocalDateTime
+
+interface CreatorRankingSnapshotJobPort {
+    fun save(job: CreatorRankingSnapshotJobRecord): CreatorRankingSnapshotJobRecord
+
+    fun findById(jobId: Long): CreatorRankingSnapshotJobRecord?
+
+    fun findByPeriodAndStatuses(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        statuses: List<CreatorRankingSnapshotJobStatus>
+    ): List<CreatorRankingSnapshotJobRecord>
+
+    fun markProcessing(jobId: Long, processingStartedAt: LocalDateTime): CreatorRankingSnapshotJobRecord?
+
+    fun markDone(jobId: Long, processedAt: LocalDateTime): CreatorRankingSnapshotJobRecord?
+
+    fun markFailed(jobId: Long, processedAt: LocalDateTime, lastError: String?): CreatorRankingSnapshotJobRecord?
+
+    fun markPending(jobId: Long): CreatorRankingSnapshotJobRecord?
+}
+
+enum class CreatorRankingSnapshotJobStatus {
+    PENDING,
+    PROCESSING,
+    DONE,
+    FAILED
+}
+
+enum class CreatorRankingSnapshotJobTrigger {
+    SCHEDULED,
+    MANUAL
+}
+
+data class CreatorRankingSnapshotJobRecord(
+    val id: Long? = null,
+    val aggregationStartAtUtc: LocalDateTime,
+    val aggregationEndAtUtc: LocalDateTime,
+    val trigger: CreatorRankingSnapshotJobTrigger,
+    val status: CreatorRankingSnapshotJobStatus,
+    val lastError: String?,
+    val processingStartedAt: LocalDateTime?,
+    val processedAt: LocalDateTime?
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/ranking/port/out/CreatorRankingSnapshotPort.kt

@@ -0,0 +1,44 @@
+package kr.co.vividnext.sodalive.v2.ranking.port.out
+
+import java.time.LocalDateTime
+
+interface CreatorRankingSnapshotPort {
+    fun findSnapshotsByAggregationPeriod(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotRecord>
+
+    fun findLatestSnapshots(): List<CreatorRankingSnapshotRecord>
+
+    fun findPreviousCompletedSnapshots(): List<CreatorRankingSnapshotRecord>
+
+    fun isSnapshotTableEmpty(): Boolean
+
+    fun replaceSnapshots(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        newSnapshots: List<CreatorRankingSnapshotRecord>
+    )
+}
+
+data class CreatorRankingSnapshotRecord(
+    val aggregationStartAtUtc: LocalDateTime,
+    val aggregationEndAtUtc: LocalDateTime,
+    val creatorId: Long,
+    val nickname: String,
+    val profileImageUrl: String?,
+    val finalScore: Double,
+    val contentLiveScore: Double,
+    val engagementScore: Double,
+    val supportScore: Double,
+    val fanLoyaltyScore: Double,
+    val liveCanAmount: Long,
+    val contentPurchaseCanAmount: Long,
+    val contentLikeCount: Long,
+    val contentCommentCount: Long,
+    val channelDonationCanAmount: Long,
+    val channelDonationCount: Long,
+    val fanTalkCount: Long,
+    val finalFollowerCount: Long,
+    val followIncrease: Long
+)

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/persistence/HomeRecommendationQueryRepository.kt

@@ -1,7 +0,0 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
-
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeRecommendationQueryPort
-import org.springframework.data.repository.NoRepositoryBean
-
-@NoRepositoryBean
-interface HomeRecommendationQueryRepository : HomeRecommendationQueryPort

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommend/adapter/out/scheduler/RecommendationSnapshotScheduler.kt

@@ -1,15 +0,0 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.scheduler
-
-import kr.co.vividnext.sodalive.v2.recommend.application.RecommendationSnapshotRefreshService
-import org.springframework.scheduling.annotation.Scheduled
-import org.springframework.stereotype.Component
-
-@Component
-class RecommendationSnapshotScheduler(
-    private val refreshService: RecommendationSnapshotRefreshService
-) {
-    @Scheduled(cron = "0 0 6 * * *", zone = "Asia/Seoul")
-    fun refreshDailySnapshots() {
-        refreshService.refreshDailySnapshots()
-    }
-}

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistory.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import kr.co.vividnext.sodalive.common.BaseEntity
 import java.time.LocalDateTime

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistoryPersistenceAdapter.kt

@@ -1,10 +1,10 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import com.querydsl.jpa.impl.JPAQueryFactory
 import kr.co.vividnext.sodalive.content.QAudioContent.audioContent
 import kr.co.vividnext.sodalive.content.theme.QAudioContentTheme.audioContentTheme
-import kr.co.vividnext.sodalive.v2.recommend.port.out.CreatorContentViewHistoryPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.CreatorContentViewHistoryRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.CreatorContentViewHistoryPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.CreatorContentViewHistoryRecord
 import org.springframework.stereotype.Repository
 
 @Repository

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistoryRepository.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import org.springframework.data.jpa.repository.JpaRepository
 

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import com.querydsl.core.types.Expression
 import com.querydsl.core.types.Projections
@@ -24,20 +24,20 @@ import kr.co.vividnext.sodalive.live.room.QLiveRoom.liveRoom
 import kr.co.vividnext.sodalive.member.QMember
 import kr.co.vividnext.sodalive.member.QMember.member
 import kr.co.vividnext.sodalive.member.block.QBlockMember
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendationScoreSpec
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedActivityType
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeAiCharacterRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeBannerRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeCheerCreatorRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeFirstAudioContentRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeGenreCreatorRecommendationGroup
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeGenreCreatorRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeLiveRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomePopularCommunityRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentDebutCreatorRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentlyActiveCreatorRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotRecord
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendationScoreSpec
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedActivityType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeAiCharacterRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeBannerRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeCheerCreatorRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeFirstAudioContentRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeGenreCreatorRecommendationGroup
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeGenreCreatorRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeLiveRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomePopularCommunityRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentDebutCreatorRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentlyActiveCreatorRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotRecord
 import org.springframework.stereotype.Repository
 import java.sql.Timestamp
 import java.time.LocalDateTime
@@ -169,7 +169,7 @@ class DefaultHomeRecommendationQueryRepository(
                            m.profile_image as creator_profile_image,
                            'COMMUNITY' as activity_type,
                            cc.created_at as activity_at,
-                           cc.id as target_id,
+                           m.id as target_id,
                            cc.id as target_sort_id
                     from creator_community cc
                     join member m on m.id = cc.member_id
@@ -933,6 +933,7 @@ class DefaultHomeRecommendationQueryRepository(
                   and (:includeAdultGenres = true or c.is_adult = false)
                   and m.is_active = true
                   and m.role = 'CREATOR'
+                  and (:memberId is null or m.id <> :memberId)
                   and not exists (
                       select 1
                       from creator_following cf
@@ -1009,6 +1010,7 @@ class DefaultHomeRecommendationQueryRepository(
                   and (:includeAdultGenres = true or c.is_adult = false)
                   and m.is_active = true
                   and m.role = 'CREATOR'
+                  and (:memberId is null or m.id <> :memberId)
                   and not exists (
                       select 1
                       from creator_following cf
@@ -1052,6 +1054,7 @@ class DefaultHomeRecommendationQueryRepository(
                   and (:includeAdultGenres = true or c.is_adult = false)
                   and m.is_active = true
                   and m.role = 'CREATOR'
+                  and (:memberId is null or m.id <> :memberId)
                   and not exists (
                       select 1
                       from creator_following cf

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/HomeRecommendationQueryRepository.kt

@@ -0,0 +1,7 @@
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeRecommendationQueryPort
+import org.springframework.data.repository.NoRepositoryBean
+
+@NoRepositoryBean
+interface HomeRecommendationQueryRepository : HomeRecommendationQueryPort

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshot.kt

@@ -1,7 +1,7 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import kr.co.vividnext.sodalive.common.BaseEntity
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
 import java.time.LocalDateTime
 import javax.persistence.Column
 import javax.persistence.Entity

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshotPersistenceAdapter.kt

@@ -1,8 +1,8 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotRecord
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotRecord
 import org.springframework.stereotype.Repository
 import java.time.LocalDateTime
 

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshotRepository.kt

@@ -1,6 +1,6 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
 import org.springframework.data.jpa.repository.JpaRepository
 import org.springframework.data.jpa.repository.Query
 import org.springframework.data.repository.query.Param

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/scheduler/RecommendationSnapshotScheduler.kt

@@ -0,0 +1,29 @@
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.scheduler
+
+import kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotRefreshService
+import org.redisson.api.RedissonClient
+import org.springframework.scheduling.annotation.Scheduled
+import org.springframework.stereotype.Component
+import java.util.concurrent.TimeUnit
+
+@Component
+class RecommendationSnapshotScheduler(
+    private val refreshService: RecommendationSnapshotRefreshService,
+    private val redissonClient: RedissonClient
+) {
+    @Scheduled(cron = "0 0 6 * * *", zone = "Asia/Seoul")
+    fun refreshDailySnapshots() {
+        val lockName = "lock:recommendation-snapshot-refresh"
+        val lock = redissonClient.getLock(lockName)
+
+        try {
+            if (lock.tryLock(0, -1, TimeUnit.SECONDS)) {
+                refreshService.refreshDailySnapshots()
+            }
+        } finally {
+            if (lock.isHeldByCurrentThread) {
+                lock.unlock()
+            }
+        }
+    }
+}

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryService.kt

@@ -1,7 +1,7 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
-import kr.co.vividnext.sodalive.v2.recommend.port.out.CreatorContentViewHistoryPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.CreatorContentViewHistoryRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.CreatorContentViewHistoryPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.CreatorContentViewHistoryRecord
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Propagation

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt

@@ -1,18 +1,18 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedActivityType
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeAiCharacterRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeBannerRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeCheerCreatorRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeFirstAudioContentRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeGenreCreatorRecommendationGroup
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeLiveRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomePopularCommunityRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeRecommendationQueryPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentDebutCreatorRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentlyActiveCreatorRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotPort
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedActivityType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeAiCharacterRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeBannerRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeCheerCreatorRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeFirstAudioContentRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeGenreCreatorRecommendationGroup
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeLiveRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomePopularCommunityRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeRecommendationQueryPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentDebutCreatorRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentlyActiveCreatorRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotPort
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Transactional
 import java.time.LocalDateTime

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshService.kt

@@ -1,9 +1,9 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeRecommendationQueryPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotRecord
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeRecommendationQueryPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotRecord
 import org.slf4j.LoggerFactory
 import org.springframework.stereotype.Service
 import org.springframework.transaction.annotation.Transactional

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowService.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
 import kr.co.vividnext.sodalive.common.SodaException
 import kr.co.vividnext.sodalive.member.Member

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/CreatorDebutPolicy.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.domain
+package kr.co.vividnext.sodalive.v2.recommendation.domain
 
 import java.time.LocalDateTime
 import java.time.temporal.ChronoUnit

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicy.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.domain
+package kr.co.vividnext.sodalive.v2.recommendation.domain
 
 import java.time.LocalDateTime
 import java.time.temporal.ChronoUnit

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScoreSpec.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.domain
+package kr.co.vividnext.sodalive.v2.recommendation.domain
 
 object RecommendationScoreSpec {
     const val NEW_BOOST_10_DAY_LIMIT = 10L

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendedActivityType.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.domain
+package kr.co.vividnext.sodalive.v2.recommendation.domain
 
 enum class RecommendedActivityType(val code: String) {
     LIVE("LIVE"),

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendedSectionType.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.domain
+package kr.co.vividnext.sodalive.v2.recommendation.domain
 
 enum class RecommendedSectionType(val code: String) {
     LIVE("LIVE"),

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/CreatorContentViewHistoryPort.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.port.out
+package kr.co.vividnext.sodalive.v2.recommendation.port.out
 
 import java.time.LocalDateTime
 

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt

@@ -1,6 +1,6 @@
-package kr.co.vividnext.sodalive.v2.recommend.port.out
+package kr.co.vividnext.sodalive.v2.recommendation.port.out
 
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedActivityType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedActivityType
 import java.time.LocalDateTime
 
 interface HomeRecommendationQueryPort {

src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/RecommendationSnapshotPort.kt

@@ -1,6 +1,6 @@
-package kr.co.vividnext.sodalive.v2.recommend.port.out
+package kr.co.vividnext.sodalive.v2.recommendation.port.out
 
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
 import java.time.LocalDateTime
 
 interface RecommendationSnapshotPort {

src/test/kotlin/kr/co/vividnext/sodalive/content/AudioContentServiceTest.kt

@@ -21,7 +21,7 @@ import kr.co.vividnext.sodalive.i18n.SodaMessageSource
 import kr.co.vividnext.sodalive.i18n.translation.ResourceTranslationJobScheduler
 import kr.co.vividnext.sodalive.member.Member
 import kr.co.vividnext.sodalive.member.block.BlockMemberRepository
-import kr.co.vividnext.sodalive.v2.recommend.application.CreatorContentViewHistoryService
+import kr.co.vividnext.sodalive.v2.recommendation.application.CreatorContentViewHistoryService
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.Assertions.assertNull
 import org.junit.jupiter.api.Assertions.assertThrows

src/test/kotlin/kr/co/vividnext/sodalive/v2/admin/ranking/creator/AdminCreatorRankingSnapshotJobControllerTest.kt

@@ -0,0 +1,172 @@
+package kr.co.vividnext.sodalive.v2.admin.ranking.creator
+
+import kr.co.vividnext.sodalive.common.CountryContext
+import kr.co.vividnext.sodalive.i18n.LangContext
+import kr.co.vividnext.sodalive.i18n.SodaMessageSource
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobRecord
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobTrigger
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.mockito.Mockito
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.autoconfigure.web.servlet.WebMvcTest
+import org.springframework.boot.test.context.TestConfiguration
+import org.springframework.boot.test.mock.mockito.MockBean
+import org.springframework.context.annotation.Bean
+import org.springframework.context.annotation.Import
+import org.springframework.http.HttpStatus
+import org.springframework.http.MediaType
+import org.springframework.security.config.annotation.method.configuration.EnableGlobalMethodSecurity
+import org.springframework.security.config.annotation.web.builders.HttpSecurity
+import org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.anonymous
+import org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.user
+import org.springframework.security.web.SecurityFilterChain
+import org.springframework.security.web.authentication.HttpStatusEntryPoint
+import org.springframework.test.web.servlet.MockMvc
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.post
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status
+import java.time.LocalDateTime
+import javax.servlet.http.HttpServletResponse
+
+@WebMvcTest(AdminCreatorRankingSnapshotJobController::class)
+@Import(AdminCreatorRankingSnapshotJobControllerTest.TestSecurityConfig::class)
+class AdminCreatorRankingSnapshotJobControllerTest @Autowired constructor(
+    private val mockMvc: MockMvc
+) {
+    @MockBean
+    private lateinit var service: AdminCreatorRankingSnapshotJobService
+
+    @MockBean
+    private lateinit var countryContext: CountryContext
+
+    @MockBean
+    private lateinit var langContext: LangContext
+
+    @MockBean
+    private lateinit var sodaMessageSource: SodaMessageSource
+
+    @TestConfiguration
+    @EnableGlobalMethodSecurity(prePostEnabled = true)
+    class TestSecurityConfig {
+        @Bean
+        fun securityFilterChain(http: HttpSecurity): SecurityFilterChain {
+            return http
+                .csrf().disable()
+                .authorizeRequests()
+                .antMatchers("/admin/rankings/creators/snapshot-jobs/**").hasRole("ADMIN")
+                .anyRequest().permitAll()
+                .and()
+                .exceptionHandling()
+                .authenticationEntryPoint(HttpStatusEntryPoint(HttpStatus.UNAUTHORIZED))
+                .accessDeniedHandler { _, response, _ -> response.sendError(HttpServletResponse.SC_FORBIDDEN) }
+                .and()
+                .build()
+        }
+    }
+
+    @Test
+    @DisplayName("관리자는 날짜 범위로 크리에이터 랭킹 수동 스냅샷 job을 생성한다")
+    fun shouldCreateManualSnapshotJobForAdmin() {
+        val response = AdminCreatorRankingSnapshotJobResponse.from(manualJob(status = CreatorRankingSnapshotJobStatus.PENDING))
+        Mockito.`when`(
+            service.createManualJob(
+                AdminCreatorRankingSnapshotJobRequest(
+                    aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                    aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0)
+                )
+            )
+        ).thenReturn(response)
+
+        mockMvc.perform(
+            post("/admin/rankings/creators/snapshot-jobs")
+                .with(user("admin").roles("ADMIN"))
+                .contentType(MediaType.APPLICATION_JSON)
+                .content(
+                    """
+                    {
+                      "aggregationStartAtUtc": "2026-05-31T15:00:00",
+                      "aggregationEndAtUtc": "2026-06-07T15:00:00"
+                    }
+                    """.trimIndent()
+                )
+        )
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data.id").value(1L))
+            .andExpect(jsonPath("$.data.trigger").value("MANUAL"))
+            .andExpect(jsonPath("$.data.status").value("PENDING"))
+            .andExpect(jsonPath("$.data.retryable").value(false))
+    }
+
+    @Test
+    @DisplayName("관리자는 크리에이터 랭킹 스냅샷 job 목록을 조회한다")
+    fun shouldListSnapshotJobsForAdmin() {
+        Mockito.`when`(
+            service.getJobs(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                statuses = listOf(CreatorRankingSnapshotJobStatus.FAILED)
+            )
+        ).thenReturn(listOf(AdminCreatorRankingSnapshotJobResponse.from(manualJob(CreatorRankingSnapshotJobStatus.FAILED))))
+
+        mockMvc.perform(
+            get("/admin/rankings/creators/snapshot-jobs")
+                .param("aggregationStartAtUtc", "2026-05-31T15:00:00")
+                .param("aggregationEndAtUtc", "2026-06-07T15:00:00")
+                .param("statuses", "FAILED")
+                .with(user("admin").roles("ADMIN"))
+        )
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data[0].status").value("FAILED"))
+            .andExpect(jsonPath("$.data[0].lastError").value("aggregate failed"))
+            .andExpect(jsonPath("$.data[0].retryable").value(true))
+    }
+
+    @Test
+    @DisplayName("관리자는 실패한 크리에이터 랭킹 스냅샷 job 재시도를 요청한다")
+    fun shouldRetryFailedSnapshotJobForAdmin() {
+        mockMvc.perform(
+            post("/admin/rankings/creators/snapshot-jobs/1/retry")
+                .with(user("admin").roles("ADMIN"))
+        )
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.success").value(true))
+    }
+
+    @Test
+    @DisplayName("비관리자는 크리에이터 랭킹 스냅샷 job 관리자 API에 접근할 수 없다")
+    fun shouldRejectNonAdmin() {
+        mockMvc.perform(
+            post("/admin/rankings/creators/snapshot-jobs")
+                .with(user("user").roles("USER"))
+                .contentType(MediaType.APPLICATION_JSON)
+                .content("{}")
+        )
+            .andExpect(status().isForbidden)
+
+        mockMvc.perform(
+            post("/admin/rankings/creators/snapshot-jobs")
+                .with(anonymous())
+                .contentType(MediaType.APPLICATION_JSON)
+                .content("{}")
+        )
+            .andExpect(status().isUnauthorized)
+    }
+
+    private fun manualJob(status: CreatorRankingSnapshotJobStatus): CreatorRankingSnapshotJobRecord {
+        return CreatorRankingSnapshotJobRecord(
+            id = 1L,
+            aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+            aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+            trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+            status = status,
+            lastError = if (status == CreatorRankingSnapshotJobStatus.FAILED) "aggregate failed" else null,
+            processingStartedAt = null,
+            processedAt = null
+        )
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/CreatorRankingControllerTest.kt

@@ -0,0 +1,151 @@
+package kr.co.vividnext.sodalive.v2.api.home
+
+import kr.co.vividnext.sodalive.member.Member
+import kr.co.vividnext.sodalive.member.MemberAdapter
+import kr.co.vividnext.sodalive.member.MemberRepository
+import kr.co.vividnext.sodalive.member.MemberRole
+import kr.co.vividnext.sodalive.member.block.BlockMember
+import kr.co.vividnext.sodalive.support.EmbeddedRedisInitializer
+import kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence.CreatorRankingSnapshot
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.autoconfigure.web.servlet.AutoConfigureMockMvc
+import org.springframework.boot.test.context.SpringBootTest
+import org.springframework.security.test.web.servlet.request.SecurityMockMvcRequestPostProcessors.user
+import org.springframework.test.context.ContextConfiguration
+import org.springframework.test.web.servlet.MockMvc
+import org.springframework.test.web.servlet.request.MockMvcRequestBuilders.get
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.jsonPath
+import org.springframework.test.web.servlet.result.MockMvcResultMatchers.status
+import org.springframework.transaction.annotation.Transactional
+import java.time.LocalDateTime
+import javax.persistence.EntityManager
+
+@SpringBootTest
+@AutoConfigureMockMvc
+@Transactional
+@ContextConfiguration(initializers = [EmbeddedRedisInitializer::class])
+class CreatorRankingControllerTest @Autowired constructor(
+    private val mockMvc: MockMvc,
+    private val memberRepository: MemberRepository,
+    private val entityManager: EntityManager
+) {
+    @Test
+    @DisplayName("크리에이터 랭킹 조회는 허용된 응답 필드만 반환하고 점수와 기간은 노출하지 않는다")
+    fun shouldReturnCreatorRankingSchemaWithoutScoreAndPeriodFields() {
+        saveSnapshot(
+            creatorId = 1L,
+            nickname = "creator-one",
+            profileImageUrl = "profile-one.png",
+            finalScore = 100.0
+        )
+        entityManager.flush()
+        entityManager.clear()
+
+        mockMvc.perform(get("/api/v2/home/rankings/creators"))
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data.showRankChange").value(false))
+            .andExpect(jsonPath("$.data.items[0].rank").value(1))
+            .andExpect(jsonPath("$.data.items[0].rankChange").doesNotExist())
+            .andExpect(jsonPath("$.data.items[0].isNew").value(false))
+            .andExpect(jsonPath("$.data.items[0].creatorId").value(1L))
+            .andExpect(jsonPath("$.data.items[0].nickname").value("creator-one"))
+            .andExpect(jsonPath("$.data.items[0].profileImageUrl").value("profile-one.png"))
+            .andExpect(jsonPath("$.data.items[0].finalScore").doesNotExist())
+            .andExpect(jsonPath("$.data.items[0].aggregationStartAtUtc").doesNotExist())
+            .andExpect(jsonPath("$.data.items[0].aggregationEndAtUtc").doesNotExist())
+            .andExpect(jsonPath("$.data.aggregationStartAtUtc").doesNotExist())
+            .andExpect(jsonPath("$.data.aggregationEndAtUtc").doesNotExist())
+    }
+
+    @Test
+    @DisplayName("크리에이터 랭킹 조회는 비회원도 호출 가능하고 빈 랭킹을 성공 응답으로 반환한다")
+    fun shouldReturnEmptyCreatorRankingsForAnonymous() {
+        mockMvc.perform(get("/api/v2/home/rankings/creators"))
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data.showRankChange").value(false))
+            .andExpect(jsonPath("$.data.items").isArray)
+            .andExpect(jsonPath("$.data.items.length()").value(0))
+    }
+
+    @Test
+    @DisplayName("크리에이터 랭킹 조회는 인증 회원 id를 전달해 차단 크리에이터 정보를 마스킹한다")
+    fun shouldMaskBlockedCreatorForAuthenticatedMember() {
+        val viewer = saveMember("ranking-viewer", MemberRole.USER)
+        val blockedCreator = saveMember("blocked-creator", MemberRole.CREATOR)
+        saveSnapshot(
+            creatorId = blockedCreator.id!!,
+            nickname = blockedCreator.nickname,
+            profileImageUrl = "blocked-profile.png",
+            finalScore = 100.0
+        )
+        saveBlock(member = viewer, blockedMember = blockedCreator)
+        entityManager.flush()
+        entityManager.clear()
+
+        mockMvc.perform(
+            get("/api/v2/home/rankings/creators")
+                .with(user(MemberAdapter(viewer)))
+        )
+            .andExpect(status().isOk)
+            .andExpect(jsonPath("$.success").value(true))
+            .andExpect(jsonPath("$.data.items[0].rank").value(1))
+            .andExpect(jsonPath("$.data.items[0].creatorId").value(0L))
+            .andExpect(jsonPath("$.data.items[0].nickname").value(""))
+            .andExpect(jsonPath("$.data.items[0].profileImageUrl").value("/profile/default-profile.png"))
+    }
+
+    private fun saveMember(seed: String, role: MemberRole): Member {
+        return memberRepository.saveAndFlush(
+            Member(
+                email = "$seed@test.com",
+                password = "password",
+                nickname = seed,
+                role = role
+            )
+        )
+    }
+
+    private fun saveBlock(member: Member, blockedMember: Member) {
+        entityManager.persist(
+            BlockMember().apply {
+                this.member = member
+                this.blockedMember = blockedMember
+            }
+        )
+    }
+
+    private fun saveSnapshot(
+        creatorId: Long,
+        nickname: String,
+        profileImageUrl: String?,
+        finalScore: Double
+    ) {
+        entityManager.persist(
+            CreatorRankingSnapshot(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0, 0),
+                creatorId = creatorId,
+                nickname = nickname,
+                profileImageUrl = profileImageUrl,
+                finalScore = finalScore,
+                contentLiveScore = 0.0,
+                engagementScore = 0.0,
+                supportScore = 0.0,
+                fanLoyaltyScore = 0.0,
+                liveCanAmount = 0,
+                contentPurchaseCanAmount = 0,
+                contentLikeCount = 0,
+                contentCommentCount = 0,
+                channelDonationCanAmount = 0,
+                channelDonationCount = 0,
+                fanTalkCount = 0,
+                finalFollowerCount = 0,
+                followIncrease = 0
+            )
+        )
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/HomeRecommendationControllerTest.kt

@@ -11,7 +11,7 @@ import kr.co.vividnext.sodalive.member.following.CreatorFollowing
 import kr.co.vividnext.sodalive.member.following.CreatorFollowingRepository
 import kr.co.vividnext.sodalive.support.EmbeddedRedisInitializer
 import kr.co.vividnext.sodalive.v2.api.home.application.HomeRecommendationFacade
-import kr.co.vividnext.sodalive.v2.recommend.application.HomeRecommendationQueryService
+import kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryService
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.Assertions.assertNotNull
 import org.junit.jupiter.api.Assertions.assertThrows

src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/dto/recommendation/HomeRecommendationResponseTest.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.api.home.dto
+package kr.co.vividnext.sodalive.v2.api.home.dto.recommendation
 
 import com.fasterxml.jackson.module.kotlin.jacksonObjectMapper
 import org.junit.jupiter.api.Assertions.assertEquals

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingAggregationRepositoryTest.kt

@@ -0,0 +1,331 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.can.payment.PaymentGateway
+import kr.co.vividnext.sodalive.can.use.CanUsage
+import kr.co.vividnext.sodalive.can.use.UseCan
+import kr.co.vividnext.sodalive.can.use.UseCanCalculate
+import kr.co.vividnext.sodalive.can.use.UseCanCalculateStatus
+import kr.co.vividnext.sodalive.configs.QueryDslConfig
+import kr.co.vividnext.sodalive.content.AudioContent
+import kr.co.vividnext.sodalive.content.comment.AudioContentComment
+import kr.co.vividnext.sodalive.content.like.AudioContentLike
+import kr.co.vividnext.sodalive.content.theme.AudioContentTheme
+import kr.co.vividnext.sodalive.explorer.profile.CreatorCheers
+import kr.co.vividnext.sodalive.member.Member
+import kr.co.vividnext.sodalive.member.MemberRole
+import kr.co.vividnext.sodalive.member.following.CreatorFollowing
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.Assertions.assertFalse
+import org.junit.jupiter.api.Assertions.assertTrue
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest
+import org.springframework.context.annotation.Import
+import java.time.LocalDateTime
+import javax.persistence.EntityManager
+
+@DataJpaTest(
+    properties = [
+        "spring.cache.type=none",
+        "spring.datasource.url=jdbc:h2:mem:testdb;MODE=MySQL;NON_KEYWORDS=VALUE"
+    ]
+)
+@Import(QueryDslConfig::class)
+class DefaultCreatorRankingAggregationRepositoryTest @Autowired constructor(
+    private val entityManager: EntityManager
+) {
+    private val adapter = DefaultCreatorRankingAggregationRepository(entityManager)
+    private val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+    private val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+    private val inPeriod = LocalDateTime.of(2026, 6, 1, 0, 0)
+
+    @Test
+    @DisplayName("콘텐츠/라이브 캔은 사용 구분, 정산 상태, 환불 여부, UTC 기간으로 집계한다")
+    fun shouldAggregateLiveAndContentCanAmountsByUsageStatusRefundAndUtcPeriod() {
+        val creator = saveCreator("can-creator")
+        val user = saveUser("can-user")
+        saveUseCanCalculate(user, creator, CanUsage.DONATION, 10, UseCanCalculateStatus.RECEIVED, false, startAt)
+        saveUseCanCalculate(user, creator, CanUsage.LIVE, 20, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveUseCanCalculate(
+            user,
+            creator,
+            CanUsage.SPIN_ROULETTE,
+            30,
+            UseCanCalculateStatus.RECEIVED,
+            false,
+            endAt.minusSeconds(1)
+        )
+        saveUseCanCalculate(user, creator, CanUsage.ORDER_CONTENT, 40, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveUseCanCalculate(user, creator, CanUsage.DONATION, 100, UseCanCalculateStatus.RECEIVED, true, inPeriod)
+        saveUseCanCalculate(user, creator, CanUsage.LIVE, 200, UseCanCalculateStatus.CALCULATE_COMPLETE, false, inPeriod)
+        saveUseCanCalculate(
+            user,
+            creator,
+            CanUsage.ORDER_CONTENT,
+            300,
+            UseCanCalculateStatus.RECEIVED,
+            false,
+            startAt.minusSeconds(1)
+        )
+        saveUseCanCalculate(user, creator, CanUsage.ORDER_CONTENT, 400, UseCanCalculateStatus.RECEIVED, false, endAt)
+        flushAndClear()
+
+        val candidate = aggregate().single()
+
+        assertEquals(60, candidate.liveCanAmount)
+        assertEquals(40, candidate.contentPurchaseCanAmount)
+    }
+
+    @Test
+    @DisplayName("활성 콘텐츠의 활성 좋아요와 작성자 본인이 아닌 활성 댓글/대댓글만 집계한다")
+    fun shouldAggregateActiveContentLikesAndCommentsExcludingCreatorSelfResponses() {
+        val creator = saveCreator("engagement-creator")
+        val otherCreator = saveCreator("inactive-content-creator")
+        val user = saveUser("engagement-user")
+        val content = saveAudioContent(creator, isActive = true)
+        val inactiveContent = saveAudioContent(otherCreator, isActive = false)
+        saveUseCanCalculate(user, creator, CanUsage.DONATION, 10, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveContentLike(content, user, isActive = true, createdAt = inPeriod)
+        saveContentLike(content, user, isActive = false, createdAt = inPeriod)
+        saveContentLike(content, user, isActive = true, createdAt = startAt.minusSeconds(1))
+        saveContentLike(inactiveContent, user, isActive = true, createdAt = inPeriod)
+        val parent = saveContentComment(content, user, isActive = true, createdAt = inPeriod)
+        saveContentComment(content, user, parent = parent, isActive = true, createdAt = inPeriod)
+        saveContentComment(content, creator, isActive = true, createdAt = inPeriod)
+        saveContentComment(content, user, isActive = false, createdAt = inPeriod)
+        saveContentComment(content, user, isActive = true, createdAt = endAt)
+        saveContentComment(inactiveContent, user, isActive = true, createdAt = inPeriod)
+        flushAndClear()
+
+        val candidate = aggregate().single { it.creatorId == creator.id }
+
+        assertEquals(1, candidate.contentLikeCount)
+        assertEquals(2, candidate.contentCommentCount)
+    }
+
+    @Test
+    @DisplayName("채널 후원 캔/건수와 최상위 활성 팬 Talk만 집계한다")
+    fun shouldAggregateChannelDonationAndTopLevelActiveFanTalks() {
+        val creator = saveCreator("support-creator")
+        val user = saveUser("support-user")
+        saveUseCanCalculate(user, creator, CanUsage.CHANNEL_DONATION, 100, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveUseCanCalculate(user, creator, CanUsage.CHANNEL_DONATION, 200, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveUseCanCalculate(user, creator, CanUsage.CHANNEL_DONATION, 300, UseCanCalculateStatus.RECEIVED, true, inPeriod)
+        saveUseCanCalculate(user, creator, CanUsage.CHANNEL_DONATION, 400, UseCanCalculateStatus.REFUND, false, inPeriod)
+        val topLevel = saveCreatorCheers(creator, user, isActive = true, createdAt = inPeriod)
+        saveCreatorCheers(creator, user, parent = topLevel, isActive = true, createdAt = inPeriod)
+        saveCreatorCheers(creator, user, isActive = false, createdAt = inPeriod)
+        saveCreatorCheers(creator, user, isActive = true, createdAt = endAt)
+        flushAndClear()
+
+        val candidate = aggregate().single()
+
+        assertEquals(300, candidate.channelDonationCanAmount)
+        assertEquals(2, candidate.channelDonationCount)
+        assertEquals(1, candidate.fanTalkCount)
+    }
+
+    @Test
+    @DisplayName("팔로우 최종 활성 수와 현재 row 기준 생성/비활성 변경 증가 수를 집계한다")
+    fun shouldAggregateFinalFollowerCountAndFollowIncreaseFromCurrentRows() {
+        val creator = saveCreator("follow-creator")
+        val activeFollower = saveUser("active-follower")
+        val newFollower = saveUser("new-follower")
+        val unfollower = saveUser("unfollower")
+        val oldInactiveFollower = saveUser("old-inactive-follower")
+        saveUseCanCalculate(activeFollower, creator, CanUsage.DONATION, 10, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveFollowing(
+            creator,
+            activeFollower,
+            isActive = true,
+            createdAt = startAt.minusDays(5),
+            updatedAt = startAt.minusDays(5)
+        )
+        saveFollowing(creator, newFollower, isActive = true, createdAt = inPeriod, updatedAt = inPeriod)
+        saveFollowing(creator, unfollower, isActive = false, createdAt = startAt.minusDays(10), updatedAt = inPeriod)
+        saveFollowing(
+            creator,
+            oldInactiveFollower,
+            isActive = false,
+            createdAt = startAt.minusDays(10),
+            updatedAt = startAt.minusSeconds(1)
+        )
+        flushAndClear()
+
+        val candidate = aggregate().single()
+
+        assertEquals(2, candidate.finalFollowerCount)
+        // 현재 CreatorFollowing row만으로 집계하므로 기간 내 재팔로우 이력은 별도 이벤트로 복원하지 않는다.
+        assertEquals(0, candidate.followIncrease)
+    }
+
+    @Test
+    @DisplayName("활성 크리에이터별 원천 지표를 합쳐 1점 이상 후보만 점수와 함께 반환한다")
+    fun shouldMergeMetricsForActiveCreatorsAndExcludeInactiveNonCreatorAndLowScoreCandidates() {
+        val creator = saveCreator("merged-creator", profileImage = "merged.png")
+        val lowScoreCreator = saveCreator("low-score-creator")
+        val inactiveCreator = saveCreator("inactive-creator", isActive = false)
+        val nonCreator = saveUser("non-creator")
+        val user = saveUser("merged-user")
+        saveUseCanCalculate(user, creator, CanUsage.DONATION, 10, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveContentLike(saveAudioContent(creator, isActive = true), user, isActive = true, createdAt = inPeriod)
+        saveUseCanCalculate(user, inactiveCreator, CanUsage.DONATION, 1000, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveUseCanCalculate(user, nonCreator, CanUsage.DONATION, 1000, UseCanCalculateStatus.RECEIVED, false, inPeriod)
+        saveFollowing(lowScoreCreator, user, isActive = true, createdAt = startAt.minusDays(1), updatedAt = startAt.minusDays(1))
+        flushAndClear()
+
+        val candidates = aggregate()
+
+        assertEquals(listOf(creator.id), candidates.map { it.creatorId })
+        val candidate = candidates.single()
+        assertEquals("merged-creator", candidate.nickname)
+        assertEquals("merged.png", candidate.profileImageUrl)
+        assertEquals(10, candidate.liveCanAmount)
+        assertEquals(0, candidate.contentPurchaseCanAmount)
+        assertEquals(1, candidate.contentLikeCount)
+        assertEquals(7.0, candidate.contentLiveScore, 0.0001)
+        assertEquals(0.5, candidate.engagementScore, 0.0001)
+        assertEquals(0.0, candidate.supportScore, 0.0001)
+        assertEquals(0.0, candidate.fanLoyaltyScore, 0.0001)
+        assertEquals(2.6, candidate.finalScore, 0.0001)
+        assertTrue(candidate.finalScore >= 1.0)
+        assertFalse(candidates.any { it.creatorId == lowScoreCreator.id })
+        assertFalse(candidates.any { it.creatorId == inactiveCreator.id })
+        assertFalse(candidates.any { it.creatorId == nonCreator.id })
+    }
+
+    private fun aggregate() = adapter.aggregateCandidates(startAt, endAt)
+
+    private fun saveCreator(nickname: String, profileImage: String? = null, isActive: Boolean = true): Member {
+        return saveMember(nickname, MemberRole.CREATOR, profileImage, isActive)
+    }
+
+    private fun saveUser(nickname: String): Member {
+        return saveMember(nickname, MemberRole.USER, null, true)
+    }
+
+    private fun saveMember(nickname: String, role: MemberRole, profileImage: String?, isActive: Boolean): Member {
+        val member = Member(
+            email = "$nickname@test.com",
+            password = "password",
+            nickname = nickname,
+            profileImage = profileImage,
+            role = role,
+            isActive = isActive
+        )
+        entityManager.persist(member)
+        entityManager.flush()
+        return member
+    }
+
+    private fun saveAudioContent(creator: Member, isActive: Boolean): AudioContent {
+        val theme = AudioContentTheme(theme = "theme-${creator.nickname}", image = "theme.png")
+        entityManager.persist(theme)
+        val content = AudioContent(
+            title = "content-${creator.nickname}",
+            detail = "detail",
+            languageCode = "ko",
+            releaseDate = inPeriod
+        )
+        content.member = creator
+        content.theme = theme
+        content.isActive = isActive
+        entityManager.persist(content)
+        return content
+    }
+
+    private fun saveUseCanCalculate(
+        member: Member,
+        creator: Member,
+        usage: CanUsage,
+        can: Int,
+        status: UseCanCalculateStatus,
+        isRefund: Boolean,
+        createdAt: LocalDateTime
+    ) {
+        val useCan = UseCan(canUsage = usage, can = can, rewardCan = 0, isRefund = isRefund)
+        useCan.member = member
+        entityManager.persist(useCan)
+        val calculate = UseCanCalculate(can = can, paymentGateway = PaymentGateway.PG, status = status)
+        calculate.useCan = useCan
+        calculate.recipientCreatorId = creator.id
+        entityManager.persist(calculate)
+        entityManager.flush()
+        updateTimestamps("use_can_calculate", calculate.id!!, createdAt, createdAt)
+    }
+
+    private fun saveContentLike(content: AudioContent, member: Member, isActive: Boolean, createdAt: LocalDateTime) {
+        val like = AudioContentLike(memberId = member.id!!)
+        like.audioContent = content
+        like.isActive = isActive
+        entityManager.persist(like)
+        entityManager.flush()
+        updateTimestamps("content_like", like.id!!, createdAt, createdAt)
+    }
+
+    private fun saveContentComment(
+        content: AudioContent,
+        member: Member,
+        parent: AudioContentComment? = null,
+        isActive: Boolean,
+        createdAt: LocalDateTime
+    ): AudioContentComment {
+        val comment = AudioContentComment(comment = "comment", languageCode = "ko", isActive = isActive)
+        comment.audioContent = content
+        comment.member = member
+        comment.parent = parent
+        entityManager.persist(comment)
+        entityManager.flush()
+        updateTimestamps("content_comment", comment.id!!, createdAt, createdAt)
+        return comment
+    }
+
+    private fun saveCreatorCheers(
+        creator: Member,
+        member: Member,
+        parent: CreatorCheers? = null,
+        isActive: Boolean,
+        createdAt: LocalDateTime
+    ): CreatorCheers {
+        val cheers = CreatorCheers(cheers = "cheers", languageCode = "ko", isActive = isActive)
+        cheers.creator = creator
+        cheers.member = member
+        cheers.parent = parent
+        entityManager.persist(cheers)
+        entityManager.flush()
+        updateTimestamps("creator_cheers", cheers.id!!, createdAt, createdAt)
+        return cheers
+    }
+
+    private fun saveFollowing(
+        creator: Member,
+        member: Member,
+        isActive: Boolean,
+        createdAt: LocalDateTime,
+        updatedAt: LocalDateTime
+    ) {
+        val following = CreatorFollowing(isActive = isActive)
+        following.creator = creator
+        following.member = member
+        entityManager.persist(following)
+        entityManager.flush()
+        updateTimestamps("creator_following", following.id!!, createdAt, updatedAt)
+    }
+
+    private fun updateTimestamps(tableName: String, id: Long, createdAt: LocalDateTime, updatedAt: LocalDateTime) {
+        entityManager.createNativeQuery(
+            "update $tableName set created_at = :createdAt, updated_at = :updatedAt where id = :id"
+        )
+            .setParameter("createdAt", createdAt)
+            .setParameter("updatedAt", updatedAt)
+            .setParameter("id", id)
+            .executeUpdate()
+        entityManager.clear()
+    }
+
+    private fun flushAndClear() {
+        entityManager.flush()
+        entityManager.clear()
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotJobRepositoryTest.kt

@@ -0,0 +1,130 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.configs.QueryDslConfig
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobRecord
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobTrigger
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest
+import org.springframework.context.annotation.Import
+import java.time.LocalDateTime
+
+@DataJpaTest(
+    properties = [
+        "spring.cache.type=none",
+        "spring.datasource.url=jdbc:h2:mem:testdb;MODE=MySQL;NON_KEYWORDS=VALUE"
+    ]
+)
+@Import(QueryDslConfig::class)
+class DefaultCreatorRankingSnapshotJobRepositoryTest @Autowired constructor(
+    private val repository: CreatorRankingSnapshotJobRepository
+) {
+    private val adapter = DefaultCreatorRankingSnapshotJobRepository(repository)
+
+    @Test
+    @DisplayName("스냅샷 job은 기간, 트리거, 상태, 처리 시각, 실패 사유를 저장하고 조회한다")
+    fun shouldSaveAndFindSnapshotJobHistoryByPeriodAndStatus() {
+        val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+
+        val saved = adapter.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = startAt,
+                aggregationEndAtUtc = endAt,
+                trigger = CreatorRankingSnapshotJobTrigger.SCHEDULED,
+                status = CreatorRankingSnapshotJobStatus.PENDING,
+                lastError = null,
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+        val savedId = saved.id!!
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, adapter.findById(savedId)?.status)
+
+        val processingStartedAt = LocalDateTime.of(2026, 6, 8, 7, 30)
+        adapter.markProcessing(savedId, processingStartedAt)
+        val processingJob = adapter.findById(savedId)
+        assertEquals(CreatorRankingSnapshotJobStatus.PROCESSING, processingJob?.status)
+        assertEquals(processingStartedAt, processingJob?.processingStartedAt)
+
+        val processedAt = LocalDateTime.of(2026, 6, 8, 7, 31)
+        adapter.markDone(savedId, processedAt)
+        val failed = adapter.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = startAt.minusWeeks(1),
+                aggregationEndAtUtc = endAt.minusWeeks(1),
+                trigger = CreatorRankingSnapshotJobTrigger.SCHEDULED,
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                lastError = "aggregate failed",
+                processingStartedAt = LocalDateTime.of(2026, 6, 1, 7, 30),
+                processedAt = LocalDateTime.of(2026, 6, 1, 7, 31)
+            )
+        )
+
+        val jobs = adapter.findByPeriodAndStatuses(
+            aggregationStartAtUtc = startAt,
+            aggregationEndAtUtc = endAt,
+            statuses = listOf(CreatorRankingSnapshotJobStatus.DONE)
+        )
+        val failedJob = adapter.findById(failed.id!!)
+
+        assertEquals(1, jobs.size)
+        assertEquals(CreatorRankingSnapshotJobTrigger.SCHEDULED, jobs.single().trigger)
+        assertEquals(CreatorRankingSnapshotJobStatus.DONE, jobs.single().status)
+        assertEquals(processingStartedAt, jobs.single().processingStartedAt)
+        assertEquals(processedAt, jobs.single().processedAt)
+        assertEquals(null, jobs.single().lastError)
+        assertEquals(CreatorRankingSnapshotJobStatus.FAILED, failedJob?.status)
+        assertEquals("aggregate failed", failedJob?.lastError)
+    }
+
+    @Test
+    @DisplayName("실패한 스냅샷 job은 PENDING으로 되돌리며 실패/처리 정보를 초기화한다")
+    fun shouldMarkFailedSnapshotJobPendingForRetry() {
+        val saved = adapter.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                lastError = "aggregate failed",
+                processingStartedAt = LocalDateTime.of(2026, 6, 8, 7, 30),
+                processedAt = LocalDateTime.of(2026, 6, 8, 7, 31)
+            )
+        )
+
+        val retried = adapter.markPending(saved.id!!)
+        val allRows = repository.findAll()
+
+        assertEquals(1, allRows.size)
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, retried?.status)
+        assertEquals(null, retried?.lastError)
+        assertEquals(null, retried?.processingStartedAt)
+        assertEquals(null, retried?.processedAt)
+    }
+
+    @Test
+    @DisplayName("실패 상태가 아닌 스냅샷 job은 재시도 대기 상태로 변경하지 않는다")
+    fun shouldNotMarkNonFailedSnapshotJobPendingForRetry() {
+        val saved = adapter.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.DONE,
+                lastError = null,
+                processingStartedAt = LocalDateTime.of(2026, 6, 8, 7, 30),
+                processedAt = LocalDateTime.of(2026, 6, 8, 7, 31)
+            )
+        )
+
+        val unchanged = adapter.markPending(saved.id!!)
+
+        assertEquals(CreatorRankingSnapshotJobStatus.DONE, unchanged?.status)
+        assertEquals(LocalDateTime.of(2026, 6, 8, 7, 30), unchanged?.processingStartedAt)
+        assertEquals(LocalDateTime.of(2026, 6, 8, 7, 31), unchanged?.processedAt)
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/persistence/DefaultCreatorRankingSnapshotRepositoryTest.kt

@@ -0,0 +1,248 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.persistence
+
+import kr.co.vividnext.sodalive.configs.QueryDslConfig
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotRecord
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.springframework.beans.factory.annotation.Autowired
+import org.springframework.boot.test.autoconfigure.orm.jpa.DataJpaTest
+import org.springframework.context.annotation.Import
+import java.time.LocalDateTime
+
+@DataJpaTest(
+    properties = [
+        "spring.cache.type=none",
+        "spring.datasource.url=jdbc:h2:mem:testdb;MODE=MySQL;NON_KEYWORDS=VALUE"
+    ]
+)
+@Import(QueryDslConfig::class)
+class DefaultCreatorRankingSnapshotRepositoryTest @Autowired constructor(
+    private val repository: CreatorRankingSnapshotRepository
+) {
+    private val adapter = DefaultCreatorRankingSnapshotRepository(repository)
+
+    @Test
+    @DisplayName("같은 집계 기간의 스냅샷은 삭제 후 새 후보로 교체한다")
+    fun shouldReplaceSnapshotsByAggregationPeriod() {
+        val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+        val oldStartAt = startAt.minusWeeks(1)
+        val oldEndAt = endAt.minusWeeks(1)
+        repository.saveAll(
+            listOf(
+                snapshot(creatorId = 1L, aggregationStartAtUtc = oldStartAt, aggregationEndAtUtc = oldEndAt),
+                snapshot(creatorId = 2L, aggregationStartAtUtc = startAt, aggregationEndAtUtc = endAt)
+            )
+        )
+
+        adapter.replaceSnapshots(
+            aggregationStartAtUtc = startAt,
+            aggregationEndAtUtc = endAt,
+            newSnapshots = listOf(snapshotRecord(creatorId = 3L, aggregationStartAtUtc = startAt, aggregationEndAtUtc = endAt))
+        )
+
+        val allSnapshots = repository.findAll()
+        assertEquals(listOf(1L, 3L), allSnapshots.map { it.creatorId }.sorted())
+        assertEquals(listOf(3L), adapter.findLatestSnapshots().map { it.creatorId })
+    }
+
+    @Test
+    @DisplayName("최신 완료 주차 스냅샷은 최신 종료 시각 기준으로 최종 점수 내림차순 조회한다")
+    fun shouldFindLatestSnapshotsByLatestAggregationEndAndFinalScoreDescending() {
+        val oldStartAt = LocalDateTime.of(2026, 5, 24, 15, 0)
+        val oldEndAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val latestStartAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val latestEndAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+        repository.saveAll(
+            listOf(
+                snapshot(
+                    creatorId = 1L,
+                    finalScore = 999.0,
+                    aggregationStartAtUtc = oldStartAt,
+                    aggregationEndAtUtc = oldEndAt
+                ),
+                snapshot(
+                    creatorId = 2L,
+                    finalScore = 100.0,
+                    aggregationStartAtUtc = latestStartAt,
+                    aggregationEndAtUtc = latestEndAt
+                ),
+                snapshot(
+                    creatorId = 3L,
+                    finalScore = 300.0,
+                    aggregationStartAtUtc = latestStartAt,
+                    aggregationEndAtUtc = latestEndAt
+                ),
+                snapshot(
+                    creatorId = 4L,
+                    finalScore = 200.0,
+                    aggregationStartAtUtc = latestStartAt,
+                    aggregationEndAtUtc = latestEndAt
+                )
+            )
+        )
+
+        val latestSnapshots = adapter.findLatestSnapshots()
+
+        assertEquals(listOf(3L, 4L, 2L), latestSnapshots.map { it.creatorId })
+        assertEquals(listOf(latestStartAt, latestStartAt, latestStartAt), latestSnapshots.map { it.aggregationStartAtUtc })
+        assertEquals(listOf(latestEndAt, latestEndAt, latestEndAt), latestSnapshots.map { it.aggregationEndAtUtc })
+    }
+
+    @Test
+    @DisplayName("직전 완료 주차 스냅샷은 최신 종료 시각보다 이전인 가장 큰 종료 시각 기준으로 조회한다")
+    fun shouldFindPreviousCompletedSnapshotsBeforeLatestPeriod() {
+        val oldestStartAt = LocalDateTime.of(2026, 5, 17, 15, 0)
+        val oldestEndAt = LocalDateTime.of(2026, 5, 24, 15, 0)
+        val previousStartAt = LocalDateTime.of(2026, 5, 24, 15, 0)
+        val previousEndAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val latestStartAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val latestEndAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+        repository.saveAll(
+            listOf(
+                snapshot(creatorId = 1L, aggregationStartAtUtc = oldestStartAt, aggregationEndAtUtc = oldestEndAt),
+                snapshot(
+                    creatorId = 2L,
+                    finalScore = 200.0,
+                    aggregationStartAtUtc = previousStartAt,
+                    aggregationEndAtUtc = previousEndAt
+                ),
+                snapshot(
+                    creatorId = 3L,
+                    finalScore = 300.0,
+                    aggregationStartAtUtc = previousStartAt,
+                    aggregationEndAtUtc = previousEndAt
+                ),
+                snapshot(creatorId = 4L, aggregationStartAtUtc = latestStartAt, aggregationEndAtUtc = latestEndAt)
+            )
+        )
+
+        val previousSnapshots = adapter.findPreviousCompletedSnapshots()
+
+        assertEquals(listOf(3L, 2L), previousSnapshots.map { it.creatorId })
+        assertEquals(listOf(previousEndAt, previousEndAt), previousSnapshots.map { it.aggregationEndAtUtc })
+    }
+
+    @Test
+    @DisplayName("요청한 집계 기간에 스냅샷이 없으면 이전 주차를 대신 반환하지 않는다")
+    fun shouldReturnEmptyWhenRequestedAggregationPeriodHasNoSnapshots() {
+        val previousStartAt = LocalDateTime.of(2026, 5, 24, 15, 0)
+        val previousEndAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val requestedStartAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val requestedEndAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+        repository.save(
+            snapshot(
+                creatorId = 1L,
+                aggregationStartAtUtc = previousStartAt,
+                aggregationEndAtUtc = previousEndAt
+            )
+        )
+
+        val snapshots = adapter.findSnapshotsByAggregationPeriod(
+            aggregationStartAtUtc = requestedStartAt,
+            aggregationEndAtUtc = requestedEndAt
+        )
+
+        assertEquals(emptyList<CreatorRankingSnapshotRecord>(), snapshots)
+    }
+
+    @Test
+    @DisplayName("스냅샷 row가 하나도 없을 때만 테이블 완전 공백으로 판단한다")
+    fun shouldReturnTrueOnlyWhenSnapshotTableHasNoRows() {
+        assertEquals(true, adapter.isSnapshotTableEmpty())
+
+        repository.save(
+            snapshot(
+                creatorId = 1L,
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 24, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0)
+            )
+        )
+
+        assertEquals(false, adapter.isSnapshotTableEmpty())
+    }
+
+    @Test
+    @DisplayName("20위 점수 경계 동점 후보는 저장소에서 누락 없이 저장하고 조회할 수 있다")
+    fun shouldPersistAllCandidatesTiedAtTwentiethScoreBoundary() {
+        val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+        val candidates = (1L..19L).map { creatorId ->
+            snapshotRecord(
+                creatorId = creatorId,
+                finalScore = 1000.0 - creatorId,
+                aggregationStartAtUtc = startAt,
+                aggregationEndAtUtc = endAt
+            )
+        } + listOf(
+            snapshotRecord(creatorId = 20L, finalScore = 500.0, aggregationStartAtUtc = startAt, aggregationEndAtUtc = endAt),
+            snapshotRecord(creatorId = 21L, finalScore = 500.0, aggregationStartAtUtc = startAt, aggregationEndAtUtc = endAt),
+            snapshotRecord(creatorId = 22L, finalScore = 500.0, aggregationStartAtUtc = startAt, aggregationEndAtUtc = endAt)
+        )
+
+        adapter.replaceSnapshots(startAt, endAt, candidates)
+
+        val latestSnapshots = adapter.findLatestSnapshots()
+        assertEquals(22, latestSnapshots.size)
+        assertEquals(setOf(20L, 21L, 22L), latestSnapshots.takeLast(3).map { it.creatorId }.toSet())
+    }
+
+    private fun snapshot(
+        creatorId: Long,
+        finalScore: Double = 100.0,
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): CreatorRankingSnapshot {
+        return CreatorRankingSnapshot(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            creatorId = creatorId,
+            nickname = "creator-$creatorId",
+            profileImageUrl = "profile-$creatorId.png",
+            finalScore = finalScore,
+            contentLiveScore = 10.0,
+            engagementScore = 20.0,
+            supportScore = 30.0,
+            fanLoyaltyScore = 40.0,
+            liveCanAmount = 100,
+            contentPurchaseCanAmount = 200,
+            contentLikeCount = 3,
+            contentCommentCount = 4,
+            channelDonationCanAmount = 500,
+            channelDonationCount = 6,
+            fanTalkCount = 7,
+            finalFollowerCount = 8,
+            followIncrease = -1
+        )
+    }
+
+    private fun snapshotRecord(
+        creatorId: Long,
+        finalScore: Double = 100.0,
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): CreatorRankingSnapshotRecord {
+        return CreatorRankingSnapshotRecord(
+            aggregationStartAtUtc = aggregationStartAtUtc,
+            aggregationEndAtUtc = aggregationEndAtUtc,
+            creatorId = creatorId,
+            nickname = "creator-$creatorId",
+            profileImageUrl = "profile-$creatorId.png",
+            finalScore = finalScore,
+            contentLiveScore = 10.0,
+            engagementScore = 20.0,
+            supportScore = 30.0,
+            fanLoyaltyScore = 40.0,
+            liveCanAmount = 100,
+            contentPurchaseCanAmount = 200,
+            contentLikeCount = 3,
+            contentCommentCount = 4,
+            channelDonationCanAmount = 500,
+            channelDonationCount = 6,
+            fanTalkCount = 7,
+            finalFollowerCount = 8,
+            followIncrease = -1
+        )
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/adapter/out/scheduler/CreatorRankingSnapshotSchedulerTest.kt

@@ -0,0 +1,72 @@
+package kr.co.vividnext.sodalive.v2.ranking.adapter.out.scheduler
+
+import kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotJobService
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.mockito.Mockito
+import org.redisson.api.RLock
+import org.redisson.api.RedissonClient
+import org.springframework.scheduling.annotation.Scheduled
+import java.util.concurrent.TimeUnit
+
+class CreatorRankingSnapshotSchedulerTest {
+    @Test
+    @DisplayName("주간 스냅샷 스케줄러는 매주 월요일 07:30 KST cron으로 job 서비스를 호출한다")
+    fun shouldScheduleWeeklySnapshotRefreshAtKstMondaySevenThirty() {
+        val scheduled = CreatorRankingSnapshotScheduler::class.java
+            .getDeclaredMethod("refreshLastCompletedWeek")
+            .getAnnotation(Scheduled::class.java)
+        val service = Mockito.mock(CreatorRankingSnapshotJobService::class.java)
+        val redissonClient = Mockito.mock(RedissonClient::class.java)
+        val lock = Mockito.mock(RLock::class.java)
+        Mockito.`when`(redissonClient.getLock("lock:creator-ranking-snapshot-refresh")).thenReturn(lock)
+        Mockito.`when`(lock.tryLock(0, -1, TimeUnit.SECONDS)).thenReturn(true)
+        Mockito.`when`(lock.isHeldByCurrentThread).thenReturn(true)
+        val scheduler = CreatorRankingSnapshotScheduler(service, redissonClient)
+
+        scheduler.refreshLastCompletedWeek()
+
+        assertEquals("0 30 7 * * MON", scheduled.cron)
+        assertEquals("Asia/Seoul", scheduled.zone)
+        Mockito.verify(service).refreshLastCompletedWeekByScheduledJob()
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 스케줄러는 Redisson lock을 획득한 인스턴스만 갱신을 실행한다")
+    fun shouldRefreshLastCompletedWeekOnlyWhenRedissonLockAcquired() {
+        val service = Mockito.mock(CreatorRankingSnapshotJobService::class.java)
+        val redissonClient = Mockito.mock(RedissonClient::class.java)
+        val lock = Mockito.mock(RLock::class.java)
+        Mockito.`when`(redissonClient.getLock("lock:creator-ranking-snapshot-refresh")).thenReturn(lock)
+        Mockito.`when`(lock.tryLock(0, -1, TimeUnit.SECONDS)).thenReturn(true)
+        Mockito.`when`(lock.isHeldByCurrentThread).thenReturn(true)
+        val scheduler = CreatorRankingSnapshotScheduler(service, redissonClient)
+
+        scheduler.refreshLastCompletedWeek()
+
+        Mockito.verify(redissonClient).getLock("lock:creator-ranking-snapshot-refresh")
+        Mockito.verify(lock).tryLock(0, -1, TimeUnit.SECONDS)
+        Mockito.verify(service).refreshLastCompletedWeekByScheduledJob()
+        Mockito.verify(lock).unlock()
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 스케줄러는 Redisson lock 획득 실패 시 갱신을 건너뛴다")
+    fun shouldSkipLastCompletedWeekRefreshWhenRedissonLockNotAcquired() {
+        val service = Mockito.mock(CreatorRankingSnapshotJobService::class.java)
+        val redissonClient = Mockito.mock(RedissonClient::class.java)
+        val lock = Mockito.mock(RLock::class.java)
+        Mockito.`when`(redissonClient.getLock("lock:creator-ranking-snapshot-refresh")).thenReturn(lock)
+        Mockito.`when`(lock.tryLock(0, -1, TimeUnit.SECONDS)).thenReturn(false)
+        Mockito.`when`(lock.isHeldByCurrentThread).thenReturn(false)
+        val scheduler = CreatorRankingSnapshotScheduler(service, redissonClient)
+
+        scheduler.refreshLastCompletedWeek()
+
+        Mockito.verify(redissonClient).getLock("lock:creator-ranking-snapshot-refresh")
+        Mockito.verify(lock).tryLock(0, -1, TimeUnit.SECONDS)
+        Mockito.verify(service, Mockito.never()).refreshLastCompletedWeekByScheduledJob()
+        Mockito.verify(lock, Mockito.never()).unlock()
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingQueryServiceTest.kt

@@ -0,0 +1,467 @@
+package kr.co.vividnext.sodalive.v2.ranking.application
+
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingItem
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingSnapshotCandidate
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingBlockPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotRecord
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.Assertions.assertFalse
+import org.junit.jupiter.api.Assertions.assertNull
+import org.junit.jupiter.api.Assertions.assertThrows
+import org.junit.jupiter.api.Assertions.assertTrue
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+import org.springframework.boot.test.system.CapturedOutput
+import org.springframework.boot.test.system.OutputCaptureExtension
+import java.time.LocalDateTime
+import java.time.ZoneId
+import java.time.ZonedDateTime
+
+@ExtendWith(OutputCaptureExtension::class)
+class CreatorRankingQueryServiceTest {
+    @Test
+    @DisplayName("스냅샷 후보와 조회 item 내부 모델은 순위 변화와 신규 진입 값을 담을 수 있다")
+    fun shouldCreateRankingDomainModelsForLaterQueryService() {
+        val candidate = CreatorRankingSnapshotCandidate(
+            creatorId = 1L,
+            nickname = "creator",
+            profileImageUrl = "profile.png",
+            finalScore = 100.0,
+            contentLiveScore = 10.0,
+            engagementScore = 20.0,
+            supportScore = 30.0,
+            fanLoyaltyScore = 40.0,
+            liveCanAmount = 100,
+            contentPurchaseCanAmount = 200,
+            contentLikeCount = 3,
+            contentCommentCount = 4,
+            channelDonationCanAmount = 500,
+            channelDonationCount = 6,
+            fanTalkCount = 7,
+            finalFollowerCount = 8,
+            followIncrease = -1
+        )
+        val item = CreatorRankingItem(
+            rank = 1,
+            rankChange = null,
+            isNew = true,
+            creatorId = candidate.creatorId,
+            nickname = candidate.nickname,
+            profileImageUrl = candidate.profileImageUrl
+        )
+        val fallenItem = item.copy(rank = 2, rankChange = -1, isNew = false)
+
+        assertEquals(1L, candidate.creatorId)
+        assertEquals(100.0, candidate.finalScore, 0.0001)
+        assertNull(item.rankChange)
+        assertTrue(item.isNew)
+        assertEquals(-1, fallenItem.rankChange)
+        assertFalse(fallenItem.isNew)
+    }
+
+    @Test
+    @DisplayName("최신 완료 주차 스냅샷이 없으면 순위 변화 비노출과 빈 목록을 반환한다")
+    fun shouldReturnEmptyResultWhenLatestSnapshotsDoNotExist() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val service = service(snapshotPort = snapshotPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertFalse(result.showRankChange)
+        assertTrue(result.items.isEmpty())
+    }
+
+    @Test
+    @DisplayName("최신 스냅샷이 있으면 cold-start fallback 집계를 호출하지 않는다")
+    fun shouldNotUseColdStartFallbackWhenLatestSnapshotsExist() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val aggregationPort = FakeCreatorRankingQueryAggregationPort()
+        snapshotPort.latestSnapshots = listOf(snapshot(creatorId = 1L, finalScore = 100.0))
+        snapshotPort.snapshotTableEmpty = true
+        aggregationPort.candidates = listOf(candidate(creatorId = 2L))
+        val service = service(snapshotPort = snapshotPort, aggregationPort = aggregationPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertEquals(listOf(1L), result.items.map { it.creatorId })
+        assertEquals(0, aggregationPort.aggregateCallCount)
+    }
+
+    @Test
+    @DisplayName("최신 스냅샷이 없고 스냅샷 테이블이 완전히 비어 있으면 cold-start fallback을 반환한다")
+    fun shouldUseColdStartFallbackOnlyWhenSnapshotTableIsEmpty() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val aggregationPort = FakeCreatorRankingQueryAggregationPort()
+        snapshotPort.snapshotTableEmpty = true
+        aggregationPort.candidates = listOf(
+            candidate(creatorId = 1L, liveCanAmount = 100),
+            candidate(creatorId = 2L, liveCanAmount = 200)
+        )
+        val service = service(snapshotPort = snapshotPort, aggregationPort = aggregationPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertFalse(result.showRankChange)
+        assertEquals(listOf(2L, 1L), result.items.map { it.creatorId })
+        assertEquals(listOf(1, 2), result.items.map { it.rank })
+        assertTrue(result.items.all { it.rankChange == null })
+        assertTrue(result.items.none { it.isNew })
+        assertEquals(1, aggregationPort.aggregateCallCount)
+        assertEquals(LocalDateTime.of(2026, 5, 31, 15, 0), aggregationPort.startInclusiveUtc)
+        assertEquals(LocalDateTime.of(2026, 6, 7, 15, 0), aggregationPort.endExclusiveUtc)
+    }
+
+    @Test
+    @DisplayName("최신 스냅샷이 없어도 과거 스냅샷 row가 있으면 cold-start fallback을 호출하지 않는다")
+    fun shouldNotUseColdStartFallbackWhenAnyHistoricalSnapshotExists() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val aggregationPort = FakeCreatorRankingQueryAggregationPort()
+        snapshotPort.snapshotTableEmpty = false
+        aggregationPort.candidates = listOf(candidate(creatorId = 1L))
+        val service = service(snapshotPort = snapshotPort, aggregationPort = aggregationPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertFalse(result.showRankChange)
+        assertTrue(result.items.isEmpty())
+        assertEquals(0, aggregationPort.aggregateCallCount)
+    }
+
+    @Test
+    @DisplayName("cold-start fallback도 차단 관계가 있으면 크리에이터 식별 정보만 마스킹한다")
+    fun shouldMaskBlockedCreatorIdentityInColdStartFallback() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val aggregationPort = FakeCreatorRankingQueryAggregationPort()
+        val blockPort = FakeCreatorRankingBlockPort()
+        snapshotPort.snapshotTableEmpty = true
+        aggregationPort.candidates = listOf(
+            candidate(creatorId = 1L, liveCanAmount = 200),
+            candidate(creatorId = 2L, liveCanAmount = 100)
+        )
+        blockPort.blockedCreatorIds = setOf(1L)
+        val service = service(
+            snapshotPort = snapshotPort,
+            blockPort = blockPort,
+            aggregationPort = aggregationPort
+        )
+
+        val result = service.getCreatorRankings(viewerMemberId = 99L)
+
+        assertEquals(99L, blockPort.memberId)
+        assertEquals(setOf(1L, 2L), blockPort.creatorIds)
+        assertEquals(0L, result.items.first().creatorId)
+        assertEquals("", result.items.first().nickname)
+        assertEquals("https://cdn.test/profile/default-profile.png", result.items.first().profileImageUrl)
+        assertEquals(2L, result.items[1].creatorId)
+    }
+
+    @Test
+    @DisplayName("직전 완료 주차 스냅샷이 없으면 순위 변화 없이 최신 스냅샷 상위 20명을 반환한다")
+    fun shouldReturnLatestTopTwentyWithoutRankChangeWhenPreviousSnapshotsDoNotExist() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        snapshotPort.latestSnapshots = (1L..21L).map { creatorId ->
+            snapshot(creatorId = creatorId, finalScore = (100 - creatorId).toDouble())
+        }
+        val service = service(snapshotPort = snapshotPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertFalse(result.showRankChange)
+        assertEquals(20, result.items.size)
+        assertEquals((1..20).toList(), result.items.map { it.rank })
+        assertEquals((1L..20L).toList(), result.items.map { it.creatorId })
+        assertTrue(result.items.all { it.rankChange == null })
+        assertTrue(result.items.none { it.isNew })
+    }
+
+    @Test
+    @DisplayName("직전 완료 주차 스냅샷이 있으면 현재 순위와 비교해 순위 변화와 신규 진입을 계산한다")
+    fun shouldCalculateRankChangeAndNewEntryFromPreviousSnapshots() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        snapshotPort.latestSnapshots = listOf(
+            snapshot(creatorId = 2L, finalScore = 300.0),
+            snapshot(creatorId = 1L, finalScore = 200.0),
+            snapshot(creatorId = 3L, finalScore = 100.0),
+            snapshot(creatorId = 4L, finalScore = 50.0)
+        )
+        snapshotPort.previousSnapshots = listOf(
+            snapshot(creatorId = 1L, finalScore = 400.0),
+            snapshot(creatorId = 2L, finalScore = 300.0),
+            snapshot(creatorId = 3L, finalScore = 100.0)
+        )
+        val service = service(snapshotPort = snapshotPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertTrue(result.showRankChange)
+        assertEquals(listOf(2L, 1L, 3L, 4L), result.items.map { it.creatorId })
+        assertEquals(listOf(1, 2, 3, 4), result.items.map { it.rank })
+        assertEquals(listOf(1, -1, 0, null), result.items.map { it.rankChange })
+        assertEquals(listOf(false, false, false, true), result.items.map { it.isNew })
+    }
+
+    @Test
+    @DisplayName("동점 스냅샷은 같은 점수 구간 안에서만 섞이고 상위 20명만 반환한다")
+    fun shouldRandomizeOnlyWithinTieGroupsAndLimitToTwentyItems() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        snapshotPort.latestSnapshots = listOf(
+            snapshot(creatorId = 1L, finalScore = 300.0),
+            snapshot(creatorId = 2L, finalScore = 200.0),
+            snapshot(creatorId = 3L, finalScore = 200.0)
+        ) + (4L..22L).map { creatorId ->
+            snapshot(creatorId = creatorId, finalScore = (100 - creatorId).toDouble())
+        }
+        val service = service(snapshotPort = snapshotPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertEquals(20, result.items.size)
+        assertEquals(1L, result.items.first().creatorId)
+        assertEquals(setOf(2L, 3L), result.items.drop(1).take(2).map { it.creatorId }.toSet())
+        assertEquals((1..20).toList(), result.items.map { it.rank })
+    }
+
+    @Test
+    @DisplayName("차단 관계가 있으면 순위 row는 유지하고 크리에이터 식별 정보만 마스킹한다")
+    fun shouldMaskBlockedCreatorIdentityWithoutRemovingRankingRow() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val blockPort = FakeCreatorRankingBlockPort()
+        snapshotPort.latestSnapshots = listOf(
+            snapshot(creatorId = 1L, finalScore = 300.0),
+            snapshot(creatorId = 2L, finalScore = 200.0)
+        )
+        snapshotPort.previousSnapshots = listOf(
+            snapshot(creatorId = 1L, finalScore = 300.0),
+            snapshot(creatorId = 2L, finalScore = 200.0)
+        )
+        blockPort.blockedCreatorIds = setOf(2L)
+        val service = service(snapshotPort = snapshotPort, blockPort = blockPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = 99L)
+
+        assertEquals(listOf(1, 2), result.items.map { it.rank })
+        assertEquals(99L, blockPort.memberId)
+        assertEquals(setOf(1L, 2L), blockPort.creatorIds)
+        assertEquals(2, result.items.size)
+        assertEquals(0L, result.items[1].creatorId)
+        assertEquals("", result.items[1].nickname)
+        assertEquals("https://cdn.test/profile/default-profile.png", result.items[1].profileImageUrl)
+        assertEquals(0, result.items[1].rankChange)
+        assertFalse(result.items[1].isNew)
+    }
+
+    @Test
+    @DisplayName("비회원 조회는 차단 관계를 조회하지 않고 원본 랭킹을 반환한다")
+    fun shouldNotLookupBlocksForAnonymousViewer() {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val blockPort = FakeCreatorRankingBlockPort()
+        snapshotPort.latestSnapshots = listOf(snapshot(creatorId = 1L, finalScore = 100.0))
+        val service = service(snapshotPort = snapshotPort, blockPort = blockPort)
+
+        val result = service.getCreatorRankings(viewerMemberId = null)
+
+        assertNull(blockPort.memberId)
+        assertEquals(1L, result.items.single().creatorId)
+        assertEquals("creator-1", result.items.single().nickname)
+        assertEquals("profile-1.png", result.items.single().profileImageUrl)
+    }
+
+    @Test
+    @DisplayName("크리에이터 랭킹 조회 성공은 순위 변화 노출 여부와 반환 수를 로그로 남긴다")
+    fun shouldLogCreatorRankingQuerySuccessWithResultCounts(output: CapturedOutput) {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        snapshotPort.latestSnapshots = listOf(snapshot(creatorId = 1L, finalScore = 100.0))
+        val service = service(snapshotPort = snapshotPort)
+
+        service.getCreatorRankings(viewerMemberId = null)
+
+        assertTrue(output.out.contains("event=creator_ranking_query_success"))
+        assertTrue(output.out.contains("showRankChange=false"))
+        assertTrue(output.out.contains("itemCount=1"))
+        assertTrue(output.out.contains("blockedCreatorCount=0"))
+    }
+
+    @Test
+    @DisplayName("크리에이터 랭킹 조회 실패는 에러를 로그로 남기고 예외를 전파한다")
+    fun shouldLogCreatorRankingQueryFailureWithError(output: CapturedOutput) {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        snapshotPort.latestFailure = IllegalStateException("latest snapshots failed")
+        val service = service(snapshotPort = snapshotPort)
+
+        val exception = assertThrows(IllegalStateException::class.java) {
+            service.getCreatorRankings(viewerMemberId = 99L)
+        }
+
+        assertEquals("latest snapshots failed", exception.message)
+        assertTrue(output.out.contains("event=creator_ranking_query_failure"))
+        assertTrue(output.out.contains("error=latest snapshots failed"))
+    }
+
+    @Test
+    @DisplayName("cold-start fallback 성공은 기간과 반환 수를 로그로 남긴다")
+    fun shouldLogColdStartFallbackSuccessWithPeriodAndCount(output: CapturedOutput) {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val aggregationPort = FakeCreatorRankingQueryAggregationPort()
+        snapshotPort.snapshotTableEmpty = true
+        aggregationPort.candidates = listOf(candidate(creatorId = 1L))
+        val service = service(snapshotPort = snapshotPort, aggregationPort = aggregationPort)
+
+        service.getCreatorRankings(viewerMemberId = null)
+
+        assertTrue(output.out.contains("event=creator_ranking_query_cold_start_fallback_attempt"))
+        assertTrue(output.out.contains("event=creator_ranking_query_cold_start_fallback_success"))
+        assertTrue(output.out.contains("aggregationStartAtUtc=2026-05-31T15:00"))
+        assertTrue(output.out.contains("aggregationEndAtUtc=2026-06-07T15:00"))
+        assertTrue(output.out.contains("itemCount=1"))
+    }
+
+    @Test
+    @DisplayName("cold-start fallback 실패는 기간과 에러를 로그로 남기고 예외를 전파한다")
+    fun shouldLogColdStartFallbackFailureWithError(output: CapturedOutput) {
+        val snapshotPort = FakeCreatorRankingQuerySnapshotPort()
+        val aggregationPort = FakeCreatorRankingQueryAggregationPort()
+        snapshotPort.snapshotTableEmpty = true
+        aggregationPort.failure = IllegalStateException("fallback failed")
+        val service = service(snapshotPort = snapshotPort, aggregationPort = aggregationPort)
+
+        val exception = assertThrows(IllegalStateException::class.java) {
+            service.getCreatorRankings(viewerMemberId = null)
+        }
+
+        assertEquals("fallback failed", exception.message)
+        assertTrue(output.out.contains("event=creator_ranking_query_cold_start_fallback_attempt"))
+        assertTrue(output.out.contains("event=creator_ranking_query_cold_start_fallback_failure"))
+        assertTrue(output.out.contains("aggregationStartAtUtc=2026-05-31T15:00"))
+        assertTrue(output.out.contains("aggregationEndAtUtc=2026-06-07T15:00"))
+        assertTrue(output.out.contains("error=fallback failed"))
+    }
+
+    private fun service(
+        snapshotPort: CreatorRankingSnapshotPort = FakeCreatorRankingQuerySnapshotPort(),
+        blockPort: CreatorRankingBlockPort = FakeCreatorRankingBlockPort(),
+        aggregationPort: CreatorRankingAggregationPort = FakeCreatorRankingQueryAggregationPort()
+    ): CreatorRankingQueryService {
+        return CreatorRankingQueryService(
+            snapshotPort = snapshotPort,
+            blockPort = blockPort,
+            aggregationPort = aggregationPort,
+            nowProvider = {
+                ZonedDateTime.of(2026, 6, 8, 7, 30, 0, 0, ZoneId.of("Asia/Seoul"))
+            },
+            cloudFrontHost = "https://cdn.test"
+        )
+    }
+
+    private fun candidate(
+        creatorId: Long,
+        liveCanAmount: Long = 100
+    ): CreatorRankingSnapshotCandidate {
+        return CreatorRankingSnapshotCandidate(
+            creatorId = creatorId,
+            nickname = "creator-$creatorId",
+            profileImageUrl = "profile-$creatorId.png",
+            finalScore = 0.0,
+            contentLiveScore = 0.0,
+            engagementScore = 0.0,
+            supportScore = 0.0,
+            fanLoyaltyScore = 0.0,
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = 0,
+            contentLikeCount = 0,
+            contentCommentCount = 0,
+            channelDonationCanAmount = 0,
+            channelDonationCount = 0,
+            fanTalkCount = 0,
+            finalFollowerCount = 0,
+            followIncrease = 0
+        )
+    }
+
+    private fun snapshot(
+        creatorId: Long,
+        finalScore: Double
+    ): CreatorRankingSnapshotRecord {
+        return CreatorRankingSnapshotRecord(
+            aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0, 0),
+            aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0, 0),
+            creatorId = creatorId,
+            nickname = "creator-$creatorId",
+            profileImageUrl = "profile-$creatorId.png",
+            finalScore = finalScore,
+            contentLiveScore = 0.0,
+            engagementScore = 0.0,
+            supportScore = 0.0,
+            fanLoyaltyScore = 0.0,
+            liveCanAmount = 0,
+            contentPurchaseCanAmount = 0,
+            contentLikeCount = 0,
+            contentCommentCount = 0,
+            channelDonationCanAmount = 0,
+            channelDonationCount = 0,
+            fanTalkCount = 0,
+            finalFollowerCount = 0,
+            followIncrease = 0
+        )
+    }
+}
+
+private class FakeCreatorRankingQuerySnapshotPort : CreatorRankingSnapshotPort {
+    var latestSnapshots: List<CreatorRankingSnapshotRecord> = emptyList()
+    var previousSnapshots: List<CreatorRankingSnapshotRecord> = emptyList()
+    var latestFailure: RuntimeException? = null
+    var snapshotTableEmpty: Boolean = true
+
+    override fun findSnapshotsByAggregationPeriod(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotRecord> = emptyList()
+
+    override fun findLatestSnapshots(): List<CreatorRankingSnapshotRecord> {
+        latestFailure?.let { throw it }
+        return latestSnapshots
+    }
+
+    override fun findPreviousCompletedSnapshots(): List<CreatorRankingSnapshotRecord> = previousSnapshots
+
+    override fun isSnapshotTableEmpty(): Boolean = snapshotTableEmpty
+
+    override fun replaceSnapshots(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        newSnapshots: List<CreatorRankingSnapshotRecord>
+    ) = Unit
+}
+
+private class FakeCreatorRankingQueryAggregationPort : CreatorRankingAggregationPort {
+    var candidates: List<CreatorRankingSnapshotCandidate> = emptyList()
+    var failure: RuntimeException? = null
+    var aggregateCallCount = 0
+    var startInclusiveUtc: LocalDateTime? = null
+    var endExclusiveUtc: LocalDateTime? = null
+
+    override fun aggregateCandidates(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotCandidate> {
+        aggregateCallCount++
+        this.startInclusiveUtc = startInclusiveUtc
+        this.endExclusiveUtc = endExclusiveUtc
+        failure?.let { throw it }
+        return candidates
+    }
+}
+
+private class FakeCreatorRankingBlockPort : CreatorRankingBlockPort {
+    var blockedCreatorIds: Set<Long> = emptySet()
+    var memberId: Long? = null
+    var creatorIds: Set<Long> = emptySet()
+
+    override fun findBlockedCreatorIds(memberId: Long, creatorIds: Collection<Long>): Set<Long> {
+        this.memberId = memberId
+        this.creatorIds = creatorIds.toSet()
+        return blockedCreatorIds
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotJobServiceTest.kt

@@ -0,0 +1,278 @@
+package kr.co.vividnext.sodalive.v2.ranking.application
+
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobRecord
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobStatus
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotJobTrigger
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.Assertions.assertThrows
+import org.junit.jupiter.api.Assertions.assertTrue
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+import org.mockito.Mockito
+import org.springframework.boot.test.system.CapturedOutput
+import org.springframework.boot.test.system.OutputCaptureExtension
+import java.time.LocalDateTime
+import java.time.ZoneId
+import java.time.ZonedDateTime
+
+@ExtendWith(OutputCaptureExtension::class)
+class CreatorRankingSnapshotJobServiceTest {
+    @Test
+    @DisplayName("스케줄 실행은 집계 기간을 포함한 SCHEDULED job을 생성하고 성공 시 DONE으로 기록한다")
+    fun shouldCreateScheduledJobAndMarkDoneWhenRefreshSucceeds() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val now = ZonedDateTime.of(2026, 6, 8, 7, 30, 0, 0, ZoneId.of("Asia/Seoul"))
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort) { now }
+
+        service.refreshLastCompletedWeekByScheduledJob()
+
+        val job = jobPort.jobs.single()
+        assertEquals(LocalDateTime.of(2026, 5, 31, 15, 0), job.aggregationStartAtUtc)
+        assertEquals(LocalDateTime.of(2026, 6, 7, 15, 0), job.aggregationEndAtUtc)
+        assertEquals(CreatorRankingSnapshotJobTrigger.SCHEDULED, job.trigger)
+        assertEquals(CreatorRankingSnapshotJobStatus.DONE, job.status)
+        assertEquals(null, job.lastError)
+        Mockito.verify(refreshService).refreshLastCompletedWeek(now)
+    }
+
+    @Test
+    @DisplayName("스케줄 실행 실패는 FAILED 상태와 실패 사유를 기록하고 예외를 전파한다")
+    fun shouldMarkScheduledJobFailedWhenRefreshFails() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val now = ZonedDateTime.of(2026, 6, 8, 7, 30, 0, 0, ZoneId.of("Asia/Seoul"))
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort) { now }
+        Mockito.doThrow(IllegalStateException("aggregate failed"))
+            .`when`(refreshService).refreshLastCompletedWeek(now)
+
+        val exception = assertThrows(IllegalStateException::class.java) {
+            service.refreshLastCompletedWeekByScheduledJob()
+        }
+
+        assertEquals("aggregate failed", exception.message)
+        assertEquals(CreatorRankingSnapshotJobStatus.FAILED, jobPort.jobs.single().status)
+        assertEquals("aggregate failed", jobPort.jobs.single().lastError)
+    }
+
+    @Test
+    @DisplayName("관리자 수동 생성은 지정 UTC 기간의 MANUAL PENDING job을 만든다")
+    fun shouldCreateManualPendingJobForRequestedPeriod() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort)
+        val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+
+        val job = service.createManualJob(startAt, endAt)
+
+        assertEquals(startAt, job.aggregationStartAtUtc)
+        assertEquals(endAt, job.aggregationEndAtUtc)
+        assertEquals(CreatorRankingSnapshotJobTrigger.MANUAL, job.trigger)
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, job.status)
+        assertEquals(null, job.lastError)
+        assertEquals(null, job.processingStartedAt)
+        assertEquals(null, job.processedAt)
+    }
+
+    @Test
+    @DisplayName("관리자 목록 조회는 기간과 상태 조건으로 snapshot job을 조회한다")
+    fun shouldFindJobsByRequestedPeriodAndStatuses() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort)
+        val startAt = LocalDateTime.of(2026, 5, 31, 15, 0)
+        val endAt = LocalDateTime.of(2026, 6, 7, 15, 0)
+        val failed = jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = startAt,
+                aggregationEndAtUtc = endAt,
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                lastError = "aggregate failed",
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+        jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = startAt,
+                aggregationEndAtUtc = endAt,
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.DONE,
+                lastError = null,
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+
+        val jobs = service.findJobs(
+            aggregationStartAtUtc = startAt,
+            aggregationEndAtUtc = endAt,
+            statuses = listOf(CreatorRankingSnapshotJobStatus.FAILED)
+        )
+
+        assertEquals(listOf(failed.id), jobs.map { it.id })
+    }
+
+    @Test
+    @DisplayName("관리자 실패 job 재시도는 FAILED job만 PENDING으로 되돌린다")
+    fun shouldRetryOnlyFailedSnapshotJob() {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort)
+        val failed = jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                lastError = "aggregate failed",
+                processingStartedAt = LocalDateTime.of(2026, 6, 8, 7, 30),
+                processedAt = LocalDateTime.of(2026, 6, 8, 7, 31)
+            )
+        )
+        val pending = jobPort.save(
+            CreatorRankingSnapshotJobRecord(
+                aggregationStartAtUtc = LocalDateTime.of(2026, 5, 31, 15, 0),
+                aggregationEndAtUtc = LocalDateTime.of(2026, 6, 7, 15, 0),
+                trigger = CreatorRankingSnapshotJobTrigger.MANUAL,
+                status = CreatorRankingSnapshotJobStatus.PENDING,
+                lastError = "keep",
+                processingStartedAt = null,
+                processedAt = null
+            )
+        )
+
+        service.retryFailedJob(failed.id!!)
+        service.retryFailedJob(pending.id!!)
+        service.retryFailedJob(999L)
+
+        val retried = jobPort.findById(failed.id!!)!!
+        val unchanged = jobPort.findById(pending.id!!)!!
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, retried.status)
+        assertEquals(null, retried.lastError)
+        assertEquals(null, retried.processingStartedAt)
+        assertEquals(null, retried.processedAt)
+        assertEquals(CreatorRankingSnapshotJobStatus.PENDING, unchanged.status)
+        assertEquals("keep", unchanged.lastError)
+    }
+
+    @Test
+    @DisplayName("스케줄 job 상태 변경은 job id와 상태를 로그로 남긴다")
+    fun shouldLogScheduledJobStatusTransitions(output: CapturedOutput) {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val now = ZonedDateTime.of(2026, 6, 8, 7, 30, 0, 0, ZoneId.of("Asia/Seoul"))
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort) { now }
+
+        service.refreshLastCompletedWeekByScheduledJob()
+
+        assertTrue(output.out.contains("event=creator_ranking_snapshot_job_status_changed"))
+        assertTrue(output.out.contains("jobId=1"))
+        assertTrue(output.out.contains("trigger=SCHEDULED"))
+        assertTrue(output.out.contains("status=PROCESSING"))
+        assertTrue(output.out.contains("status=DONE"))
+    }
+
+    @Test
+    @DisplayName("실패 job 상태 변경은 실패 상태와 사유를 로그로 남긴다")
+    fun shouldLogFailedScheduledJobStatusTransition(output: CapturedOutput) {
+        val refreshService = Mockito.mock(CreatorRankingSnapshotRefreshService::class.java)
+        val jobPort = FakeCreatorRankingSnapshotJobPort()
+        val now = ZonedDateTime.of(2026, 6, 8, 7, 30, 0, 0, ZoneId.of("Asia/Seoul"))
+        val service = CreatorRankingSnapshotJobService(refreshService, jobPort) { now }
+        Mockito.doThrow(IllegalStateException("aggregate failed"))
+            .`when`(refreshService).refreshLastCompletedWeek(now)
+
+        assertThrows(IllegalStateException::class.java) {
+            service.refreshLastCompletedWeekByScheduledJob()
+        }
+
+        assertTrue(output.out.contains("event=creator_ranking_snapshot_job_status_changed"))
+        assertTrue(output.out.contains("jobId=1"))
+        assertTrue(output.out.contains("trigger=SCHEDULED"))
+        assertTrue(output.out.contains("status=FAILED"))
+        assertTrue(output.out.contains("error=aggregate failed"))
+    }
+}
+
+private class FakeCreatorRankingSnapshotJobPort : CreatorRankingSnapshotJobPort {
+    val jobs = mutableListOf<CreatorRankingSnapshotJobRecord>()
+    private var nextId = 1L
+
+    override fun save(job: CreatorRankingSnapshotJobRecord): CreatorRankingSnapshotJobRecord {
+        val saved = job.copy(id = job.id ?: nextId++)
+        jobs.add(saved)
+        return saved
+    }
+
+    override fun findById(jobId: Long): CreatorRankingSnapshotJobRecord? {
+        return jobs.firstOrNull { it.id == jobId }
+    }
+
+    override fun findByPeriodAndStatuses(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        statuses: List<CreatorRankingSnapshotJobStatus>
+    ): List<CreatorRankingSnapshotJobRecord> {
+        return jobs.filter {
+            it.aggregationStartAtUtc == aggregationStartAtUtc &&
+                it.aggregationEndAtUtc == aggregationEndAtUtc &&
+                it.status in statuses
+        }
+    }
+
+    override fun markProcessing(jobId: Long, processingStartedAt: LocalDateTime): CreatorRankingSnapshotJobRecord? {
+        return update(jobId) {
+            it.copy(
+                status = CreatorRankingSnapshotJobStatus.PROCESSING,
+                processingStartedAt = processingStartedAt
+            )
+        }
+    }
+
+    override fun markDone(jobId: Long, processedAt: LocalDateTime): CreatorRankingSnapshotJobRecord? {
+        return update(jobId) {
+            it.copy(
+                status = CreatorRankingSnapshotJobStatus.DONE,
+                processedAt = processedAt,
+                lastError = null
+            )
+        }
+    }
+
+    override fun markFailed(jobId: Long, processedAt: LocalDateTime, lastError: String?): CreatorRankingSnapshotJobRecord? {
+        return update(jobId) {
+            it.copy(
+                status = CreatorRankingSnapshotJobStatus.FAILED,
+                processedAt = processedAt,
+                lastError = lastError
+            )
+        }
+    }
+
+    override fun markPending(jobId: Long): CreatorRankingSnapshotJobRecord? {
+        return update(jobId) {
+            it.copy(
+                status = CreatorRankingSnapshotJobStatus.PENDING,
+                lastError = null,
+                processingStartedAt = null,
+                processedAt = null
+            )
+        }
+    }
+
+    private fun update(
+        jobId: Long,
+        updater: (CreatorRankingSnapshotJobRecord) -> CreatorRankingSnapshotJobRecord
+    ): CreatorRankingSnapshotJobRecord? {
+        val index = jobs.indexOfFirst { it.id == jobId }
+        if (index < 0) return null
+        val updated = updater(jobs[index])
+        jobs[index] = updated
+        return updated
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/application/CreatorRankingSnapshotRefreshServiceTest.kt

@@ -0,0 +1,273 @@
+package kr.co.vividnext.sodalive.v2.ranking.application
+
+import kr.co.vividnext.sodalive.v2.ranking.domain.CreatorRankingSnapshotCandidate
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingAggregationResult
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotPort
+import kr.co.vividnext.sodalive.v2.ranking.port.out.CreatorRankingSnapshotRecord
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.Assertions.assertThrows
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import org.junit.jupiter.api.extension.ExtendWith
+import org.springframework.boot.test.system.CapturedOutput
+import org.springframework.boot.test.system.OutputCaptureExtension
+import org.springframework.transaction.support.TransactionSynchronizationManager
+import java.time.LocalDateTime
+import java.time.ZoneId
+import java.time.ZonedDateTime
+
+@ExtendWith(OutputCaptureExtension::class)
+class CreatorRankingSnapshotRefreshServiceTest {
+    @Test
+    @DisplayName("주간 스냅샷 생성은 KST 지난 주를 UTC 조회 기간으로 변환하고 raw 지표 점수를 다시 계산해 저장한다")
+    fun shouldRefreshLastCompletedWeekWithUtcRangeAndCalculatedScores() {
+        val aggregationPort = FakeCreatorRankingAggregationPort()
+        val snapshotPort = FakeCreatorRankingSnapshotPort()
+        val service = service(aggregationPort = aggregationPort, snapshotPort = snapshotPort)
+        val now = ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul"))
+        aggregationPort.candidates = listOf(
+            candidate(
+                creatorId = 1L,
+                finalScore = 1.0,
+                liveCanAmount = 100,
+                contentPurchaseCanAmount = 50,
+                contentLikeCount = 10,
+                contentCommentCount = 4,
+                channelDonationCanAmount = 30,
+                channelDonationCount = 6,
+                fanTalkCount = 3,
+                finalFollowerCount = 20,
+                followIncrease = -2
+            )
+        )
+
+        service.refreshLastCompletedWeek(now)
+
+        val stored = snapshotPort.snapshots.single()
+        assertEquals(LocalDateTime.of(2026, 5, 31, 15, 0, 0), aggregationPort.startInclusiveUtc)
+        assertEquals(LocalDateTime.of(2026, 6, 7, 15, 0, 0), aggregationPort.endExclusiveUtc)
+        assertEquals(aggregationPort.startInclusiveUtc, snapshotPort.aggregationStartAtUtc)
+        assertEquals(aggregationPort.endExclusiveUtc, snapshotPort.aggregationEndAtUtc)
+        assertEquals(85.0, stored.contentLiveScore, 0.0001)
+        assertEquals(7.0, stored.engagementScore, 0.0001)
+        assertEquals(19.8, stored.supportScore, 0.0001)
+        assertEquals(13.4, stored.fanLoyaltyScore, 0.0001)
+        assertEquals(38.14, stored.finalScore, 0.0001)
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 생성은 20위 점수 경계와 동점인 후보를 모두 저장하고 더 낮은 점수는 제외한다")
+    fun shouldStoreAllCandidatesTiedAtTwentiethScoreBoundary() {
+        val aggregationPort = FakeCreatorRankingAggregationPort()
+        val snapshotPort = FakeCreatorRankingSnapshotPort()
+        val service = service(aggregationPort = aggregationPort, snapshotPort = snapshotPort)
+        aggregationPort.candidates = (1L..19L).map { candidate(creatorId = it, liveCanAmount = 1_000 - it) } +
+            candidate(creatorId = 20L, liveCanAmount = 500) +
+            candidate(creatorId = 21L, liveCanAmount = 500) +
+            candidate(creatorId = 22L, liveCanAmount = 500) +
+            candidate(creatorId = 23L, liveCanAmount = 499)
+
+        service.refreshLastCompletedWeek(ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul")))
+
+        assertEquals((1L..22L).toList(), snapshotPort.snapshots.map { it.creatorId })
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 생성은 같은 집계 기간을 다시 생성할 때 기존 row를 교체한다")
+    fun shouldReplaceSnapshotsForSameAggregationPeriod() {
+        val aggregationPort = FakeCreatorRankingAggregationPort()
+        val snapshotPort = FakeCreatorRankingSnapshotPort()
+        val service = service(aggregationPort = aggregationPort, snapshotPort = snapshotPort)
+        val now = ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul"))
+        aggregationPort.candidates = listOf(candidate(creatorId = 1L, liveCanAmount = 100))
+        service.refreshLastCompletedWeek(now)
+
+        aggregationPort.candidates = listOf(candidate(creatorId = 2L, liveCanAmount = 200))
+        service.refreshLastCompletedWeek(now)
+
+        assertEquals(listOf(2L), snapshotPort.snapshots.map { it.creatorId })
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 생성 성공은 집계 기간과 후보/저장 수를 로그로 남긴다")
+    fun shouldLogSnapshotRefreshSuccessWithPeriodAndCounts(output: CapturedOutput) {
+        val aggregationPort = FakeCreatorRankingAggregationPort()
+        val snapshotPort = FakeCreatorRankingSnapshotPort()
+        val service = service(aggregationPort = aggregationPort, snapshotPort = snapshotPort)
+        aggregationPort.candidates = listOf(
+            candidate(creatorId = 1L, liveCanAmount = 100),
+            candidate(creatorId = 2L, liveCanAmount = 50)
+        )
+
+        service.refreshLastCompletedWeek(ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul")))
+
+        assertEquals(true, output.out.contains("event=creator_ranking_snapshot_refresh_success"))
+        assertEquals(true, output.out.contains("aggregationStartAtUtc=2026-05-31T15:00"))
+        assertEquals(true, output.out.contains("aggregationEndAtUtc=2026-06-07T15:00"))
+        assertEquals(true, output.out.contains("candidateCount=2"))
+        assertEquals(true, output.out.contains("storedCount=2"))
+        assertEquals(true, output.out.contains("lowScoreExcludedCount=0"))
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 생성 성공 로그는 트랜잭션 커밋 후 기록한다")
+    fun shouldLogSnapshotRefreshSuccessAfterTransactionCommit(output: CapturedOutput) {
+        val aggregationPort = FakeCreatorRankingAggregationPort()
+        val service = service(aggregationPort = aggregationPort)
+        aggregationPort.candidates = listOf(candidate(creatorId = 1L, liveCanAmount = 100))
+
+        TransactionSynchronizationManager.initSynchronization()
+        try {
+            service.refreshLastCompletedWeek(ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul")))
+
+            assertEquals(false, output.out.contains("event=creator_ranking_snapshot_refresh_success"))
+            TransactionSynchronizationManager.getSynchronizations().forEach { it.afterCommit() }
+        } finally {
+            TransactionSynchronizationManager.clearSynchronization()
+        }
+
+        assertEquals(true, output.out.contains("event=creator_ranking_snapshot_refresh_success"))
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 생성 성공은 최종 점수 1점 미만 제외 수를 로그로 남긴다")
+    fun shouldLogLowScoreExcludedCount(output: CapturedOutput) {
+        val aggregationPort = FakeCreatorRankingAggregationPort()
+        val service = service(aggregationPort = aggregationPort)
+        aggregationPort.candidates = listOf(candidate(creatorId = 1L, liveCanAmount = 100))
+        aggregationPort.lowScoreExcludedCount = 2
+
+        service.refreshLastCompletedWeek(ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul")))
+
+        assertEquals(true, output.out.contains("candidateCount=1"))
+        assertEquals(true, output.out.contains("lowScoreExcludedCount=2"))
+    }
+
+    @Test
+    @DisplayName("주간 스냅샷 생성 실패는 집계 기간과 에러를 로그로 남기고 예외를 전파한다")
+    fun shouldLogSnapshotRefreshFailureWithPeriodAndError(output: CapturedOutput) {
+        val aggregationPort = FakeCreatorRankingAggregationPort()
+        val service = service(aggregationPort = aggregationPort)
+        aggregationPort.failure = IllegalStateException("aggregate failed")
+
+        val exception = assertThrows(IllegalStateException::class.java) {
+            service.refreshLastCompletedWeek(ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul")))
+        }
+
+        assertEquals("aggregate failed", exception.message)
+        assertEquals(true, output.out.contains("event=creator_ranking_snapshot_refresh_failure"))
+        assertEquals(true, output.out.contains("aggregationStartAtUtc=2026-05-31T15:00"))
+        assertEquals(true, output.out.contains("aggregationEndAtUtc=2026-06-07T15:00"))
+        assertEquals(true, output.out.contains("error=aggregate failed"))
+    }
+
+    private fun service(
+        aggregationPort: CreatorRankingAggregationPort = FakeCreatorRankingAggregationPort(),
+        snapshotPort: CreatorRankingSnapshotPort = FakeCreatorRankingSnapshotPort()
+    ): CreatorRankingSnapshotRefreshService {
+        return CreatorRankingSnapshotRefreshService(
+            aggregationPort = aggregationPort,
+            snapshotPort = snapshotPort
+        )
+    }
+
+    private fun candidate(
+        creatorId: Long,
+        finalScore: Double = 0.0,
+        liveCanAmount: Long = 0,
+        contentPurchaseCanAmount: Long = 0,
+        contentLikeCount: Long = 0,
+        contentCommentCount: Long = 0,
+        channelDonationCanAmount: Long = 0,
+        channelDonationCount: Long = 0,
+        fanTalkCount: Long = 0,
+        finalFollowerCount: Long = 0,
+        followIncrease: Long = 0
+    ): CreatorRankingSnapshotCandidate {
+        return CreatorRankingSnapshotCandidate(
+            creatorId = creatorId,
+            nickname = "creator-$creatorId",
+            profileImageUrl = "profile-$creatorId.png",
+            finalScore = finalScore,
+            contentLiveScore = 0.0,
+            engagementScore = 0.0,
+            supportScore = 0.0,
+            fanLoyaltyScore = 0.0,
+            liveCanAmount = liveCanAmount,
+            contentPurchaseCanAmount = contentPurchaseCanAmount,
+            contentLikeCount = contentLikeCount,
+            contentCommentCount = contentCommentCount,
+            channelDonationCanAmount = channelDonationCanAmount,
+            channelDonationCount = channelDonationCount,
+            fanTalkCount = fanTalkCount,
+            finalFollowerCount = finalFollowerCount,
+            followIncrease = followIncrease
+        )
+    }
+}
+
+private class FakeCreatorRankingAggregationPort : CreatorRankingAggregationPort {
+    var candidates: List<CreatorRankingSnapshotCandidate> = emptyList()
+    var lowScoreExcludedCount: Int = 0
+    var failure: RuntimeException? = null
+    var startInclusiveUtc: LocalDateTime? = null
+    var endExclusiveUtc: LocalDateTime? = null
+
+    override fun aggregateCandidates(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotCandidate> {
+        this.startInclusiveUtc = startInclusiveUtc
+        this.endExclusiveUtc = endExclusiveUtc
+        failure?.let { throw it }
+        return candidates
+    }
+
+    override fun aggregateCandidateResult(
+        startInclusiveUtc: LocalDateTime,
+        endExclusiveUtc: LocalDateTime
+    ): CreatorRankingAggregationResult {
+        this.startInclusiveUtc = startInclusiveUtc
+        this.endExclusiveUtc = endExclusiveUtc
+        failure?.let { throw it }
+        return CreatorRankingAggregationResult(
+            candidates = candidates,
+            lowScoreExcludedCount = lowScoreExcludedCount
+        )
+    }
+}
+
+private class FakeCreatorRankingSnapshotPort : CreatorRankingSnapshotPort {
+    val snapshots = mutableListOf<CreatorRankingSnapshotRecord>()
+    var aggregationStartAtUtc: LocalDateTime? = null
+    var aggregationEndAtUtc: LocalDateTime? = null
+
+    override fun findSnapshotsByAggregationPeriod(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime
+    ): List<CreatorRankingSnapshotRecord> {
+        return snapshots.filter {
+            it.aggregationStartAtUtc == aggregationStartAtUtc && it.aggregationEndAtUtc == aggregationEndAtUtc
+        }
+    }
+
+    override fun findLatestSnapshots(): List<CreatorRankingSnapshotRecord> = snapshots
+
+    override fun findPreviousCompletedSnapshots(): List<CreatorRankingSnapshotRecord> = snapshots
+
+    override fun isSnapshotTableEmpty(): Boolean = snapshots.isEmpty()
+
+    override fun replaceSnapshots(
+        aggregationStartAtUtc: LocalDateTime,
+        aggregationEndAtUtc: LocalDateTime,
+        newSnapshots: List<CreatorRankingSnapshotRecord>
+    ) {
+        this.aggregationStartAtUtc = aggregationStartAtUtc
+        this.aggregationEndAtUtc = aggregationEndAtUtc
+        snapshots.removeIf {
+            it.aggregationStartAtUtc == aggregationStartAtUtc && it.aggregationEndAtUtc == aggregationEndAtUtc
+        }
+        snapshots.addAll(newSnapshots)
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingPeriodPolicyTest.kt

@@ -0,0 +1,59 @@
+package kr.co.vividnext.sodalive.v2.ranking.domain
+
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+import java.time.LocalDateTime
+import java.time.ZoneId
+import java.time.ZonedDateTime
+
+class CreatorRankingPeriodPolicyTest {
+    private val policy = CreatorRankingPeriodPolicy()
+
+    @Test
+    @DisplayName("월요일 KST 기준 지난 주 월요일 00시 이상 이번 주 월요일 00시 미만 기간을 산출한다")
+    fun shouldResolveLastCompletedWeekByKstMonday() {
+        val now = ZonedDateTime.of(2026, 6, 8, 6, 0, 0, 0, ZoneId.of("Asia/Seoul"))
+
+        val period = policy.resolveLastCompletedWeek(now)
+
+        assertEquals(LocalDateTime.of(2026, 6, 1, 0, 0), period.startInclusiveKst)
+        assertEquals(LocalDateTime.of(2026, 6, 8, 0, 0), period.endExclusiveKst)
+    }
+
+    @Test
+    @DisplayName("기간 산출은 서버 timezone UTC와 무관하게 KST 기준으로 계산한다")
+    fun shouldResolveLastCompletedWeekIndependentOfServerTimezone() {
+        val now = ZonedDateTime.of(2026, 6, 7, 21, 0, 0, 0, ZoneId.of("UTC"))
+
+        val period = policy.resolveLastCompletedWeek(now)
+
+        assertEquals(LocalDateTime.of(2026, 6, 1, 0, 0), period.startInclusiveKst)
+        assertEquals(LocalDateTime.of(2026, 6, 8, 0, 0), period.endExclusiveKst)
+    }
+
+    @Test
+    @DisplayName("연도 경계를 넘어도 KST 기준 지난 완료 주차를 산출한다")
+    fun shouldResolveLastCompletedWeekAcrossYearBoundary() {
+        val now = ZonedDateTime.of(2026, 1, 1, 12, 0, 0, 0, ZoneId.of("Asia/Seoul"))
+
+        val period = policy.resolveLastCompletedWeek(now)
+
+        assertEquals(LocalDateTime.of(2025, 12, 22, 0, 0), period.startInclusiveKst)
+        assertEquals(LocalDateTime.of(2025, 12, 29, 0, 0), period.endExclusiveKst)
+    }
+
+    @Test
+    @DisplayName("KST 기간은 DB 조회용 UTC LocalDateTime 이상/미만 조건으로 변환한다")
+    fun shouldConvertKstPeriodToUtcRange() {
+        val period = CreatorRankingPeriod(
+            startInclusiveKst = LocalDateTime.of(2026, 6, 1, 0, 0),
+            endExclusiveKst = LocalDateTime.of(2026, 6, 8, 0, 0)
+        )
+
+        val utcRange = policy.toUtcRange(period)
+
+        assertEquals(LocalDateTime.of(2026, 5, 31, 15, 0), utcRange.startInclusiveUtc)
+        assertEquals(LocalDateTime.of(2026, 6, 7, 15, 0), utcRange.endExclusiveUtc)
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/ranking/domain/CreatorRankingScorePolicyTest.kt

@@ -0,0 +1,76 @@
+package kr.co.vividnext.sodalive.v2.ranking.domain
+
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.DisplayName
+import org.junit.jupiter.api.Test
+
+class CreatorRankingScorePolicyTest {
+    private val policy = CreatorRankingScorePolicy()
+
+    @Test
+    @DisplayName("콘텐츠/라이브 점수는 라이브 계열 캔 70%와 콘텐츠 구매 캔 30%를 raw value로 계산한다")
+    fun shouldCalculateContentLiveScore() {
+        assertEquals(0.7, CreatorRankingScoreSpec.CONTENT_LIVE_CAN_WEIGHT, 0.0001)
+        assertEquals(0.3, CreatorRankingScoreSpec.CONTENT_PURCHASE_CAN_WEIGHT, 0.0001)
+
+        val score = policy.calculateContentLiveScore(liveCanAmount = 1000, contentPurchaseCanAmount = 200)
+
+        assertEquals(760.0, score, 0.0001)
+    }
+
+    @Test
+    @DisplayName("참여 반응 점수는 좋아요 수와 댓글 수를 각각 50% raw value로 계산한다")
+    fun shouldCalculateEngagementScore() {
+        assertEquals(0.5, CreatorRankingScoreSpec.CONTENT_LIKE_COUNT_WEIGHT, 0.0001)
+        assertEquals(0.5, CreatorRankingScoreSpec.CONTENT_COMMENT_COUNT_WEIGHT, 0.0001)
+
+        val score = policy.calculateEngagementScore(contentLikeCount = 40, contentCommentCount = 20)
+
+        assertEquals(30.0, score, 0.0001)
+    }
+
+    @Test
+    @DisplayName("응원 점수는 채널 후원 캔/건수와 팬 Talk 수를 raw value로 계산한다")
+    fun shouldCalculateSupportScore() {
+        assertEquals(0.6, CreatorRankingScoreSpec.CHANNEL_DONATION_CAN_WEIGHT, 0.0001)
+        assertEquals(0.2, CreatorRankingScoreSpec.CHANNEL_DONATION_COUNT_WEIGHT, 0.0001)
+        assertEquals(0.2, CreatorRankingScoreSpec.FAN_TALK_COUNT_WEIGHT, 0.0001)
+
+        val score = policy.calculateSupportScore(
+            channelDonationCanAmount = 1000,
+            channelDonationCount = 10,
+            fanTalkCount = 20
+        )
+
+        assertEquals(606.0, score, 0.0001)
+    }
+
+    @Test
+    @DisplayName("팬 충성도 점수는 음수 팔로우 증가 수를 최종 점수에 그대로 반영한다")
+    fun shouldCalculateFanLoyaltyScoreWithNegativeFollowIncrease() {
+        assertEquals(0.7, CreatorRankingScoreSpec.FINAL_FOLLOWER_COUNT_WEIGHT, 0.0001)
+        assertEquals(0.3, CreatorRankingScoreSpec.FOLLOW_INCREASE_WEIGHT, 0.0001)
+
+        val score = policy.calculateFanLoyaltyScore(finalFollowerCount = 100, followIncrease = -10)
+
+        assertEquals(67.0, score, 0.0001)
+    }
+
+    @Test
+    @DisplayName("최종 점수는 카테고리별 점수에 PRD 가중치를 적용하고 0~100 정규화하지 않는다")
+    fun shouldCalculateFinalScoreWithoutNormalization() {
+        assertEquals(0.35, CreatorRankingScoreSpec.CONTENT_LIVE_SCORE_WEIGHT, 0.0001)
+        assertEquals(0.3, CreatorRankingScoreSpec.ENGAGEMENT_SCORE_WEIGHT, 0.0001)
+        assertEquals(0.25, CreatorRankingScoreSpec.SUPPORT_SCORE_WEIGHT, 0.0001)
+        assertEquals(0.1, CreatorRankingScoreSpec.FAN_LOYALTY_SCORE_WEIGHT, 0.0001)
+
+        val score = policy.calculateFinalScore(
+            contentLiveScore = 760.0,
+            engagementScore = 30.0,
+            supportScore = 606.0,
+            fanLoyaltyScore = 67.0
+        )
+
+        assertEquals(433.2, score, 0.0001)
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/CreatorContentViewHistoryPersistenceAdapterTest.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import com.querydsl.jpa.impl.JPAQueryFactory
 import kr.co.vividnext.sodalive.configs.QueryDslConfig

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import com.querydsl.jpa.impl.JPAQueryFactory
 import kr.co.vividnext.sodalive.admin.content.series.genre.SeriesGenre
@@ -34,12 +34,12 @@ import kr.co.vividnext.sodalive.member.Member
 import kr.co.vividnext.sodalive.member.MemberRole
 import kr.co.vividnext.sodalive.member.block.BlockMember
 import kr.co.vividnext.sodalive.member.following.CreatorFollowing
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendationScorePolicy
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedActivityType
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeAiCharacterRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeCheerCreatorRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomePopularCommunityRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendationScorePolicy
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedActivityType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeAiCharacterRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeCheerCreatorRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomePopularCommunityRecommendationRecord
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
@@ -369,7 +369,7 @@ class DefaultHomeRecommendationQueryRepositoryTest @Autowired constructor(
         assertEquals(RecommendedActivityType.LIVE_REPLAY, byCreatorNickname[replayCreator.nickname]!!.activityType)
         assertEquals(replay.id, byCreatorNickname[replayCreator.nickname]!!.targetId)
         assertEquals(RecommendedActivityType.COMMUNITY, byCreatorNickname[communityCreator.nickname]!!.activityType)
-        assertEquals(community.id, byCreatorNickname[communityCreator.nickname]!!.targetId)
+        assertEquals(communityCreator.id, byCreatorNickname[communityCreator.nickname]!!.targetId)
     }
 
     @Test
@@ -403,7 +403,7 @@ class DefaultHomeRecommendationQueryRepositoryTest @Autowired constructor(
         assertEquals(null, visibleCreators[0].targetId)
         assertEquals(null, visibleCreators[1].targetId)
         assertEquals(adultAudio.id, visibleCreators[2].targetId)
-        assertEquals(adultCommunity.id, visibleCreators[3].targetId)
+        assertEquals(adultCommunityCreator.id, visibleCreators[3].targetId)
         assertEquals(RecommendedActivityType.LIVE, visibleCreators[0].activityType)
         assertEquals(RecommendedActivityType.LIVE, visibleCreators[1].activityType)
         assertEquals(RecommendedActivityType.AUDIO, visibleCreators[2].activityType)
@@ -1427,6 +1427,108 @@ class DefaultHomeRecommendationQueryRepositoryTest @Autowired constructor(
         assertEquals(listOf(visibleCreator.id), recommendations.single().creators.map { it.creatorId })
     }
 
+    @Test
+    @DisplayName("장르 기반 크리에이터 추천은 요청자 본인만 있는 장르를 후보에서 제외한다")
+    fun shouldExcludeRequesterOnlyGenreFromGenreCreatorRecommendations() {
+        val viewer = saveMember("self-only-viewer", MemberRole.CREATOR)
+        val fallbackCreator = saveMember("self-only-fallback", MemberRole.CREATOR)
+        val selfTheme = saveTheme("self-only-theme")
+        val fallbackTheme = saveTheme("self-only-fallback-theme")
+        val selfContent = saveAudioContent(
+            viewer,
+            LocalDateTime.of(2026, 5, 30, 10, 0),
+            isActive = true,
+            theme = selfTheme
+        )
+        saveAudioContent(
+            fallbackCreator,
+            LocalDateTime.of(2026, 5, 30, 11, 0),
+            isActive = true,
+            theme = fallbackTheme
+        )
+        entityManager.persist(
+            CreatorContentViewHistory(
+                memberId = viewer.id!!,
+                contentId = selfContent.id!!,
+                genreId = 999L,
+                viewedAt = LocalDateTime.of(2026, 5, 31, 10, 0)
+            )
+        )
+        flushAndClear()
+
+        val recommendations = repository.findGenreCreatorRecommendations(
+            memberId = viewer.id!!,
+            includeAdultGenres = false,
+            genreLimit = 1,
+            creatorLimit = 8
+        )
+
+        assertEquals(listOf(fallbackTheme.id), recommendations.map { it.genreId })
+        assertEquals(listOf(fallbackCreator.id), recommendations.single().creators.map { it.creatorId })
+    }
+
+    @Test
+    @DisplayName("장르 기반 크리에이터 추천은 요청자 본인을 제외한 뒤 대체 크리에이터로 8명을 채운다")
+    fun shouldBackfillCreatorAfterExcludingRequesterFromGenreCreatorRecommendations() {
+        val viewer = saveMember("self-backfill-viewer", MemberRole.CREATOR)
+        val theme = saveTheme("self-backfill-theme")
+        saveAudioContent(viewer, LocalDateTime.of(2026, 5, 30, 10, 0), isActive = true, theme = theme)
+        val expectedCreators = (0..8).map { index ->
+            saveMember("self-backfill-creator-$index", MemberRole.CREATOR).also { creator ->
+                saveAudioContent(
+                    creator,
+                    LocalDateTime.of(2026, 5, 30, 11, 0).plusMinutes(index.toLong()),
+                    isActive = true,
+                    theme = theme
+                )
+            }
+        }
+        flushAndClear()
+
+        val recommendations = repository.findGenreCreatorRecommendations(
+            memberId = viewer.id!!,
+            includeAdultGenres = false,
+            genreLimit = 1,
+            creatorLimit = 8
+        )
+        val creatorIds = recommendations.single().creators.map { it.creatorId }
+
+        assertEquals(8, creatorIds.size)
+        assertEquals(false, creatorIds.contains(viewer.id))
+        assertEquals(true, creatorIds.all { it in expectedCreators.map { creator -> creator.id } })
+    }
+
+    @Test
+    @DisplayName("장르 기반 크리에이터 추천은 요청자 본인 제외 후 대체가 없으면 가능한 크리에이터만 응답한다")
+    fun shouldReturnAvailableCreatorsAfterExcludingRequesterFromGenreCreatorRecommendations() {
+        val viewer = saveMember("self-partial-viewer", MemberRole.CREATOR)
+        val theme = saveTheme("self-partial-theme")
+        saveAudioContent(viewer, LocalDateTime.of(2026, 5, 30, 10, 0), isActive = true, theme = theme)
+        val expectedCreators = (0 until 7).map { index ->
+            saveMember("self-partial-creator-$index", MemberRole.CREATOR).also { creator ->
+                saveAudioContent(
+                    creator,
+                    LocalDateTime.of(2026, 5, 30, 11, 0).plusMinutes(index.toLong()),
+                    isActive = true,
+                    theme = theme
+                )
+            }
+        }
+        flushAndClear()
+
+        val recommendations = repository.findGenreCreatorRecommendations(
+            memberId = viewer.id!!,
+            includeAdultGenres = false,
+            genreLimit = 1,
+            creatorLimit = 8
+        )
+        val creatorIds = recommendations.single().creators.map { it.creatorId }
+
+        assertEquals(7, creatorIds.size)
+        assertEquals(false, creatorIds.contains(viewer.id))
+        assertEquals(expectedCreators.map { it.id }.toSet(), creatorIds.toSet())
+    }
+
     @Test
     @DisplayName("장르 기반 크리에이터 추천은 series_genre가 아니라 content_theme 기준으로 그룹을 만든다")
     fun shouldGroupGenreCreatorRecommendationsByContentThemeNotSeriesGenre() {

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/RecommendationSnapshotPersistenceAdapterTest.kt

@@ -1,8 +1,8 @@
-package kr.co.vividnext.sodalive.v2.recommend.adapter.out.persistence
+package kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence
 
 import kr.co.vividnext.sodalive.configs.QueryDslConfig
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotRecord
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotRecord
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.Test
 import org.springframework.beans.factory.annotation.Autowired

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/CreatorContentViewHistoryServiceTest.kt

@@ -1,7 +1,7 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
-import kr.co.vividnext.sodalive.v2.recommend.port.out.CreatorContentViewHistoryPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.CreatorContentViewHistoryRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.CreatorContentViewHistoryPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.CreatorContentViewHistoryRecord
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.Assertions.assertTrue
 import org.junit.jupiter.api.DisplayName

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt

@@ -1,20 +1,20 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedActivityType
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeAiCharacterRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeBannerRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeCheerCreatorRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeFirstAudioContentRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeGenreCreatorRecommendationGroup
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeGenreCreatorRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeLiveRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomePopularCommunityRecommendationRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeRecommendationQueryPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentDebutCreatorRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecentlyActiveCreatorRecord
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotRecord
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedActivityType
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeAiCharacterRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeBannerRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeCheerCreatorRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeFirstAudioContentRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeGenreCreatorRecommendationGroup
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeGenreCreatorRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeLiveRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomePopularCommunityRecommendationRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeRecommendationQueryPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentDebutCreatorRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecentlyActiveCreatorRecord
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotRecord
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
@@ -526,6 +526,35 @@ class HomeRecommendationQueryServiceTest {
         assertEquals((101L..108L).toList(), recommendations[1].creators.map { it.creatorId })
     }
 
+    @Test
+    @DisplayName("장르 기반 크리에이터 추천은 장르의 추천 가능 크리에이터가 8명 미만이면 가능한 만큼 응답한다")
+    fun shouldReturnAvailableCreatorsWhenGenreCreatorCountIsUnderLimit() {
+        val availableCreators = (1L..7L).map { creatorId ->
+            HomeGenreCreatorRecommendationRecord(
+                creatorId = creatorId,
+                creatorNickname = "available-$creatorId",
+                creatorProfileImage = null
+            )
+        }
+        port.genreCreatorRecommendations = listOf(
+            HomeGenreCreatorRecommendationGroup(
+                genreId = 1L,
+                genreName = "partial-theme",
+                creators = availableCreators
+            )
+        )
+
+        val recommendations = service.findGenreCreatorRecommendations(
+            memberId = 100L,
+            includeAdultGenres = false,
+            genreLimit = 5,
+            creatorLimit = 8
+        )
+
+        assertEquals(listOf(1L), recommendations.map { it.genreId })
+        assertEquals((1L..7L).toList(), recommendations.single().creators.map { it.creatorId })
+    }
+
     @Test
     @DisplayName("장르 기반 크리에이터 추천은 조회 이력 장르는 중복 제거 후 8명 미만이어도 유지한다")
     fun shouldKeepViewedThemeWhenCreatorDeduplicationMakesThemeUnderfilled() {

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendationSnapshotRefreshServiceTest.kt

@@ -1,20 +1,23 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
-import kr.co.vividnext.sodalive.v2.recommend.adapter.out.scheduler.RecommendationSnapshotScheduler
-import kr.co.vividnext.sodalive.v2.recommend.domain.RecommendedSectionType
-import kr.co.vividnext.sodalive.v2.recommend.port.out.HomeRecommendationQueryPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotPort
-import kr.co.vividnext.sodalive.v2.recommend.port.out.RecommendationSnapshotRecord
+import kr.co.vividnext.sodalive.v2.recommendation.adapter.out.scheduler.RecommendationSnapshotScheduler
+import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeRecommendationQueryPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotPort
+import kr.co.vividnext.sodalive.v2.recommendation.port.out.RecommendationSnapshotRecord
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.DisplayName
 import org.junit.jupiter.api.Test
 import org.junit.jupiter.api.extension.ExtendWith
 import org.mockito.Mockito
+import org.redisson.api.RLock
+import org.redisson.api.RedissonClient
 import org.springframework.boot.test.system.CapturedOutput
 import org.springframework.boot.test.system.OutputCaptureExtension
 import org.springframework.scheduling.annotation.Scheduled
 import org.springframework.transaction.support.TransactionSynchronizationManager
 import java.time.LocalDateTime
+import java.util.concurrent.TimeUnit
 
 @ExtendWith(OutputCaptureExtension::class)
 class RecommendationSnapshotRefreshServiceTest {
@@ -170,7 +173,12 @@ class RecommendationSnapshotRefreshServiceTest {
             .getDeclaredMethod("refreshDailySnapshots")
             .getAnnotation(Scheduled::class.java)
         val service = Mockito.mock(RecommendationSnapshotRefreshService::class.java)
-        val scheduler = RecommendationSnapshotScheduler(service)
+        val redissonClient = Mockito.mock(RedissonClient::class.java)
+        val lock = Mockito.mock(RLock::class.java)
+        Mockito.`when`(redissonClient.getLock("lock:recommendation-snapshot-refresh")).thenReturn(lock)
+        Mockito.`when`(lock.tryLock(0, -1, TimeUnit.SECONDS)).thenReturn(true)
+        Mockito.`when`(lock.isHeldByCurrentThread).thenReturn(true)
+        val scheduler = RecommendationSnapshotScheduler(service, redissonClient)
 
         scheduler.refreshDailySnapshots()
 
@@ -179,6 +187,44 @@ class RecommendationSnapshotRefreshServiceTest {
         Mockito.verify(service).refreshDailySnapshots()
     }
 
+    @Test
+    @DisplayName("추천 스냅샷 스케줄러는 Redisson lock을 획득한 인스턴스만 갱신을 실행한다")
+    fun shouldRefreshDailySnapshotsOnlyWhenRedissonLockAcquired() {
+        val service = Mockito.mock(RecommendationSnapshotRefreshService::class.java)
+        val redissonClient = Mockito.mock(RedissonClient::class.java)
+        val lock = Mockito.mock(RLock::class.java)
+        Mockito.`when`(redissonClient.getLock("lock:recommendation-snapshot-refresh")).thenReturn(lock)
+        Mockito.`when`(lock.tryLock(0, -1, TimeUnit.SECONDS)).thenReturn(true)
+        Mockito.`when`(lock.isHeldByCurrentThread).thenReturn(true)
+        val scheduler = RecommendationSnapshotScheduler(service, redissonClient)
+
+        scheduler.refreshDailySnapshots()
+
+        Mockito.verify(redissonClient).getLock("lock:recommendation-snapshot-refresh")
+        Mockito.verify(lock).tryLock(0, -1, TimeUnit.SECONDS)
+        Mockito.verify(service).refreshDailySnapshots()
+        Mockito.verify(lock).unlock()
+    }
+
+    @Test
+    @DisplayName("추천 스냅샷 스케줄러는 Redisson lock 획득 실패 시 갱신을 건너뛴다")
+    fun shouldSkipDailySnapshotRefreshWhenRedissonLockNotAcquired() {
+        val service = Mockito.mock(RecommendationSnapshotRefreshService::class.java)
+        val redissonClient = Mockito.mock(RedissonClient::class.java)
+        val lock = Mockito.mock(RLock::class.java)
+        Mockito.`when`(redissonClient.getLock("lock:recommendation-snapshot-refresh")).thenReturn(lock)
+        Mockito.`when`(lock.tryLock(0, -1, TimeUnit.SECONDS)).thenReturn(false)
+        Mockito.`when`(lock.isHeldByCurrentThread).thenReturn(false)
+        val scheduler = RecommendationSnapshotScheduler(service, redissonClient)
+
+        scheduler.refreshDailySnapshots()
+
+        Mockito.verify(redissonClient).getLock("lock:recommendation-snapshot-refresh")
+        Mockito.verify(lock).tryLock(0, -1, TimeUnit.SECONDS)
+        Mockito.verify(service, Mockito.never()).refreshDailySnapshots()
+        Mockito.verify(lock, Mockito.never()).unlock()
+    }
+
     private fun service(
         snapshotPort: RecommendationSnapshotPort = FakeRecommendationSnapshotPort(),
         queryPort: HomeRecommendationQueryPort = Mockito.mock(HomeRecommendationQueryPort::class.java)

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/RecommendedCreatorFollowServiceTest.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.application
+package kr.co.vividnext.sodalive.v2.recommendation.application
 
 import kr.co.vividnext.sodalive.common.SodaException
 import kr.co.vividnext.sodalive.member.Member

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/CreatorDebutPolicyTest.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.domain
+package kr.co.vividnext.sodalive.v2.recommendation.domain
 
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.Assertions.assertFalse

src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/domain/RecommendationScorePolicyTest.kt

@@ -1,4 +1,4 @@
-package kr.co.vividnext.sodalive.v2.recommend.domain
+package kr.co.vividnext.sodalive.v2.recommendation.domain
 
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.DisplayName