docs(content): 전체 탭 구현 문서를 추가한다

docs/20260625_메인_콘텐츠_탭_내부_전체_탭/plan-task.md

@@ -0,0 +1,456 @@
+# 메인 콘텐츠 탭 내부 전체 탭 구현 계획/TASK
+
+> **For agentic workers:** REQUIRED SUB-SKILL: 구현 시 `superpowers:subagent-driven-development` 또는 `superpowers:executing-plans`를 사용해 task 단위로 진행한다. 각 단계는 체크박스(`- [ ]`)로 추적하고, 완료 즉시 `- [x]`로 갱신한다. 구현 범위 변경이 생기면 이 문서를 먼저 수정한 뒤 코드에 반영한다.
+
+**Goal:** `GET /api/v2/audio/contents` 응답을 기반으로 메인 콘텐츠 탭 내부 `전체` 탭에 타입별 오디오/시리즈 콘텐츠 목록, 시리즈 요일 필터, 정렬, 스크롤 페이징을 제공한다.
+
+**Architecture:** 기존 `ContentMainFragment`의 `추천`, `랭킹`, `전체` Text Tab 구조는 유지하고, `전체` 선택 시 전용 Capsule type tab, optional day-of-week filter, sort bar, paged grid RecyclerView를 노출한다. 신규 API/Repository/DTO/UI state/mapper/ViewModel/adapter는 `kr.co.vividnext.sodalive.v2.main.content` 하위에 두고, 공통 카드 위젯인 `AudioContentCardView`, `SeriesContentCardView`, `CapsuleTabBarView`를 재사용한다. 레거시 파일은 직접 수정하지 않고 `SeriesPublishedDaysOfWeek` enum만 참조한다.
+
+**Tech Stack:** Kotlin, Android XML Views, ViewBinding, RecyclerView, Retrofit, Gson, RxJava3, Koin, JUnit4/Robolectric local unit test.
+
+---
+
+## 전제와 성공 기준
+- PRD: `docs/20260625_메인_콘텐츠_탭_내부_전체_탭/prd.md`
+- API endpoint는 `GET /api/v2/audio/contents`이다.
+- query parameter 기본값은 `page=0`, `size=20`, `sort=LATEST`, `type=AUDIO`다.
+- `dayOfWeek`는 `type=SERIES`일 때만 전송한다.
+- 기본 `dayOfWeek`는 디바이스 현재 요일을 `SeriesPublishedDaysOfWeek`로 변환한다.
+- UI 타입 탭은 `오디오`, `시리즈`, `오리지널`, `무료`, `포인트`만 구현한다.
+- Figma에 보이는 `전체`, `연재` 콘텐츠 타입 칩은 이번 범위에서 구현하지 않는다.
+- `SERIES`, `ORIGINAL`은 응답의 `series` 목록을 표시한다.
+- `AUDIO`, `FREE`, `POINT`는 응답의 `audios` 목록을 표시한다.
+- 이번 범위의 `ORIGINAL`은 오리지널 시리즈 목록만 의미한다.
+- `RANDOM` 요일 라벨은 한국어 `기타`, 일본어 `その他`, 영어 `OTHER`로 표시한다.
+- 정렬 옵션은 기존 `ContentSort.entries` 전체를 사용하고, UI는 `CreatorChannelSortPopup`/`ContentSort.toLabelResId()` 패턴을 따른다.
+- `SeriesContentCardView`는 `isAdult` 성인 배지를 지원해야 한다.
+  - `SeriesContentCardSize.Large`: `ic_new_shield_large`
+  - `SeriesContentCardSize.Small`: `ic_new_shield_small`
+  - badge background: `bg_creator_channel_live_adult_badge`
+- 구현 완료 후 최소 다음 명령을 실행한다.
+  - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.*"`
+  - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.SeriesContentCardViewTest"`
+  - `./gradlew :app:mergeDebugResources`
+  - `./gradlew :app:compileDebugKotlin`
+  - `./gradlew :app:ktlintCheck`
+  - `git diff --check`
+
+---
+
+## Figma 참조 필요 Phase
+- Phase 1: 제한 참조
+  - 기존 콘텐츠 추천/랭킹 구조, DI, sort popup, 카드 위젯 구조 확인 중심으로 진행한다.
+- Phase 2: Figma 참조 불필요
+  - API/DTO/Repository와 enum/요일 변환은 PRD 서버 계약과 기존 V2 data layer 패턴을 따른다.
+- Phase 3: 필수 참조
+  - `SeriesContentCardView` 성인 배지는 Figma `567:18346`, `567:18347`과 기존 오디오 배지 구조를 대조한다.
+- Phase 4: Figma 참조 불필요
+  - ViewModel 페이징/정렬/요일 상태는 기존 크리에이터 채널 pagination 패턴을 따른다.
+- Phase 5: 필수 참조
+  - 전체 탭 type tab, 요일 필터, 정렬 바, 3열 그리드 위치는 Figma `35:5857`, `24:6909`, `24:9105`를 기준으로 확인한다.
+- Phase 6: 필수 참조
+  - 최종 수동 화면 검증은 PRD의 모든 포함/제외 항목과 실제 화면을 대조한다.
+
+---
+
+## 파일 구조
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/data/MainContentAllTabApi.kt`
+  - `GET /api/v2/audio/contents` Retrofit endpoint를 정의한다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/data/MainContentAllTabModels.kt`
+  - `MainContentAllTabResponse`, `MainContentAllType`, `MainContentAudioResponse`, `MainContentSeriesResponse` DTO를 정의한다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/data/MainContentAllTabRepository.kt`
+  - API 호출을 repository method로 감싼다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllTabUiState.kt`
+  - `Loading`, `Content`, `Empty`, `Error` 상태와 paging/loading-more 상태를 정의한다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllTabUiModels.kt`
+  - 오디오/시리즈/요일/type tab/sort UI model을 정의한다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllTabMappers.kt`
+  - DTO를 UI model로 변환하고 타입별 `audios`/`series` 선택 규칙을 구현한다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllDayOfWeekMapper.kt`
+  - 디바이스 현재 요일과 UI 라벨을 `SeriesPublishedDaysOfWeek`로 매핑한다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ContentAllTabViewModel.kt`
+  - type/sort/day/page/hasNext/loading-more 상태와 API 호출을 관리한다.
+- Modify: `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`
+  - `MainContentAllTabApi`, `MainContentAllTabRepository`, `ContentAllTabViewModel`을 Koin에 등록한다.
+- Modify: `app/src/main/res/layout/view_series_content_card.xml`
+  - 성인 배지 `ImageView`를 썸네일 우측 상단에 추가한다.
+- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/widget/SeriesContentCardView.kt`
+  - `setAdultVisible(isVisible: Boolean)`과 size별 shield icon 적용을 추가한다.
+- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/widget/SeriesContentCardViewTest.kt`
+  - 성인 배지 visibility, background, size별 icon source를 검증한다.
+- Create: `app/src/main/res/layout/item_content_all_series_card.xml`
+  - `SeriesContentCardView` 기반 전체 탭 시리즈 카드 item이다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ui/ContentAllSeriesCardAdapter.kt`
+  - `SERIES`, `ORIGINAL` grid item을 바인딩한다.
+- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ui/ContentAllAudioCardAdapter.kt`
+  - `AUDIO`, `FREE`, `POINT` grid item을 바인딩한다.
+- Modify: `app/src/main/res/layout/fragment_v2_main_content.xml`
+  - 전체 탭 전용 type tab, day filter, sort bar, grid RecyclerView, loading-more/error surface를 추가한다.
+- Modify: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ContentMainFragment.kt`
+  - `전체` Text Tab 선택 시 전체 탭 surface를 표시하고 ViewModel/adapter/sort popup/day filter/paging/routing을 연결한다.
+- Modify: `app/src/main/res/values/strings.xml`
+  - 전체 탭 type 라벨, 요일 `기타`, 정렬/빈 목록/오류 표시 문구를 추가한다.
+- Modify: `app/src/main/res/values-en/strings.xml`
+  - 전체 탭 type 라벨, 요일 `OTHER`, 정렬/빈 목록/오류 표시 문구를 추가한다.
+- Modify: `app/src/main/res/values-ja/strings.xml`
+  - 전체 탭 type 라벨, 요일 `その他`, 정렬/빈 목록/오류 표시 문구를 추가한다.
+- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/MainContentAllTabMapperTest.kt`
+  - 타입별 audios/series 선택, tag/adult/original/free/point mapping을 검증한다.
+- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/MainContentAllDayOfWeekMapperTest.kt`
+  - current day mapping과 라벨 리소스 mapping을 검증한다.
+- Create: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/ContentAllTabViewModelTest.kt`
+  - 첫 페이지, type/sort/day 변경, load-more, stale response 방지를 검증한다.
+- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/ContentMainFragmentSourceTest.kt`
+  - 전체 탭 layout id, adapter/ViewModel 연결, `전체`/`연재` 칩 제외, routing source를 검증한다.
+
+---
+
+### Phase 1: 기존 구조 확인과 작업 경계 고정
+
+- [ ] **Task 1.1: 기존 콘텐츠 탭 구조와 전체 탭 삽입 지점 확인**
+  - 확인:
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ContentMainFragment.kt`
+    - `app/src/main/res/layout/fragment_v2_main_content.xml`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ContentMainViewModel.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ContentRankingViewModel.kt`
+  - 작업:
+    - 기존 `추천`, `랭킹`, `전체` Text Tab bar는 유지한다.
+    - `showContentTab(CONTENT_TAB_ALL)` 분기에서 전체 탭 surface를 보이도록 확장할 위치를 확인한다.
+    - 추천/랭킹 API와 ViewModel은 리팩터링하지 않는다.
+  - 검증:
+    - Run: `rg -n "CONTENT_TAB_ALL|hideContentSurfaces|showRecommendationContent|showRankingContent|textTabBarContent" app/src/main/java/kr/co/vividnext/sodalive/v2/main/content app/src/main/res/layout/fragment_v2_main_content.xml`
+    - Expected: Text Tab 전환과 기존 surface visibility 지점이 확인된다.
+
+- [ ] **Task 1.2: 재사용 위젯과 신규 adapter 경계 확정**
+  - 확인:
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/widget/AudioContentCardView.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/widget/SeriesContentCardView.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/widget/CapsuleTabBarView.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/ui/CreatorChannelSortPopup.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/creator/channel/model/CreatorChannelSortModels.kt`
+  - 작업:
+    - 타입 칩은 `CapsuleTabBarView` 재사용으로 고정한다.
+    - 정렬 팝업은 `CreatorChannelSortPopup`과 `ContentSort.toLabelResId()` 재사용으로 고정한다.
+    - 전체 탭 grid는 pagination과 type별 모델 분리를 위해 `ContentAllAudioCardAdapter`, `ContentAllSeriesCardAdapter` 신규 생성으로 고정한다.
+  - 검증:
+    - Run: `rg -n "class CapsuleTabBarView|class CreatorChannelSortPopup|fun ContentSort.toLabelResId|class AudioContentCardView|class SeriesContentCardView" app/src/main/java/kr/co/vividnext/sodalive/v2`
+    - Expected: 재사용 후보 클래스와 함수가 확인된다.
+
+- [ ] **Task 1.3: 제외 범위 확인**
+  - 확인:
+    - `docs/20260625_메인_콘텐츠_탭_내부_전체_탭/prd.md`
+  - 제외:
+    - Figma type chip `전체`, `연재` 구현
+    - 추천/랭킹 탭 기존 기능 변경
+    - 레거시 API/화면 파일 직접 수정
+    - 오리지널 오디오 별도 표시
+    - 오프라인 캐시/로컬 DB 저장
+  - 검증:
+    - Run: `rg -n '전체|연재|Non-Goals|오리지널 오디오|레거시|Open Questions' docs/20260625_메인_콘텐츠_탭_내부_전체_탭/prd.md`
+    - Expected: 제외 범위와 Open Questions 없음 상태가 확인된다.
+
+---
+
+### Phase 2: API, DTO, Repository, enum/요일 mapping 추가
+
+- [ ] **Task 2.1: API/DTO/Repository 계약 추가**
+  - 생성:
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/data/MainContentAllTabApi.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/data/MainContentAllTabModels.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/data/MainContentAllTabRepository.kt`
+  - 수정:
+    - `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`
+  - 작업:
+    - Retrofit endpoint는 `@GET("/api/v2/audio/contents")`로 정의한다.
+    - query parameter는 `type`, `sort`, `page`, `size`, `dayOfWeek`를 정의한다.
+    - `dayOfWeek` parameter는 nullable로 두고 repository/ViewModel에서 `SERIES`일 때만 값을 전달한다.
+    - DTO는 PRD response class 필드를 모두 포함하되 Gson `@SerializedName`을 사용한다.
+    - `MainContentAllType`은 `AUDIO`, `SERIES`, `ORIGINAL`, `FREE`, `POINT`만 정의한다.
+    - `ContentSort`와 `SeriesPublishedDaysOfWeek`는 기존 타입을 import한다.
+    - Koin `networkModule`, `repositoryModule`에 신규 API/Repository를 등록한다.
+  - 검증:
+    - Run: `./gradlew :app:compileDebugKotlin`
+    - Expected: 신규 data layer와 DI 등록이 컴파일된다.
+
+- [ ] **Task 2.2: 타입 라벨과 요일 라벨 리소스 추가**
+  - 수정:
+    - `app/src/main/res/values/strings.xml`
+    - `app/src/main/res/values-en/strings.xml`
+    - `app/src/main/res/values-ja/strings.xml`
+  - 작업:
+    - type tab 라벨 문자열을 추가한다.
+      - `screen_content_all_type_audio`
+      - `screen_content_all_type_series`
+      - `screen_content_all_type_original`
+      - `screen_content_all_type_free`
+      - `screen_content_all_type_point`
+    - 전체 탭 요일 `RANDOM` 전용 문자열을 추가한다.
+      - `screen_content_all_day_other`
+      - values: `기타`
+      - values-en: `OTHER`
+      - values-ja: `その他`
+    - 기존 전역 `day_random`은 레거시 사용처 영향 방지를 위해 수정하지 않는다.
+    - 빈 목록/페이징 오류 표시를 위해 전체 탭 전용 문자열을 추가한다.
+      - `screen_content_all_empty`
+      - `screen_content_all_pagination_error`
+  - 검증:
+    - Run: `./gradlew :app:mergeDebugResources`
+    - Expected: 3개 locale string resource가 중복 없이 merge된다.
+
+- [ ] **Task 2.3: 요일 mapping 테스트 작성**
+  - 생성:
+    - `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/MainContentAllDayOfWeekMapperTest.kt`
+  - 테스트 케이스:
+    - `Calendar.MONDAY`는 `SeriesPublishedDaysOfWeek.MON`
+    - `Calendar.TUESDAY`는 `SeriesPublishedDaysOfWeek.TUE`
+    - `Calendar.WEDNESDAY`는 `SeriesPublishedDaysOfWeek.WED`
+    - `Calendar.THURSDAY`는 `SeriesPublishedDaysOfWeek.THU`
+    - `Calendar.FRIDAY`는 `SeriesPublishedDaysOfWeek.FRI`
+    - `Calendar.SATURDAY`는 `SeriesPublishedDaysOfWeek.SAT`
+    - `Calendar.SUNDAY`는 `SeriesPublishedDaysOfWeek.SUN`
+    - `SeriesPublishedDaysOfWeek.RANDOM` 라벨은 `screen_content_all_day_other`
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.MainContentAllDayOfWeekMapperTest"`
+    - Expected: mapper 구현 전 RED 실패.
+
+- [ ] **Task 2.4: 요일 mapping 구현**
+  - 생성:
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllDayOfWeekMapper.kt`
+  - 작업:
+    - `fun currentDeviceDayOfWeek(calendar: Calendar = Calendar.getInstance()): SeriesPublishedDaysOfWeek`를 추가한다.
+    - `fun SeriesPublishedDaysOfWeek.toContentAllDayLabelResId(): Int`를 추가한다.
+    - `RANDOM`은 `R.string.screen_content_all_day_other`로 매핑한다.
+    - 요일 UI 표시 순서는 `MON`, `TUE`, `WED`, `THU`, `FRI`, `SAT`, `SUN`, `RANDOM`으로 고정한다.
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.MainContentAllDayOfWeekMapperTest"`
+    - Expected: PASS.
+
+---
+
+### Phase 3: UI model, mapper, SeriesContentCardView 성인 배지
+
+- [ ] **Task 3.1: 전체 탭 mapper RED 테스트 작성**
+  - 생성:
+    - `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/MainContentAllTabMapperTest.kt`
+  - 테스트 케이스:
+    - `AUDIO`, `FREE`, `POINT`는 response `audios`만 UI 목록으로 사용한다.
+    - `SERIES`, `ORIGINAL`은 response `series`만 UI 목록으로 사용한다.
+    - `ORIGINAL`은 시리즈 카드 타입으로 매핑한다.
+    - `isAdult`는 오디오/시리즈 UI model의 `showAdultBadge`로 매핑된다.
+    - 오디오 `isPointAvailable=true`는 `AudioContentTag.Point`로 매핑된다.
+    - 오디오 `isFirstContent=true`는 `AudioContentTag.First`로 매핑된다.
+    - 오디오 `isOriginalSeries=true`는 `AudioContentTag.Original`로 매핑된다.
+    - 오디오 `price == 0`은 `AudioContentTag.Free`로 매핑된다.
+    - `hasNext`, `page`, `size`, `totalCount`, `sort`, `dayOfWeek`는 UI state에 보존된다.
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.MainContentAllTabMapperTest"`
+    - Expected: UI model/mapper 구현 전 RED 실패.
+
+- [ ] **Task 3.2: 전체 탭 UI model과 mapper 구현**
+  - 생성:
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllTabUiState.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllTabUiModels.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/model/MainContentAllTabMappers.kt`
+  - 작업:
+    - `MainContentAllAudioUiModel`은 `audioContentId`, `title`, `imageUrl`, `price`, `creatorNickname`, `tags`, `showAdultBadge`를 가진다.
+    - `MainContentAllSeriesUiModel`은 `seriesId`, `title`, `coverImageUrl`, `creatorNickname`, `showOriginalTag`, `showAdultBadge`를 가진다.
+    - `MainContentAllTabUiState.Content`는 `selectedType`, `selectedSort`, `selectedDayOfWeek`, `totalCount`, `audioItems`, `seriesItems`, `page`, `size`, `hasNext`, `isLoadingMore`, `paginationErrorMessage`를 가진다.
+    - `MainContentAllType.usesSeriesItems()`는 `SERIES`, `ORIGINAL`에서 true를 반환한다.
+    - `MainContentAllType.usesDayOfWeekQuery()`는 `SERIES`에서만 true를 반환한다.
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.MainContentAllTabMapperTest"`
+    - Expected: PASS.
+
+- [ ] **Task 3.3: SeriesContentCardView 성인 배지 테스트 작성**
+  - 생성:
+    - `app/src/test/java/kr/co/vividnext/sodalive/v2/widget/SeriesContentCardViewTest.kt`
+  - 테스트 케이스:
+    - inflate 직후 adult badge는 `GONE`
+    - `setAdultVisible(true)` 호출 시 adult badge는 `VISIBLE`
+    - `setAdultVisible(false)` 호출 시 adult badge는 `GONE`
+    - `setSize(SeriesContentCardSize.Large)` 호출 시 adult badge는 24dp 컨테이너와 `ic_new_shield_large`를 사용한다.
+    - `setSize(SeriesContentCardSize.Small)` 호출 시 adult badge는 18dp 컨테이너와 `ic_new_shield_small`을 사용한다.
+    - adult badge background는 `bg_creator_channel_live_adult_badge`다.
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.SeriesContentCardViewTest"`
+    - Expected: adult badge 미구현으로 RED 실패.
+
+- [ ] **Task 3.4: SeriesContentCardView 성인 배지 구현**
+  - 수정:
+    - `app/src/main/res/layout/view_series_content_card.xml`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/widget/SeriesContentCardView.kt`
+  - 작업:
+    - `view_series_content_card.xml`의 `FrameLayout` 안에 `ImageView @+id/iv_series_content_adult_badge`를 추가한다.
+    - layout gravity는 `top|end`, 기본 visibility는 `gone`으로 둔다.
+    - background는 `@drawable/bg_creator_channel_live_adult_badge`로 둔다.
+    - `SeriesContentCardView`에서 `adultBadge`를 findViewById로 보관한다.
+    - `setAdultVisible(isVisible: Boolean)`을 추가한다.
+    - `setSize(size)`에서 size별 adult badge layout params와 icon을 갱신한다.
+      - Large: 24dp, marginTop/marginEnd 8dp, padding 4dp, `ic_new_shield_large`
+      - Small: 18dp, marginTop/marginEnd 6dp, padding 2dp, `ic_new_shield_small`
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.SeriesContentCardViewTest"`
+    - Expected: PASS.
+
+---
+
+### Phase 4: ViewModel 페이징, 타입, 정렬, 요일 상태 구현
+
+- [ ] **Task 4.1: ViewModel RED 테스트 작성**
+  - 생성:
+    - `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/ContentAllTabViewModelTest.kt`
+  - 테스트 케이스:
+    - 최초 로드는 `type=AUDIO`, `sort=LATEST`, `page=0`, `size=20`, `dayOfWeek=null`로 요청한다.
+    - `SERIES` 선택 시 현재 디바이스 요일을 포함해 `page=0`으로 요청한다.
+    - `AUDIO`, `FREE`, `POINT`, `ORIGINAL` 선택 시 `dayOfWeek=null`로 요청한다.
+    - `SERIES` 상태에서 요일 변경 시 `type=SERIES`, 변경된 `dayOfWeek`, `page=0`으로 요청한다.
+    - 정렬 변경 시 현재 type/day 조건을 유지하고 `page=0`으로 요청한다.
+    - `hasNext=true`이면 `loadMore()`가 다음 page를 요청하고 기존 목록 뒤에 append한다.
+    - loading-more 중복 요청은 1회로 제한한다.
+    - load-more 실패 시 기존 목록을 유지하고 `paginationErrorMessage`를 설정한다.
+    - type/sort/day 변경 후 도착한 이전 응답은 현재 목록에 append하지 않는다.
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.ContentAllTabViewModelTest"`
+    - Expected: ViewModel 미구현으로 RED 실패.
+
+- [ ] **Task 4.2: ContentAllTabViewModel 구현**
+  - 생성:
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ContentAllTabViewModel.kt`
+  - 작업:
+    - `DEFAULT_PAGE_SIZE = 20`, `FIRST_PAGE = 0`을 정의한다.
+    - `allTabStateLiveData`, `isLoading`, `toastLiveData`를 노출한다.
+    - `loadInitial()`, `changeType(type)`, `changeSort(sort)`, `changeDayOfWeek(dayOfWeek)`, `loadMore()`, `retry()`, `consumePaginationErrorMessage()`를 구현한다.
+    - `requestGeneration` 방식으로 stale response를 무시한다.
+    - `authToken()`은 기존 ViewModel과 동일하게 `Bearer ${SharedPreferenceManager.token}` 형태를 사용한다.
+    - API success + 표시 대상 list empty이면 `Empty` 상태로 둔다.
+    - first page error는 `Error` 상태와 `R.string.common_error_unknown` toast로 처리한다.
+    - load-more error는 기존 content state를 유지하고 `paginationErrorMessage`만 설정한다.
+  - 수정:
+    - `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.ContentAllTabViewModelTest"`
+    - Expected: PASS.
+
+---
+
+### Phase 5: Layout, adapter, Fragment 연결
+
+- [ ] **Task 5.1: 전체 탭 layout과 source test 추가**
+  - 수정:
+    - `app/src/test/java/kr/co/vividnext/sodalive/v2/main/content/ContentMainFragmentSourceTest.kt`
+  - 테스트 케이스:
+    - `fragment_v2_main_content.xml`에 `view_content_all_type_tabs`가 있다.
+    - `fragment_v2_main_content.xml`에 `layout_content_all_day_filter`가 있다.
+    - `fragment_v2_main_content.xml`에 `layout_content_all_sort_bar`가 있다.
+    - `fragment_v2_main_content.xml`에 `rv_content_all_items`가 있다.
+    - source에 `ContentAllTabViewModel by viewModel()`이 있다.
+    - source에 `ContentAllAudioCardAdapter`와 `ContentAllSeriesCardAdapter`가 있다.
+    - source에 `MainContentAllType.AUDIO`, `SERIES`, `ORIGINAL`, `FREE`, `POINT`는 있지만 type tab menu에 `전체`, `연재` 매핑은 없다.
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.ContentMainFragmentSourceTest"`
+    - Expected: layout/Fragment 연결 전 RED 실패.
+
+- [ ] **Task 5.2: 전체 탭 item layout과 adapter 구현**
+  - 생성:
+    - `app/src/main/res/layout/item_content_all_series_card.xml`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ui/ContentAllAudioCardAdapter.kt`
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ui/ContentAllSeriesCardAdapter.kt`
+  - 작업:
+    - 오디오 adapter는 `AudioContentCardView`에 `AudioContentCardSize.Small`을 적용한다.
+    - 오디오 adapter는 title/creator/image/tags/adult badge를 바인딩하고 클릭 시 `audioContentId`를 전달한다.
+    - 시리즈 adapter는 `SeriesContentCardView`에 `SeriesContentCardSize.Small`을 적용한다.
+    - 시리즈 adapter는 title/creator/cover/original/adult badge를 바인딩하고 클릭 시 `seriesId`를 전달한다.
+    - adapter는 `submitItems(items)`로 전체 list를 교체하며, ViewModel이 append된 list를 전달한다.
+  - 검증:
+    - Run: `./gradlew :app:mergeDebugResources`
+    - Expected: 신규 item layout binding class가 생성된다.
+    - Run: `./gradlew :app:compileDebugKotlin`
+    - Expected: 신규 adapter가 컴파일된다.
+
+- [ ] **Task 5.3: fragment_v2_main_content.xml에 전체 탭 surface 추가**
+  - 수정:
+    - `app/src/main/res/layout/fragment_v2_main_content.xml`
+  - 작업:
+    - `text_tab_bar_content` 아래에 `view_content_all_type_tabs` include를 추가한다.
+    - `layout_content_all_day_filter`를 추가하고 기본 visibility는 `gone`으로 둔다.
+    - `layout_content_all_sort_bar`를 추가하고 total count와 sort label view id를 둔다.
+      - `tv_content_all_total_count`
+      - `layout_content_all_sort_button`
+      - `tv_content_all_sort_label`
+    - `rv_content_all_items` RecyclerView를 추가하고 기본 visibility는 `gone`으로 둔다.
+    - 기존 추천/랭킹 surface와 겹치지 않도록 `showContentTab()`에서 visibility를 제어할 수 있는 root id를 둔다.
+      - `layout_content_all_surface`
+  - 검증:
+    - Run: `./gradlew :app:mergeDebugResources`
+    - Expected: layout resource merge가 성공한다.
+
+- [ ] **Task 5.4: ContentMainFragment 전체 탭 연결**
+  - 수정:
+    - `app/src/main/java/kr/co/vividnext/sodalive/v2/main/content/ContentMainFragment.kt`
+  - 작업:
+    - `private val contentAllTabViewModel: ContentAllTabViewModel by viewModel()`을 추가한다.
+    - type tab은 `AUDIO`, `SERIES`, `ORIGINAL`, `FREE`, `POINT` 순서로 구성한다.
+    - `CONTENT_TAB_ALL` 선택 시 추천/랭킹 surface를 숨기고 전체 탭 surface를 표시한다.
+    - 전체 탭 최초 선택 시 `contentAllTabViewModel.loadInitial()`을 한 번 호출한다.
+    - type 변경 시 `contentAllTabViewModel.changeType(...)`을 호출한다.
+    - `SERIES` 상태에서만 day filter를 보이고, 다른 type에서는 숨긴다.
+    - day filter 클릭 시 `changeDayOfWeek(...)`를 호출한다.
+    - sort button 클릭 시 `CreatorChannelSortPopup`을 띄우고 `changeSort(...)`를 호출한다.
+    - grid는 `GridLayoutManager(spanCount = 3)`로 구성한다.
+    - 현재 state가 오디오 계열이면 audio adapter를, 시리즈 계열이면 series adapter를 연결한다.
+    - RecyclerView 하단 접근 시 `loadMore()`를 호출한다.
+    - `paginationErrorMessage`는 toast로 표시하고 `consumePaginationErrorMessage()`를 호출한다.
+    - 오디오 클릭은 기존 `openAudioContentDetail(audioContentId)`를 재사용한다.
+    - 시리즈 클릭은 기존 `openSeriesDetail(seriesId)`를 재사용한다.
+  - 검증:
+    - Run: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.ContentMainFragmentSourceTest"`
+    - Expected: PASS.
+    - Run: `./gradlew :app:compileDebugKotlin`
+    - Expected: Fragment/ViewBinding/adapter 연결이 컴파일된다.
+
+---
+
+### Phase 6: 통합 검증과 수동 확인
+
+- [ ] **Task 6.1: 단위 테스트 실행**
+  - 실행:
+    - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.content.*"`
+    - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.SeriesContentCardViewTest"`
+  - 기대 결과:
+    - 전체 탭 mapper/day/ViewModel/source test가 PASS한다.
+    - 시리즈 카드 성인 배지 test가 PASS한다.
+  - 검증 기록:
+    - 구현 후 실행 결과를 여기에 누적한다.
+
+- [ ] **Task 6.2: 리소스/컴파일/스타일 검증**
+  - 실행:
+    - `./gradlew :app:mergeDebugResources`
+    - `./gradlew :app:compileDebugKotlin`
+    - `./gradlew :app:ktlintCheck`
+    - `git diff --check`
+  - 기대 결과:
+    - resource merge, Kotlin compile, ktlint, whitespace 검증이 모두 성공한다.
+  - 검증 기록:
+    - 구현 후 실행 결과를 여기에 누적한다.
+
+- [ ] **Task 6.3: 수동 화면 검증**
+  - 확인:
+    - 콘텐츠 탭 진입 후 `추천`이 기존처럼 표시된다.
+    - `랭킹`이 기존처럼 표시된다.
+    - `전체` 선택 시 오디오 type이 기본 선택된다.
+    - type chip에는 `오디오`, `시리즈`, `오리지널`, `무료`, `포인트`만 보인다.
+    - type chip에 Figma의 `전체`, `연재`는 보이지 않는다.
+    - `AUDIO`, `FREE`, `POINT`는 오디오 카드 3열 grid로 표시된다.
+    - `SERIES`, `ORIGINAL`은 시리즈 카드 3열 grid로 표시된다.
+    - `SERIES`에서만 요일 필터가 보인다.
+    - `RANDOM` 요일은 한국어 `기타`, 일본어 `その他`, 영어 `OTHER`로 표시된다.
+    - sort popup은 기존 `ContentSort` UI와 동일한 선택 UI로 동작한다.
+    - 하단 스크롤 시 다음 페이지가 append된다.
+    - 시리즈 성인 콘텐츠는 `SeriesContentCardView` 우측 상단에 성인 배지를 표시한다.
+  - 검증 기록:
+    - 구현 후 수동 확인 결과를 여기에 누적한다.
+
+---
+
+## Verification Log
+- 문서 작성 시점에는 구현 전이므로 실행한 빌드/테스트가 없다.