docs(home-following): Phase 3-5 기록을 갱신한다

2026-06-26 02:51:57 +09:00
parent 75bd0ced28
commit 9a20c54670
2 changed files with 56 additions and 13 deletions
--- a/docs/20260625_메인_홈_팔로잉_탭_API/plan-task.md
+++ b/docs/20260625_메인_홈_팔로잉_탭_API/plan-task.md
@@ -404,7 +404,7 @@ data class HomeFollowingNewsInboxRecord(

 ### Phase 3: 팔로잉 탭 조회 Repository/Service

- [ ] **Task 3.1: 팔로잉 크리에이터 조회**
+- [x] **Task 3.1: 팔로잉 크리에이터 조회**
  - Files:
    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/port/out/HomeFollowingQueryPort.kt`
    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/HomeFollowingQueryRepository.kt`
@@ -417,7 +417,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 기본 프로필 이미지와 CDN 변환 책임은 service/facade 중 기존 패턴과 맞는 위치로 정리한다.

- [ ] **Task 3.2: On Air 조회**
+- [x] **Task 3.2: On Air 조회**
  - Files:
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/DefaultHomeFollowingQueryRepository.kt`
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/DefaultHomeFollowingQueryRepositoryTest.kt`
@@ -428,7 +428,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 라이브 진행 중 판단 조건이 스케줄 `isOnAir`와 중복되면 private helper로 추출한다.

- [ ] **Task 3.3: 이달의 스케줄 조회**
+- [x] **Task 3.3: 이달의 스케줄 조회**
  - Files:
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/DefaultHomeFollowingQueryRepository.kt`
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/DefaultHomeFollowingQueryRepositoryTest.kt`
@@ -439,7 +439,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: `scheduleId`는 `{TYPE}:{targetId}` 형식으로 안정적으로 생성한다.

- [ ] **Task 3.4: 최근 소식 조회**
+- [x] **Task 3.4: 최근 소식 조회**
  - Files:
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/DefaultHomeFollowingQueryRepository.kt`
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/DefaultHomeFollowingQueryRepositoryTest.kt`
@@ -450,7 +450,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 조회 시 차단/성인/target 활성 조건을 과도하게 조인하지 않도록 필요한 조건만 유지한다.

- [ ] **Task 3.5: HomeFollowingQueryService 조립**
+- [x] **Task 3.5: HomeFollowingQueryService 조립**
  - Files:
    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/application/HomeFollowingQueryService.kt`
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/home/following/application/HomeFollowingQueryServiceTest.kt`
@@ -461,7 +461,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: `nowProvider: () -> LocalDateTime`을 주입해 테스트 시간을 고정한다.

- [ ] **Task 3.6: Inbox 중복 insert 충돌 통합 테스트 보강**
+- [x] **Task 3.6: Inbox 중복 insert 충돌 통합 테스트 보강**
  - Files:
    - Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/home/following/adapter/out/persistence/HomeFollowingNewsInboxPersistenceAdapterTest.kt`
  - RED: 실제 `HomeFollowingNewsInboxJpaRepository`로 동일 `memberId/newsType/sourceKey` unique 충돌을 발생시킨 뒤, 같은 테스트 흐름에서 `insertIgnoreAll(records)` 또는 repository 조회가 예외 없이 동작하는 통합 테스트를 작성한다.
@@ -472,7 +472,7 @@ data class HomeFollowingNewsInboxRecord(

 ### Phase 4: 최근 소식 Publish Service와 기존 이벤트 연결

- [ ] **Task 4.1: sourceKey 생성 정책 구현**
+- [x] **Task 4.1: sourceKey 생성 정책 구현**
  - Files:
    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/domain/HomeFollowingNewsSourceKey.kt`
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/home/following/domain/HomeFollowingNewsSourceKeyTest.kt`
@@ -483,7 +483,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 문자열 상수는 `FollowingNewsType` enum 이름과 불일치하지 않게 정리한다.

- [ ] **Task 4.2: HomeFollowingNewsPublishService 구현**
+- [x] **Task 4.2: HomeFollowingNewsPublishService 구현**
  - Files:
    - Create: `src/main/kotlin/kr/co/vividnext/sodalive/v2/home/following/application/HomeFollowingNewsPublishService.kt`
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/home/following/application/HomeFollowingNewsPublishServiceTest.kt`
@@ -495,7 +495,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 외부 MQ/outbox 없이 동작하되 호출부가 service 메서드에만 의존하도록 public API를 작게 유지한다.

- [ ] **Task 4.3: 언팔로우 시 inbox 비활성화 연동**
+- [x] **Task 4.3: 언팔로우 시 inbox 비활성화 연동**
  - Files:
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/member/MemberService.kt`
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/member/following/CreatorFollowingRepository.kt`
@@ -507,7 +507,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 팔로잉 공개 API 스키마는 변경하지 않는다.

- [ ] **Task 4.4: 크리에이터 랭킹 소식 발행 연결**
+- [x] **Task 4.4: 크리에이터 랭킹 소식 발행 연결**
  - Files:
    - Modify: `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`
@@ -518,7 +518,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 월요일 01:00 생성, 09:00 노출 정책은 inbox `visibleFromAtUtc`로만 처리한다.

- [ ] **Task 4.5: 콘텐츠/커뮤니티 업로드 소식 발행 연결**
+- [x] **Task 4.5: 콘텐츠/커뮤니티 업로드 소식 발행 연결**
  - Files:
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/content/AudioContentService.kt`
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/explorer/profile/creatorCommunity/CreatorCommunityService.kt`
@@ -538,7 +538,7 @@ data class HomeFollowingNewsInboxRecord(

 ### Phase 5: Facade 통합, 최근 대화 재사용, API End-to-End

- [ ] **Task 5.1: HomeFollowingFacade 통합**
+- [x] **Task 5.1: HomeFollowingFacade 통합**
  - Files:
    - Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/following/application/HomeFollowingFacade.kt`
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/following/application/HomeFollowingFacadeTest.kt`
@@ -549,7 +549,7 @@ data class HomeFollowingNewsInboxRecord(
  - 통과 확인: 같은 단일 테스트 명령 실행, PASS 확인.
  - REFACTOR: 한 섹션 데이터 부족은 빈 배열/가능한 개수로 성공 처리한다.

- [ ] **Task 5.2: End-to-End API 통합 테스트**
+- [x] **Task 5.2: End-to-End API 통합 테스트**
  - Files:
    - Test: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/following/adapter/in/web/HomeFollowingEndToEndTest.kt`
  - RED: 비로그인 호출이 200, `isLoginRequired=true`, 모든 배열 빈 값인지 검증하는 통합 테스트를 작성한다.
@@ -602,4 +602,46 @@ data class HomeFollowingNewsInboxRecord(
  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.api.home.following.adapter.in.web.HomeFollowingControllerTest"` 실행 결과 `BUILD SUCCESSFUL`.
  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.HomeFollowingNewsInboxPersistenceAdapterTest"` 실행 결과 `BUILD SUCCESSFUL`.
  - 병렬 Gradle 실행 중 `build/snapshot/kotlin/kaptGenerateStubsKotlin` 삭제 충돌이 1회 발생해 동일 명령을 순차 재실행했다.
+- 2026-06-25 Phase 3 구현 검증:
+  - RED 확인: `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.DefaultHomeFollowingQueryRepositoryTest"` 실행 결과 repository/service 미구현 컴파일 오류로 `BUILD FAILED`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.DefaultHomeFollowingQueryRepositoryTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.application.HomeFollowingQueryServiceTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.HomeFollowingNewsInboxPersistenceAdapterTest"` 실행 결과 `BUILD SUCCESSFUL`.
+- 2026-06-25 Phase 4 구현 검증:
+  - RED 확인: `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.domain.HomeFollowingNewsSourceKeyTest"` 실행 결과 `HomeFollowingNewsSourceKey`, `HomeFollowingNewsPublishService` 미구현 및 생성자 의존성 미연동 컴파일 오류로 `BUILD FAILED`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.domain.HomeFollowingNewsSourceKeyTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.application.HomeFollowingNewsPublishServiceTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.member.MemberServiceTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.content.AudioContentServiceTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityServiceTest"` 실행 결과 `BUILD SUCCESSFUL`.
  - `insertIgnoreAll`은 H2/MySQL dialect 분기 없이 JPA `saveAndFlush`와 unique 제약 기반 중복 예외 재확인 단일 경로로 검증했다.
+- 2026-06-25 Phase 5 구현 검증:
+  - RED 확인: `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.api.home.following.application.HomeFollowingFacadeTest"` 실행 결과 facade 생성자 미구현으로 `BUILD FAILED`.
+  - RED 확인: `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.api.home.following.adapter.in.web.HomeFollowingEndToEndTest"` 실행 결과 facade 생성자 미구현으로 `BUILD FAILED`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.api.home.following.application.HomeFollowingFacadeTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.api.home.following.adapter.in.web.HomeFollowingEndToEndTest"` 실행 결과 `BUILD SUCCESSFUL`.
+- 2026-06-26 Phase 3-5 리뷰 보완 검증:
+  - 리뷰 지적 사항에 따라 팔로잉 탭 조회의 크리에이터 role 필터, 오디오 공개 시각 판정, 유료 커뮤니티 최근 소식 미리보기 마스킹, 최근 소식 발행 `REQUIRES_NEW` 트랜잭션, inbox `title/body` 길이 정규화를 보강했다.
+  - RED 확인: `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.DefaultHomeFollowingQueryRepositoryTest" --tests "kr.co.vividnext.sodalive.v2.home.following.application.HomeFollowingNewsPublishServiceTest" --tests "kr.co.vividnext.sodalive.content.AudioContentServiceTest" --tests "kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityServiceTest"` 실행 결과 reviewer 보완 전 7개 regression 테스트 실패를 확인했다.
+  - 같은 regression 테스트 명령 재실행 결과 `BUILD SUCCESSFUL`.
+  - Phase 3-5 전체 대상 테스트 명령 재실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon ktlintCheck` 실행 결과 `BUILD SUCCESSFUL`.
+- 2026-06-26 Phase 3-5 2차 리뷰 보완 검증:
+  - 2차 리뷰 지적 사항에 따라 inbox insert 정상 경로를 row별 `saveAndFlush`에서 기존 memberId 일괄 조회 + `saveAll` + 단일 `flush`로 완화하고, 중복 충돌 fallback은 유지했다.
+  - 유료 오디오 콘텐츠의 `isFullDetailVisible=false` 상세 설명은 기존 상세 API 정책과 동일하게 미리보기만 최근 소식에 저장하도록 보강했다.
+  - 오디오/커뮤니티/랭킹 최근 소식 발행 실패가 원 업로드/게시글 생성/랭킹 스냅샷 갱신 성공을 실패로 전파하지 않도록 after-commit 발행 예외를 로그로 격리했다.
+  - 보완 직후 regression 테스트에서 adapter race 테스트와 Mockito matcher stubbing 불일치 실패를 확인한 뒤 테스트를 새 구현 경로에 맞게 정리했다.
+  - `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.HomeFollowingNewsInboxPersistenceAdapterTest" --tests "kr.co.vividnext.sodalive.content.AudioContentServiceTest" --tests "kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityServiceTest" --tests "kr.co.vividnext.sodalive.v2.ranking.application.CreatorRankingSnapshotRefreshServiceTest"` 실행 결과 `BUILD SUCCESSFUL`.
+  - Phase 3-5 전체 대상 테스트 명령 재실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon ktlintCheck` 실행 결과 `BUILD SUCCESSFUL`.
+- 2026-06-26 Phase 3-5 3차 리뷰 보완 검증:
+  - 최근 소식 조회가 `AUDIO_CONTENT`, `COMMUNITY_POST` 원천 target의 `isActive=false` 상태를 최종 제외하도록 보강했다. `CREATOR_RANKING`은 creator 활성/role 필터를 유지하고, 아직 원천 테이블이 없는 예약 타입은 조회에서 노출하지 않는다.
+  - 이달의 스케줄 정렬을 `scheduledAtUtc asc`, `type.sortOrder asc`, `targetId asc`로 안정화했다.
+  - inbox insert를 H2/MySQL 공통 JPA portable path로 변경했다. 구현은 `newsType/sourceKey`별 기존 수신 member id를 일괄 조회한 뒤 신규 row만 `saveAll` + `flush`하고, unique 충돌 시 persistence context를 정리한 뒤 한 번 재조회/재시도한다.
+  - 추후 운영에서 follower 수가 큰 크리에이터 이벤트로 `member_id in (...)` 또는 `saveAll` 배치 크기가 병목이 되면, follower id chunking, outbox table, 비동기 worker, 재시도/모니터링 대시보드 도입을 별도 후속 작업으로 진행한다.
+  - RED 확인: `./gradlew --no-daemon test --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.DefaultHomeFollowingQueryRepositoryTest" --tests "kr.co.vividnext.sodalive.v2.home.following.adapter.out.persistence.HomeFollowingNewsInboxPersistenceAdapterRetryTest"` 실행 결과 target 비활성 필터와 insert retry 미구현으로 `BUILD FAILED`.
+  - 같은 regression 테스트 명령 재실행 결과 `BUILD SUCCESSFUL`.
+  - Phase 3-5 전체 대상 테스트 명령 재실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon ktlintCheck` 실행 결과 `BUILD SUCCESSFUL`.
+  - `./gradlew --no-daemon test` 전체 테스트 실행 결과 `BUILD SUCCESSFUL`.
--- a/docs/20260625_메인_홈_팔로잉_탭_API/prd.md
+++ b/docs/20260625_메인_홈_팔로잉_탭_API/prd.md
@@ -157,6 +157,7 @@
 - 이벤트 발생 처리 흐름에서 내부 publish service를 호출해 follower 조회와 inbox bulk insert를 수행한다.
 - publish service는 콘텐츠/커뮤니티/랭킹 도메인 코드에 직접 흩어지지 않고, 향후 outbox/worker로 전환할 수 있는 단일 경계로 둔다.
 - follower가 많아져 동기 bulk insert가 운영 부하를 만들면 publish service 내부 구현을 outbox/worker 방식으로 교체할 수 있어야 한다.
+- 현재 구현은 H2/MySQL 공통 검증이 가능한 JPA portable path를 우선 사용한다. follower 수가 큰 크리에이터 이벤트에서 `member_id in (...)` 또는 `saveAll` 배치 크기가 운영 부하를 만들면, 후속 작업에서 follower id chunking, outbox table, 비동기 worker, 재시도/모니터링 대시보드로 전환한다.
 - 새로 팔로우한 사용자는 팔로우 이전에 발생한 과거 소식을 받지 않는다.
 - 언팔로우 시 해당 크리에이터가 보낸 기존 inbox row를 `isActive = false`로 비활성화한다.
 - 재팔로우 시 비활성화된 기존 inbox row는 복구하지 않는다.