Merge pull request 'test' (#446) from test into main

Reviewed-on: #446

docs/20260710_메인_홈_추천_응원크리에이터_스냅샷/plan-task.md

@@ -4,10 +4,10 @@
 
 | 항목 | 내용 |
 |---|---|
-| 상태 | 3차 Phase별 리뷰 완료 |
+| 상태 | Jenkins 회귀 수정 완료 |
-| 확정일 | 2026-07-31 |
+| 확정일 | 2026-08-03 |
 | 요구사항 기준 | `docs/20260710_메인_홈_추천_응원크리에이터_스냅샷/prd.md` 전체 |
-| 현재 Phase | Phase 1~7 3차 리뷰 완료 |
+| 현재 Phase | Phase 1~7 및 `P5-R2` 완료 |
 | 현재 활성 Goal | 없음 |
 | 다음 Goal | 없음 |
 
@@ -318,6 +318,20 @@
 - [x] **GREEN:** 새 테스트가 구현 결함을 드러낼 때만 `refreshFutures` 또는 lock 내부 존재 확인 경로를 최소 수정한다.
 - [x] **REFACTOR/GATE:** sleep 없이 `RecommendationSnapshotFallbackServiceTest` focused test와 `git diff --check`를 실행해 결과를 누적한다.
 
+#### Task R5.2 Jenkins single-flight 테스트 scheduling race 제거
+
+**Goal 실행 `P5-R2`:** 두 동시 요청이 pending refresh future를 공유하는 계약을 worker 완료 순서에 의존하지 않고 검증한다.
+
+- **시작 조건:** Jenkins에서 `shouldShareSingleCheerCreatorRefreshFutureForConcurrentRequests`의 두 번째 request `Future.get(...)`이 `TimeoutException`으로 실패하고, `REV-P5-002`가 테스트 scheduling race로 확정됨.
+- **완료 증거:** Jenkins 실패 원인 기록, 결정적 테스트 최소 수정, fallback focused test 반복 통과, 직접 영향 회귀·format·문서 명령·diff 검증 결과 누적.
+- **범위 밖:** `RecommendationSnapshotFallbackService` production 동작, worker 수, 300ms lock 대기와 1,500ms 홈 대기, 다른 fallback 섹션 변경.
+
+- [x] **RED:** Jenkins 실패의 `RecommendationSnapshotFallbackServiceTest.kt:322 TimeoutException`과 로컬 focused test 통과를 함께 기록해 worker scheduling에 따라 결과가 달라지는 기존 테스트를 확인한다.
+- [x] **RED 확인:** `./gradlew cleanTest test --tests 'kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotFallbackServiceTest.shouldShareSingleCheerCreatorRefreshFutureForConcurrentRequests'`의 로컬 통과와 Jenkins 실패를 대조해 비결정성을 확인한다.
+- [x] **GREEN:** 수동 `CapturingExecutor.runNext()` 완료 경쟁 대신 refresh worker를 latch로 pending 상태에 유지한다. 두 요청이 홈 대기 timeout으로 반환할 때까지 refresh를 완료하지 않고 `refreshCheerCreatorSnapshots(...)` 호출이 1회인지 검증한다.
+- [x] **GREEN 확인:** 같은 focused test를 반복 실행하고 `RecommendationSnapshotFallbackServiceTest` 전체를 실행해 single-flight, timeout 후 worker 지속, lock 내부 double-check가 모두 통과하는지 확인한다.
+- [x] **REFACTOR/GATE:** 사용하지 않는 test helper/import만 제거하고 `ktlintCheck`, `./gradlew tasks --all`, `git diff --check` 결과를 전체 검증 기록에 누적한다.
+
 ---
 
 ### Phase 6: API 회귀와 최종 검증
@@ -440,6 +454,8 @@ git diff --check
 - Non-Goals: Task 4.1, Task 6.1, Task 6.3, Task 7.1에서 다른 스냅샷 섹션 marker 확장 없음, 공개 API URL/응답 필드 변경 없음, 16명 밖 후보 보충 없음, 신규 DDL 없음, 관리자/ML/A-B 제외를 확인한다.
 
 ## 전체 검증 기록
+- 2026-08-03: `P5-R2` GREEN/GATE로 수동 `CapturingExecutor` 완료 경쟁을 제거하고, 실제 worker를 latch로 pending 상태에 유지한 채 두 요청의 worker task 제출과 `refreshCheerCreatorSnapshots(...)` 호출이 각각 1회인지 검증하도록 수정했다. focused test는 최초 1회와 연속 10회 모두 통과했고, `RecommendationSnapshotFallbackServiceTest` 전체, `./gradlew ktlintCheck`, `./gradlew tasks --all`, `./gradlew cleanTest test`, `git diff --check`가 모두 `BUILD SUCCESSFUL` 또는 출력 없음으로 통과했다. 전체 테스트는 7분 14초 소요됐다. Oracle 고강도 리뷰도 correctness·결정성·thread cleanup·production 무변경 판단에 blocker 없이 승인했다.
+- 2026-08-03: `P5-R2` RED 확인으로 Jenkins의 `RecommendationSnapshotFallbackServiceTest.kt:322 TimeoutException`과 로컬 `./gradlew cleanTest test --tests 'kr.co.vividnext.sodalive.v2.recommendation.application.RecommendationSnapshotFallbackServiceTest.shouldShareSingleCheerCreatorRefreshFutureForConcurrentRequests'` `BUILD SUCCESSFUL`을 대조했다. 같은 코드가 worker scheduling에 따라 실패·성공하여 기존 테스트의 `taskSubmitted` latch가 두 요청의 동일 future 대기를 보장하지 않는 비결정성을 확인했다.
 - 2026-07-31: Phase 1~7 3차 리뷰로 PRD·plan-task·현재 코드·테스트를 정적으로 대조했다. 이전 리뷰에서 보완한 문서 정합성, 종료 라이브 데뷔 이력, `CHEER_CREATOR` refresh 실패 로그, fallback single-flight·double-check, 공개 응답 3개 필드, 본인·활성 팔로우 제외가 현재 구현과 회귀 테스트에 유지됨을 확인했다. 각 결과는 기존 `reviews/phase-1-review.md`~`reviews/phase-7-review.md`에 3차 리뷰로 별도 누적했다. 추가 확정 발견 사항이 없어 신규 회귀 Task/Goal은 추가하지 않았다. 사용자 지시에 따라 Gradle compile/test는 실행하지 않았다. `git diff --check`는 출력 없이 통과했다. 문서 명령 유효성 확인용 `./gradlew tasks --all`은 일반 sandbox에서 `~/.gradle` wrapper lock 권한으로 실패한 뒤 승인된 동일 명령에서 `BUILD SUCCESSFUL`로 통과했다.
 - 2026-07-31: `P3-R2`로 `CHEER_CREATOR` 데뷔 CTE가 채널명이 있는 종료 라이브를 데뷔 이력으로 인정하도록 복구했다. RED 확인으로 `./gradlew test --tests kr.co.vividnext.sodalive.v2.recommendation.adapter.out.persistence.DefaultHomeRecommendationQueryRepositoryTest`를 실행해 `shouldIncludeEndedLiveWithChannelNameAsCheerCreatorDebut`가 `AssertionFailedError`로 실패하는 것을 확인했다. 이후 `findCheerCreatorSnapshots(...)` 라이브 branch에서 `lr.is_active = true`만 제거했고, 같은 repository focused test는 `BUILD SUCCESSFUL`로 통과했다. `./gradlew ktlintCheck`도 `BUILD SUCCESSFUL`로 통과했으며, `git diff --check`는 출력 없이 통과했다.
 - 2026-07-31: `P1-R2`로 상단 후속 변경 상태를 현재 PRD 전체, Phase 1~7 판정, 실제 미완료 Goal `P3-R2` 기준으로 정리했다. 문서 정합성 복구만 수행해 TDD 예외로 처리했다. `git diff --check -- docs/20260710_메인_홈_추천_응원크리에이터_스냅샷/plan-task.md`는 출력 없이 통과했고, `./gradlew tasks --all`은 `BUILD SUCCESSFUL`로 통과했다.

docs/20260710_메인_홈_추천_응원크리에이터_스냅샷/reviews/phase-5-review.md

@@ -32,6 +32,7 @@
 | ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal |
 |---|---|---|---|---|---|
 | `REV-P5-001` | Low | 보완 완료 | 동일 섹션 single-flight와 lock 내부 double-check의 직접 회귀 테스트가 없다 | Task R5.1 | `P5-R1` |
+| `REV-P5-002` | Medium | 보완 완료 | single-flight 테스트가 worker 완료 순서에 의존해 Jenkins에서 timeout된다 | Task R5.2 | `P5-R2` |
 
 ## 6. 발견 사항 상세
 
@@ -102,3 +103,16 @@ sleep 대신 latch와 결정적 fake를 사용해 두 경쟁 조건을 고정하
 - **plan·goal 전환:** 전환 항목 없음.
 - **최종 결론:** 확정 발견 사항 없음.
 - **남은 항목:** 없음.
+
+---
+
+## 11. 4차 리뷰 기록 — 2026-08-03
+
+- **리뷰 대상:** Phase 5 / Task R5.1의 `shouldShareSingleCheerCreatorRefreshFutureForConcurrentRequests` Jenkins 실패.
+- **검토 근거:** Jenkins `RecommendationSnapshotFallbackServiceTest.kt:322 TimeoutException`, `RecommendationSnapshotFallbackService.kt:141-149`, 테스트의 `CapturingExecutor`와 latch 흐름, 로컬 `cleanTest` focused test 실행, JDK 17 `CompletableFuture`·`CountDownLatch` 계약.
+- **확정 발견 사항:** `REV-P5-002`. `taskSubmitted` latch는 worker task가 executor에 전달됐다는 사실만 보장하며, refresh future가 `refreshFutures`에 게시됐거나 두 요청이 같은 future에서 대기 중임을 보장하지 않는다. Jenkins에서 첫 worker가 먼저 완료되면 reference가 제거되고 두 번째 요청은 실행되지 않는 새 captured task를 기다려 바깥 `get(1s)`에서 timeout된다.
+- **판정:** production single-flight 결함 근거는 없다. timeout 확대는 경쟁을 숨기므로 제외하고, refresh를 latch로 pending 상태에 유지한 채 두 요청의 refresh 호출 횟수 1회를 검증하도록 테스트만 수정한다.
+- **plan·goal 전환:** `plan-task.md` Phase 5에 Task R5.2 / `P5-R2`를 추가했다.
+- **검증 결과:** focused test 최초 1회와 연속 10회, `RecommendationSnapshotFallbackServiceTest` 전체, `ktlintCheck`, `tasks --all`, 전체 `cleanTest test`, `git diff --check`가 모두 통과했다. Oracle 고강도 리뷰도 blocker 없이 승인했다.
+- **최종 결론:** `P5-R2` 보완 완료.
+- **남은 항목:** 없음.

docs/20260804_관리자정산크리에이터번호적용/plan-task.md

@@ -0,0 +1,170 @@
+# 관리자 정산 크리에이터 번호 적용 구현 계획
+
+| 문서 항목 | 내용 |
+|---|---|
+| 상태 | 구현 완료 |
+| 작성일 | 2026-08-04 |
+| 요구사항 기준 | `docs/20260804_관리자정산크리에이터번호적용/prd.md` |
+| 현재 Phase | Phase 1 완료 |
+| 현재 활성 Goal | 없음 |
+
+## 목표
+
+이메일이 없는 크리에이터도 관리자 크리에이터별 정산에서 오류 없이 조회되고 `creatorId`로 구분된다.
+
+## 현재 상태
+
+| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
+|---:|---|---:|---|---|
+| 1 | 완료 | `2/2` | 없음 | 없음 |
+
+## 범위
+
+### 포함
+
+- 관리자 라이브·콘텐츠·커뮤니티 크리에이터별 정산 QueryDSL projection 변경
+- 정산 query/response DTO의 `email` 제거 및 `creatorId` 추가
+- 크리에이터별 정산 엑셀 이메일 컬럼 제거 및 크리에이터 번호 컬럼 추가
+- null 이메일 크리에이터 QueryDSL 회귀 테스트와 엑셀 출력 테스트
+
+### 제외
+
+- 에이전트·채널후원 정산 변경
+- `Member.email` 정책 변경
+- 정산 공식·집계·필터·정렬·페이지네이션 변경
+- dependency 추가와 관련 없는 리팩터링
+
+## 기술적 제약
+
+- Kotlin, Spring Boot 2.7.14, QueryDSL 5.0.0, JUnit 5의 기존 패턴을 유지한다.
+- `@QueryProjection` 생성자 변경은 Gradle KAPT가 생성 코드를 갱신하도록 하고 생성 파일은 직접 수정하지 않는다.
+- 구현은 RED → GREEN → REFACTOR 순서로 진행한다.
+- Gradle 명령은 QueryDSL 생성 코드 충돌을 피하기 위해 순차 실행한다.
+
+### Phase 1: 정산 projection 및 출력 변경
+
+**Phase 결과:** null 이메일 크리에이터 정산 조회와 creatorId 기반 API·엑셀 출력이 동작한다.
+
+**선행조건:** PRD와 본 계획 문서 작성 완료.
+
+#### Task 1.1 QueryDSL 정산 응답에 creatorId 적용
+
+**Goal 실행 `P1-T1`:** null 이메일 크리에이터의 세 정산 조회가 creatorId를 반환하도록 한다.
+
+- **시작 조건:** `CALC-001`, `CALC-002`, `CALC-004` 확정.
+- **완료 증거:** RED/GREEN 결과와 focused test 기록.
+- **범위 밖:** 엑셀 출력 변경은 `P1-T2`에서 처리한다.
+
+**Files:**
+
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateQueryRepositoryTest.kt`
+- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/GetCalculateByCreatorQueryData.kt`
+- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/GetCalculateByCreatorItem.kt`
+- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateQueryRepository.kt`
+
+- [x] **RED:** email이 null인 크리에이터의 라이브·콘텐츠·커뮤니티 정산 조회가 `creatorId`를 반환하는 통합 테스트를 작성한다.
+- [x] **RED 확인:** `./gradlew test --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateQueryRepositoryTest`를 실행해 기존 projection의 null email 생성 오류 또는 미구현 `creatorId` 계약 실패를 확인한다.
+- [x] **GREEN:** 두 DTO에서 `email`을 `creatorId: Long`으로 교체하고 세 QueryDSL projection에서 `member.id`를 선택한다.
+- [x] **GREEN 확인:** 같은 focused test가 성공하는지 확인한다.
+- [x] **REFACTOR:** 이번 Task가 만든 중복만 정리하고 정산 계산 회귀 테스트를 실행한다.
+
+#### Task 1.2 엑셀 크리에이터 번호 적용
+
+**Goal 실행 `P1-T2`:** 크리에이터별 정산 엑셀에서 이메일 대신 크리에이터 번호를 출력한다.
+
+- **시작 조건:** `P1-T1` 완료.
+- **완료 증거:** 엑셀 헤더·값 테스트와 focused test 기록.
+- **범위 밖:** 다른 정산 엑셀 형식 변경.
+
+**Files:**
+
+- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateServiceTest.kt`
+- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateService.kt`
+
+- [x] **RED:** 크리에이터별 정산 엑셀의 첫 헤더와 값이 크리에이터 번호인지 검증하는 테스트를 작성한다.
+- [x] **RED 확인:** `./gradlew test --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateServiceTest`를 실행해 남아 있는 `item.email` 계약 때문에 컴파일이 실패하는지 확인한다.
+- [x] **GREEN:** 엑셀 첫 헤더를 `크리에이터 번호`로 교체하고 `creatorId`를 기록한다.
+- [x] **GREEN 확인:** 같은 focused test가 성공하는지 확인한다.
+- [x] **REFACTOR:** 나머지 엑셀 컬럼과 계산 결과가 유지되는지 회귀 확인한다.
+
+### 완료 조건
+
+- [x] `P1-T1`, `P1-T2`의 체크박스와 완료 증거가 충족됐다.
+- [x] 문서와 구현의 차이가 없다.
+
+### Phase 1 Gate
+
+**Goal 실행 `P1-GATE`:** 변경 범위의 기능·컴파일·포맷을 최종 판정한다.
+
+```bash
+./gradlew compileKotlin
+./gradlew test --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateQueryRepositoryTest --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateServiceTest --tests kr.co.vividnext.sodalive.admin.calculate.ContentSettlementCalculationTest
+./gradlew ktlintCheck
+./gradlew tasks --all
+git diff --check
+```
+
+**Expected:** 모든 Gradle 명령이 `BUILD SUCCESSFUL`, 테스트가 모두 통과하고 `git diff --check` 출력이 없다.
+
+전체 테스트는 관리자 크리에이터별 정산의 projection/DTO/엑셀 경계로 변경이 제한되고 focused test와 컴파일로 세 쿼리 호출부를 검증하므로 생략한다.
+
+## 실행 순서와 의존성
+
+| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
+|---:|---|---|---|---|
+| 1 | `P1-T1` | 문서 작성 완료 | 아니요 | RED 실패 원인 재확인 |
+| 2 | `P1-T2` | `P1-T1` 완료 | 아니요 | 엑셀 계약 재확인 |
+| 3 | `P1-GATE` | Phase 1 Task 전체 | 아니요 | 실패 소유 Task에 회귀 수정 기록 |
+
+## 변경 금지 항목
+
+- QueryDSL 생성 파일을 직접 수정하지 않는다.
+- 정산 계산식과 쿼리 집계 조건을 변경하지 않는다.
+- 테스트를 삭제·skip·완화하지 않는다.
+- 요청 범위 밖의 정산 API를 변경하지 않는다.
+
+## Progress
+
+### `P1-T1` 1차 실행 — 2026-08-04
+
+- 상태: 진행 중
+- 무엇을: PRD와 구현 계획을 작성하고 QueryDSL 통합 테스트 seam을 확정했다.
+- 왜: production 변경 전에 요구사항과 TDD 완료 기준을 고정하기 위해서다.
+- 어떻게:
+  - `docs/sample/sample-prd.md`, `docs/sample/sample-plan-task.md` 확인 — 완료
+  - `AdminCalculateQueryRepository`와 관련 DTO 호출 경로 확인 — 완료
+  - `./gradlew test --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateQueryRepositoryTest` — RED 확인, `creatorId` 미구현으로 `compileTestKotlin` 실패
+  - `./gradlew test --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateServiceTest` — RED 확인, 남아 있는 `item.email` 참조로 `compileKotlin` 실패
+  - `./gradlew test --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateQueryRepositoryTest --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateServiceTest` — GREEN, `BUILD SUCCESSFUL`
+- 남은 항목: Phase Gate 검증.
+- 다음 행동: 컴파일·focused 회귀·ktlint·문서 검증을 순차 실행한다.
+
+### `P1-GATE` 1차 실행 — 2026-08-04
+
+- 상태: 완료
+- 무엇을: creatorId projection·응답·엑셀 변경과 null 이메일 회귀 방지를 검증했다.
+- 왜: `CALC-001`~`CALC-004`의 수용 기준과 기존 계산 불변성을 최종 판정하기 위해서다.
+- 어떻게:
+  - `./gradlew compileKotlin` — `BUILD SUCCESSFUL`
+  - `./gradlew test --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateQueryRepositoryTest --tests kr.co.vividnext.sodalive.admin.calculate.AdminCalculateServiceTest --tests kr.co.vividnext.sodalive.admin.calculate.ContentSettlementCalculationTest` — 11 tests, failures 0, errors 0
+  - `./gradlew ktlintCheck` — `BUILD SUCCESSFUL`
+  - `./gradlew build -x test` — `BUILD SUCCESSFUL`
+  - `git diff --check` — 출력 없음
+  - 독립 Oracle 리뷰 — `APPROVED`, 차단 이슈 없음
+- 수동 검증: QueryDSL H2 통합 테스트로 null 이메일 세 정산 조회를 실행하고, 실제 XLSX workbook의 헤더와 numeric creatorId 셀을 확인했다.
+- 전체 테스트 생략: 변경이 관리자 크리에이터별 정산의 공용 projection/DTO/엑셀 경계에 한정되어 focused 통합·서비스·계산 테스트와 전체 빌드로 직접 영향 범위를 검증했다.
+- 남은 항목: 없음.
+- 다음 행동: 없음.
+
+## Decision Log
+
+| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
+|---|---|---|---|---|---|
+| 2026-08-04 | `DEC-001` | 확정 | email을 제거하고 creatorId를 projection·응답에 추가한다. | PRD `DEC-001` | `P1-T1` |
+| 2026-08-04 | `DEC-002` | 확정 | 엑셀 이메일 컬럼을 크리에이터 번호로 교체한다. | PRD `DEC-002` | `P1-T2` |
+
+## 발견된 문제
+
+| ID | 심각도 | 상태 | 발견 내용 | 영향 Goal | 처리 계획 |
+|---|---|---|---|---|---|
+| `ISSUE-001` | High | 확정 | nullable `Member.email`이 non-null QueryProjection 생성자로 전달되어 정산 조회가 실패한다. | `P1-T1` | creatorId로 projection 계약 교체 |

docs/20260804_관리자정산크리에이터번호적용/prd.md

@@ -0,0 +1,73 @@
+# 관리자 정산 크리에이터 번호 적용 PRD
+
+## 문서 정보
+
+| 항목 | 내용 |
+|---|---|
+| 문서 상태 | 구현 완료 |
+| 작성일 | 2026-08-04 |
+| 최종 수정일 | 2026-08-04 |
+| 대상 제품 | 관리자 크리에이터별 정산 조회 및 엑셀 |
+| 작성자·결정권자 | 사용자 |
+| 관련 구현 계획 | `docs/20260804_관리자정산크리에이터번호적용/plan-task.md` |
+
+## 1. Overview
+
+관리자 크리에이터별 정산에서 nullable인 `Member.email`을 필수 QueryDSL projection 값으로 사용해 발생하는 조회 오류를 제거한다. 정산 대상 식별값은 이메일 대신 non-null PK인 `creatorId`를 사용한다.
+
+## 2. Problem Statement
+
+- `Member.email`은 nullable이지만 `GetCalculateByCreatorQueryData.email`은 non-null `String`이다.
+- 이메일이 없는 크리에이터가 정산 결과에 포함되면 QueryDSL이 DTO 생성 중 `ExpressionException`을 발생시킨다.
+- 이메일은 정산 계산식에 사용되지 않으므로 필수 projection 값으로 유지할 이유가 없다.
+
+문제 해결 여부는 이메일이 null인 크리에이터의 정산 조회가 성공하고 `creatorId`를 반환하는지로 판단한다.
+
+## 3. Goals
+
+- 라이브·콘텐츠·커뮤니티 크리에이터별 정산 projection에서 `email`을 제거한다.
+- 정산 응답에 `creatorId`를 추가한다.
+- 크리에이터별 정산 엑셀에서 이메일을 제거하고 크리에이터 번호를 제공한다.
+- 기존 정산 금액 계산, 집계, 필터, 정렬과 페이지네이션을 유지한다.
+
+## 4. Non-Goals
+
+- `Member.email`의 nullable 정책을 변경하지 않는다.
+- 이메일이 없는 회원의 다른 기능을 수정하지 않는다.
+- 에이전트 정산과 채널후원 정산 API를 변경하지 않는다.
+- 정산 공식 또는 정산 비율을 변경하지 않는다.
+
+## 5. 기능 요구사항
+
+| ID | 상태 | 요구사항 | 수용 기준 | Goal 연결 |
+|---|---|---|---|---|
+| `CALC-001` | 확정 | 크리에이터별 정산 조회는 이메일 대신 크리에이터 번호를 반환한다. | 응답 item에 `creatorId: Long`이 있고 `email`이 없다. | `P1-T1` |
+| `CALC-002` | 확정 | 이메일이 없는 크리에이터도 정산 조회 대상에 포함된다. | null 이메일 크리에이터의 라이브·콘텐츠·커뮤니티 정산 QueryDSL 조회가 예외 없이 성공한다. | `P1-T1` |
+| `CALC-003` | 확정 | 크리에이터별 정산 엑셀은 이메일 대신 크리에이터 번호를 제공한다. | 첫 헤더가 `크리에이터 번호`이고 데이터 셀에 `creatorId`가 기록된다. | `P1-T2` |
+| `CALC-004` | 확정 | 기존 정산 계산 결과를 유지한다. | `totalCan`, 원화, 결제수수료, 정산금액, 원천세와 입금액 계산 회귀 테스트가 통과한다. | `P1-T1`, `P1-GATE` |
+
+## 6. API 계약
+
+대상 endpoint는 다음과 같다.
+
+- `GET /admin/calculate/live-by-creator`
+- `GET /admin/calculate/content-by-creator`
+- `GET /admin/calculate/community-by-creator`
+- 위 세 endpoint의 `/excel` 다운로드
+
+조회 응답 item의 `email: String`을 제거하고 `creatorId: Long`을 추가한다. 요청 파라미터와 응답의 나머지 필드는 변경하지 않는다.
+
+## 7. 성공 기준
+
+- [x] null 이메일 크리에이터에 대한 세 종류의 크리에이터별 정산 조회가 성공한다.
+- [x] 조회 응답은 `creatorId`를 포함하고 `email`을 포함하지 않는다.
+- [x] 엑셀은 `크리에이터 번호` 컬럼을 포함하고 이메일 컬럼을 포함하지 않는다.
+- [x] 기존 정산 계산 및 관련 회귀 테스트가 통과한다.
+
+## 8. Decision Log
+
+| 날짜 | ID | 상태 | 결정 | 근거 | 영향 요구사항·Goal |
+|---|---|---|---|---|---|
+| 2026-08-04 | `DEC-001` | 확정 | 정산에서 email을 제거하고 creatorId를 사용한다. | email은 계산에 사용되지 않고 nullable이라 projection 오류를 발생시킨다. | `CALC-001`, `CALC-002`, `P1-T1` |
+| 2026-08-04 | `DEC-002` | 확정 | 엑셀의 이메일 컬럼을 크리에이터 번호 컬럼으로 교체한다. | 사용자가 이메일 제거와 creatorId 기반 구분을 확정했다. | `CALC-003`, `P1-T2` |
+| 2026-08-04 | `DEC-003` | 확정 | 이메일 제거에 따른 추가 식별력 보완은 하지 않는다. | 사용자가 식별력 저하는 문제가 되지 않는다고 확정했다. | Non-Goals |

docs/20260805_추천탭_배너_조회조건/plan-task.md

@@ -0,0 +1,90 @@
+# 추천 탭 배너 조회 조건 보정 Implementation Plan
+
+| 문서 항목 | 내용 |
+|---|---|
+| 상태 | 구현 완료 |
+| 작성일 | 2026-08-05 |
+| 요구사항 기준 | `docs/20260805_추천탭_배너_조회조건/prd.md` |
+| API 기준 | 기존 공개 API 계약 유지 |
+| 현재 Phase | Phase 1: 배너 조회 조건 보정 |
+| 현재 활성 Goal | 없음 |
+
+## 목표
+
+메인 홈 추천과 메인 콘텐츠 추천에서 화면별 탭과 회원의 성인 콘텐츠 조회 가능 여부에 맞는 배너만 조회한다.
+
+## 현재 상태
+
+| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
+|---:|---|---:|---|---|
+| 1 | 완료 | `2/2` | 없음 | 없음 |
+
+## 범위
+
+### 포함
+
+- 홈 추천 배너의 `tab_id IS NULL` 조건 유지 및 성인 배너 필터 추가
+- 콘텐츠 추천 배너의 `tab_id = 2` 조건과 성인 배너 필터 추가
+- application에서 계산한 성인 콘텐츠 조회 가능 여부를 persistence port까지 전달
+- 관련 service/facade/Repository focused test와 직접 영향 범위 회귀
+
+### 제외
+
+- 공개 API endpoint와 응답 DTO 변경
+- 배너 언어/활성/차단/대상 유효성/정렬/limit 정책 변경
+- DB 데이터 또는 스키마 변경
+
+## 기술적 제약
+
+- Kotlin, Spring Boot 2.7.14, QueryDSL 기존 패턴을 유지한다.
+- 성인 콘텐츠 조회 가능 여부는 `MemberContentPreferenceService.canViewAdultContent(member)` 결과를 재사용한다.
+- 조회 가능 여부가 `false`이면 `audioContentBanner.isAdult.isFalse`, `true`이면 성인 조건을 추가하지 않는다.
+- 신규 공통 추상화나 의존성을 추가하지 않는다.
+
+### Phase 1: 배너 조회 조건 보정
+
+- [x] **Task 1.1: 추천 API별 탭 및 성인 배너 조회 조건 구현 (`P1-T1`)**
+  - Objective: 두 추천 API의 배너가 확정된 탭과 성인 콘텐츠 조회 정책에 따라 반환된다.
+  - 시작 조건: PRD `BANNER-001~004`가 확정되어 있다.
+  - 완료 증거: 신규/보강 테스트가 RED 후 GREEN이고 관련 production/test 코드가 컴파일된다.
+  - 범위 밖: 언어 필터와 공개 응답 스키마 변경.
+  - Modify:
+    - `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacade.kt`
+    - `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryService.kt`
+    - `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/port/out/HomeRecommendationQueryPort.kt`
+    - `src/main/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepository.kt`
+    - `src/main/kotlin/kr/co/vividnext/sodalive/v2/content/recommendation/adapter/out/persistence/DefaultAudioRecommendationQueryRepository.kt`
+    - `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/home/application/HomeRecommendationFacadeTest.kt`
+    - `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/application/HomeRecommendationQueryServiceTest.kt`
+    - `src/test/kotlin/kr/co/vividnext/sodalive/v2/recommendation/adapter/out/persistence/DefaultHomeRecommendationQueryRepositoryTest.kt`
+    - `src/test/kotlin/kr/co/vividnext/sodalive/v2/content/recommendation/adapter/out/persistence/DefaultAudioRecommendationQueryRepositoryTest.kt`
+  - RED: 홈 성인 조회 플래그 전달, 홈 비성인 필터, 콘텐츠 `tab_id = 2` 및 비성인 필터를 검증하는 테스트를 먼저 작성하고 실패를 확인한다.
+  - GREEN: 기존 QueryDSL 조건에 필요한 탭/성인 조건만 추가하고 홈 application 경로에 플래그를 전달한다.
+  - REFACTOR: 중복되지 않는 기존 조건 helper 패턴을 따르고 불필요한 변경이 없는지 확인한다.
+  - Verify:
+    - `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.application.HomeRecommendationFacadeTest --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.content.recommendation.adapter.out.persistence.DefaultAudioRecommendationQueryRepositoryTest`
+  - 검증 기록:
+    - RED: 두 Repository 테스트를 실행해 `shouldExcludeAdultHomeBannersWhenAdultContentIsNotVisible`, `shouldFindBannersForContentRecommendationTabWithAdultVisibility` 두 건의 기대값 실패를 확인했다.
+    - RED: 홈 service 테스트는 `includeAdultBanners` 미구현 컴파일 실패, Facade 테스트는 플래그 미전달 assertion 실패를 각각 확인했다.
+    - GREEN: 위 4개 focused test class를 함께 실행해 `BUILD SUCCESSFUL`을 확인했다.
+
+- [x] **Task 1.2: 영향 범위 회귀 및 문서 검증 (`P1-GATE`)**
+  - Objective: 추천 배너 변경이 기존 API 계약과 코드 품질 규칙을 깨지 않았음을 확인한다.
+  - 시작 조건: `P1-T1`이 완료되어 있다.
+  - 완료 증거: focused test, `ktlintCheck`, `tasks --all`, `git diff --check`가 통과하고 결과가 기록되어 있다.
+  - 범위 밖: 전체 회귀 테스트. 변경이 배너 조회 경로 두 곳에 한정되어 targeted test로 직접 영향 범위를 판단할 수 있으므로 생략한다.
+  - Verify:
+    - `./gradlew test --tests kr.co.vividnext.sodalive.v2.api.home.application.HomeRecommendationFacadeTest --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.content.recommendation.adapter.out.persistence.DefaultAudioRecommendationQueryRepositoryTest`
+    - `./gradlew ktlintCheck`
+    - `./gradlew tasks --all`
+    - `git diff --check`
+  - 검증 기록:
+    - `HomeRecommendationControllerTest`, `AudioRecommendationControllerTest`, `AudioRecommendationEndToEndTest`를 함께 실행해 `BUILD SUCCESSFUL`을 확인했다.
+    - `./gradlew ktlintCheck`: `BUILD SUCCESSFUL`.
+    - `./gradlew tasks --all`: `BUILD SUCCESSFUL`.
+    - `git diff --check`: 출력 없음.
+
+## 검증 기록
+
+- 최초 Gradle 실행은 sandbox의 `~/.gradle` wrapper lock 접근 제한으로 실패했으며, 승인된 동일 명령을 재실행해 검증을 완료했다.
+- 전체 회귀 테스트는 실행하지 않았다. 변경이 두 배너 조회 조건과 홈 플래그 전달에 한정되어 focused Repository/application 테스트와 두 API의 controller/E2E 회귀로 직접 영향 범위를 검증했다.

docs/20260805_추천탭_배너_조회조건/prd.md

@@ -0,0 +1,71 @@
+# PRD: 추천 탭 배너 조회 조건 보정
+
+## 문서 정보
+
+| 항목 | 내용 |
+|---|---|
+| 문서 상태 | 구현 완료 |
+| 작성일 | 2026-08-05 |
+| 최종 수정일 | 2026-08-05 |
+| 대상 제품 | 메인 홈 추천 탭, 메인 콘텐츠 추천 탭 |
+| 작성자·결정권자 | 사용자 |
+| 관련 구현 계획 | `docs/20260805_추천탭_배너_조회조건/plan-task.md` |
+| 관련 기존 문서 | `docs/20260529_메인_홈_추천_API/prd.md`, `docs/20260623_메인_콘텐츠_추천_탭_API/prd.md` |
+
+## 1. Overview
+
+메인 홈 추천 API와 메인 콘텐츠 추천 API의 배너 조회에 회원의 성인 콘텐츠 조회 가능 여부를 반영하고, 두 화면이 서로 다른 탭의 배너를 조회하도록 조건을 보정한다.
+
+## 2. Problem Statement
+
+- 두 추천 API가 모두 `content_banner.tab_id IS NULL`인 같은 배너를 조회한다.
+- 두 추천 API의 배너 조회가 `content_banner.is_adult`를 필터링하지 않아 성인 콘텐츠 조회 불가 사용자에게 성인 배너가 노출될 수 있다.
+
+문제를 해결했다는 판단은 두 API의 탭 조건과 성인 배너 노출 조건이 Repository 테스트로 구분되어 검증되는 것으로 한다.
+
+## 3. Goals
+
+- 성인 콘텐츠 조회 불가 사용자는 `is_adult = false`인 배너만 조회한다.
+- 성인 콘텐츠 조회 가능 사용자는 성인·비성인 배너를 모두 조회한다.
+- 메인 홈 추천 API는 기존처럼 `tab_id IS NULL`인 배너를 조회한다.
+- 메인 콘텐츠 추천 API는 `tab_id = 2`인 배너를 조회한다.
+
+## 4. Non-Goals
+
+- 공개 API endpoint와 응답 DTO를 변경하지 않는다.
+- 배너 언어 필터, 정렬, 최대 조회 개수, 대상 활성/차단 정책을 변경하지 않는다.
+- 배너 또는 탭 데이터와 DB 스키마를 변경하지 않는다.
+
+## 5. 기능 요구사항
+
+| ID | 상태 | 요구사항 | 수용 기준 | Goal 연결 |
+|---|---|---|---|---|
+| `BANNER-001` | 확정 | `GET /api/v2/home/recommendations`의 배너는 `tab_id IS NULL` 조건을 유지한다. | 탭이 없는 활성 배너만 조회하고 `tab_id = 2` 배너는 조회하지 않는다. | `P1-T1` |
+| `BANNER-002` | 확정 | `GET /api/v2/audio/recommendations`의 배너는 `tab_id = 2` 조건을 사용한다. | `tab_id = 2`인 활성 배너만 조회하고 탭이 없는 배너는 조회하지 않는다. | `P1-T1` |
+| `BANNER-003` | 확정 | 두 API 모두 회원의 성인 콘텐츠 조회 가능 여부를 배너 조회에 반영한다. | 조회 불가이면 비성인 배너만, 조회 가능이면 성인·비성인 배너를 모두 반환한다. | `P1-T1` |
+| `BANNER-004` | 확정 | 기존 배너 활성/차단/대상 유효성/정렬/limit 정책을 유지한다. | 기존 관련 Repository 테스트가 계속 통과한다. | `P1-GATE` |
+
+## 6. API 계약
+
+| Method | Path | 변경 내용 |
+|---|---|---|
+| `GET` | `/api/v2/home/recommendations` | 응답 스키마 변경 없이 배너의 성인 조회 조건만 추가한다. |
+| `GET` | `/api/v2/audio/recommendations` | 응답 스키마 변경 없이 배너 탭 조건을 `tab_id = 2`로 변경하고 성인 조회 조건을 추가한다. |
+
+## 7. 성공 기준
+
+- [x] 홈 추천 배너가 `tab_id IS NULL` 조건을 유지한다.
+- [x] 콘텐츠 추천 배너가 `tab_id = 2` 조건만 사용한다.
+- [x] 성인 콘텐츠 조회 불가/가능 사용자의 배너 결과가 확정 정책과 일치한다.
+- [x] 기존 배너 응답 스키마와 활성/차단/정렬/limit 정책이 유지된다.
+
+## 8. Open Questions
+
+- 없음.
+
+## 9. Decision Log
+
+| 날짜 | ID | 상태 | 결정 | 근거 | 영향 요구사항·Goal |
+|---|---|---|---|---|---|
+| 2026-08-05 | `DEC-001` | 확정 | 성인 조회 불가이면 비성인 배너만, 조회 가능이면 성인·비성인 배너를 모두 조회한다. | 사용자 답변 A | `BANNER-003`, `P1-T1` |
+| 2026-08-05 | `DEC-002` | 확정 | 홈 추천은 `tab_id IS NULL`, 콘텐츠 추천은 `tab_id = 2`를 사용한다. | 사용자 직접 요구사항 | `BANNER-001`, `BANNER-002`, `P1-T1` |

docs/20260805_크리에이터관리자_시리즈상세_LazyInitializationException_수정/plan-task.md

@@ -0,0 +1,174 @@
+# 크리에이터 관리자 시리즈 상세 LazyInitializationException 수정 Plan/TASK
+
+| 문서 항목 | 내용 |
+|---|---|
+| 상태 | 구현 완료 |
+| 작성일 | 2026-08-05 |
+| 요구사항 기준 | `docs/20260805_크리에이터관리자_시리즈상세_LazyInitializationException_수정/prd.md` |
+| API 기준 | 기존 `GET /creator-admin/audio-content/series/{seriesId}` 계약 유지 |
+| 현재 Phase | Phase 1 완료 |
+| 현재 활성 Goal | 없음, 구현 완료 |
+
+## 목표
+
+OSIV off 환경에서 크리에이터 관리자가 본인 시리즈 상세를 조회할 때 `Series.keywordList` lazy 초기화 예외 없이 기존 응답을 받게 한다.
+
+## 현재 상태
+
+| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
+|---:|---|---:|---|---|
+| 1 | 완료 | `1/1` | 없음 | 없음 |
+
+- 동시에 하나의 미완료 goal만 운용한다.
+- 완료된 Task와 검증 기록은 되돌리거나 삭제하지 않는다.
+
+## 범위
+
+### 포함
+
+- `CreatorAdminContentSeriesService`의 class-level read-only 트랜잭션 경계
+- `Series.keywordList` lazy 예외를 재현하고 방지하는 서비스 통합 테스트
+- 기존 상세 응답과 소유권 동작의 영향 범위 회귀 검증
+
+### 제외
+
+- endpoint와 `GetCreatorAdminContentSeriesDetailResponse` 변경
+- OSIV, entity fetch 전략, repository query 변경
+- 다른 시리즈 조회·수정 흐름 리팩터링
+- 새 abstraction 또는 dependency 추가
+
+## 기술적 제약
+
+- Kotlin, Java 17, Spring Boot 2.7.14, Spring Data JPA, Hibernate, JUnit 5를 유지한다.
+- production code는 `CreatorAdminContentSeriesService` class-level annotation 한 줄만 변경한다.
+- 기존 쓰기 메서드 `createSeries()`, `modifySeries()`, `addingContentToTheSeries()`, `removeContentInTheSeries()`,
+  `updateSeriesOrders()`의 메서드 레벨 `@Transactional`은 유지해 class-level read-only 기본값을 재정의한다.
+- 테스트는 실제 Spring 서비스 프록시를 사용하고 외부 테스트 트랜잭션으로 서비스 경계를 가리지 않는다.
+- focused test부터 실행하고 직접 영향받는 characterization test까지만 회귀 범위를 확장한다.
+- 전체 테스트는 class-level annotation 한 줄 변경과 targeted test로 영향 범위를 판정할 수 있으므로 기본적으로 생략한다. targeted test에서
+  범위를 설명할 수 없는 실패가 발생하거나 공통 경계 변경으로 확대될 때만 실행한다.
+
+## Phase 1: 상세 조회 트랜잭션 회귀 수정
+
+**Phase 결과:** 크리에이터 관리자 시리즈 상세 조회가 OSIV off 환경에서 키워드를 포함한 기존 DTO를 정상 반환한다.
+
+**선행조건:** `CASD-001`~`CASD-003` 요구사항과 `DEC-CASD-002`, `DEC-CASD-003` 결정 확정.
+
+**Phase 완료 조건:** `P1-T1`과 `P1-GATE` 완료, focused·영향 범위 회귀 결과 기록.
+
+### 구현 항목
+
+#### Task 1.1 상세 조회 lazy 예외 재현 및 최소 수정
+
+**Goal 실행 `P1-T1`:** 서비스 클래스의 기본 read-only 트랜잭션 안에서 상세 조회가 키워드 lazy 컬렉션을 DTO로 변환하게 한다.
+
+- **시작 조건:** PRD 구현 기준 확정, production code 미수정 상태.
+- **완료 증거:** RED/GREEN/REFACTOR 체크박스 완료, focused test 실제 실행 결과, class-level annotation 이외 production diff 없음,
+  기존 쓰기 메서드 annotation 유지.
+- **범위 밖:** OSIV·entity mapping·repository query·controller·response DTO 변경.
+
+**Files:**
+
+- Create: `src/test/kotlin/kr/co/vividnext/sodalive/creator/admin/content/series/CreatorAdminContentSeriesServiceIntegrationTest.kt`
+- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/creator/admin/content/series/CreatorAdminContentSeriesService.kt`
+- Modify: `docs/20260805_크리에이터관리자_시리즈상세_LazyInitializationException_수정/plan-task.md`
+- Verify: `src/test/resources/application.yml`
+
+**Interfaces:**
+
+- Consumes: `CreatorAdminContentSeriesService.getDetail(id: Long, memberId: Long)`과 기존 `Series.toDetailResponse(imageHost)`
+- Produces: 기존 시그니처·DTO를 유지하면서 class-level read-only 트랜잭션 안에서 완성된
+  `GetCreatorAdminContentSeriesDetailResponse`
+
+- [x] **RED:** `@SpringBootTest`, `EmbeddedRedisInitializer`, 실제 `CreatorAdminContentSeriesService` 빈을 사용하는 통합 테스트를 작성한다.
+  테스트 외부 트랜잭션은 사용하지 않고 `TransactionTemplate` 안에서 소유 회원, 장르, 시리즈, 해시태그와 `SeriesKeyword` fixture를
+  저장한 뒤 트랜잭션 밖에서 `service.getDetail()`을 호출해 `keywords`와 주요 상세 필드를 검증한다.
+- [x] **RED 확인:** `./gradlew --no-daemon test --rerun-tasks --tests kr.co.vividnext.sodalive.creator.admin.content.series.CreatorAdminContentSeriesServiceIntegrationTest`
+  를 실행해 `Series.keywordList`의 `LazyInitializationException`으로 실패하는지 확인한다. 환경·fixture·컴파일 실패는 RED 증거로
+  인정하지 않고 먼저 바로잡는다.
+- [x] **GREEN:** `CreatorAdminContentSeriesService` 클래스 선언 바로 위에 기존 import를 사용하는
+  `@Transactional(readOnly = true)` 한 줄을 추가하고 기존 쓰기 메서드의 메서드 레벨 `@Transactional`을 유지한다.
+- [x] **GREEN 확인:** RED와 같은 focused test를 다시 실행해 `BUILD SUCCESSFUL`과 fixture의 `keywords`, `seriesId`,
+  `publishedDaysOfWeek`, `state` 값 일치를 확인한다.
+- [x] **REFACTOR:** 새 abstraction 없이 테스트 fixture의 중복만 파일 내부 private helper로 제한한다. focused test와
+  `./gradlew --no-daemon test --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.series.LegacyCreatorAdminSeriesCharacterizationTest`
+  를 실행하고, production diff가 class-level annotation 한 줄이며 모든 기존 쓰기 메서드 annotation이 유지되는지 확인해 결과를
+  이 Task 아래에 기록한다.
+
+### 완료 조건
+
+- [x] `P1-T1`의 RED/GREEN/REFACTOR와 완료 증거가 모두 충족됐다.
+- [x] `CASD-001`~`CASD-003`이 자동 검증 결과로 추적된다.
+- [x] API 계약, OSIV, entity mapping, repository query에 변경이 없다.
+
+### 검증 방법
+
+#### Phase 1 Gate
+
+**Goal 실행 `P1-GATE`:** 상세 조회 수정의 기능·회귀·문서 범위를 최종 판정한다.
+
+- **시작 조건:** `P1-T1` 완료.
+- **완료 증거:** 아래 명령 통과 및 실제 결과를 검증 기록에 누적.
+- **범위 밖:** Gate 통과를 위한 테스트 완화와 관련 없는 코드 수정.
+
+```bash
+./gradlew --no-daemon test --rerun-tasks --tests kr.co.vividnext.sodalive.creator.admin.content.series.CreatorAdminContentSeriesServiceIntegrationTest
+./gradlew --no-daemon test --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.series.LegacyCreatorAdminSeriesCharacterizationTest
+./gradlew --no-daemon ktlintCheck
+./gradlew --no-daemon tasks --all
+git diff --check
+./gradlew --no-daemon test
+```
+
+- [x] focused test가 실제 실행되고 failures/errors 0으로 통과한다.
+- [x] 기존 시리즈 상세·소유권 characterization test가 통과한다.
+- [x] `ktlintCheck`, `tasks --all`, `git diff --check`가 통과한다.
+- [x] ultrawork verification 요구에 따라 전체 테스트를 실행하고 통과했다.
+- [x] production code 변경이 `CreatorAdminContentSeriesService`의 class-level `@Transactional(readOnly = true)` 한 줄뿐이다.
+- [x] 기존 쓰기 메서드 5개의 메서드 레벨 `@Transactional`이 유지된다.
+
+## 실행 순서
+
+| 순서 | Goal | 완료 후 다음 Goal |
+|---:|---|---|
+| 1 | `P1-T1` | `P1-GATE` |
+| 2 | `P1-GATE` | 구현 완료 |
+
+## Progress
+
+- 2026-08-05: 운영 stack trace와 controller → service → repository → entity DTO 변환 흐름을 확인했다.
+- 2026-08-05: `Series.keywordList` lazy 접근과 트랜잭션 없는 `getDetail()`을 원인으로 확정했다.
+- 2026-08-05: PRD와 Plan/TASK를 작성했으며 production code와 테스트는 아직 변경하지 않았다.
+- 2026-08-05: 메서드 분류 재검토 결과 트랜잭션 없는 public 메서드 4개는 모두 조회이고, 쓰기 메서드 5개는 모두 메서드 레벨
+  `@Transactional`을 보유함을 확인했다. 해결안을 `getDetail()` 메서드 단위에서 서비스 class-level read-only 기본값으로 정정했다.
+- 2026-08-05: `P1-T1` RED/GREEN/REFACTOR를 완료했다. 다음 Goal은 `P1-GATE`이며 Gate 체크박스는 아직 미완료다.
+- 2026-08-05: `P1-GATE`의 focused·characterization·정적 검사·Gradle task 확인·전체 테스트를 모두 통과해 Phase 1과 구현을 완료했다.
+
+## 검증 기록
+
+- 문서 작성 시점에는 구현용 RED/GREEN 테스트를 실행하지 않았다.
+- 2026-08-05: 문서 변경 후 `./gradlew --no-daemon tasks --all`로 계획에 사용한 Gradle 명령이 유효한지 확인했다.
+  - sandbox 실행은 `/Users/klaus/.gradle/wrapper/dists/.../gradle-8.1.1-bin.zip.lck` 접근 제한으로 실패했다.
+  - 승인 실행은 `BUILD SUCCESSFUL in 8s`로 통과했다.
+- 2026-08-05: `git diff --check`가 출력 없이 통과했고, 구현 파일과 테스트 파일은 변경하지 않았음을 확인했다.
+- 2026-08-05: class-level read-only 트랜잭션 기준으로 문서를 보완한 뒤 `./gradlew --no-daemon tasks --all`을 재실행해
+  `BUILD SUCCESSFUL in 7s`를 확인했다.
+- 2026-08-05: production 수정 전 focused test를 실행해 `BUILD FAILED in 6m 50s`와
+  `org.hibernate.LazyInitializationException: failed to lazily initialize a collection of role: kr.co.vividnext.sodalive.creator.admin.content.series.Series.keywordList, could not initialize proxy - no Session`을 확인했다.
+- 2026-08-05: `CreatorAdminContentSeriesService`에 `@Transactional(readOnly = true)` 한 줄을 추가한 뒤 같은 focused test를
+  재실행해 `BUILD SUCCESSFUL in 4m 52s`를 확인했다. 테스트는 fixture의 `seriesId`, `title`, `introduction`, `coverImageUrl`,
+  `publishedDaysOfWeek`, `genre`, `keywords`, `isAdult`, `state`, `writer`, `studio` 값을 검증한다.
+- 2026-08-05: `./gradlew --no-daemon test --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.series.LegacyCreatorAdminSeriesCharacterizationTest`
+  를 실행해 `BUILD SUCCESSFUL in 47s`를 확인했다.
+- 2026-08-05: production diff는 `CreatorAdminContentSeriesService` 클래스 선언 위의 `@Transactional(readOnly = true)` 한 줄뿐이며,
+  `createSeries()`, `modifySeries()`, `addingContentToTheSeries()`, `removeContentInTheSeries()`, `updateSeriesOrders()`의 기존 메서드 레벨
+  `@Transactional` 5개가 유지됨을 확인했다. API 계약, OSIV, entity mapping, repository query 변경은 없다.
+- 2026-08-05: `P1-GATE`에서 명령을 순차 실행해 다음 결과를 확인했다.
+  - `./gradlew --no-daemon test --rerun-tasks --tests kr.co.vividnext.sodalive.creator.admin.content.series.CreatorAdminContentSeriesServiceIntegrationTest`: exit code 0, `BUILD SUCCESSFUL in 4m 44s`.
+  - `./gradlew --no-daemon test --tests kr.co.vividnext.sodalive.v2.api.admin.aicharacter.series.LegacyCreatorAdminSeriesCharacterizationTest`: exit code 0, `BUILD SUCCESSFUL in 41s`.
+  - `./gradlew --no-daemon ktlintCheck`: exit code 0, `BUILD SUCCESSFUL in 30s`.
+  - `./gradlew --no-daemon tasks --all`: exit code 0, `BUILD SUCCESSFUL in 7s`.
+  - `git diff --check`: exit code 0, 출력 없음.
+  - `./gradlew --no-daemon test`: exit code 0, `BUILD SUCCESSFUL in 6m 20s`. 기본 계획의 targeted 검증 범위를 넘어 전체 테스트를 실행한 이유는 ultrawork verification 요구사항 때문이다.
+- 2026-08-05: Gate 검증 후 production diff가 class-level `@Transactional(readOnly = true)` 한 줄뿐이고, 새 테스트 파일은
+  `CreatorAdminContentSeriesServiceIntegrationTest.kt` 하나이며, 기존 쓰기 메서드의 `@Transactional` 5개가 유지됨을 재확인했다.

docs/20260805_크리에이터관리자_시리즈상세_LazyInitializationException_수정/prd.md

@@ -0,0 +1,148 @@
+# PRD: 크리에이터 관리자 시리즈 상세 LazyInitializationException 수정
+
+## 문서 정보
+
+| 항목 | 내용 |
+|---|---|
+| 문서 상태 | 구현 기준 확정 |
+| 작성일 | 2026-08-05 |
+| 최종 수정일 | 2026-08-05 |
+| 대상 기능 | 크리에이터 관리자 시리즈 상세 조회 |
+| 관련 구현 계획 | `docs/20260805_크리에이터관리자_시리즈상세_LazyInitializationException_수정/plan-task.md` |
+
+## 1. Overview
+
+`spring.jpa.open-in-view=false` 환경에서 `GET /creator-admin/audio-content/series/{seriesId}` 호출 시
+`Series.keywordList` 접근으로 발생하는 `LazyInitializationException`을 서비스 클래스의 기본 read-only 트랜잭션 경계로 방지한다.
+
+## 2. Problem Statement
+
+- `CreatorAdminContentSeriesController.getDetail()`은 `CreatorAdminContentSeriesService.getDetail()`에 상세 조회를 위임한다.
+- `CreatorAdminContentSeriesService.getDetail()`에는 트랜잭션이 없으며,
+  `CreatorAdminContentSeriesRepository.findByIdAndCreatorId()`가 반환한 `Series`로 상세 DTO를 생성한다.
+- 같은 서비스의 트랜잭션 없는 public 메서드는 모두 조회 기능이고, 데이터를 변경하는 public 메서드에는 이미 메서드 레벨
+  `@Transactional`이 적용되어 있다.
+- `Series.keywordList`는 별도 fetch 설정이 없는 `@OneToMany`이므로 lazy 컬렉션이다.
+- `Series.toDetailResponse()`은 `keywordList.map { it.keyword!!.tag }`를 실행한다.
+- 운영·테스트 설정의 `spring.jpa.open-in-view=false` 때문에 리포지토리 호출 후 영속성 컨텍스트가 종료되고, DTO 변환 중
+  `org.hibernate.LazyInitializationException: failed to lazily initialize a collection of role: kr.co.vividnext.sodalive.creator.admin.content.series.Series.keywordList, could not initialize proxy - no Session`
+  예외가 발생한다.
+- 기존 `LegacyCreatorAdminSeriesCharacterizationTest`는 클래스 레벨 `@Transactional`과 직접 생성한 서비스 객체를 사용하므로,
+  실제 Spring 서비스 프록시의 트랜잭션 유무에 따른 회귀를 검증하지 못한다.
+
+문제를 해결했다는 판단은 외부 테스트 트랜잭션이 없는 OSIV off 통합 테스트에서 실제 Spring 서비스 프록시로 상세 조회 후
+키워드가 포함된 기존 응답을 정상 생성하는 것으로 한다.
+
+## 3. Goals
+
+- OSIV off 환경에서도 소유한 시리즈 상세 조회가 `LazyInitializationException` 없이 완료된다.
+- 서비스 클래스의 조회 기본값을 read-only 트랜잭션으로 두고, 시리즈 조회부터 `toDetailResponse()`의 lazy 컬렉션 접근까지
+  같은 영속성 컨텍스트에서 처리한다.
+- 실제 Spring 서비스 프록시를 호출하는 통합 테스트로 수정 전 실패와 수정 후 성공을 검증한다.
+- 기존 endpoint, 인증·소유권 검사, 성공 응답 필드와 값 형식을 유지한다.
+
+## 4. Non-Goals
+
+- `spring.jpa.open-in-view`를 활성화하지 않는다.
+- `Series.keywordList`를 전역 eager fetch로 변경하지 않는다.
+- 상세 조회 쿼리를 fetch join 또는 projection으로 재작성하지 않는다.
+- `Series.toDetailResponse()` 또는 `GetCreatorAdminContentSeriesDetailResponse` 구조를 변경하지 않는다.
+- 시리즈 목록·수정·콘텐츠 연결 등 다른 흐름을 함께 리팩터링하지 않는다.
+
+## 5. Target Users and Permissions
+
+- 대상 사용자: 본인이 소유한 시리즈 상세를 조회하는 `CREATOR` 역할의 크리에이터 관리자
+- 인증·권한: 기존 `@PreAuthorize("hasRole('CREATOR')")`와 인증 회원 검사를 유지한다.
+- 소유권: 기존 `findByIdAndCreatorId(id, creatorId)` 조건과 `creator.admin.series.invalid_access` 오류를 유지한다.
+
+## 6. 기능 요구사항
+
+| ID | 상태 | 요구사항 | 수용 기준 | Goal 연결 |
+|---|---|---|---|---|
+| `CASD-001` | 확정 | 서비스 클래스에 read-only 트랜잭션을 기본 적용하고 기존 쓰기 메서드의 메서드 레벨 트랜잭션을 유지한다. | 키워드가 있는 소유 시리즈 조회가 OSIV off 환경에서 예외 없이 완료되고 기존 쓰기 메서드 annotation이 보존된다. | `P1-T1` |
+| `CASD-002` | 확정 | 기존 상세 조회 API 계약을 유지한다. | endpoint, 권한, 오류 key, 응답 DTO의 필드·형식이 바뀌지 않는다. | `P1-T1`, `P1-GATE` |
+| `CASD-003` | 확정 | 테스트 외부 트랜잭션 없이 실제 서비스 프록시를 검증한다. | 수정 전 `Series.keywordList` 예외를 재현하고, 수정 후 같은 테스트가 통과한다. | `P1-T1` |
+
+## 7. API 계약
+
+| Method | Path | 변경 사항 |
+|---|---|---|
+| `GET` | `/creator-admin/audio-content/series/{seriesId}` | 공개 계약 변경 없음 |
+
+- 성공 응답은 기존 `ApiResponse.ok(GetCreatorAdminContentSeriesDetailResponse)`를 유지한다.
+- `seriesId`, `title`, `introduction`, `coverImageUrl`, `publishedDaysOfWeek`, `genre`, `keywords`, `isAdult`,
+  `state`, `writer`, `studio` 필드와 기존 문자열 변환 규칙을 유지한다.
+- 인증 실패와 타 소유자·미존재 시리즈 오류 처리를 변경하지 않는다.
+
+## 8. 해결 방안
+
+`CreatorAdminContentSeriesService` 클래스에 `@Transactional(readOnly = true)`를 기본 적용한다.
+
+```kotlin
+@Service
+@Transactional(readOnly = true)
+class CreatorAdminContentSeriesService(
+```
+
+`getDetail()`의 `findByIdAndCreatorId()` 조회와 `series.toDetailResponse()` 변환이 이 경계 안에서 모두 끝나므로 `keywordList`를
+정상 초기화할 수 있다. 다른 조회 메서드도 같은 기본 경계를 사용하며, 기존 쓰기 메서드의 메서드 레벨 `@Transactional`은
+class-level `readOnly = true`를 쓰기 트랜잭션으로 재정의한다. 이미 서비스 파일에서 `Transactional`을 사용하고 있어 새 의존성이나
+import는 필요하지 않다.
+
+### 현재 메서드 분류
+
+| 기본 read-only 트랜잭션을 사용하는 조회 메서드 | 메서드 레벨 쓰기 트랜잭션을 유지하는 메서드 |
+|---|---|
+| `getSeriesList()` | `createSeries()` |
+| `getDetail()` | `modifySeries()` |
+| `getSeriesContent()` | `addingContentToTheSeries()` |
+| `searchContentNotInSeries()` | `removeContentInTheSeries()` |
+|  | `updateSeriesOrders()` |
+
+### 제외한 대안
+
+- OSIV 활성화: 요청 전체로 영속성 컨텍스트를 확장해 현재 저장소 정책을 되돌리므로 제외한다.
+- `keywordList` eager 변경: 모든 `Series` 조회 비용에 영향을 주는 전역 변경이므로 제외한다.
+- fetch join/projection 추가: 이 endpoint만의 결함을 고치는 데 리포지토리 계약과 쿼리 변경이 불필요하므로 제외한다.
+- 컨트롤러 트랜잭션: 영속성 및 DTO 변환 경계는 서비스가 소유하는 기존 구조에 맞지 않으므로 제외한다.
+- `getDetail()`에만 read-only 트랜잭션 적용: 현재 트랜잭션 없는 메서드가 모두 조회 기능이므로 class-level 기본값보다 반복과
+  누락 가능성이 크다.
+
+## 9. 기술적 제약
+
+- Kotlin, Java 17, Spring Boot 2.7.14, Spring Data JPA, Hibernate, JUnit 5, Gradle Wrapper를 사용한다.
+- `src/main/resources/application.yml`과 `src/test/resources/application.yml`의 `spring.jpa.open-in-view=false`를 유지한다.
+- 테스트는 클래스 외부 트랜잭션을 비활성화하고 fixture 생성만 `TransactionTemplate`로 분리한다.
+- 실제 Spring `CreatorAdminContentSeriesService` 빈을 주입해 proxy annotation 동작을 검증한다.
+- production code 변경은 `CreatorAdminContentSeriesService` class-level annotation 한 줄로 제한한다.
+- `createSeries()`, `modifySeries()`, `addingContentToTheSeries()`, `removeContentInTheSeries()`, `updateSeriesOrders()`의 기존
+  메서드 레벨 `@Transactional`을 유지한다.
+
+## 10. 성공 기준
+
+- [ ] 수정 전 focused test가 `Series.keywordList`의 `LazyInitializationException`으로 실패한다.
+- [ ] 서비스 클래스에 `@Transactional(readOnly = true)` 적용 후 같은 테스트가 통과한다.
+- [ ] 응답의 `keywords`와 주요 기존 상세 필드 값이 fixture와 일치한다.
+- [ ] 기존 소유권·상세 동작 characterization test와 `ktlintCheck`가 통과한다.
+- [ ] `tasks --all`과 `git diff --check`가 통과한다.
+- [ ] API 스키마, 엔티티 fetch 전략, repository query에는 변경이 없다.
+- [ ] 모든 기존 쓰기 메서드의 메서드 레벨 `@Transactional`이 유지된다.
+
+## 11. 요구사항 추적표
+
+| 요구사항 | 계획 Phase | Goal | 자동 검증 |
+|---|---:|---|---|
+| `CASD-001`, `CASD-003` | 1 | `P1-T1` | `CreatorAdminContentSeriesServiceIntegrationTest` |
+| `CASD-002` | 1 | `P1-T1`, `P1-GATE` | focused test, `LegacyCreatorAdminSeriesCharacterizationTest` |
+
+## 12. Open Questions
+
+없음. 운영 stack trace, entity mapping, 서비스 호출 경계와 OSIV 설정으로 원인과 최소 해결 범위가 확인됐다.
+
+## 13. Decision Log
+
+| 날짜 | ID | 상태 | 결정 | 근거 | 영향 요구사항·Goal |
+|---|---|---|---|---|---|
+| 2026-08-05 | `DEC-CASD-001` | 확정 | `CreatorAdminContentSeriesService.getDetail()`에 메서드 단위 read-only 트랜잭션을 적용한다. | DTO 변환이 이미 서비스 내부에 있어 한 줄로 lazy 접근 전체를 영속성 컨텍스트 안에 포함할 수 있다. | `CASD-001`, `CASD-002`, `P1-T1` |
+| 2026-08-05 | `DEC-CASD-002` | 확정 | 실제 Spring 서비스 프록시와 외부 트랜잭션이 없는 통합 테스트로 회귀를 고정한다. | 기존 characterization test는 테스트 트랜잭션과 직접 생성한 서비스 때문에 annotation 회귀를 검증할 수 없다. | `CASD-003`, `P1-T1` |
+| 2026-08-05 | `DEC-CASD-003` | 정정 | `DEC-CASD-001`의 메서드 단위 적용을 class-level `@Transactional(readOnly = true)` 적용으로 정정하고 기존 쓰기 메서드의 메서드 레벨 `@Transactional`을 유지한다. | 트랜잭션 없는 기존 public 메서드는 모두 조회 기능이며, 쓰기 메서드는 이미 메서드 레벨 annotation으로 read-only 기본값을 재정의한다. | `CASD-001`, `CASD-002`, `P1-T1` |

docs/20260810_크리에이터_채널_홈_커뮤니티_응답_확장/plan-task.md

@@ -0,0 +1,293 @@
+# 크리에이터 채널 홈 커뮤니티 응답 확장 Implementation Plan
+
+> **For agentic workers:** REQUIRED SUB-SKILL: Use `superpowers:subagent-driven-development` or `superpowers:executing-plans` to implement this plan task-by-task. Steps use checkbox (`- [ ]`) syntax for tracking.
+
+**Goal:** 크리에이터 채널 홈의 `notices`와 `communities` 게시글에 실제 고정 여부와 댓글 가능 여부를 non-null Boolean으로 제공한다.
+
+**Architecture:** 기존 `CreatorChannelCommunityPost`가 보유한 두 값을 공유 `CreatorChannelCommunityPostResponse.from`에서 그대로 매핑한다. 조회 계층과 데이터 모델은 건드리지 않고 공개 응답 DTO와 직접 영향받는 직렬화·E2E 테스트만 수정한다.
+
+**Tech Stack:** Kotlin, Java 17, Spring Boot 2.7.14, Jackson, JUnit 5, MockMvc, Gradle Wrapper
+
+## 문서 상태
+
+| 문서 항목 | 내용 |
+|---|---|
+| 상태 | 구현 완료 |
+| 작성일 | 2026-08-10 |
+| 요구사항 기준 | `docs/20260810_크리에이터_채널_홈_커뮤니티_응답_확장/prd.md` |
+| API 기준 | PRD `7. API 계약` |
+| 현재 Phase | Phase 1 완료: 홈 커뮤니티 상태 응답 확장 |
+| 현재 활성 Goal | 없음 |
+| 다음 Goal | 없음 |
+| Gate | `P1-GATE` 완료 |
+
+## 현재 상태
+
+| Phase | 상태 | 완료 Task | 활성/다음 Goal | 차단 또는 남은 조건 |
+|---:|---|---:|---|---|
+| 1 | 완료 | `1/1` | 없음 | 없음 |
+
+- 동시에 하나의 미완료 goal만 운용한다.
+- 완료된 Task와 검증 기록은 되돌리거나 삭제하지 않는다.
+- goal 실행 시 token budget을 설정하지 않는다.
+
+## 범위
+
+### 포함
+
+- `GET /api/v2/creator-channels/{creatorId}/home`의 `notices[*]`, `communities[*]`에 `isPinned` 추가
+- 같은 게시글 응답에 `isCommentAvailable` 추가
+- 도메인 값의 DTO 매핑과 정확한 `is*` JSON 필드명 검증
+- 기존 홈 API E2E와 Kotlin 포맷 회귀 검증
+
+### 제외
+
+- 조회 조건, 정렬, 최대 노출 개수와 권한 정책 변경
+- 커뮤니티 탭·상세·댓글 API 변경
+- DB, entity, domain model, repository 수정
+- 전용 DTO 분리, 신규 dependency와 관련 없는 리팩터링
+
+## Global Constraints
+
+- Kotlin + Java 17, Spring Boot 2.7.14와 기존 Jackson 직렬화 방식을 유지한다.
+- 기존 공유 `CreatorChannelCommunityPostResponse`와 `from` 변환만 확장한다.
+- 공개 필드명은 `isPinned`, `isCommentAvailable`로 고정하고 두 값은 nullable로 만들지 않는다.
+- `CreatorChannelCommunityPost.isPinned`, `CreatorChannelCommunityPost.isCommentAvailable` 값을 재계산하지 않는다.
+- 구현은 RED → RED 확인 → GREEN → GREEN 확인 → REFACTOR 순서로 진행한다.
+- focused test에서 시작해 직접 영향받는 홈 E2E와 `ktlintCheck`까지만 확장한다.
+- 전체 `./gradlew test`는 공통 경계 영향이나 targeted test로 판단할 수 없는 실패가 있을 때만 실행한다.
+
+---
+
+## Phase 1: 홈 커뮤니티 상태 응답 확장
+
+**Phase 결과:** 홈 API의 공지와 일반 커뮤니티 게시글이 고정 여부와 댓글 가능 여부를 정확한 Boolean 필드로 반환한다.
+
+**선행조건:** 승인된 PRD의 `CCHC-001~004`, `DEC-001~003` 확인.
+
+**Phase 완료 조건:** `P1-T1`과 `P1-GATE` 완료, 체크박스와 실제 검증 결과를 Progress에 누적.
+
+### Task 1.1 공유 게시글 응답에 상태 필드 추가
+
+**Goal 실행 `P1-T1`:** 공유 홈 게시글 응답이 도메인의 `isPinned`, `isCommentAvailable`을 정확한 JSON 필드로 직렬화하게 한다.
+
+- **시작 조건:** PRD 상태가 `구현 기준 확정`이고 현재 활성 Goal이 없다.
+- **완료 증거:** 아래 5단계 완료, controller focused test와 홈 E2E 통과, 변경 파일과 결과를 Progress에 기록.
+- **범위 밖:** 조회 service/repository, domain model, 다른 커뮤니티 API 수정.
+
+**Files:**
+
+- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/adapter/in/web/CreatorChannelHomeControllerTest.kt:92`
+- Modify: `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt:57`
+- Modify: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/dto/CreatorChannelHomeResponse.kt:173`
+- Modify: `docs/20260810_크리에이터_채널_홈_커뮤니티_응답_확장/plan-task.md`
+
+**Interfaces:**
+
+- Consumes: `CreatorChannelCommunityPost.isPinned: Boolean`, `CreatorChannelCommunityPost.isCommentAvailable: Boolean`
+- Produces: `CreatorChannelCommunityPostResponse.isPinned: Boolean`, `CreatorChannelCommunityPostResponse.isCommentAvailable: Boolean`
+- JSON: `data.notices[*].isPinned`, `data.notices[*].isCommentAvailable`, `data.communities[*].isPinned`, `data.communities[*].isCommentAvailable`
+
+- [x] **RED:** `CreatorChannelHomeControllerTest.shouldReturnCreatorChannelHomeForAuthenticatedMember`의 일반 커뮤니티 fixture를 아래처럼 공지와 반대 상태로 만들고, 네 JSON 경로 assertion을 추가한다. 같은 assertion을 `CreatorChannelHomeEndToEndTest.shouldAssembleCreatorChannelHomeSectionsThroughSingleHttpRequest`에도 추가하되 E2E fixture의 댓글 가능 값은 기존 `true`를 사용한다.
+
+```kotlin
+communities = listOf(
+    post.copy(
+        postId = 302L,
+        content = "community",
+        isCommentAvailable = false,
+        isPinned = false
+    )
+)
+```
+
+```kotlin
+.andExpect(jsonPath("$.data.notices[0].isPinned").value(true))
+.andExpect(jsonPath("$.data.notices[0].isCommentAvailable").value(true))
+.andExpect(jsonPath("$.data.communities[0].isPinned").value(false))
+.andExpect(jsonPath("$.data.communities[0].isCommentAvailable").value(false))
+```
+
+E2E assertion은 실제 저장값과 조회 조건을 검증한다.
+
+```kotlin
+.andExpect(jsonPath("$.data.notices[0].isPinned").value(true))
+.andExpect(jsonPath("$.data.notices[0].isCommentAvailable").value(true))
+.andExpect(jsonPath("$.data.communities[0].isPinned").value(false))
+.andExpect(jsonPath("$.data.communities[0].isCommentAvailable").value(true))
+```
+
+- [x] **RED 확인:** 다음 focused test를 실행해 `$.data.notices[0].isPinned` 등 신규 JSON 경로에 값이 없어 실패하는지 확인한다.
+
+```bash
+./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' --no-daemon
+```
+
+**Expected:** 테스트가 신규 필드 미직렬화로 실패한다. compile 오류나 fixture 오류는 RED 증거로 인정하지 않는다.
+
+- [x] **GREEN:** `CreatorChannelCommunityPostResponse`에 기존 커뮤니티 탭 DTO와 같은 `@JsonProperty` 관례로 필드를 추가하고 `from`에서 도메인 값을 직접 매핑한다.
+
+```kotlin
+data class CreatorChannelCommunityPostResponse(
+    val postId: Long,
+    val creatorId: Long,
+    val creatorNickname: String,
+    val creatorProfileUrl: String,
+    val imageUrl: String?,
+    val audioUrl: String?,
+    val content: String,
+    val price: Int,
+    val dateUtc: String,
+    val existOrdered: Boolean,
+    @JsonProperty("isCommentAvailable")
+    val isCommentAvailable: Boolean,
+    val likeCount: Int,
+    val commentCount: Int,
+    @JsonProperty("isPinned")
+    val isPinned: Boolean,
+    @JsonProperty("isLiked")
+    val isLiked: Boolean
+) {
+    companion object {
+        fun from(post: CreatorChannelCommunityPost): CreatorChannelCommunityPostResponse {
+            return CreatorChannelCommunityPostResponse(
+                postId = post.postId,
+                creatorId = post.creatorId,
+                creatorNickname = post.creatorNickname,
+                creatorProfileUrl = post.creatorProfileUrl,
+                imageUrl = post.imageUrl,
+                audioUrl = post.audioUrl,
+                content = post.content,
+                price = post.price,
+                dateUtc = post.createdAt.toUtcIso(),
+                existOrdered = post.existOrdered,
+                isCommentAvailable = post.isCommentAvailable,
+                likeCount = post.likeCount,
+                commentCount = post.commentCount,
+                isPinned = post.isPinned,
+                isLiked = post.isLiked
+            )
+        }
+    }
+}
+```
+
+- [x] **GREEN 확인:** controller test와 홈 E2E를 함께 실행해 공유 DTO 매핑, JSON 이름, 실제 조회값이 모두 통과하는지 확인한다.
+
+```bash
+./gradlew test \
+  --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' \
+  --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest' \
+  --no-daemon
+```
+
+**Expected:** 두 테스트 클래스가 `BUILD SUCCESSFUL`로 종료된다.
+
+- [x] **REFACTOR:** 새 abstraction을 만들지 않고 이번 Task가 추가한 fixture·필드·매핑만 정리한다. 다음 명령을 실행하고 결과를 `P1-T1` Progress에 기록한다.
+
+```bash
+./gradlew ktlintCheck --no-daemon
+git diff --check
+```
+
+**Expected:** 두 명령 모두 exit code `0`.
+
+- [x] **Commit:** 커밋 전후 규칙 검증과 함께 구현·테스트·Progress 변경만 커밋한다.
+
+```bash
+work/scripts/check-commit-message-rules.sh --message "feat(creator-channel): 홈 커뮤니티 응답 상태를 추가한다"
+git add \
+  src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/dto/CreatorChannelHomeResponse.kt \
+  src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/adapter/in/web/CreatorChannelHomeControllerTest.kt \
+  src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt \
+  docs/20260810_크리에이터_채널_홈_커뮤니티_응답_확장/plan-task.md
+git commit -m "feat(creator-channel): 홈 커뮤니티 응답 상태를 추가한다"
+work/scripts/check-commit-message-rules.sh HEAD
+```
+
+### Phase 1 Gate
+
+**Goal 실행 `P1-GATE`:** PRD의 네 확정 요구사항과 작은 변경 범위를 최종 판정한다.
+
+- **시작 조건:** `P1-T1`의 체크박스, focused test, E2E, 포맷과 Progress 기록 완료.
+- **완료 증거:** 아래 자동 검증 통과, PRD 추적성 확인, Gate 결과를 Progress에 기록.
+- **범위 밖:** Gate 통과를 위한 test 삭제·skip·완화와 관련 없는 코드 수정.
+
+```bash
+./gradlew test \
+  --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' \
+  --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest' \
+  --no-daemon
+./gradlew ktlintCheck --no-daemon
+./gradlew tasks --all --no-daemon
+git diff --check
+```
+
+**Expected:** 모든 명령이 exit code `0`이고 다음 조건이 충족된다.
+
+- [x] `notices[*]`와 `communities[*]`에 두 non-null Boolean이 존재한다. (`CCHC-001~003`)
+- [x] `notices[*].isPinned == true`, `communities[*].isPinned == false`가 실제 조회 조건과 일치한다.
+- [x] 댓글 가능 값이 `true`와 `false` 모두 그대로 직렬화된다.
+- [x] endpoint, 인증, 기존 홈 응답 필드와 조회 결과가 유지된다. (`CCHC-004`)
+- [x] 전체 회귀 테스트를 생략한 근거와 대신 실행한 focused·E2E 검증을 Progress에 기록한다.
+
+## 실행 순서와 의존성
+
+| 순서 | Goal | 선행조건 | 병행 가능 | 차단 시 다음 행동 |
+|---:|---|---|---|---|
+| 1 | `P1-T1` | 승인된 PRD | 아니요 | RED 실패 원인이 신규 필드 누락인지 다시 확인 |
+| 2 | `P1-GATE` | `P1-T1` 완료 | 아니요 | 실패를 소유한 Task에 회귀 수정 goal 추가 |
+
+```text
+P1-T1 → P1-GATE
+```
+
+## 변경 금지 항목
+
+- 공개 필드명이나 기존 홈 응답 필드를 근거 없이 변경하지 않는다.
+- domain, service, repository에서 두 Boolean을 재계산하지 않는다.
+- 전용 DTO, helper, 신규 dependency를 추가하지 않는다.
+- 테스트를 삭제·skip·완화하거나 관련 없는 코드를 정리하지 않는다.
+- 기존 완료 기록과 Decision Log를 삭제하거나 덮어쓰지 않는다.
+
+## 의사결정 및 중단 규칙
+
+- 구현 범위가 바뀌면 PRD Decision Log와 이 계획을 먼저 갱신한다.
+- 신규 JSON 필드 외 실패가 발생하면 원인을 분리하고 범위 밖 변경을 임의로 적용하지 않는다.
+- targeted test로 영향 범위를 판단할 수 없을 때만 전체 `./gradlew test --no-daemon`을 실행한다.
+- 체크박스와 완료 증거, Progress 기록이 모두 충족된 뒤에만 goal을 완료 처리한다.
+
+## Progress
+
+기존 기록을 삭제하지 않고 Goal별 실행 결과를 아래에 누적한다.
+
+### P1-T1
+
+- RED 작성: controller fixture의 일반 게시글을 `postId=302L`, `content="community"`, `isCommentAvailable=false`, `isPinned=false`로 구성하고 controller 및 E2E에 공지/일반 게시글 상태 assertion을 추가했다.
+- RED 확인: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' --no-daemon`은 exit code `1`로 실패했다. `CreatorChannelHomeControllerTest.kt:138`의 `$.data.notices[0].isPinned` assertion에서 `PathNotFoundException`이 발생해 신규 JSON 필드 미직렬화가 원인임을 확인했으며 compile 및 fixture 오류는 없었다.
+- GREEN 구현: `CreatorChannelCommunityPostResponse`에 non-null Boolean `isCommentAvailable`, `isPinned`을 명시적 `@JsonProperty`와 함께 추가하고 `post.isCommentAvailable`, `post.isPinned`을 직접 매핑했다.
+- GREEN 확인: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest' --no-daemon`은 exit code `0`, `BUILD SUCCESSFUL in 54s`로 종료됐다. controller focused test와 직접 영향받는 홈 E2E가 함께 통과해 공지 `true/true`, 일반 게시글 `false/false` controller fixture 및 `false/true` 실제 E2E 저장값의 매핑과 JSON 이름을 확인했다.
+- REFACTOR 확인: 새 abstraction 없이 계획된 fixture, 응답 필드, 직접 매핑만 유지했다. `./gradlew ktlintCheck --no-daemon`은 exit code `0`, `BUILD SUCCESSFUL in 25s`였고 `git diff --check`도 exit code `0`이었다.
+- 전체 회귀 생략: 이번 변경은 공유 홈 DTO의 additive 직렬화 필드 두 개와 직접 영향받는 테스트에 한정되고 controller focused test와 실제 저장·조회 E2E가 모두 통과했으므로 계획의 조건에 따라 전체 `./gradlew test`는 실행하지 않았다.
+- 변경 파일: `src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/dto/CreatorChannelHomeResponse.kt`, `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/adapter/in/web/CreatorChannelHomeControllerTest.kt`, `src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt`, `docs/20260810_크리에이터_채널_홈_커뮤니티_응답_확장/plan-task.md`.
+- 커밋 검증: 커밋 전 `work/scripts/check-commit-message-rules.sh --message "feat(creator-channel): 홈 커뮤니티 응답 상태를 추가한다"`가 모든 규칙을 `[PASS]`로 확인했다. 최종 diff는 계획된 네 파일만 포함하고 비밀값, 관련 없는 변경, agent footer가 없음을 자체 검토했다. 커밋 후 `work/scripts/check-commit-message-rules.sh HEAD`를 커밋 `d99104d945743663803b506417b4d2ad3ac4b0a2`에 실행해 모든 규칙이 `[PASS]`임을 확인했다.
+
+### P1-GATE
+
+- 자동 검증: `./gradlew test --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.adapter.in.web.CreatorChannelHomeControllerTest' --tests 'kr.co.vividnext.sodalive.v2.api.creator.channel.home.CreatorChannelHomeEndToEndTest' --no-daemon`은 최초 실행에서 exit code `0`, `BUILD SUCCESSFUL in 40s`였고 테스트 산출물이 `UP-TO-DATE`였다. 실제 HTTP 경계를 새로 실행하기 위해 `./gradlew cleanTest --no-daemon`을 exit code `0`, `BUILD SUCCESSFUL in 16s`로 수행한 뒤 같은 Gate 테스트 명령을 다시 실행해 `:test` 실행과 exit code `0`, `BUILD SUCCESSFUL in 48s`를 확인했다.
+- 정적·빌드 검증: `./gradlew ktlintCheck --no-daemon`은 exit code `0`, `BUILD SUCCESSFUL in 1m 22s`, `./gradlew tasks --all --no-daemon`은 exit code `0`, `BUILD SUCCESSFUL in 22s`, `git diff --check`는 출력 없이 exit code `0`이었다.
+- 요구사항 추적: `CCHC-001~003`은 `notices[*]`, `communities[*]`의 non-null Boolean `isPinned`, `isCommentAvailable`과 도메인 값 직접 매핑으로 확인했다. 실제 저장·조회 E2E에서 공지는 `isPinned=true`, 일반 게시글은 `isPinned=false`였고 controller fixture와 E2E를 합쳐 `isCommentAvailable=true/false`가 모두 그대로 직렬화됨을 확인했다. `CCHC-004`는 기존 `GET /api/v2/creator-channels/{creatorId}/home`, 비회원 `401`, 인증 회원 `200`, 기존 홈 섹션·필드·조회 결과 assertion의 유지와 focused·E2E 통과로 확인했다.
+- 실제 HTTP 표면: `CreatorChannelHomeEndToEndTest.shouldAssembleCreatorChannelHomeSectionsThroughSingleHttpRequest`가 인증된 MockMvc `GET`을 controller에서 service, repository, H2 database 조회까지 통과시켜 실제 API 응답의 공지와 일반 게시글 값을 검증했다.
+- 전체 회귀 생략: 변경은 공유 홈 응답 DTO의 additive Boolean 두 필드와 직접 직렬화 경계에 한정되고 focused controller test와 실제 저장·조회 MockMvc E2E로 영향을 판정할 수 있었으며 모호한 실패가 없었다. 계획의 실행 조건에 따라 전체 `./gradlew test`는 실행하지 않았다.
+- 변경 문서 상태: 구현·테스트는 커밋 `d99104d945743663803b506417b4d2ad3ac4b0a2`에 있고, Gate에서는 기존 `P1-T1` 기록과 이미 존재한 커밋 후 검증 문장을 보존한 채 `plan-task.md`와 `prd.md`의 완료 상태만 변경했다. Kotlin 코드, 테스트, Decision Log는 변경하지 않았다.
+
+## Decision Log
+
+| 날짜 | ID | 상태 | 결정 | 근거 | 영향 Goal/문서 |
+|---|---|---|---|---|---|
+| 2026-08-10 | `PLAN-DEC-001` | 확정 | 하나의 구현 Task와 하나의 Gate로 실행한다. | 공유 DTO 한 곳의 additive 변경이며 별도 구현 경계가 없다. | `P1-T1`, `P1-GATE` |
+| 2026-08-10 | `PLAN-DEC-002` | 확정 | 전체 회귀는 조건부로 두고 controller test, 홈 E2E, `ktlintCheck`를 기본 검증으로 사용한다. | 변경이 홈 게시글 응답 직렬화 경계에 한정된다. | `P1-T1`, `P1-GATE` |
+
+## 발견된 문제
+
+없음.

docs/20260810_크리에이터_채널_홈_커뮤니티_응답_확장/prd.md

@@ -0,0 +1,144 @@
+# PRD: 크리에이터 채널 홈 커뮤니티 응답 확장
+
+## 문서 정보
+
+| 항목 | 내용 |
+|---|---|
+| 문서 상태 | 구현 기준 확정 |
+| 작성일 | 2026-08-10 |
+| 최종 수정일 | 2026-08-10 |
+| 대상 제품 | 크리에이터 채널 홈 API |
+| 작성자·결정권자 | 사용자 |
+| 관련 API Contract | 별도 문서 없음, 이 문서의 `7. API 계약`을 기준으로 함 |
+| 관련 구현 계획 | `docs/20260810_크리에이터_채널_홈_커뮤니티_응답_확장/plan-task.md` |
+| 관련 review | 없음 |
+
+## 1. Overview
+
+크리에이터 채널 홈 API의 `notices`와 `communities` 게시글 응답에 고정 여부와 댓글 가능 여부를 각각 `isPinned`, `isCommentAvailable`로 제공한다. 기존 조회 결과가 이미 보유한 값을 응답에 그대로 반영해 클라이언트가 별도 추론 없이 게시글 상태를 표시할 수 있게 한다.
+
+## 2. Problem Statement
+
+- 현재 `GET /api/v2/creator-channels/{creatorId}/home`의 게시글 도메인 모델에는 고정 여부와 댓글 가능 여부가 있지만 홈 응답 DTO에는 두 값이 없다.
+- 클라이언트는 홈의 게시글이 고정 글인지, 댓글 작성이 가능한지 응답만으로 일관되게 판단할 수 없다.
+- `notices`와 `communities`가 같은 `CreatorChannelCommunityPostResponse`를 사용하므로 두 배열의 계약을 함께 확장해야 한다.
+
+문제를 해결했다는 판단은 두 배열의 각 게시글에 실제 도메인 값과 일치하는 non-null Boolean 필드가 직렬화되는지로 한다.
+
+## 3. Goals
+
+- 홈 응답의 `notices[*]`와 `communities[*]`에 `isPinned`를 제공한다.
+- 홈 응답의 `notices[*]`와 `communities[*]`에 `isCommentAvailable`을 제공한다.
+- 기존 커뮤니티 조회 결과의 값을 변형하거나 재계산하지 않고 그대로 사용한다.
+- 기존 홈 API의 endpoint, 인증 정책과 기존 응답 필드를 유지한다.
+
+## 4. Non-Goals
+
+- 커뮤니티 조회 조건, 고정 정렬, 최대 노출 개수는 변경하지 않는다.
+- 댓글 작성·수정·삭제 정책과 API는 변경하지 않는다.
+- 커뮤니티 탭 및 게시글 상세 API 계약은 변경하지 않는다.
+- DB schema, entity, domain model과 repository query는 변경하지 않는다.
+- `notices`와 `communities` 전용 응답 DTO를 새로 분리하지 않는다.
+- 관련 없는 홈 응답 필드나 패키지 구조는 리팩터링하지 않는다.
+
+## 5. Target Users and Permissions
+
+- 대상 사용자: 인증 후 크리에이터 채널 홈을 조회하는 앱 사용자
+- 인증 및 권한: 기존 홈 API 정책을 그대로 사용한다.
+- 차단, 성인 콘텐츠와 구매 여부 정책: 기존 홈 API 조회 결과를 그대로 사용한다.
+
+## 6. 기능 요구사항
+
+| ID | 상태 | 요구사항 | 수용 기준 | 계약/Goal 연결 |
+|---|---|---|---|---|
+| `CCHC-001` | 확정 | `notices[*]`와 `communities[*]`에 `isPinned`를 제공한다. | JSON 필드명이 정확히 `isPinned`이고 값은 `CreatorChannelCommunityPost.isPinned`와 일치한다. | `7. API 계약`, `P1-T1` |
+| `CCHC-002` | 확정 | `notices[*]`와 `communities[*]`에 `isCommentAvailable`을 제공한다. | JSON 필드명이 정확히 `isCommentAvailable`이고 값은 `CreatorChannelCommunityPost.isCommentAvailable`과 일치한다. | `7. API 계약`, `P1-T1` |
+| `CCHC-003` | 확정 | 두 필드는 non-null Boolean으로 응답한다. | 게시글이 존재하면 두 필드가 누락되거나 `null`이 되지 않는다. | `P1-T1`, `P1-GATE` |
+| `CCHC-004` | 확정 | 기존 홈 API 계약과 조회 정책을 보존한다. | endpoint, 인증 정책, 기존 응답 필드와 게시글 선택·정렬 결과가 변경되지 않는다. | `P1-GATE` |
+
+### 상태별 기대값
+
+| 배열 | `isPinned` | `isCommentAvailable` |
+|---|---:|---|
+| `notices` | 해당 게시글의 실제 값. 현재 홈 조회 조건상 `true` | 해당 게시글의 댓글 허용 설정값 |
+| `communities` | 해당 게시글의 실제 값. 현재 홈 조회 조건상 `false` | 해당 게시글의 댓글 허용 설정값 |
+
+- 댓글 수가 `0`이어도 `isCommentAvailable`을 별도로 계산하지 않는다.
+- 빈 `notices` 또는 `communities`는 기존처럼 빈 배열로 응답한다.
+
+## 7. API 계약
+
+### 7.1 Endpoint
+
+- Method: `GET`
+- Path: `/api/v2/creator-channels/{creatorId}/home`
+- 요청과 인증 정책: 변경 없음
+
+### 7.2 응답 확장
+
+`data.notices[*]`와 `data.communities[*]`에 다음 필드를 추가한다.
+
+| 필드 | 타입 | nullable | 의미 |
+|---|---|---:|---|
+| `isPinned` | Boolean | 아니요 | 해당 커뮤니티 게시글의 고정 여부 |
+| `isCommentAvailable` | Boolean | 아니요 | 해당 커뮤니티 게시글의 댓글 작성 허용 여부 |
+
+예시:
+
+```json
+{
+  "data": {
+    "notices": [
+      {
+        "postId": 301,
+        "isPinned": true,
+        "isCommentAvailable": true
+      }
+    ],
+    "communities": [
+      {
+        "postId": 302,
+        "isPinned": false,
+        "isCommentAvailable": false
+      }
+    ]
+  }
+}
+```
+
+예시는 추가 필드와 배열별 의미만 나타내며 기존 게시글 응답 필드는 그대로 유지한다.
+
+## 8. 기술적 제약
+
+- Kotlin + Java 17, Spring Boot 2.7.14와 기존 Jackson 직렬화 방식을 유지한다.
+- 기존 공유 `CreatorChannelCommunityPostResponse`와 `from` 변환을 재사용한다.
+- `is*` JSON 이름이 변경되지 않도록 기존 Boolean 응답 필드의 `@JsonProperty` 관례를 따른다.
+- 신규 dependency와 별도 abstraction을 추가하지 않는다.
+- 구현은 응답 DTO와 직접 영향받는 테스트로 제한한다.
+
+## 9. 성공 기준
+
+- [x] `notices[*].isPinned`와 `notices[*].isCommentAvailable`이 실제 값으로 응답된다. (`CCHC-001~003`)
+- [x] `communities[*].isPinned`와 `communities[*].isCommentAvailable`이 실제 값으로 응답된다. (`CCHC-001~003`)
+- [x] 기존 홈 API 응답 및 조회 흐름 회귀 테스트가 통과한다. (`CCHC-004`)
+- [x] `ktlintCheck`가 통과한다.
+- [x] 전체 회귀 테스트를 생략하면 작은 응답 DTO 변경이라는 근거와 대신 실행한 focused·영향 범위 테스트를 검증 기록에 남긴다.
+
+## 10. Open Questions
+
+없음.
+
+## 11. 요구사항 추적표
+
+| 요구사항 범위 | 계획 Phase | Goal | 자동 검증 | 수동 검증 |
+|---|---:|---|---|---|
+| `CCHC-001~003` | 1 | `P1-T1` | `CreatorChannelHomeControllerTest` | 홈 응답 JSON 필드명과 Boolean 값 확인 |
+| `CCHC-004` | 1 | `P1-GATE` | `CreatorChannelHomeEndToEndTest`, `ktlintCheck` | 기존 필드 유지 여부 확인 |
+
+## 12. Decision Log
+
+| 날짜 | ID | 상태 | 결정 | 근거 | 영향 요구사항·Goal |
+|---|---|---|---|---|---|
+| 2026-08-10 | `DEC-001` | 확정 | `isPinned`, `isCommentAvailable`을 `notices`와 `communities` 모두에 추가한다. | 두 배열이 같은 게시글 응답 DTO를 사용하며 사용자가 인터뷰 선택지 A를 승인했다. | `CCHC-001~004`, `P1-T1`, `P1-GATE` |
+| 2026-08-10 | `DEC-002` | 확정 | 공유 응답 DTO를 확장하고 전용 DTO는 분리하지 않는다. | 기존 도메인 값과 변환 경로를 재사용하는 최소 변경이다. | `CCHC-001~004`, `P1-T1` |
+| 2026-08-10 | `DEC-003` | 확정 | PRD를 구현 기준으로 승인한다. | 사용자가 작성된 PRD를 검토하고 승인했다. | 문서 전체, `plan-task.md` |

src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateQueryRepository.kt

@@ -391,7 +391,7 @@ class AdminCalculateQueryRepository(private val queryFactory: JPAQueryFactory) {
         return queryFactory
             .select(
                 QGetCalculateByCreatorQueryData(
-                    member.email,
+                    member.id,
                     member.nickname,
                     useCan.can.add(useCan.rewardCan).sum(),
                     creatorSettlementRatio.liveSettlementRatio
@@ -447,7 +447,7 @@ class AdminCalculateQueryRepository(private val queryFactory: JPAQueryFactory) {
         return queryFactory
             .select(
                 QGetCalculateByCreatorQueryData(
-                    member.email,
+                    member.id,
                     member.nickname,
                     order.can.sum(),
                     creatorSettlementRatio.contentSettlementRatio
@@ -504,7 +504,7 @@ class AdminCalculateQueryRepository(private val queryFactory: JPAQueryFactory) {
         return queryFactory
             .select(
                 QGetCalculateByCreatorQueryData(
-                    member.email,
+                    member.id,
                     member.nickname,
                     useCan.can.add(useCan.rewardCan).sum(),
                     creatorSettlementRatio.communitySettlementRatio

src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateService.kt

@@ -474,7 +474,7 @@ class AdminCalculateService(
         return createExcelStream(
             sheetName = sheetName,
             headers = listOf(
-                "이메일",
+                "크리에이터 번호",
                 "닉네임",
                 "총 캔",
                 "원화",
@@ -486,7 +486,7 @@ class AdminCalculateService(
         ) { sheet ->
             items.forEachIndexed { index, item ->
                 val row = sheet.createRow(index + 1)
-                row.createCell(0).setCellValue(item.email)
+                row.createCell(0).setCellValue(item.creatorId.toDouble())
                 row.createCell(1).setCellValue(item.nickname)
                 row.createCell(2).setCellValue(item.totalCan.toDouble())
                 row.createCell(3).setCellValue(item.totalKrw.toDouble())

src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/GetCalculateByCreatorItem.kt

@@ -3,7 +3,7 @@ package kr.co.vividnext.sodalive.admin.calculate
 import com.fasterxml.jackson.annotation.JsonProperty
 
 data class GetCalculateByCreatorItem(
-    @JsonProperty("email") val email: String,
+    @JsonProperty("creatorId") val creatorId: Long,
     @JsonProperty("nickname") val nickname: String,
     @JsonProperty("totalCan") val totalCan: Int,
     @JsonProperty("totalKrw") val totalKrw: Int,

src/main/kotlin/kr/co/vividnext/sodalive/admin/calculate/GetCalculateByCreatorQueryData.kt

@@ -5,7 +5,7 @@ import java.math.BigDecimal
 import java.math.RoundingMode
 
 data class GetCalculateByCreatorQueryData @QueryProjection constructor(
-    val email: String,
+    val creatorId: Long,
     val nickname: String,
     val totalCan: Int,
     val settlementRatio: Int?
@@ -31,7 +31,7 @@ data class GetCalculateByCreatorQueryData @QueryProjection constructor(
         val depositAmount = settlementAmount.subtract(tax)
 
         return GetCalculateByCreatorItem(
-            email = email,
+            creatorId = creatorId,
             nickname = nickname,
             totalCan = totalCan,
             totalKrw = totalKrw.toInt(),

src/main/kotlin/kr/co/vividnext/sodalive/creator/admin/content/series/CreatorAdminContentSeriesService.kt

@@ -26,6 +26,7 @@ import org.springframework.transaction.annotation.Transactional
 import org.springframework.web.multipart.MultipartFile
 
 @Service
+@Transactional(readOnly = true)
 class CreatorAdminContentSeriesService(
     private val repository: CreatorAdminContentSeriesRepository,
     private val genreRepository: CreatorAdminContentSeriesGenreRepository,

src/main/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/dto/CreatorChannelHomeResponse.kt

@@ -181,8 +181,12 @@ data class CreatorChannelCommunityPostResponse(
     val price: Int,
     val dateUtc: String,
     val existOrdered: Boolean,
+    @JsonProperty("isCommentAvailable")
+    val isCommentAvailable: Boolean,
     val likeCount: Int,
     val commentCount: Int,
+    @JsonProperty("isPinned")
+    val isPinned: Boolean,
     @JsonProperty("isLiked")
     val isLiked: Boolean
 ) {
@@ -199,8 +203,10 @@ data class CreatorChannelCommunityPostResponse(
                 price = post.price,
                 dateUtc = post.createdAt.toUtcIso(),
                 existOrdered = post.existOrdered,
+                isCommentAvailable = post.isCommentAvailable,
                 likeCount = post.likeCount,
                 commentCount = post.commentCount,
+                isPinned = post.isPinned,
                 isLiked = post.isLiked
             )
         }

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

@@ -53,7 +53,11 @@ class HomeRecommendationFacade(
                     memberId = member?.id,
                     includeAdultLives = includeAdult
                 ).map { it.toItem() },
-                banners = queryService.findHomeBanners(HOME_BANNER_LIMIT, member?.id)
+                banners = queryService.findHomeBanners(
+                    limit = HOME_BANNER_LIMIT,
+                    memberId = member?.id,
+                    includeAdultBanners = includeAdult
+                )
                     .map { RecommendationBannerResponse.from(it.toBanner()) },
                 recentlyActiveCreators = queryService.findRecentlyActiveCreators(
                     HOME_ACTIVE_CREATOR_LIMIT,

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

@@ -63,7 +63,8 @@ class DefaultAudioRecommendationQueryRepository(
             .leftJoin(series.member, seriesOwner)
             .where(
                 audioContentBanner.isActive.isTrue,
-                audioContentBanner.tab.isNull,
+                audioContentBanner.tab.id.eq(2L),
+                adultBannerCondition(canViewAdultContent),
                 activeBannerTargetCondition(memberId, bannerCreator, seriesOwner)
             )
             .orderBy(audioContentBanner.orders.asc(), randomTieBreaker.asc())
@@ -544,6 +545,10 @@ class DefaultAudioRecommendationQueryRepository(
         return if (canViewAdultContent) null else series.isAdult.isFalse
     }
 
+    private fun adultBannerCondition(canViewAdultContent: Boolean): BooleanExpression? {
+        return if (canViewAdultContent) null else audioContentBanner.isAdult.isFalse
+    }
+
     private fun adultAudioCondition(canViewAdultContent: Boolean): BooleanExpression? {
         return if (canViewAdultContent) null else audioContent.isAdult.isFalse
     }

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

@@ -87,7 +87,8 @@ class DefaultHomeRecommendationQueryRepository(
 
     override fun findHomeBanners(
         limit: Int,
-        memberId: Long?
+        memberId: Long?,
+        includeAdultBanners: Boolean
     ): List<HomeBannerRecommendationRecord> {
         val bannerCreator = QMember("bannerCreator")
         val seriesOwner = QMember("seriesOwner")
@@ -115,6 +116,7 @@ class DefaultHomeRecommendationQueryRepository(
             .where(
                 audioContentBanner.isActive.isTrue,
                 audioContentBanner.tab.isNull,
+                includeAdultBannerCondition(includeAdultBanners),
                 activeBannerTargetCondition(memberId, bannerCreator, seriesOwner)
             )
             .orderBy(audioContentBanner.orders.asc(), randomTieBreaker.asc())
@@ -1265,6 +1267,10 @@ class DefaultHomeRecommendationQueryRepository(
         return if (includeAdultCommunities) null else creatorCommunity.isAdult.isFalse
     }
 
+    private fun includeAdultBannerCondition(includeAdultBanners: Boolean): BooleanExpression? {
+        return if (includeAdultBanners) null else audioContentBanner.isAdult.isFalse
+    }
+
     private fun includeAdultLiveCondition(includeAdultLives: Boolean): BooleanExpression? {
         return if (includeAdultLives) null else liveRoom.isAdult.isFalse
     }

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

@@ -43,9 +43,10 @@ class HomeRecommendationQueryService(
 
     fun findHomeBanners(
         limit: Int = DEFAULT_BANNER_LIMIT,
-        memberId: Long? = null
+        memberId: Long? = null,
+        includeAdultBanners: Boolean = false
     ): List<HomeBannerRecommendationRecord> {
-        return queryPort.findHomeBanners(limit, memberId)
+        return queryPort.findHomeBanners(limit, memberId, includeAdultBanners)
     }
 
     fun findRecentlyActiveCreators(

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

@@ -13,7 +13,8 @@ interface HomeRecommendationQueryPort {
 
     fun findHomeBanners(
         limit: Int,
-        memberId: Long? = null
+        memberId: Long? = null,
+        includeAdultBanners: Boolean = false
     ): List<HomeBannerRecommendationRecord>
 
     fun findRecentlyActiveCreators(

src/test/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateQueryRepositoryTest.kt

@@ -0,0 +1,169 @@
+package kr.co.vividnext.sodalive.admin.calculate
+
+import com.querydsl.jpa.impl.JPAQueryFactory
+import kr.co.vividnext.sodalive.can.use.CanUsage
+import kr.co.vividnext.sodalive.can.use.UseCan
+import kr.co.vividnext.sodalive.can.use.UseCanRepository
+import kr.co.vividnext.sodalive.configs.QueryDslConfig
+import kr.co.vividnext.sodalive.content.AudioContent
+import kr.co.vividnext.sodalive.content.AudioContentRepository
+import kr.co.vividnext.sodalive.content.order.Order
+import kr.co.vividnext.sodalive.content.order.OrderRepository
+import kr.co.vividnext.sodalive.content.order.OrderType
+import kr.co.vividnext.sodalive.content.theme.AudioContentTheme
+import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunity
+import kr.co.vividnext.sodalive.explorer.profile.creatorCommunity.CreatorCommunityRepository
+import kr.co.vividnext.sodalive.live.room.LiveRoom
+import kr.co.vividnext.sodalive.live.room.LiveRoomRepository
+import kr.co.vividnext.sodalive.member.Member
+import kr.co.vividnext.sodalive.member.MemberRepository
+import kr.co.vividnext.sodalive.member.MemberRole
+import org.junit.jupiter.api.Assertions.assertEquals
+import org.junit.jupiter.api.BeforeEach
+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.jpa.database-platform=kr.co.vividnext.sodalive.support.H2MySqlFunctionDialect"
+    ]
+)
+@Import(QueryDslConfig::class)
+class AdminCalculateQueryRepositoryTest @Autowired constructor(
+    private val queryFactory: JPAQueryFactory,
+    private val memberRepository: MemberRepository,
+    private val liveRoomRepository: LiveRoomRepository,
+    private val audioContentRepository: AudioContentRepository,
+    private val orderRepository: OrderRepository,
+    private val creatorCommunityRepository: CreatorCommunityRepository,
+    private val useCanRepository: UseCanRepository,
+    private val entityManager: EntityManager
+) {
+    private lateinit var repository: AdminCalculateQueryRepository
+
+    @BeforeEach
+    fun setup() {
+        repository = AdminCalculateQueryRepository(queryFactory)
+    }
+
+    @Test
+    @DisplayName("이메일이 없는 크리에이터도 크리에이터별 정산에서 번호로 조회한다")
+    fun shouldReturnCreatorIdForByCreatorRowsWhenCreatorEmailIsNull() {
+        // given
+        val creator = saveMember(email = null, nickname = "creator", role = MemberRole.CREATOR)
+        val buyer = saveMember(email = "buyer@test.com", nickname = "buyer", role = MemberRole.USER)
+        val createdAt = LocalDateTime.of(2026, 8, 4, 12, 0, 0)
+
+        val room = saveLiveRoom(creator)
+        saveUseCan(buyer, CanUsage.LIVE, 10, createdAt) { this.room = room }
+
+        val content = saveAudioContent(creator)
+        saveOrder(buyer, creator, content, createdAt)
+
+        val post = saveCommunityPost(creator)
+        saveUseCan(buyer, CanUsage.PAID_COMMUNITY_POST, 30, createdAt) { communityPost = post }
+
+        entityManager.flush()
+        entityManager.clear()
+
+        val startDate = LocalDateTime.of(2026, 8, 4, 0, 0, 0)
+        val endDate = LocalDateTime.of(2026, 8, 4, 23, 59, 59)
+
+        // when
+        val liveRows = repository.getCalculateLiveByCreator(startDate, endDate, offset = 0, limit = 10)
+        val contentRows = repository.getCalculateContentByCreator(startDate, endDate, offset = 0, limit = 10)
+        val communityRows = repository.getCalculateCommunityByCreator(startDate, endDate, offset = 0, limit = 10)
+
+        // then
+        assertEquals(listOf(creator.id), liveRows.map { it.creatorId })
+        assertEquals(listOf(creator.id), contentRows.map { it.creatorId })
+        assertEquals(listOf(creator.id), communityRows.map { it.creatorId })
+    }
+
+    private fun saveMember(email: String?, nickname: String, role: MemberRole): Member {
+        return memberRepository.saveAndFlush(
+            Member(
+                email = email,
+                password = "password",
+                nickname = nickname,
+                role = role
+            )
+        )
+    }
+
+    private fun saveLiveRoom(creator: Member): LiveRoom {
+        val room = LiveRoom(
+            title = "live-room",
+            notice = "notice",
+            beginDateTime = LocalDateTime.of(2026, 8, 4, 8, 0, 0),
+            numberOfPeople = 1,
+            isAdult = false,
+            price = 10
+        )
+        room.member = creator
+        return liveRoomRepository.saveAndFlush(room)
+    }
+
+    private fun saveAudioContent(creator: Member): AudioContent {
+        val theme = AudioContentTheme(theme = "theme", image = "theme.png")
+        entityManager.persist(theme)
+
+        val content = AudioContent(
+            title = "content",
+            detail = "detail",
+            languageCode = "ko",
+            price = 20
+        )
+        content.theme = theme
+        content.member = creator
+        content.isActive = true
+        return audioContentRepository.saveAndFlush(content)
+    }
+
+    private fun saveOrder(buyer: Member, creator: Member, content: AudioContent, createdAt: LocalDateTime) {
+        val order = Order(type = OrderType.KEEP)
+        order.member = buyer
+        order.creator = creator
+        order.audioContent = content
+        val saved = orderRepository.saveAndFlush(order)
+        updateCreatedAt("Order", saved.id!!, createdAt)
+    }
+
+    private fun saveCommunityPost(creator: Member): CreatorCommunity {
+        val post = CreatorCommunity(
+            content = "community-content",
+            price = 30,
+            isCommentAvailable = true,
+            isAdult = false
+        )
+        post.member = creator
+        return creatorCommunityRepository.saveAndFlush(post)
+    }
+
+    private fun saveUseCan(
+        member: Member,
+        usage: CanUsage,
+        can: Int,
+        createdAt: LocalDateTime,
+        configure: UseCan.() -> Unit
+    ) {
+        val useCan = UseCan(canUsage = usage, can = can, rewardCan = 0)
+        useCan.member = member
+        useCan.configure()
+        val saved = useCanRepository.saveAndFlush(useCan)
+        updateCreatedAt("UseCan", saved.id!!, createdAt)
+    }
+
+    private fun updateCreatedAt(entityName: String, id: Long, createdAt: LocalDateTime) {
+        entityManager.createQuery("update $entityName e set e.createdAt = :createdAt where e.id = :id")
+            .setParameter("createdAt", createdAt)
+            .setParameter("id", id)
+            .executeUpdate()
+    }
+}

src/test/kotlin/kr/co/vividnext/sodalive/admin/calculate/AdminCalculateServiceTest.kt

@@ -9,11 +9,13 @@ import kr.co.vividnext.sodalive.can.use.UseCanCalculate
 import kr.co.vividnext.sodalive.can.use.UseCanCalculateRepository
 import kr.co.vividnext.sodalive.can.use.UseCanCalculateStatus
 import kr.co.vividnext.sodalive.common.SodaException
+import kr.co.vividnext.sodalive.extensions.convertLocalDateTime
 import kr.co.vividnext.sodalive.i18n.LangContext
 import kr.co.vividnext.sodalive.i18n.SodaMessageSource
 import kr.co.vividnext.sodalive.live.room.LiveRoom
 import kr.co.vividnext.sodalive.live.room.LiveRoomRepository
 import kr.co.vividnext.sodalive.member.Member
+import org.apache.poi.xssf.usermodel.XSSFWorkbook
 import org.junit.jupiter.api.Assertions.assertEquals
 import org.junit.jupiter.api.Assertions.assertThrows
 import org.junit.jupiter.api.Assertions.assertTrue
@@ -24,6 +26,8 @@ import org.mockito.Mockito.atLeastOnce
 import org.mockito.Mockito.mock
 import org.mockito.Mockito.verify
 import org.mockito.Mockito.`when`
+import java.io.ByteArrayInputStream
+import java.io.ByteArrayOutputStream
 import java.util.Optional
 
 class AdminCalculateServiceTest {
@@ -45,6 +49,35 @@ class AdminCalculateServiceTest {
         langContext
     )
 
+    @Test
+    @DisplayName("크리에이터별 정산 엑셀은 이메일 대신 크리에이터 번호를 출력한다")
+    fun shouldWriteCreatorIdInsteadOfEmailToCreatorSettlementExcel() {
+        // given
+        val startDate = "2026-08-04".convertLocalDateTime()
+        val endDate = "2026-08-04".convertLocalDateTime(hour = 23, minute = 59, second = 59)
+        val queryData = GetCalculateByCreatorQueryData(
+            creatorId = 42L,
+            nickname = "creator",
+            totalCan = 100,
+            settlementRatio = 70
+        )
+
+        `when`(repository.getCalculateLiveByCreatorTotalCount(startDate, endDate)).thenReturn(1)
+        `when`(repository.getCalculateLiveByCreator(startDate, endDate, 0L, 1L)).thenReturn(listOf(queryData))
+
+        // when
+        val output = ByteArrayOutputStream()
+        adminCalculateService.downloadCalculateLiveByCreatorExcel("2026-08-04", "2026-08-04").writeTo(output)
+
+        // then
+        XSSFWorkbook(ByteArrayInputStream(output.toByteArray())).use { workbook ->
+            val sheet = workbook.getSheetAt(0)
+            assertEquals("크리에이터 번호", sheet.getRow(0).getCell(0).stringCellValue)
+            assertEquals(42.0, sheet.getRow(1).getCell(0).numericCellValue)
+            assertEquals("닉네임", sheet.getRow(0).getCell(1).stringCellValue)
+        }
+    }
+
     @Test
     @DisplayName("라이브 환불 성공 테스트")
     fun shouldRefundLiveSuccessfully() {

src/test/kotlin/kr/co/vividnext/sodalive/creator/admin/content/series/CreatorAdminContentSeriesServiceIntegrationTest.kt

@@ -0,0 +1,96 @@
+package kr.co.vividnext.sodalive.creator.admin.content.series
+
+import kr.co.vividnext.sodalive.admin.content.series.genre.SeriesGenre
+import kr.co.vividnext.sodalive.content.hashtag.HashTag
+import kr.co.vividnext.sodalive.creator.admin.content.series.keyword.SeriesKeyword
+import kr.co.vividnext.sodalive.member.Member
+import kr.co.vividnext.sodalive.member.MemberRole
+import kr.co.vividnext.sodalive.support.EmbeddedRedisInitializer
+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.context.SpringBootTest
+import org.springframework.test.context.ContextConfiguration
+import org.springframework.transaction.support.TransactionTemplate
+import javax.persistence.EntityManager
+
+@SpringBootTest(properties = ["cloud.aws.cloud-front.host=https://cdn.test"])
+@ContextConfiguration(initializers = [EmbeddedRedisInitializer::class])
+class CreatorAdminContentSeriesServiceIntegrationTest @Autowired constructor(
+    private val service: CreatorAdminContentSeriesService,
+    private val entityManager: EntityManager,
+    private val transactionTemplate: TransactionTemplate
+) {
+    @Test
+    @DisplayName("OSIV off 환경에서 크리에이터 관리자 시리즈 상세는 키워드와 기존 필드를 반환한다")
+    fun shouldReturnOwnedSeriesDetailWithKeywordsWhenOpenInViewIsDisabled() {
+        val fixtureIds = createSeriesFixture()
+
+        val response = service.getDetail(id = fixtureIds.seriesId, memberId = fixtureIds.memberId)
+
+        assertEquals(fixtureIds.seriesId, response.seriesId)
+        assertEquals("lazy series", response.title)
+        assertEquals("lazy series introduction", response.introduction)
+        assertEquals("https://cdn.test/series/lazy-series.png", response.coverImageUrl)
+        assertEquals("월, 수", response.publishedDaysOfWeek)
+        assertEquals("lazy genre", response.genre)
+        assertEquals("#lazy-keyword", response.keywords)
+        assertEquals(true, response.isAdult)
+        assertEquals("완결", response.state)
+        assertEquals("lazy writer", response.writer)
+        assertEquals("lazy studio", response.studio)
+    }
+
+    private fun createSeriesFixture(): FixtureIds {
+        return transactionTemplate.execute {
+            val member = Member(
+                email = "creator-admin-series-detail@test.com",
+                password = "password",
+                nickname = "creator-admin-series-detail",
+                role = MemberRole.CREATOR
+            )
+            entityManager.persist(member)
+
+            val genre = SeriesGenre(genre = "lazy genre")
+            entityManager.persist(genre)
+
+            val hashTag = HashTag("#lazy-keyword")
+            entityManager.persist(hashTag)
+
+            val series = Series(
+                title = "lazy series",
+                introduction = "lazy series introduction",
+                state = SeriesState.COMPLETE,
+                writer = "lazy writer",
+                studio = "lazy studio",
+                publishedDaysOfWeek = mutableSetOf(
+                    SeriesPublishedDaysOfWeek.MON,
+                    SeriesPublishedDaysOfWeek.WED
+                ),
+                isAdult = true
+            ).apply {
+                this.member = member
+                this.genre = genre
+                coverImage = "series/lazy-series.png"
+            }
+            series.keywordList.add(
+                SeriesKeyword().apply {
+                    this.series = series
+                    keyword = hashTag
+                }
+            )
+            entityManager.persist(series)
+
+            entityManager.flush()
+            val fixtureIds = FixtureIds(memberId = member.id!!, seriesId = series.id!!)
+            entityManager.clear()
+            fixtureIds
+        }!!
+    }
+
+    private data class FixtureIds(
+        val memberId: Long,
+        val seriesId: Long
+    )
+}

src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/CreatorChannelHomeEndToEndTest.kt

@@ -66,12 +66,16 @@ class CreatorChannelHomeEndToEndTest @Autowired constructor(
             .andExpect(jsonPath("$.data.latestAudioContent.audioContentId").value(fixture.latestAudioId))
             .andExpect(jsonPath("$.data.channelDonations[0].can").value(500))
             .andExpect(jsonPath("$.data.notices[0].postId").value(fixture.noticeId))
+            .andExpect(jsonPath("$.data.notices[0].isPinned").value(true))
+            .andExpect(jsonPath("$.data.notices[0].isCommentAvailable").value(true))
             .andExpect(jsonPath("$.data.schedules[0].targetId").value(fixture.liveScheduleId))
             .andExpect(jsonPath("$.data.schedules[1].targetId").value(fixture.audioScheduleId))
             .andExpect(jsonPath("$.data.audioContents[0].audioContentId").value(fixture.listAudioId))
             .andExpect(jsonPath("$.data.audioContents[1].audioContentId").value(fixture.firstAudioId))
             .andExpect(jsonPath("$.data.series[0].seriesId").value(fixture.seriesId))
             .andExpect(jsonPath("$.data.communities[0].postId").value(fixture.communityId))
+            .andExpect(jsonPath("$.data.communities[0].isPinned").value(false))
+            .andExpect(jsonPath("$.data.communities[0].isCommentAvailable").value(true))
             .andExpect(jsonPath("$.data.fanTalk.latestFanTalk.fanTalkId").value(fixture.fanTalkId))
             .andExpect(jsonPath("$.data.introduce").value("e2e introduce"))
             .andExpect(jsonPath("$.data.activity.audioContentCount").value(3))

src/test/kotlin/kr/co/vividnext/sodalive/v2/api/creator/channel/home/adapter/in/web/CreatorChannelHomeControllerTest.kt

@@ -135,7 +135,11 @@ class CreatorChannelHomeControllerTest @Autowired constructor(
             .andExpect(jsonPath("$.data.notices[0].dateUtc").value("2026-06-12T04:00:00Z"))
             .andExpect(jsonPath("$.data.notices[0].imageUrl").doesNotExist())
             .andExpect(jsonPath("$.data.notices[0].audioUrl").doesNotExist())
+            .andExpect(jsonPath("$.data.notices[0].isPinned").value(true))
+            .andExpect(jsonPath("$.data.notices[0].isCommentAvailable").value(true))
             .andExpect(jsonPath("$.data.notices[0].isLiked").value(true))
+            .andExpect(jsonPath("$.data.communities[0].isPinned").value(false))
+            .andExpect(jsonPath("$.data.communities[0].isCommentAvailable").value(false))
             .andExpect(jsonPath("$.data.communities[0].isLiked").value(true))
             .andExpect(jsonPath("$.data.series[0].isNew").value(true))
             .andExpect(jsonPath("$.data.series[0].isOriginal").value(true))
@@ -283,7 +287,14 @@ class CreatorChannelHomeControllerTest @Autowired constructor(
                     isOriginal = true
                 )
             ),
-            communities = listOf(post.copy(postId = 302L, content = "community")),
+            communities = listOf(
+                post.copy(
+                    postId = 302L,
+                    content = "community",
+                    isCommentAvailable = false,
+                    isPinned = false
+                )
+            ),
             fanTalk = CreatorChannelFanTalkSummary(
                 totalCount = 1,
                 latestFanTalk = CreatorChannelFanTalk(

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

@@ -1,5 +1,6 @@
 package kr.co.vividnext.sodalive.v2.api.home.application
 
+import kr.co.vividnext.sodalive.member.Member
 import kr.co.vividnext.sodalive.member.contentpreference.MemberContentPreferenceService
 import kr.co.vividnext.sodalive.v2.recommendation.application.HomeRecommendationQueryService
 import kr.co.vividnext.sodalive.v2.recommendation.domain.RecommendedSectionType
@@ -44,6 +45,17 @@ class HomeRecommendationFacadeTest {
         assertFalse(response.firstAudioContents[2].isPointAvailable)
     }
 
+    @Test
+    @DisplayName("홈 추천은 회원의 성인 콘텐츠 조회 가능 여부를 배너 조회에 전달한다")
+    fun shouldPassAdultVisibilityToHomeBannerQuery() {
+        val member = Member(password = "password", nickname = "member").apply { id = 10L }
+        Mockito.doReturn(true).`when`(preferenceService).canViewAdultContent(member)
+
+        facade.getHomeRecommendations(member)
+
+        assertTrue(queryPort.bannerIncludeAdultBanners)
+    }
+
     private fun firstAudio(price: Int, isPointAvailable: Boolean): HomeFirstAudioContentRecord {
         return HomeFirstAudioContentRecord(
             contentId = price.toLong() + 1,
@@ -61,6 +73,7 @@ class HomeRecommendationFacadeTest {
 
     private class FakeHomeRecommendationQueryPort : HomeRecommendationQueryPort {
         var firstAudioContents: List<HomeFirstAudioContentRecord> = emptyList()
+        var bannerIncludeAdultBanners: Boolean = false
 
         override fun findLiveRecommendations(
             offset: Long,
@@ -69,7 +82,14 @@ class HomeRecommendationFacadeTest {
             includeAdultLives: Boolean
         ): List<HomeLiveRecommendationRecord> = emptyList()
 
-        override fun findHomeBanners(limit: Int, memberId: Long?): List<HomeBannerRecommendationRecord> = emptyList()
+        override fun findHomeBanners(
+            limit: Int,
+            memberId: Long?,
+            includeAdultBanners: Boolean
+        ): List<HomeBannerRecommendationRecord> {
+            bannerIncludeAdultBanners = includeAdultBanners
+            return emptyList()
+        }
 
         override fun findRecentlyActiveCreators(
             limit: Int,

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

@@ -8,6 +8,7 @@ import kr.co.vividnext.sodalive.content.comment.AudioContentComment
 import kr.co.vividnext.sodalive.content.like.AudioContentLike
 import kr.co.vividnext.sodalive.content.main.banner.AudioContentBanner
 import kr.co.vividnext.sodalive.content.main.banner.AudioContentBannerType
+import kr.co.vividnext.sodalive.content.main.tab.AudioContentMainTab
 import kr.co.vividnext.sodalive.content.theme.AudioContentTheme
 import kr.co.vividnext.sodalive.creator.admin.content.series.Series
 import kr.co.vividnext.sodalive.creator.admin.content.series.SeriesContent
@@ -41,25 +42,58 @@ class DefaultAudioRecommendationQueryRepositoryTest @Autowired constructor(
     private val repository = DefaultAudioRecommendationQueryRepository(queryFactory, entityManager, "https://cdn.test")
 
     @Test
-    @DisplayName("배너는 홈 추천 배너와 같은 활성/탭/차단 정책과 CDN URL을 적용한다")
+    @DisplayName("배너는 콘텐츠 추천 탭과 성인 조회 가능 여부를 적용한다")
-    fun shouldFindBannersWithHomeBannerPolicy() {
+    fun shouldFindBannersForContentRecommendationTabWithAdultVisibility() {
         val viewer = saveMember("viewer", MemberRole.USER)
         val visibleCreator = saveMember("visible-creator", MemberRole.CREATOR)
         val blockedCreator = saveMember("blocked-creator", MemberRole.CREATOR)
-        val visibleBanner = saveBanner("visible.png", AudioContentBannerType.CREATOR, 1, creator = visibleCreator)
+        val recommendationTab = saveContentRecommendationTab()
-        val adultBanner = saveBanner("adult.png", AudioContentBannerType.LINK, 2, isAdult = true, link = "https://adult.test")
+        val visibleBanner = saveBanner(
-        saveBanner("inactive.png", AudioContentBannerType.LINK, 2, isActive = false, link = "https://inactive.test")
+            "visible.png",
-        saveBanner("blocked.png", AudioContentBannerType.CREATOR, 3, creator = blockedCreator)
+            AudioContentBannerType.CREATOR,
+            1,
+            creator = visibleCreator,
+            tab = recommendationTab
+        )
+        val adultBanner = saveBanner(
+            "adult.png",
+            AudioContentBannerType.LINK,
+            2,
+            isAdult = true,
+            link = "https://adult.test",
+            tab = recommendationTab
+        )
+        saveBanner(
+            "inactive.png",
+            AudioContentBannerType.LINK,
+            3,
+            isActive = false,
+            link = "https://inactive.test",
+            tab = recommendationTab
+        )
+        saveBanner(
+            "blocked.png",
+            AudioContentBannerType.CREATOR,
+            4,
+            creator = blockedCreator,
+            tab = recommendationTab
+        )
+        saveBanner("home.png", AudioContentBannerType.LINK, 1, link = "https://home.test")
         saveBlock(viewer, blockedCreator)
         flushAndClear()
 
-        val banners = repository.findBanners(limit = 20, memberId = viewer.id, canViewAdultContent = false)
+        val safeBanners = repository.findBanners(limit = 20, memberId = viewer.id, canViewAdultContent = false)
+        val allBanners = repository.findBanners(limit = 20, memberId = viewer.id, canViewAdultContent = true)
 
         assertEquals(
-            listOf("https://cdn.test/${visibleBanner.thumbnailImage}", "https://cdn.test/${adultBanner.thumbnailImage}"),
+            listOf("https://cdn.test/${visibleBanner.thumbnailImage}"),
-            banners.map { it.imageUrl }
+            safeBanners.map { it.imageUrl }
         )
-        assertEquals(visibleCreator.id, banners.first().creatorId)
+        assertEquals(
+            listOf("https://cdn.test/${visibleBanner.thumbnailImage}", "https://cdn.test/${adultBanner.thumbnailImage}"),
+            allBanners.map { it.imageUrl }
+        )
+        assertEquals(visibleCreator.id, safeBanners.first().creatorId)
     }
 
     @Test
@@ -369,7 +403,8 @@ class DefaultAudioRecommendationQueryRepositoryTest @Autowired constructor(
         isActive: Boolean = true,
         isAdult: Boolean = false,
         creator: Member? = null,
-        link: String? = null
+        link: String? = null,
+        tab: AudioContentMainTab? = null
     ): AudioContentBanner {
         val banner = AudioContentBanner(
             thumbnailImage = thumbnailImage,
@@ -380,10 +415,18 @@ class DefaultAudioRecommendationQueryRepositoryTest @Autowired constructor(
         )
         banner.creator = creator
         banner.link = link
+        banner.tab = tab
         entityManager.persist(banner)
         return banner
     }
 
+    private fun saveContentRecommendationTab(): AudioContentMainTab {
+        entityManager.createNativeQuery(
+            "insert into audio_content_main_tab (id, title, is_active) values (2, '추천', true)"
+        ).executeUpdate()
+        return entityManager.getReference(AudioContentMainTab::class.java, 2L)
+    }
+
     private fun saveSeries(
         title: String,
         creator: Member,

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

@@ -262,6 +262,36 @@ class DefaultHomeRecommendationQueryRepositoryTest @Autowired constructor(
         assertEquals(listOf(homeBanner.thumbnailImage), banners.map { it.thumbnailImage })
     }
 
+    @Test
+    @DisplayName("홈 배너는 성인 콘텐츠 조회가 불가능하면 비성인 배너만 반환한다")
+    fun shouldExcludeAdultHomeBannersWhenAdultContentIsNotVisible() {
+        val safeBanner = saveBanner(
+            "safe-home-banner.png",
+            AudioContentBannerType.LINK,
+            orders = 1,
+            isActive = true,
+            link = "https://safe-home-banner.test"
+        )
+        val adultBanner = saveBanner(
+            "adult-home-banner.png",
+            AudioContentBannerType.LINK,
+            orders = 2,
+            isActive = true,
+            isAdult = true,
+            link = "https://adult-home-banner.test"
+        )
+        flushAndClear()
+
+        val safeBanners = repository.findHomeBanners(limit = 20)
+        val allBanners = repository.findHomeBanners(limit = 20, includeAdultBanners = true)
+
+        assertEquals(listOf(safeBanner.thumbnailImage), safeBanners.map { it.thumbnailImage })
+        assertEquals(
+            listOf(safeBanner.thumbnailImage, adultBanner.thumbnailImage),
+            allBanners.map { it.thumbnailImage }
+        )
+    }
+
     @Test
     @DisplayName("홈 배너는 비활성 대상 엔티티를 제외하고 LINK는 배너 자체 활성 상태만으로 조회한다")
     fun shouldExcludeHomeBannersWithInactiveTargetsExceptLink() {
@@ -2658,6 +2688,7 @@ class DefaultHomeRecommendationQueryRepositoryTest @Autowired constructor(
         type: AudioContentBannerType,
         orders: Int,
         isActive: Boolean,
+        isAdult: Boolean = false,
         creator: Member? = null,
         event: Event? = null,
         series: Series? = null,
@@ -2668,7 +2699,7 @@ class DefaultHomeRecommendationQueryRepositoryTest @Autowired constructor(
             thumbnailImage = thumbnailImage,
             type = type,
             lang = Lang.KO,
-            isAdult = false,
+            isAdult = isAdult,
             isActive = isActive,
             orders = orders
         )

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

@@ -86,12 +86,13 @@ class HomeRecommendationQueryServiceTest {
     }
 
     @Test
-    @DisplayName("홈 배너 추천은 기본 20개를 활성 배너 조회 포트에 위임한다")
+    @DisplayName("홈 배너 추천은 기본 20개와 성인 노출 여부를 조회 포트에 위임한다")
     fun shouldFindHomeBannersWithDefaultLimit() {
-        val banners = service.findHomeBanners(memberId = 100L)
+        val banners = service.findHomeBanners(memberId = 100L, includeAdultBanners = true)
 
         assertEquals(20, port.bannerLimit)
         assertEquals(100L, port.bannerMemberId)
+        assertEquals(true, port.bannerIncludeAdultBanners)
         assertEquals(port.banners, banners)
     }
 
@@ -964,6 +965,7 @@ class HomeRecommendationQueryServiceTest {
         var liveIncludeAdultLives: Boolean? = null
         var bannerLimit: Int? = null
         var bannerMemberId: Long? = null
+        var bannerIncludeAdultBanners: Boolean? = null
         var activeCreatorLimit: Int? = null
         var activeCreatorMemberId: Long? = null
         var activeCreatorIncludeAdultActivities: Boolean? = null
@@ -1063,9 +1065,14 @@ class HomeRecommendationQueryServiceTest {
             return liveRecommendations
         }
 
-        override fun findHomeBanners(limit: Int, memberId: Long?): List<HomeBannerRecommendationRecord> {
+        override fun findHomeBanners(
+            limit: Int,
+            memberId: Long?,
+            includeAdultBanners: Boolean
+        ): List<HomeBannerRecommendationRecord> {
             bannerLimit = limit
             bannerMemberId = memberId
+            bannerIncludeAdultBanners = includeAdultBanners
             return banners
         }
 

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

@@ -14,8 +14,8 @@ import java.util.concurrent.CountDownLatch
 import java.util.concurrent.Executor
 import java.util.concurrent.Executors
 import java.util.concurrent.Future
-import java.util.concurrent.LinkedBlockingQueue
 import java.util.concurrent.TimeUnit
+import java.util.concurrent.atomic.AtomicInteger
 
 class RecommendationSnapshotFallbackServiceTest {
     @Test
@@ -265,10 +265,18 @@ class RecommendationSnapshotFallbackServiceTest {
             homeWaitMillis = 50
         )
 
-        val first = service.refreshCheerCreatorIfMissing(offset = 0, limit = 16, nowUtc = LocalDateTime.of(2026, 7, 9, 21, 0))
+        val first = try {
-        assertEquals(true, refreshStarted.await(1, TimeUnit.SECONDS))
+            val result = service.refreshCheerCreatorIfMissing(
-        allowRefreshComplete.countDown()
+                offset = 0,
-        executor.shutdown()
+                limit = 16,
+                nowUtc = LocalDateTime.of(2026, 7, 9, 21, 0)
+            )
+            assertEquals(true, refreshStarted.await(1, TimeUnit.SECONDS))
+            result
+        } finally {
+            allowRefreshComplete.countDown()
+            executor.shutdown()
+        }
         assertEquals(true, executor.awaitTermination(1, TimeUnit.SECONDS))
         val second = service.refreshCheerCreatorIfMissing(
             offset = 0,
@@ -283,46 +291,43 @@ class RecommendationSnapshotFallbackServiceTest {
     @Test
     @DisplayName("응원 크리에이터 fallback 동시 요청은 하나의 refresh future를 공유한다")
     fun shouldShareSingleCheerCreatorRefreshFutureForConcurrentRequests() {
-        val existsSnapshotEntered = CountDownLatch(2)
+        val snapshotPort = FakeRecommendationFallbackSnapshotPort()
-        val existsSnapshotReturned = CountDownLatch(2)
+        val refreshStarted = CountDownLatch(1)
-        val snapshotPort = FakeRecommendationFallbackSnapshotPort(
+        val allowRefreshComplete = CountDownLatch(1)
-            existsSnapshotEntered = existsSnapshotEntered,
+        val refreshService = BlockingCheerRefreshService(snapshotPort, refreshStarted, allowRefreshComplete)
-            existsSnapshotReturned = existsSnapshotReturned
-        )
-        val refreshService = FastCheerRefreshService(snapshotPort)
         val redissonClient = Mockito.mock(RedissonClient::class.java)
         val lock = Mockito.mock(RLock::class.java)
         Mockito.`when`(redissonClient.getLock(RecommendationSnapshotFallbackService.CHEER_CREATOR_LOCK_KEY)).thenReturn(lock)
         Mockito.`when`(lock.tryLock(300, -1, TimeUnit.MILLISECONDS)).thenReturn(true)
         Mockito.`when`(lock.isHeldByCurrentThread).thenReturn(true)
-        val workerExecutor = CapturingExecutor()
+        val workerTaskCount = AtomicInteger()
+        val workerPool = Executors.newFixedThreadPool(2)
+        val workerExecutor = Executor { command ->
+            workerTaskCount.incrementAndGet()
+            workerPool.execute(command)
+        }
         val requestExecutor = Executors.newFixedThreadPool(2)
         val service = RecommendationSnapshotFallbackService(
             snapshotPort,
             refreshService,
             redissonClient,
             workerExecutor,
-            homeWaitMillis = 1_000
+            homeWaitMillis = 50
         )
         val nowUtc = LocalDateTime.of(2026, 7, 9, 21, 0)
 
         try {
             val first = requestExecutor.submitCheerRefresh(service, nowUtc)
             val second = requestExecutor.submitCheerRefresh(service, nowUtc)
-            assertEquals(true, existsSnapshotEntered.await(1, TimeUnit.SECONDS))
+            assertEquals(true, refreshStarted.await(5, TimeUnit.SECONDS))
-            assertEquals(true, existsSnapshotReturned.await(1, TimeUnit.SECONDS))
+            assertEquals(emptyList<RecommendationSnapshotRecord>(), first.get(5, TimeUnit.SECONDS))
-            assertEquals(true, workerExecutor.taskSubmitted.await(1, TimeUnit.SECONDS))
+            assertEquals(emptyList<RecommendationSnapshotRecord>(), second.get(5, TimeUnit.SECONDS))
-            assertEquals(false, first.isDone)
+            assertEquals(1, workerTaskCount.get())
-            assertEquals(false, second.isDone)
-            assertEquals(1, workerExecutor.taskCount)
-
-            workerExecutor.runNext()
-
-            assertEquals(listOf(99L), first.get(1, TimeUnit.SECONDS).map { it.targetId })
-            assertEquals(listOf(99L), second.get(1, TimeUnit.SECONDS).map { it.targetId })
             assertEquals(1, refreshService.cheerRefreshCount)
         } finally {
+            allowRefreshComplete.countDown()
             requestExecutor.shutdownNow()
+            workerPool.shutdownNow()
         }
     }
 
@@ -408,23 +413,6 @@ class RecommendationSnapshotFallbackServiceTest {
     }
 }
 
-private class CapturingExecutor : Executor {
-    val taskSubmitted = CountDownLatch(1)
-    private val tasks = LinkedBlockingQueue<Runnable>()
-
-    val taskCount: Int
-        get() = tasks.size
-
-    override fun execute(command: Runnable) {
-        tasks.add(command)
-        taskSubmitted.countDown()
-    }
-
-    fun runNext() {
-        tasks.poll(1, TimeUnit.SECONDS)!!.run()
-    }
-}
-
 private class BlockingCheerRefreshService(
     private val snapshotPort: RecommendationSnapshotPort,
     private val refreshStarted: CountDownLatch,
@@ -438,26 +426,7 @@ private class BlockingCheerRefreshService(
     override fun refreshCheerCreatorSnapshots(nowUtc: LocalDateTime): Int {
         cheerRefreshCount += 1
         refreshStarted.countDown()
-        allowRefreshComplete.await(1, TimeUnit.SECONDS)
+        allowRefreshComplete.await()
-        snapshotPort.replaceSnapshots(
-            RecommendedSectionType.CHEER_CREATOR,
-            LocalDateTime.of(2026, 7, 9, 14, 59, 59),
-            listOf(snapshot(RecommendedSectionType.CHEER_CREATOR, 99L))
-        )
-        return 1
-    }
-}
-
-private class FastCheerRefreshService(
-    private val snapshotPort: RecommendationSnapshotPort
-) : RecommendationSnapshotRefreshService(
-    snapshotPort,
-    Mockito.mock(kr.co.vividnext.sodalive.v2.recommendation.port.out.HomeRecommendationQueryPort::class.java)
-) {
-    var cheerRefreshCount: Int = 0
-
-    override fun refreshCheerCreatorSnapshots(nowUtc: LocalDateTime): Int {
-        cheerRefreshCount += 1
         snapshotPort.replaceSnapshots(
             RecommendedSectionType.CHEER_CREATOR,
             LocalDateTime.of(2026, 7, 9, 14, 59, 59),
@@ -496,10 +465,7 @@ private class BlockingAiAndFastCheerRefreshService(
     }
 }
 
-private class FakeRecommendationFallbackSnapshotPort(
+private class FakeRecommendationFallbackSnapshotPort : RecommendationSnapshotPort {
-    private val existsSnapshotEntered: CountDownLatch? = null,
-    private val existsSnapshotReturned: CountDownLatch? = null
-) : RecommendationSnapshotPort {
     private val snapshots = mutableListOf<RecommendationSnapshotRecord>()
 
     override fun findLatestSnapshots(
@@ -531,12 +497,7 @@ private class FakeRecommendationFallbackSnapshotPort(
     }
 
     override fun existsSnapshot(sectionType: RecommendedSectionType, snapshotAt: LocalDateTime): Boolean {
-        existsSnapshotEntered?.countDown()
+        return snapshots.any { it.sectionType == sectionType && it.snapshotAt == snapshotAt }
-        existsSnapshotEntered?.await(1, TimeUnit.SECONDS)
-        val exists = snapshots.any { it.sectionType == sectionType && it.snapshotAt == snapshotAt }
-        existsSnapshotReturned?.countDown()
-        existsSnapshotReturned?.await(1, TimeUnit.SECONDS)
-        return exists
     }
 
     override fun replaceSnapshots(