docs(workflow): PRD와 계획 문서 구조를 정리한다

docs/plan-task/20260224_AGENTS문서정비.md

@@ -0,0 +1,54 @@
+# AGENTS 문서 정비 계획
+
+## 구현 체크리스트
+- [x] 저장소의 빌드/린트/테스트 실행 명령 근거 파일 수집
+- [x] 단일 테스트 실행 명령(클래스/메서드 단위) 근거 확인
+- [x] 코드 스타일 규칙(포맷/타입/네이밍/에러 처리/import) 근거 수집
+- [x] 기존 `AGENTS.md` 존재 여부 확인 및 개선/신규 작성 방향 결정
+- [x] Cursor/Copilot 규칙 파일 존재 여부 확인 및 반영
+- [x] `AGENTS.md` 약 150줄로 작성/갱신
+- [x] `설정/보안 유의사항` 섹션을 현재 프로젝트 민감 항목 기준으로 채우기
+- [x] `AGENTS.md` 내용이 현재 프로젝트 설정(`settings.gradle`, `app/build.gradle`, `.editorconfig`)과 일치하는지 재검증
+- [x] 사용자 추가 요청 반영: `AGENTS.md` 전면 한글화 및 향후 문서 한글 작성 규칙 명시
+- [x] 최소 1회 빌드 시스템 명령 유효성 확인
+
+## 작업 메모
+- 본 문서는 요청된 문서 유지보수 규칙에 따라 작업 시작 시점에 생성한다.
+- 구현 중 범위 변경이 발생하면 체크리스트를 먼저 갱신한다.
+
+## 검증 기록
+- 검증 #1
+  - 무엇: 문서 파일 문법/형식 진단
+  - 왜: 문서 수정 후 오류 여부를 즉시 확인하기 위해
+  - 어떻게: `lsp_diagnostics`로 `AGENTS.md`, `docs/20260224_AGENTS문서정비.md` 검사
+  - 결과: 오류 없음
+- 검증 #2
+  - 무엇: 빌드 시스템 명령 유효성
+  - 왜: 문서 규칙(문서 변경 후 최소 1회 빌드 시스템 명령 실행) 충족을 위해
+  - 어떻게: `./gradlew :app:help` 실행
+  - 결과: `BUILD SUCCESSFUL`
+- 검증 #3
+  - 무엇: 단일 테스트 실행 명령 유효성
+  - 왜: AGENTS.md의 단일 테스트 실행 가이드가 실제로 동작하는지 확인하기 위해
+  - 어떻게: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.chat.talk.room.TimeUtilsTest"` 실행
+  - 결과: `BUILD SUCCESSFUL` (테스트 태스크 up-to-date)
+- 검증 #4
+  - 무엇: AGENTS.md 내용의 현재 프로젝트 적합성 점검
+  - 왜: 요청사항(현재 프로젝트에 맞는지 확인)을 충족하기 위해
+  - 어떻게: `settings.gradle`, `build.gradle`, `app/build.gradle`, `.editorconfig`, `app/src/main/AndroidManifest.xml`을 재확인하고 명령/규칙 문구를 대조
+  - 결과: `:app` 단일 모듈, `lint.checkReleaseBuilds false`, import-ordering 비활성화, 권한/보안 주의 항목 반영 완료
+- 검증 #5
+  - 무엇: 문서 변경 후 Gradle 명령 유효성 재확인
+  - 왜: 문서 유지보수 규칙(문서 변경 후 `./gradlew tasks --all`)을 충족하기 위해
+  - 어떻게: `./gradlew tasks --all` 실행
+  - 결과: `BUILD SUCCESSFUL`
+- 검증 #6
+  - 무엇: 단일 테스트 가이드 재검증
+  - 왜: AGENTS.md 단일 테스트 예시의 최신 유효성을 다시 확인하기 위해
+  - 어떻게: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.chat.talk.room.TimeUtilsTest"` 실행
+  - 결과: `BUILD SUCCESSFUL` (`:app:testDebugUnitTest UP-TO-DATE`)
+- 검증 #7
+  - 무엇: 최종 문서 진단
+  - 왜: 수정 완료 직후 문서 상태를 확인하기 위해
+  - 어떻게: `lsp_diagnostics`로 `AGENTS.md`, `docs/20260224_AGENTS문서정비.md` 검사
+  - 결과: 오류 없음

docs/plan-task/20260224_유료라이브최소금액30캔검사추가.md

@@ -0,0 +1,39 @@
+- [x] 라이브 생성 정합성 검사 로직 위치를 확인한다.
+- [x] 유료 라이브 최소 금액 30캔 조건을 생성 전 검사에 추가한다.
+- [x] 금액이 0 미만인 경우 0으로 보정하도록 반영한다.
+- [x] 최소금액 메시지의 영어/일본어 리소스를 추가한다.
+- [x] 관련 파일 진단/테스트/빌드를 실행해 결과를 확인한다.
+
+## 검증 기록
+
+### 1) 유료 라이브 최소 금액 30캔 정합성 추가
+- 무엇: 유료 라이브 생성 전 정합성 검사에 최소 금액(30캔) 조건 추가 반영 여부를 검증.
+- 왜: 유료 라이브를 30캔 미만(1~29캔)으로 생성하지 못하도록 클라이언트에서 사전 차단하기 위함.
+- 어떻게:
+  - `lsp_diagnostics` (`LiveRoomCreateViewModel.kt`, `strings.xml`) 실행 시 현재 환경에 Kotlin/XML LSP 서버가 없어 진단 도구 사용 불가를 확인.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - Gradle: `BUILD SUCCESSFUL` (단위 테스트/디버그 빌드 통과).
+  - 문자열 리소스 `msg_live_room_create_minimum_paid_price` 추가 및 ViewModel 검증 조건 반영 확인.
+
+### 2) 금액 음수 입력 0 보정
+- 무엇: 라이브 생성 금액 설정 시 음수 값 입력을 0으로 보정하는 로직 반영 여부 검증.
+- 왜: 비정상 입력(0 미만)이 들어와도 가격 상태를 안전하게 유지하기 위함.
+- 어떻게:
+  - `LiveRoomCreateViewModel.setPrice`를 `price.coerceAtLeast(0)`로 변경.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - Gradle: `BUILD SUCCESSFUL`.
+  - 음수 입력 시 `priceLiveData`는 최소 0으로 보정됨.
+
+### 3) 최소 금액 메시지 다국어(en/ja) 추가
+- 무엇: `msg_live_room_create_minimum_paid_price` 키의 영어/일본어 리소스 추가 반영 여부를 검증.
+- 왜: 기본(한국어)만 존재하던 최소금액 안내 메시지를 다국어 환경에서도 동일하게 노출하기 위함.
+- 어떻게:
+  - `values-en/strings.xml`, `values-ja/strings.xml`에 동일 키를 생성.
+  - `lsp_diagnostics`로 XML 진단을 시도했으나 현재 환경에서 XML LSP 서버 미설정으로 실행 불가 확인.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - 영어: `The minimum paid live price is 30 cans.`
+  - 일본어: `有料ライブの最低金額は30缶です。`
+  - Gradle: `BUILD SUCCESSFUL`.

docs/plan-task/20260224_프로필SNS오픈채팅전환.md

@@ -0,0 +1,61 @@
+- [x] 1단계: 프로필 SNS 도메인 필드를 `websiteUrl`/`blogUrl`에서 `kakaoOpenChatUrl`로 전환한다.
+  - 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/mypage/profile/ProfileUpdateRequest.kt`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/profile/ProfileResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/profile/ProfileUpdateViewModel.kt`
+- [x] 2단계: 프로필 수정 화면 입력 항목을 `instagram`, `youtube`, `kakaoOpenChatUrl`, `fancimm`, `x` 순서로 정리한다.
+  - 대상 파일: `app/src/main/res/layout/activity_profile_update.xml`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/profile/ProfileUpdateActivity.kt`
+- [x] 3단계: 프로필 수정 화면 문자열 리소스에서 Website/Blog 라벨·힌트를 제거하고 OpenChat 문구를 추가한다.
+  - 대상 파일: `app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`
+- [x] 4단계: 크리에이터/유저 프로필 조회 응답 모델의 SNS 필드 구성을 동일 규격으로 맞춘다.
+  - 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/GetCreatorProfileResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/profile/GetLiveRoomUserProfileResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/GetRoomDetailResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageResponse.kt`
+- [x] 5단계: 프로필 SNS 노출 UI(상세/라이브 상세)에서 Website/Blog 노출 및 클릭 처리를 OpenChat 기준으로 교체한다.
+  - 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/LiveRoomDetailFragment.kt`, `app/src/main/res/layout/fragment_live_room_detail.xml`, `app/src/main/res/layout/layout_user_profile.xml`
+  - 아이콘 점검 파일: `app/src/main/res/drawable-xxhdpi/ic_website_blue.png`, `app/src/main/res/drawable-xxhdpi/ic_blog_blue.png`, `app/src/main/res/drawable-xxhdpi/ic_website_circle.png`, `app/src/main/res/drawable-xxhdpi/ic_blog_circle.png`, `app/src/main/res/drawable-xxhdpi/ic_login_kakao.png`
+- [x] 6단계: 변경 영향 범위 컴파일/테스트를 수행하고 결과를 문서 하단 검증 기록에 누적한다.
+  - 대상 명령: `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`
+- [x] 7단계: 기존 SNS URL 필드 구성 지점에 `fancimmUrl`, `xUrl`를 추가 반영한다.
+  - 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/GetCreatorProfileResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/profile/GetLiveRoomUserProfileResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/GetRoomDetailResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageResponse.kt`
+
+## 검증 기록
+
+### 1) 작업계획 문서 작성
+- 무엇: 프로필 SNS 필드 전환 및 프로필 수정 UI 변경 작업을 단계별 체크리스트로 정의.
+- 왜: 일부만 반영된 상태에서 누락 파일 없이 일관되게 마이그레이션하기 위함.
+- 어떻게:
+  - `websiteUrl`, `blogUrl`, `kakaoOpenChatUrl`, `et_website`, `et_blog` 키워드 기준으로 Kotlin/XML 사용처를 탐색.
+  - 단계별로 실제 수정 후보 파일 경로를 체크리스트에 연결.
+- 결과:
+  - 계획 문서 `docs/20260224_프로필SNS오픈채팅전환.md` 생성 완료.
+  - 구현은 아직 미수행(체크박스 전체 미완료 상태 유지).
+
+### 2) 프로필 SNS 필드/수정 UI 오픈채팅 전환 구현
+- 무엇: SNS 필드 규격을 `instagram`, `youtube`, `kakaoOpenChatUrl`, `fancimm`, `x`로 통일하고 프로필 수정 UI에서 Website/Blog 입력을 제거 후 Open Chat 입력으로 대체.
+- 왜: 서버/클라이언트 모델 및 UI의 SNS 항목을 동일 스펙으로 맞추고, 부분 반영 상태를 해소하기 위함.
+- 어떻게:
+  - 모델/요청/뷰모델(`ProfileUpdateRequest`, `ProfileResponse`, `ProfileUpdateViewModel`)의 `websiteUrl`/`blogUrl` 사용부를 `kakaoOpenChatUrl`로 변경.
+  - 프로필 수정 화면(`activity_profile_update.xml`, `ProfileUpdateActivity.kt`)에서 `et_website`/`et_blog` 제거 후 `et_open_chat` 입력으로 교체.
+  - 조회 응답 모델(`GetCreatorProfileResponse`, `GetLiveRoomUserProfileResponse`, `GetRoomDetailResponse`, `MyPageResponse`) 필드명 통일.
+  - 노출 UI(`fragment_live_room_detail.xml`, `layout_user_profile.xml`)와 클릭 처리(`LiveRoomDetailFragment.kt`)를 오픈채팅 기준으로 변경.
+  - 문자열 리소스(`values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`)에서 Website/Blog 문구 제거 후 Open Chat 문구 추가.
+- 결과:
+  - app/src/main 기준 `websiteUrl`, `blogUrl`, `et_website`, `et_blog`, 관련 문자열 키가 제거되고 `kakaoOpenChatUrl`/`et_open_chat`/`screen_profile_update_open_chat_*` 기준으로 정렬됨.
+
+### 3) 진단/테스트/빌드 검증
+- 무엇: 변경 파일 정합성과 빌드 안정성을 검증.
+- 왜: 필드명/뷰 ID/바인딩 변경으로 인한 컴파일 오류를 사전에 확인하기 위함.
+- 어떻게:
+  - `lsp_diagnostics`를 수정된 Kotlin/XML 파일 전체에 실행 시도.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - LSP: 현재 환경에서 Kotlin/XML LSP 미설정으로 진단 도구 사용 불가(`No LSP server configured for extension: .kt/.xml`).
+  - Gradle: `BUILD SUCCESSFUL` (unit test + debug assemble 통과).
+
+### 4) `fancimmUrl`/`xUrl` 필드 추가 반영
+- 무엇: 기존 SNS URL 필드가 정의된 응답 모델 구간에 `fancimmUrl`, `xUrl`를 추가.
+- 왜: SNS URL 필드 스키마를 모델 간 일관되게 유지하고, 서버 응답 확장 시 누락 파싱을 방지하기 위함.
+- 어떻게:
+  - `GetCreatorProfileResponse.CreatorResponse`, `GetLiveRoomUserProfileResponse`, `GetRoomDetailManager`, `MyPageResponse`에 `@SerializedName("fancimmUrl")`, `@SerializedName("xUrl")` 필드를 추가.
+  - `grep`으로 `fancimmUrl|xUrl` 사용처를 재탐색해 대상 파일에 반영 여부 확인.
+  - `lsp_diagnostics` 실행 시도 후 `./gradlew :app:testDebugUnitTest :app:assembleDebug` 수행.
+- 결과:
+  - 대상 4개 모델 파일에 `fancimmUrl`, `xUrl` 필드 추가 완료.
+  - LSP: Kotlin LSP 미설정으로 진단 도구 사용 불가(`No LSP server configured for extension: .kt`).
+  - Gradle: `BUILD SUCCESSFUL` (unit test + debug assemble 통과).

docs/plan-task/20260225_사용자차단다이얼로그문구수정.md

@@ -0,0 +1,21 @@
+## 작업 개요
+- 사용자 차단 Dialog 문구를 role 분기(`CREATOR`/일반 리스너) 기준으로 요청 문구에 맞게 수정한다.
+
+## 체크리스트
+- [x] 차단 다이얼로그 문구 사용 위치(`MemberProfileDialog`, `strings.xml`) 반영
+- [x] `CREATOR` 문구를 요청 리스트로 교체
+- [x] 일반 리스너 문구를 요청 리스트로 교체
+- [x] role 분기 누락 위치(`UserProfileActivity`) 정합성 반영
+- [x] 국제화 문자열(`values-en`, `values-ja`) 동기화
+- [x] 진단/검증 수행 및 결과 기록
+
+## 검증 기록
+- 일시: 2026-02-25
+- 무엇/왜/어떻게: 사용자 차단 Dialog 문구를 `CREATOR`/일반 리스너 분기로 통일하고, `values`/`values-en`/`values-ja` 국제화 문자열을 동일 의미로 동기화했다. `MemberProfileDialog`의 하드코딩 메시지를 공용 string 리소스로 전환했고 `UserProfileActivity`에도 role 분기를 반영했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: 성공 (BUILD SUCCESSFUL)
+- 실행 명령: `./gradlew :app:lintDebug`
+- 결과: 실패 (기존 lint 이슈) — `app/src/main/AndroidManifest.xml:292`의 `com.facebook.FacebookActivity` MissingClass 포함 총 16 errors, 573 warnings
+- 참고: 현재 실행 환경은 `.kt`/`.xml` LSP 서버가 없어 `lsp_diagnostics`를 사용할 수 없음을 확인했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug` (재검증)
+- 결과: 성공 (BUILD SUCCESSFUL, 53 tasks up-to-date)

docs/plan-task/20260225_채널후원영역및전체보기구현.md

@@ -0,0 +1,70 @@
+# 20260225 채널 후원 영역 및 전체보기 구현
+
+## 작업 목표
+- 크리에이터 채널에 채널 후원 섹션을 추가한다.
+- 채널 후원하기 UI는 라이브 후원하기 UI와 동일한 흐름/스타일을 따른다.
+- 채널 후원 전체보기 페이지를 별도로 추가한다.
+- API 연동은 `/explorer/profile/channel-donation`의 POST/GET 요구사항을 반영한다.
+
+## 구현 체크리스트
+- [x] 기존 라이브 후원 다이얼로그/아이콘/문구 스타일 재사용 지점 확인
+- [x] `ExplorerApi`/`ExplorerRepository`에 채널 후원 POST/GET API 추가
+- [x] `UserProfileViewModel`에 채널 후원 조회/후원하기 액션 추가
+- [x] `kr.co.vividnext.sodalive.explorer.profile.channel_donation` 패키지에 전체보기 Activity/ViewModel/Adapter 생성
+- [x] 크리에이터 채널(`UserProfileActivity`)에 채널 후원 섹션 UI 추가
+- [x] 섹션 상단 `제목 - 전체보기` 및 총 개수 노출
+- [x] 가로 아이템 리스트 폭을 줄여 좌/우 아이템 일부가 보이도록 구성
+- [x] `채널 후원하기` 텍스트 버튼 스타일 적용(배경 `#525252`, radius `16dp`, 흰색 텍스트, 선물 아이콘)
+- [x] 아이템 UI 적용(프로필 이미지, 닉네임, 시간, 내용)
+- [x] `createdAt(UTC)`을 기기 타임존으로 변환해 `OO분전/OO시간전/OO일전` 표시
+- [x] 내용 텍스트에서 `OO캔` 색상 `#FDCA2F`, 나머지 `#CFD8DC`, 글자 크기 `16sp` 적용
+- [x] 문자열/리소스 추가 및 기존 다국어 리소스 반영
+- [x] LSP 진단, 테스트/빌드 실행 및 결과 확인
+
+## 검증 기록
+- 2026-02-25
+  - 무엇/왜/어떻게: 채널 후원 API(POST/GET) 연동, 프로필 채널 후원 섹션 및 후원 버튼(라이브 후원 다이얼로그 재사용), 채널 후원 전체보기 페이지를 추가하고 아이템 시간/문구 스타일을 요구사항대로 반영했다.
+  - 실행 명령: `./gradlew :app:testDebugUnitTest`
+  - 결과: 성공(BUILD SUCCESSFUL), 신규 변경으로 인한 테스트 실패 없음.
+  - 실행 명령: `./gradlew :app:assembleDebug`
+  - 결과: 성공(BUILD SUCCESSFUL), 디버그 빌드 정상 완료.
+  - 참고: 현재 실행 환경의 LSP 도구는 `.kt` 확장 LSP 서버가 구성되어 있지 않아 LSP 진단 대신 Gradle 컴파일/테스트로 정합성을 검증했다.
+
+- 2026-02-25 (후속 요구사항 반영)
+  - 무엇/왜/어떻게: 채널 후원 섹션 위치를 최신 콘텐츠 아래로 이동하고, 프로필 페이지는 `GetCreatorProfileResponse.channelDonationList`만 사용하도록 변경했다. 후원 0건 시 빈 문구 노출/전체보기 숨김, 프로필 페이지 개수 제거, 비밀후원 전달, 채널 후원 메시지 100자 제한, `OO캔을 후원했습니다.` 문구 강조, 라이브룸 채팅 후원과 동일한 배경색 규칙을 적용했다.
+  - 실행 명령: `./gradlew --no-daemon :app:assembleDebug`
+  - 결과: 성공(BUILD SUCCESSFUL), 디버그 빌드 정상 완료.
+  - 실행 명령: `./gradlew --no-daemon :app:testDebugUnitTest`
+  - 결과: 성공(BUILD SUCCESSFUL), 단위 테스트 통과.
+  - 참고: 일반 daemon 모드에서 Kotlin incremental cache 충돌로 실패가 발생해 `--no-daemon`으로 재검증했다.
+
+- 2026-02-25 (힌트 최대 글자수/국제화 및 중복 문구 수정)
+  - 무엇/왜/어떻게: 채널 후원 UI에서는 메시지 힌트를 최대 100자로 표시하도록 변경하고(라이브는 기존 1000 유지), 힌트 문자열을 `%d` 포맷 기반 국제화 리소스로 분리했다. 또한 채널 후원 리스트 문구는 서버 `message` 원문을 그대로 표시하도록 바꿔 `OO캔을 후원했습니다.` 중복이 생기지 않게 수정하고, 원문 안의 `OO캔` 구간만 색상 강조하도록 반영했다.
+  - 실행 명령: `./gradlew --no-daemon :app:testDebugUnitTest`
+  - 결과: 성공(BUILD SUCCESSFUL), 단위 테스트 통과.
+  - 실행 명령: `./gradlew --no-daemon :app:assembleDebug`
+  - 결과: 성공(BUILD SUCCESSFUL), 디버그 빌드 정상 완료.
+  - 참고: 1회 실행에서 리소스 패키징 일시 오류(`NoSuchFileException`)가 있었으나 재실행 시 정상 통과했다.
+
+- 2026-02-25 (채널 후원 아이템 길이 제한/전체보기 터치 동작)
+  - 무엇/왜/어떻게: 채널 후원 아이템에서 긴 메시지로 인한 UI 깨짐을 막기 위해 `message`를 최대 30자 + `...`로 표시하도록 변경했다. 크리에이터 채널 페이지 아이템에는 터치 이벤트를 추가하지 않았고, 채널 후원 전체보기 페이지 아이템은 터치 시 전체 `message`를 다이얼로그로 확인할 수 있게 적용했다.
+  - 실행 명령: `./gradlew --no-daemon :app:assembleDebug`
+  - 결과: 성공(BUILD SUCCESSFUL), 디버그 빌드 정상 완료.
+  - 실행 명령: `./gradlew --no-daemon :app:testDebugUnitTest`
+  - 결과: 성공(BUILD SUCCESSFUL), 단위 테스트 통과.
+  - 참고: 테스트/빌드를 병렬 실행한 1회에서 매니페스트 입력 파일 검증 오류가 발생해 테스트를 단독 재실행하여 통과 확인했다.
+
+- 2026-02-25 (전체보기 아이템 확장 방식 변경)
+  - 무엇/왜/어떻게: 채널 후원 전체 리스트 페이지에서 말줄임표가 붙은 텍스트를 터치했을 때 AlertDialog를 띄우지 않고, 해당 아이템 내부 텍스트를 전체 내용으로 확장해서 표시하도록 변경했다. 크리에이터 채널 페이지는 기존처럼 터치 이벤트를 추가하지 않았다.
+  - 실행 명령: `./gradlew --no-daemon :app:testDebugUnitTest`
+  - 결과: 성공(BUILD SUCCESSFUL), 단위 테스트 통과.
+  - 실행 명령: `./gradlew --no-daemon :app:assembleDebug`
+  - 결과: 성공(BUILD SUCCESSFUL), 디버그 빌드 정상 완료.
+  - 참고: 테스트/빌드 병렬 실행 시 1회 manifest 중간 산출물 누락 오류가 발생해 각각 재실행하여 최종 성공을 확인했다.
+
+- 2026-02-25 (채널 후원 시간 표시 보정)
+  - 무엇/왜/어떻게: 채널 후원 아이템의 상대 시간 표시가 커뮤니티 포스트와 다르게 계산되던 문제를 수정하기 위해 `GetCommunityPostListResponse.relativeTimeText`와 동일한 계산 규칙(방금 전/분/시간/일/개월/년, UTC 파싱 및 로컬 타임존 기준 계산)으로 동기화했다.
+  - 실행 명령: `./gradlew --no-daemon :app:testDebugUnitTest`
+  - 결과: 성공(BUILD SUCCESSFUL), 단위 테스트 통과.
+  - 실행 명령: `./gradlew --no-daemon :app:assembleDebug`
+  - 결과: 성공(BUILD SUCCESSFUL), 디버그 빌드 정상 완료.

docs/plan-task/20260225_크리에이터상세정보다이얼로그구현.md

@@ -0,0 +1,110 @@
+# 크리에이터 상세정보 다이얼로그 구현 계획
+
+## 구현 체크리스트
+- [x] 1단계: 크리에이터 상세정보 다이얼로그 요구사항 및 기존 구현 패턴을 확인한다.
+  - 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/UserProfileActivity.kt`, `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/detail/GetCreatorDetailResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/dialog/MemberProfileDialog.kt`, `app/src/main/res/values/strings.xml`
+- [x] 2단계: `kr.co.vividnext.sodalive.explorer.profile.detail` 패키지에 크리에이터 상세정보 Custom Dialog UI/로직을 구현한다.
+  - 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/detail/*.kt`, `app/src/main/res/layout/*.xml`, `app/src/main/res/drawable/*.xml`
+- [x] 3단계: `UserProfileActivity`에서 `tvNotificationCount` 클릭 시 상세정보 다이얼로그가 표시되도록 연결한다.
+  - 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/UserProfileActivity.kt`, `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/UserProfileViewModel.kt`, `app/src/main/java/kr/co/vividnext/sodalive/explorer/ExplorerApi.kt`, `app/src/main/java/kr/co/vividnext/sodalive/explorer/ExplorerRepository.kt`
+- [x] 4단계: 팔로워 문구를 `팔로워 OO명 · 상세정보 >` 형태로 국제화 문자열에 반영한다.
+  - 대상 파일: `app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`
+- [x] 5단계: 진단/테스트/빌드 검증을 수행하고 문서 하단 검증 기록에 누적한다.
+  - 대상 명령: `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`
+
+## 작업 메모
+- `@docs/20260224_AGENTS문서정비.md`의 제목/섹션 구조를 기준 포맷으로 채택한다.
+- 구현 중 범위 변경 시 체크리스트를 먼저 갱신한 뒤 코드 변경을 진행한다.
+- SNS 아이콘/정렬 정책 추가 반영: `ic_sns_*` 아이콘 사용, 노출 순서 `유튜브 -> 인스타그램 -> 오픈채팅 -> fancimm -> x` 고정.
+
+## 검증 기록
+
+### 1) 계획 문서 포맷 정렬
+- 무엇: 계획 문서를 `제목 -> 구현 체크리스트 -> 작업 메모 -> 검증 기록` 구조로 정렬.
+- 왜: 초기 기준 문서(`docs/20260224_AGENTS문서정비.md`)와 동일한 작성 규칙을 유지하기 위해.
+- 어떻게:
+  - `docs/20260224_AGENTS문서정비.md`의 헤더 구조를 확인.
+  - `docs/20260225_크리에이터상세정보다이얼로그구현.md`에 제목/체크리스트/메모 섹션을 추가 및 정리.
+- 결과: 계획 문서 형식이 기준 문서와 동일한 섹션 구조로 정렬됨.
+
+### 2) 상세정보 다이얼로그 및 문자열 반영
+- 무엇: 크리에이터 상세정보 다이얼로그 구현 및 `tvNotificationCount` 연결, 팔로워 문구 국제화 반영.
+- 왜: 팔로워 수 클릭 시 상세정보 노출 UX와 다국어 문구 요구사항을 충족하기 위해.
+- 어떻게:
+  - `CreatorDetailDialog`/`dialog_creator_detail.xml`/`ic_x_white.xml` 생성.
+  - `ExplorerApi`/`ExplorerRepository`/`UserProfileViewModel`에 크리에이터 상세 API 호출 흐름 추가.
+  - `UserProfileActivity`에서 `tvNotificationCount` 클릭 시 상세 다이얼로그 표시 연결.
+  - `values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`의 팔로워 문구를 `... · ... >` 형태로 변경하고 상세정보 타이틀 문자열 추가.
+- 결과: 요구한 다이얼로그 표시 흐름과 국제화 문자열 반영 완료.
+
+### 3) 진단/테스트/빌드 검증
+- 무엇: 변경 파일 진단 및 단위 테스트/디버그 빌드 수행.
+- 왜: 구현 반영 후 컴파일/리소스/테스트 안정성을 확인하기 위해.
+- 어떻게:
+  - `lsp_diagnostics`를 수정한 Kotlin/XML 파일에 실행 시도.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - LSP: 현재 환경에서 Kotlin/XML LSP 미설정(`No LSP server configured for extension: .kt/.xml`).
+  - Gradle: `BUILD SUCCESSFUL` (unit test + debug assemble 통과).
+
+### 4) 추가 수정 후 재검증
+- 무엇: SNS 항목 확장 반영(`fancimmUrl`, `websiteUrl`, `blogUrl`) 이후 재검증.
+- 왜: 마지막 코드 변경 이후에도 빌드/테스트가 정상인지 확인하기 위해.
+- 어떻게:
+  - `lsp_diagnostics`로 `CreatorDetailDialog.kt` 진단 실행 시도.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 재실행.
+- 결과:
+  - LSP: Kotlin LSP 미설정(`No LSP server configured for extension: .kt`).
+  - Gradle: `BUILD SUCCESSFUL`.
+
+### 5) 최종 변경 반영 후 검증
+- 무엇: SNS 아이템 노출 필드(오픈채팅/인스타그램/유튜브/팬심/X/웹사이트/블로그) 최종 반영 후 재검증.
+- 왜: 마지막 수정 이후에도 테스트/빌드 통과 상태를 보장하기 위해.
+- 어떻게:
+  - `lsp_diagnostics`로 `CreatorDetailDialog.kt` 진단 실행 시도.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - LSP: Kotlin LSP 미설정(`No LSP server configured for extension: .kt`).
+  - Gradle: `BUILD SUCCESSFUL`.
+
+### 6) SNS 순서/아이콘 정책 반영 후 재검증
+- 무엇: SNS 노출 순서를 `유튜브 -> 인스타그램 -> 오픈채팅 -> fancimm -> x`로 고정하고 `ic_sns_*` 아이콘 사용으로 통일.
+- 왜: 추가 요청된 UI 정책을 정확히 반영하기 위해.
+- 어떻게:
+  - `CreatorDetailDialog.kt`의 SNS 리스트 순서와 아이콘 리소스를 `ic_sns_youtube`, `ic_sns_instagram`, `ic_sns_kakao`, `ic_sns_fancimm`, `ic_sns_x`로 수정.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과: `BUILD SUCCESSFUL`.
+
+### 7) 프로필 이미지 1:1 전체 폭 반영 후 재검증
+- 무엇: 상세 다이얼로그 프로필 이미지를 다이얼로그 가로 전체 폭으로 확장하고 1:1 비율로 고정.
+- 왜: 추가 요청된 UI 규격(가로 full + 정사각형 비율)을 충족하기 위해.
+- 어떻게:
+  - `dialog_creator_detail.xml`에서 이미지 블록을 상단 full-width ConstraintLayout으로 분리.
+  - `ImageView`를 `0dp x 0dp` + `app:layout_constraintDimensionRatio="1:1"`로 설정해 가로 기준 정사각형을 강제.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - LSP: XML LSP 미설정(`No LSP server configured for extension: .xml`).
+  - Gradle: `BUILD SUCCESSFUL`.
+
+### 8) 최근 2회 수정 롤백 및 검증
+- 무엇: 직전 2회 수정(라운드/패딩/스크롤 구조 변경, 긴급 표시 수정)을 롤백.
+- 왜: 요청에 따라 최근 2회 수정 내용을 원복하기 위해.
+- 어떻게:
+  - `dialog_creator_detail.xml`을 롤백 전 구조(루트 `wrap_content`, 스크롤 `wrap_content`, 이미지 `0dp/0dp + ratio 1:1`)로 복원.
+  - `CreatorDetailDialog.kt`를 롤백 전 상태(`CircleCropTransformation`, 다이얼로그 높이 `WRAP_CONTENT`, `ivProfile.post` 제거)로 복원.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - LSP: Kotlin/XML LSP 미설정(`No LSP server configured for extension: .kt/.xml`).
+  - Gradle: `BUILD SUCCESSFUL`.
+
+### 9) 라이브 누적 시간 섹션 추가
+- 무엇: `라이브 총 횟수` 아래에 동일 UI 패턴의 `라이브 누적 시간` 섹션을 추가하고 `liveTime` 값을 표시.
+- 왜: 추가 요청된 정보 항목을 동일한 상세정보 구조로 노출하기 위해.
+- 어떻게:
+  - `dialog_creator_detail.xml`에 `ll_section_live_time`, `tv_live_time_title`, `tv_live_time_value` 추가.
+  - `CreatorDetailDialog.kt`에서 `detail.activitySummary.liveTime`을 `moneyFormat()`으로 바인딩.
+  - `values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`에 `screen_creator_detail_live_time` 문자열 추가.
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행.
+- 결과:
+  - LSP: Kotlin/XML LSP 미설정(`No LSP server configured for extension: .kt/.xml`).
+  - Gradle: `BUILD SUCCESSFUL`.

docs/plan-task/20260225_후원UI비밀문구국제화수정.md

@@ -0,0 +1,13 @@
+- [x] 후원 UI 공용 다이얼로그와 호출부에서 문구 분기 지점을 확정한다.
+- [x] 채널 후원에서는 '비밀후원', 라이브 룸에서는 기존 '비밀미션'이 노출되도록 구현한다.
+- [x] 다국어 리소스(values, values-en, values-ja)에 신규 문구를 추가하고 연결한다.
+- [x] 관련 검증(진단/테스트)을 수행하고 결과를 기록한다.
+- [x] 비밀후원 체크 시 메시지 입력창은 체크 전과 동일한 힌트를 유지하도록 수정하고 검증한다.
+
+## 검증 기록
+
+- 무엇/왜/어떻게: Kotlin LSP 진단 가능 여부를 먼저 확인해 수정 파일 정적 진단을 수행하려고 했다. 명령: `lsp_diagnostics(LiveRoomDonationDialog.kt, UserProfileActivity.kt)` 결과: 현 실행 환경에 `.kt` LSP 서버가 설정되어 있지 않아 도구 기반 LSP 진단은 수행 불가 메시지를 확인했다.
+- 무엇/왜/어떻게: 변경으로 인한 회귀를 확인하기 위해 단위 테스트를 전체 실행했다. 명령: `./gradlew :app:testDebugUnitTest` 결과: `BUILD SUCCESSFUL`.
+- 무엇/왜/어떻게: 실제 앱 빌드 가능 여부를 검증하기 위해 디버그 APK 빌드를 수행했다. 명령: `./gradlew :app:assembleDebug` 결과: `BUILD SUCCESSFUL`.
+- 무엇/왜/어떻게: 최종 상태 재검증을 위해 테스트와 빌드를 한 번 더 동시 실행했다. 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug` 결과: `BUILD SUCCESSFUL`.
+- 무엇/왜/어떻게: 비밀후원 체크 시 메시지 힌트가 기본 상태를 유지하도록 로직을 분리한 뒤 회귀를 확인했다. 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug` 결과: `BUILD SUCCESSFUL`.

docs/plan-task/20260226_시리즈상세오류시이전페이지이동.md

@@ -0,0 +1,18 @@
+- [x] SeriesDetailActivity/SeriesDetailViewModel 오류 처리 흐름 확인
+- [x] 시리즈 상세 조회 실패 시 이전 페이지 이동 로직 반영
+- [x] 관련 테스트 실행 및 결과 확인
+
+## 검증 기록
+
+- 일시: 2026-02-26
+- 무엇을/왜: 시리즈 상세 진입 후 `getSeriesDetail` 실패 시 토스트만 노출되고 화면이 유지되어 사용자 요청대로 이전 페이지 복귀가 필요함.
+- 어떻게:
+  - `SeriesDetailViewModel.getSeriesDetail`에 `onFailure` 콜백을 추가하고 실패 분기(`success=false`, `onError`)에서 콜백을 실행하도록 수정.
+  - `SeriesDetailActivity`에서 `viewModel.getSeriesDetail { finish() }` 형태로 호출해 조회 실패 시 이전 페이지로 이동.
+  - `seriesId <= 0` 가드에서 `finish()` 이후 `return`을 추가해 후속 로직 실행 방지.
+- 실행 명령:
+  - `./gradlew :app:testDebugUnitTest && ./gradlew :app:assembleDebug`
+- 결과:
+  - `:app:testDebugUnitTest` 성공
+  - `:app:assembleDebug` 성공
+  - Kotlin LSP 미구성 환경으로 `lsp_diagnostics`는 실행 불가(도구에서 `.kt` 서버 미설정 오류 확인)

docs/plan-task/20260226_채널후원버튼노출조건수정.md

@@ -0,0 +1,9 @@
+- [x] 채널 후원하기 버튼 노출 제어 위치와 내 페이지 판별 조건을 확인한다.
+- [x] 내 페이지일 때 채널 후원하기 버튼이 숨김 처리되도록 수정한다.
+- [x] 관련 검증(진단/테스트/빌드) 결과를 기록한다.
+
+## 검증 기록
+
+- 무엇/왜/어떻게: 채널 후원하기 버튼의 노출 조건을 코드에서 직접 확인했다. `setupChannelDonationView()`에서 `userId == SharedPreferenceManager.userId` 비교로 내 페이지 여부를 판별하고, 내 페이지면 `llChannelDonation`을 `View.GONE` 처리하도록 반영했다.
+- 무엇/왜/어떻게: 수정 파일 정적 진단을 위해 `lsp_diagnostics(UserProfileActivity.kt)`를 실행했다. 현재 환경에 `.kt` LSP 서버가 없어 도구 기반 진단은 수행 불가 메시지를 확인했다.
+- 무엇/왜/어떻게: 회귀 여부 확인을 위해 테스트/빌드를 실행했다. 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug` 결과: `BUILD SUCCESSFUL`.

docs/plan-task/20260304_커뮤니티전체아이템텍스트수정.md

@@ -0,0 +1,32 @@
+# 커뮤니티 전체 아이템 텍스트 수정
+
+## 구현 체크리스트
+- [x] `item_creator_community_all.xml`의 닉네임 글자 크기를 `item_creator_community.xml`과 동일하게 조정
+- [x] `item_creator_community_all.xml`의 date 글자 크기를 `item_creator_community.xml`과 동일하게 조정
+- [x] `item_creator_community_all.xml`의 content 글자 크기를 `item_creator_community.xml`과 동일하게 조정
+- [x] content 길이가 길 때 말줄임표가 보이도록 속성 보강
+- [x] `item_creator_community_all.xml`의 닉네임/date/content fontFamily를 `item_creator_community.xml`과 동일하게 조정
+- [x] 콘텐츠가 여러 줄일 때도 글자 수 제한 초과 시 말줄임표가 보이도록 어댑터 로직 보강
+- [x] 여러 줄 접힘 상태에서 불필요한 스크롤 없이 말줄임표(`...`)가 보이도록 텍스트 처리 로직 보강
+
+## 검증 기록
+- 무엇/왜/어떻게: `item_creator_community_all.xml`에서 `tv_nickname`, `tv_date`, `tv_content`의 `textSize`를 기준 레이아웃과 동일 값으로 조정하고, `tv_content` 폭을 `match_parent`로 변경해 긴 텍스트에서 말줄임표가 동작하도록 보강했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest`
+- 결과: BUILD SUCCESSFUL
+- 실행 명령: `./gradlew :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 진단: XML 파일은 현재 환경에서 LSP 진단 서버 미구성으로 `lsp_diagnostics` 수행 불가(확인 메시지 수신).
+- 무엇/왜/어떻게: `CreatorCommunityAllAdapter`에서 접힘 상태(`isExpand=false`)일 때 콘텐츠를 120자로 잘라 `...`를 붙인 `visibleText`로 표시하도록 수정해, 여러 줄에서도 글자 수 기준 말줄임표가 보이게 했다.
+- 실행 명령: `./gradlew --stop && ./gradlew :app:testDebugUnitTest && ./gradlew :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL (`:app:testDebugUnitTest`, `:app:assembleDebug` 순차 통과)
+- 진단: Kotlin/XML 확장자에 대한 LSP 서버 미구성으로 `lsp_diagnostics`는 수행 불가.
+- 무엇/왜/어떻게: 접힘 상태에서 `LinkMovementMethod`를 해제하고(`movementMethod=null`, `linksClickable=false`) `maxLines=3`, `ellipsize=END`, 120자 절단 텍스트를 적용했다. 펼침 상태에서만 URL span/링크 이동을 활성화해, 긴 여러 줄 콘텐츠에서 스크롤 대신 말줄임표가 우선 동작하도록 분리했다.
+- 실행 명령: `./gradlew --stop && ./gradlew :app:testDebugUnitTest && ./gradlew :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL (`:app:testDebugUnitTest`, `:app:assembleDebug` 순차 통과)
+- 진단: `.kt` 확장자 LSP 서버 미구성으로 `lsp_diagnostics` 수행 불가(환경 메시지 확인).
+- 무엇/왜/어떻게: 후속 요청에 따라 `tv_nickname`, `tv_date`, `tv_content`의 `fontFamily`를 각각 `@font/bold`, `@font/regular`, `@font/regular`로 변경해 기준 레이아웃과 동일하게 맞췄다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest`
+- 결과: BUILD SUCCESSFUL
+- 실행 명령: `./gradlew :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 진단: XML 파일은 현재 환경에서 LSP 진단 서버 미구성으로 `lsp_diagnostics` 수행 불가(확인 메시지 수신).

docs/plan-task/20260305_라이브룸팔로우버튼룩앤필개선.md

@@ -0,0 +1,31 @@
+# 라이브 룸 팔로우/팔로잉 버튼 룩앤필 개선
+
+- [x] 요구사항 정리 및 영향 파일 확인 (`LiveRoomActivity.kt`, `activity_live_room.xml`)
+- [x] 팔로우/팔로잉 관련 기존 구현 및 스타일 패턴 전수 탐색
+- [x] 팔로우 버튼을 텍스트 기반 UI로 변경하고 국제화 문자열 연결
+- [x] 팔로우/팔로잉 상태별 아이콘(`ic_live_creator_follow_plus`, `ic_live_creator_follow_no_alarm`, `ic_live_creator_follow_alarm`) 반영
+- [x] 팔로우 버튼을 하트/후원 캔과 동일 UI 구조(아이콘+텍스트)로 정렬하고 아이콘을 14x14dp로 적용
+- [x] 정적 진단/테스트/빌드 검증 수행 및 결과 기록
+
+## 검증 기록
+
+### 2026-03-05 15:11 (KST)
+- 무엇/왜/어떻게: 라이브룸 상단 우측 팔로우 버튼을 이미지 리소스(`btn_follow_*`) 기반에서 텍스트+아이콘 기반으로 변경해 같은 레벨 버튼(`ll_heart`, `ll_donation`)과 룩앤필을 맞추고, 상태별 아이콘/텍스트를 코드에서 바인딩하도록 수정했다.
+- 전수 탐색: `explore` 2건 + `librarian` 2건 병렬 실행, `grep`/`ast-grep`로 내부 사용처를 확인했다. `rg`는 로컬 환경에서 명령 미설치(`command not found`)로 실행 불가였다.
+- 수정 파일:
+  - `app/src/main/res/layout/activity_live_room.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+  - `docs/20260305_라이브룸팔로우버튼룩앤필개선.md`
+- 실행 명령 및 결과:
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+  - `./gradlew :app:ktlintCheck` -> `:app:ktlintMainSourceSetCheck FAILED` (기존 `LiveRoomActivity.kt` 다수 스타일 위반으로 실패, 이번 변경 라인 외 기존 누적 이슈)
+  - `lsp_diagnostics` -> `.kt`/`.xml` 확장자용 LSP 서버 미구성으로 실행 불가
+
+### 2026-03-05 15:20 (KST) - 추가 요청 반영
+- 무엇/왜/어떻게: 팔로우 버튼을 하트/후원 캔 버튼과 동일한 표시 방식으로 맞추기 위해 `TextView` 단일 구조를 `LinearLayout(아이콘+텍스트)` 구조로 변경하고, 내부 아이콘 `iv_creator_follow_icon` 크기를 `14dp x 14dp`로 고정했다.
+- 수정 파일:
+  - `app/src/main/res/layout/activity_live_room.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+- 실행 명령 및 결과:
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+  - `lsp_diagnostics` -> `.kt`/`.xml` 확장자용 LSP 서버 미구성으로 실행 불가

docs/plan-task/20260305_라이브룸팔로우버튼추가.md

@@ -0,0 +1,14 @@
+# 라이브 룸 팔로우/팔로잉 버튼 추가
+
+## 구현 체크리스트
+- [x] `activity_live_room.xml`에 방장 팔로우/팔로잉 이미지 버튼 위치 추가(참여자 수 영역)
+- [x] `LiveRoomActivity.kt`에 방장 본인 제외 노출 조건 및 팔로우/팔로잉 버튼 상태 처리 추가
+- [x] `UserProfileActivity`의 팔로잉 다이얼로그(`CreatorFollowNotifyFragment`) 패턴을 라이브 룸에 거의 동일하게 적용
+- [x] 관련 뷰모델/리포지토리 팔로우 호출 파라미터 정렬
+- [x] 변경 파일 진단 및 테스트 수행
+
+## 검증 기록
+- (대기) 구현 후 기록 예정
+- 2026-03-05: `./gradlew :app:testDebugUnitTest :app:assembleDebug` 실행, 단위 테스트/디버그 빌드 모두 성공(BUILD SUCCESSFUL).
+- 2026-03-05: `./gradlew :app:ktlintCheck` 실행, 저장소 전반의 기존 규칙 위반(`:app:ktlintMainSourceSetCheck`)으로 실패 확인(이번 변경 파일 한정 이슈 아님).
+- 2026-03-05: Kotlin/XML LSP 진단 도구는 현재 환경에 서버 미구성으로 실행 불가(`No LSP server configured for extension: .kt/.xml`).

docs/plan-task/20260305_종료라이브상대시간국제화적용.md

@@ -0,0 +1,22 @@
+# 종료 라이브 상대시간 국제화 적용
+
+- [x] `GetLatestFinishedLiveResponse`의 `dateUtc`를 기준으로 상대시간 계산 방식 정의 확인
+- [x] `LatestFinishedLiveAdapter`에서 UTC -> 기기 타임존 기준 상대시간 계산 로직 적용
+- [x] `방금 전 / OO분 전 / OO시간 전 / OO일 전` 문자열 국제화 리소스 적용
+- [x] 변경 파일 진단 및 테스트/빌드 검증 수행
+
+## 검증 기록
+
+### 2026-03-05
+- 무엇을: `LatestFinishedLiveAdapter`에서 `item.timeAgo` 직접 노출 대신 `dateUtc`를 UTC로 파싱한 후 기기 타임존 기준 현재 시각과 비교해 `방금 전 / 분 전 / 시간 전 / 일 전` 형태로 표시하도록 변경.
+- 왜: 서버 문자열 의존을 줄이고, 기기 로컬 타임존 기준의 일관된 상대시간 표기 및 다국어 리소스 기반 UI를 적용하기 위해.
+- 어떻게:
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/LatestFinishedLiveAdapter.kt`에 UTC 파싱(`parseDateUtcToMillis`)과 상대시간 계산(`relativeTimeText`) 추가.
+  - `app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`에 `latest_finished_live_time_*` 문자열 추가.
+  - LSP 진단 시도: `.kt`, `.xml` 확장자용 LSP 서버 미구성으로 자동 진단 불가 확인.
+  - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과: `BUILD SUCCESSFUL` (단위 테스트 및 디버그 빌드 성공, 기존 경고만 존재)
+  - 실행 명령: `./gradlew :app:lintDebug`
+  - 결과: `:app:lintDebug FAILED` (기존 이슈로 판단되는 `AndroidManifest.xml`의 `com.facebook.FacebookActivity` MissingClass 포함, 총 16 errors/573 warnings)
+  - 재검증 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 재검증 결과: `BUILD SUCCESSFUL` (어댑터 파싱 패턴 보강 후에도 테스트/빌드 정상)

docs/plan-task/20260305_크리에이터커뮤니티전체보기그리드리스트구현.md

@@ -0,0 +1,48 @@
+# 크리에이터 커뮤니티 전체보기 그리드/리스트 전환 구현
+
+## 구현 체크리스트
+- [x] Toolbar 하단에 좌/우 2탭(왼쪽 List, 오른쪽 Grid) 가로 꽉찬 UI 추가
+- [x] 탭 아이콘 선택/비선택 상태(`ic_community_list*`, `ic_community_grid*`) 반영
+- [x] 기본 초기 화면을 List 모드로 표시
+- [x] Grid 아이템 클릭 시 List 모드로 전환하고 클릭 아이템을 리스트 상단에 표시
+- [x] Grid 클릭으로 진입한 List 상태에서 뒤로가기 시 Grid로 복귀
+- [x] 초기 기본 List 상태에서 뒤로가기 시 Activity 기본 종료 동작 수행
+- [x] Grid 셀 규칙 적용 (이미지 우선, 이미지 없음 시 텍스트 일부, 유료 미구매 시 자물쇠 이미지)
+- [x] Grid 레이아웃 한 줄 3개 고정(`GridLayoutManager` span 3)
+- [x] List/Grid 전환 버벅임 완화를 위해 데이터 재로딩 없이 화면 전환 비용 최소화
+- [x] 탭 배경/하단 라인/선택 인디케이터 디테일 적용
+
+## 검증 기록
+- 무엇/왜/어떻게: `CreatorCommunityAllActivity`에 Grid/List 모드 전환 상태(`isListMode`)를 추가하고, 초기 Grid 표시 -> 아이템 클릭 시 List 전환 -> List 뒤로가기 시 Grid 복귀 흐름을 구현했다. List 스크롤 시 첫 가시 아이템을 앵커로 저장해 Grid 복귀 시 해당 아이템이 보이도록 처리했다.
+- 무엇/왜/어떻게: Grid 전용 `CreatorCommunityAllGridAdapter`와 `item_creator_community_all_grid.xml`을 추가했다. 규칙은 `price > 0 && !existOrdered`면 `ic_lock_bb` 잠금 아이콘, 이미지 URL이 있으면 이미지, 없으면 본문 텍스트 일부(24자) 표시로 분기했다.
+- 무엇/왜/어떻게: 사용자 추가 요청("그리드 리스트 한 줄에 3개 표시")을 반영해 `GridLayoutManager(applicationContext, 3)`로 고정했다.
+- 무엇/왜/어떻게: `activity_creator_community_all.xml`의 RecyclerView 높이를 `0dp + weight 1`로 조정해 Grid/List 모두 화면 높이를 점유하며 스크롤 동작이 안정적으로 유지되도록 보강했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug` (최종 수정 후 재검증)
+- 결과: BUILD SUCCESSFUL
+- 진단: `.kt`, `.xml` 확장자에 대한 LSP 서버가 현재 환경에 미구성되어 `lsp_diagnostics`는 실행 불가(도구 오류 메시지 확인).
+- 무엇/왜/어떻게: `switchToGridMode()`에서 `mediaPlayerManager.pauseContent()` 호출 전에 `::mediaPlayerManager.isInitialized` 가드를 추가해 `lateinit property mediaPlayerManager has not been initialized` 크래시를 방지했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 무엇/왜/어떻게: Grid 아이템 클릭 직후 `onScrolled` 초기 이벤트가 앵커를 0으로 덮어쓰던 문제를 막기 위해, `switchToListMode()`에서 클릭 위치를 `requestedPosition`으로 고정해 해당 위치로 스크롤하도록 수정했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 무엇/왜/어떻게: Grid 셀 자물쇠 아이콘(`iv_grid_lock`)의 크기를 요청사항에 맞춰 `24dp x 24dp`로 조정했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 진단: `.xml` 확장자 LSP 서버가 현재 환경에 없어 `lsp_diagnostics`는 실행 불가(도구 오류 메시지 확인).
+- 무엇/왜/어떻게: `activity_creator_community_all.xml`에 툴바 하단 2탭(좌 List/우 Grid)을 추가하고 각 탭 아이콘을 선택/비선택 리소스로 토글하도록 반영했다.
+- 무엇/왜/어떻게: `CreatorCommunityAllActivity`의 초기 진입 모드를 List로 변경하고, Grid 아이템 클릭으로 List에 들어온 경우에만 뒤로가기를 Grid 복귀로 처리하도록 `isListEnteredFromGridClick` 분기 로직을 추가했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 진단: `.kt`, `.xml` 확장자 LSP 서버가 현재 환경에 미구성되어 `lsp_diagnostics`는 실행 불가(도구 오류 메시지 확인).
+- 무엇/왜/어떻게: 전환 버벅임 완화를 위해 `RecyclerView`를 List/Grid 각각 유지하는 구조로 변경하고, 전환 시 `LayoutManager`/`Adapter` 재할당 대신 `visibility`만 전환하도록 수정했다. 데이터는 기존처럼 `listAdapter`/`gridAdapter`에 동일 소스를 공유해 재요청 없이 유지된다.
+- 무엇/왜/어떻게: `activity_creator_community_all.xml`을 `FrameLayout + rv_creator_community + rv_creator_community_grid` 구조로 바꾸고, `setupRecyclerViews()`에서 두 RecyclerView를 초기 1회만 구성해 전환 비용을 줄였다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 진단: `.kt`, `.xml` 확장자 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가(도구 오류 메시지 확인).
+- 무엇/왜/어떻게: 탭 영역 배경을 `#777777`로 변경하고 탭 하단 전체 라인(`1dp`, `#909090`)을 추가했다. 선택 탭 하단에는 인디케이터(`2dp`, `#FFFFFF`)가 표시되도록 `v_tab_list_indicator`, `v_tab_grid_indicator`를 레이아웃과 `updateTabUi()`에 연결했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL
+- 진단: `.kt`, `.xml` 확장자 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가(도구 오류 메시지 확인).

docs/plan-task/20260306_딥링크스플래시우회및라이브룸확인다이얼로그.md

@@ -0,0 +1,98 @@
+# 딥링크 실행 시 Splash 우회 및 LiveRoom 이동 확인 다이얼로그 구현
+
+- [x] 요구사항 정리 및 영향 범위 확정 (`DeepLinkActivity`, `MainActivity`, `LiveRoomActivity`, `AndroidManifest.xml`, 문자열 리소스)
+- [x] 딥링크 진입/라우팅 및 기존 다이얼로그 패턴 전수 탐색 (내부 검색 + 백그라운드 에이전트 병렬 탐색)
+- [x] 앱 실행 중 딥링크 진입 시 `SplashActivity`를 거치지 않고 `MainActivity`로 직접 라우팅하도록 구현
+- [x] 딥링크 파라미터를 `MainActivity.executeDeeplink`에서 즉시 처리할 수 있도록 전달/파싱 보강
+- [x] `LiveRoomActivity`에서 앱 딥링크 실행 시 "현재 페이지 종료 후 이동" 확인 다이얼로그 추가 (확인 시 이동+현재 화면 종료, 취소 시 유지)
+- [x] 신규 다이얼로그 문구 다국어 문자열(`values`, `values-en`, `values-ja`) 추가
+- [x] 푸시 메시지 클릭 진입도 딥링크와 동일 라우팅 규칙 적용 (실행 중 Splash 우회)
+- [x] 정적 진단/테스트/빌드 실행 후 결과를 검증 기록에 누적
+
+## 검증 기록
+
+### 2026-03-06 14:54 (KST)
+- 무엇/왜/어떻게: 구현 착수 전 요구사항을 작업 단위로 분해하고, 딥링크 진입 경로와 현재 라우팅 구조를 기준으로 변경 포인트를 계획 문서에 확정했다.
+- 전수 탐색: `explore` 3건 + `librarian` 2건 병렬 실행, `grep`/`ast-grep` 수행, `rg`는 로컬 미설치(`command not found`) 확인.
+- 실행 명령 및 결과:
+  - `rg -n --hidden --glob '!**/build/**' "..." app/src/main` -> `command not found`
+  - 나머지 구현 검증 명령은 구현 완료 후 본 문서에 누적 기록 예정
+
+### 2026-03-06 15:08 (KST)
+- 무엇/왜/어떻게: `DeepLinkActivity`에서 앱 foreground 시 `MainActivity`로 직접 전달하도록 분기하고, URL query(`deep_link_value`, `deep_link_sub5`)를 `Constants.EXTRA_DATA`로 매핑해 `MainActivity.executeDeeplink`에서 즉시 처리되게 보강했다. 또한 `LiveRoomActivity` 공지 URL 클릭 시 앱 딥링크인 경우 `LiveDialog` 확인 후 이동/종료하도록 처리했다.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+  - `app/src/main/res/values/strings.xml`
+  - `app/src/main/res/values-en/strings.xml`
+  - `app/src/main/res/values-ja/strings.xml`
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`DeepLinkActivity.kt`, `MainActivity.kt`, `LiveRoomActivity.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck` -> `:app:ktlintMainSourceSetCheck FAILED` (기존 누적 ktlint 위반 다수 + 기존 파일 이슈 포함)
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+
+### 2026-03-06 15:21 (KST)
+- 무엇/왜/어떻게: 푸시 클릭 진입도 딥링크와 동일하게 처리하기 위해 `SodaFirebaseMessagingService`의 PendingIntent 타깃을 `DeepLinkActivity`로 통일하고, 푸시 payload를 `Constants.EXTRA_DATA` 번들(`room_id`, `channel_id`, `message_id`, `audition_id`, `content_id`)로 전달했다. 동시에 `DeepLinkActivity`에서 URI query + `EXTRA_DATA` + 레거시 long extras를 모두 병합 파싱하도록 보강해 warm 상태 Splash 우회 규칙을 푸시에도 적용했다.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/fcm/SodaFirebaseMessagingService.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt`
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`SodaFirebaseMessagingService.kt`, `DeepLinkActivity.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` (최종 수정 후 재실행) -> `BUILD SUCCESSFUL`
+
+### 2026-03-06 15:29 (KST)
+- 무엇/왜/어떻게: LiveRoom 화면 체류 중 외부 딥링크/푸시 탭 시 즉시 이동하지 않도록 `DeepLinkActivity`에서 `LiveRoomActivity.isForeground`를 확인해 확인 요청 브로드캐스트를 보내고 종료하도록 변경했다. `LiveRoomActivity`는 브로드캐스트 수신 시 `LiveDialog` 확인/취소를 표시하며, 확인 시 현재 화면을 종료하고 `MainActivity`로 딥링크 번들(`Constants.EXTRA_DATA`)을 전달해 목적지로 이동하고 취소 시 이동하지 않는다.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/common/Constants.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+
+### 2026-03-06 15:34 (KST)
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`Constants.kt`, `DeepLinkActivity.kt`, `LiveRoomActivity.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> 1차 컴파일 실패(`LiveRoomActivity` companion object 중복)
+  - companion 중복 선언 정리 후 `./gradlew :app:testDebugUnitTest :app:assembleDebug` 재실행 -> `BUILD SUCCESSFUL`
+
+### 2026-03-06 15:43 (KST)
+- 무엇/왜/어떻게: LiveRoom 체류 상태에서 다이얼로그가 누락되는 문제를 수정하기 위해, 브로드캐스트 방식 대신 `DeepLinkActivity`에서 직접 확인 다이얼로그(`AlertDialog`)를 표시하도록 전환했다. 조건은 `SodaLiveApp.isAppInForeground && LiveRoomActivity.isForeground`이며, 확인 시 `MainActivity`로 `Constants.EXTRA_DATA`를 전달해 이동하고, 취소/백키/바깥영역 dismiss 시 `DeepLinkActivity`만 종료되어 이동하지 않는다. 또한 `LiveRoomActivity.isForeground` 판단을 `onStart/onStop` 기준으로 조정해 전환 순간에도 상태가 유지되도록 보강했다.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/common/Constants.kt`
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`DeepLinkActivity.kt`, `LiveRoomActivity.kt`, `Constants.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+
+### 2026-03-06 15:50 (KST)
+- 무엇/왜/어떻게: 사용자 피드백(검은 배경 노출) 반영으로 `AlertDialog` 경유를 제거하고, LiveRoom 화면에서 직접 `SodaDialog`가 뜨도록 플로우를 조정했다. `DeepLinkActivity`는 LiveRoom 활성 시 `Constants.ACTION_LIVE_ROOM_DEEPLINK_CONFIRM` 브로드캐스트만 전송하고 종료하며, `LiveRoomActivity`는 이를 수신해 `SodaDialog`를 표시한다. 확인 시 `MainActivity`로 이동+현재 화면 종료, 취소 시 이동하지 않는다.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/common/Constants.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`DeepLinkActivity.kt`, `LiveRoomActivity.kt`, `Constants.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+
+### 2026-03-06 15:57 (KST)
+- 무엇/왜/어떻게: LiveRoom 확인 다이얼로그 문구를 정적으로 `딥링크 목적지`라고 표시하던 방식에서, 실제 이동 대상 페이지명을 삽입하는 방식으로 변경했다. `LiveRoomActivity.resolveDestinationPageName`에서 `room_id/channel_id/content_id/message_id` 및 `deep_link_value`를 기반으로 목적지명을 결정하고, `SodaDialog` 설명에 `screen_live_room_deeplink_move_message(%1$s)` 포맷으로 주입한다. 예: 콘텐츠 등록 푸시 탭 시 `콘텐츠 상세 페이지`로 이동 문구 표시.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+  - `app/src/main/res/values/strings.xml`
+  - `app/src/main/res/values-en/strings.xml`
+  - `app/src/main/res/values-ja/strings.xml`
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`LiveRoomActivity.kt`, `DeepLinkActivity.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+
+### 2026-03-06 16:01 (KST)
+- 무엇/왜/어떻게: 요청에 따라 문구를 다시 고정 텍스트로 변경했다. 다이얼로그 제목은 `딥링크 이동`에서 `알림`으로 바꾸고, 설명은 `다른 페이지로 이동시 현재 라이브에서 나가게 됩니다.`로 통일했다. 이 변경으로 더 이상 사용되지 않는 목적지명 매핑 코드(`resolveDestinationPageName`, `buildDeepLinkExtrasFromUri`)와 관련 문자열(`screen_live_room_deeplink_target_*`)을 제거했다.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+  - `app/src/main/res/values/strings.xml`
+  - `app/src/main/res/values-en/strings.xml`
+  - `app/src/main/res/values-ja/strings.xml`
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`LiveRoomActivity.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`

docs/plan-task/20260306_유저프로필라이브상세페이지이동수정.md

@@ -0,0 +1,28 @@
+# 유저 프로필 라이브 섹션 아이템 터치 시 상세 페이지 진입으로 수정
+
+- [x] 요구사항 및 영향 범위 확인 (`UserProfileActivity`, `UserProfileLiveAdapter`, 라이브 상세 진입 패턴)
+- [x] 라이브 카드 터치 동작을 즉시 참여/예약 처리 대신 라이브 상세 페이지(`LiveRoomDetailFragment`) 노출로 변경
+- [x] 변경 파일 정적 진단 및 관련 테스트/빌드 실행
+- [x] 검증 결과를 본 문서에 누적 기록
+
+## 검증 기록
+
+### 2026-03-06 17:00 (KST)
+- 무엇/왜/어떻게: 요청사항을 구현 단위로 분해하고, 기존 라이브 리스트 화면(`LiveNowAllActivity`, `LiveReservationAllActivity`)의 카드 터치 시 `LiveRoomDetailFragment`를 띄우는 패턴을 확인했다. 이를 `UserProfileActivity` 라이브 섹션에 동일 적용하기로 결정했다.
+- 실행 명령 및 결과:
+  - `grep` 기반 코드 탐색으로 라이브 상세 진입/콜백 연결 지점 확인 완료
+  - 구현/검증 명령은 변경 후 본 문서에 누적 기록 예정
+
+### 2026-03-06 17:04 (KST)
+- 무엇/왜/어떻게: `UserProfileActivity.setupLiveView`의 `onClickParticipant`/`onClickReservation` 콜백을 직접 참여/예약 처리 대신 `showLiveRoomDetail(roomId)` 호출로 변경했다. `showLiveRoomDetail`에서 `LiveRoomDetailFragment`를 띄우고, 상세 내 액션 버튼만 기존 `enterLiveRoom`/`reservationRoom` 로직을 타도록 연결해 카드 터치 시 즉시 결제/참여가 발생하지 않게 조정했다.
+- 수정 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/UserProfileActivity.kt`
+  - `docs/20260306_유저프로필라이브상세페이지이동수정.md`
+- 실행 명령 및 결과:
+  - `lsp_diagnostics` (`UserProfileActivity.kt`) -> `.kt` 확장자 LSP 서버 미구성으로 실행 불가
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL`
+
+### 2026-03-06 17:06 (KST)
+- 무엇/왜/어떻게: 최종 완료 전 동일 검증 명령을 재실행해 변경사항이 빌드/테스트에 영향을 주지 않는지 재확인했다.
+- 실행 명령 및 결과:
+  - `./gradlew :app:testDebugUnitTest :app:assembleDebug` -> `BUILD SUCCESSFUL` (UP-TO-DATE)

docs/plan-task/20260306_커뮤니티그리드패딩배경동일화.md

@@ -0,0 +1,15 @@
+# 크리에이터 커뮤니티 전체보기 Grid 패딩/배경 동기화
+
+- [x] Grid RecyclerView 상/하 padding을 List와 동일 기준으로 적용
+- [x] Grid 아이템 배경색을 List 아이템 배경색과 동일하게 수정
+- [x] 변경 파일 진단/빌드/테스트 실행 및 결과 기록
+
+## 검증 기록
+
+### 2026-03-06
+- 무엇/왜/어떻게: Grid 상/하 여백과 Grid 아이템 배경색 변경이 기존 프로젝트 기준에서 안전한지 확인하기 위해 진단, 단위 테스트, 디버그 빌드, 린트를 순서대로 실행했다.
+- LSP 진단: `lsp_diagnostics` (`CreatorCommunityAllActivity.kt`) 시도 결과, 현재 실행 환경에 Kotlin LSP 서버가 없어 진단 불가(`No LSP server configured for extension: .kt`).
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: `BUILD SUCCESSFUL` (단위 테스트 통과 및 디버그 빌드 성공).
+- 실행 명령: `./gradlew :app:lintDebug`
+- 결과: 실패. 기존 프로젝트 이슈로 보이는 `AndroidManifest.xml`의 `MissingClass(com.facebook.FacebookActivity)` 포함 다수(18 errors, 577 warnings)로 중단되었고, 이번 변경 파일(`CreatorCommunityAllActivity.kt`, `item_creator_community_all_grid.xml`, `bg_round_corner_5_3_263238.xml`)과 직접 연관된 신규 오류는 로그에서 확인되지 않았다.

docs/plan-task/20260309_DataStore전환및SharedPreferences마이그레이션.md

@@ -0,0 +1,57 @@
+# DataStore 전환 및 SharedPreferences 마이그레이션
+
+- [x] 공식 문서의 DataStore 권고 문구 확인 및 근거 정리
+- [x] 프로젝트 내 SharedPreferences 사용 지점 식별
+- [x] `SharedPreferenceManager`를 DataStore 기반으로 전환
+- [x] `LanguageManager`를 DataStore 기반 읽기/쓰기로 전환
+- [x] 채팅방 `chat_room_prefs`를 DataStore + 마이그레이션으로 전환
+- [x] 앱 초기화 경로에 DataStore 초기화 반영
+- [x] 진단/테스트/빌드 검증 결과 기록
+- [x] 핵심 런타임 회귀 자동 테스트(androidTest) 추가
+
+## 검증 기록
+
+### 2026-03-09
+- 무엇/왜/어떻게: Android 공식 문구를 확인한 뒤, 기본 설정 저장소(`SharedPreferenceManager`)와 채팅방 전용 저장소(`chat_room_prefs`)를 각각 DataStore로 전환하고 `SharedPreferencesMigration`으로 기존 설치 기기의 데이터가 손실 없이 이관되도록 구현했다. 기존 호출부 대량 수정을 피하기 위해 기존 매니저 API를 유지하고 내부 저장소만 교체했다.
+- 공식 문서 근거: "If you're using `SharedPreferences` to store data, consider migrating to DataStore instead." (`App Architecture: Data Layer - DataStore - Android Developers`, https://developer.android.com/topic/libraries/architecture/datastore)
+- 실행 명령: `lsp_diagnostics` (변경 Kotlin 파일 8개)
+- 결과: 현재 실행 환경에 Kotlin LSP 서버가 없어 진단 불가(`No LSP server configured for extension: .kt`).
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: `BUILD SUCCESSFUL` (단위 테스트/디버그 빌드 성공).
+- 실행 명령: Oracle 리뷰(`bg_0bc7de61`)
+- 결과: 리스너 콜백 쓰레드 호환성 리스크(백그라운드 스레드에서 UI 리스너 호출 가능)와 읽기 전용 `SharedPreferences` 뷰의 no-op `edit()` 리스크를 확인했고, `SharedPreferenceManager`에서 메인 스레드 디스패치 및 fail-fast `edit()` 예외 처리로 반영했다.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug` (Oracle 피드백 반영 후 재검증)
+- 결과: `BUILD SUCCESSFUL`.
+- 실행 명령: `./gradlew :app:lintDebug`
+- 결과: 실패. 기존 프로젝트 이슈(`AndroidManifest.xml`의 `MissingClass(com.facebook.FacebookActivity)` 포함 18 errors, 577 warnings)로 중단되었고, 재실행에서도 동일 결과다.
+- 실행 명령: `./gradlew :app:ktlintCheck`
+- 결과: 실패. 기존 코드베이스 전반의 스타일 이슈(다수 파일)로 `:app:ktlintMainSourceSetCheck` 실패.
+- 무엇/왜/어떻게: 요청에 따라 "첫 접근 시 이관" 지점 주석을 추가했다. `AppPreferencesDataStoreProvider`의 `SharedPreferencesMigration` 등록부와 `SharedPreferenceManager`/`ChatRoomPreferenceManager`의 `dataStore.data.first()` 트리거 지점에 주석을 배치해, 언제 이관이 실행되는지 코드를 읽는 즉시 파악할 수 있게 했다.
+- 실행 명령: `./gradlew :app:assembleDebug :app:testDebugUnitTest`
+- 결과: `BUILD SUCCESSFUL`.
+- 무엇/왜/어떻게: 사용자 요청에 맞춰 "전체 일괄 치환" 대신 값 변화 반응 지점과 즉시 사용 안정성이 중요한 지점을 우선 리팩터링했다. `SharedPreferenceManager`/`ChatRoomPreferenceManager` 내부 `runBlocking`을 제거하고 비동기 수집 + 메모리 캐시 기반으로 변경했으며, 기존 `OnSharedPreferenceChangeListener` 의존 화면 4개를 `Flow` 수집으로 전환했다.
+- 반응형 전환 파일: `MainActivity`, `HomeFragment`, `LiveFragment`, `AudioContentPlaylistDetailActivity`에서 `isPlayerServiceRunningFlow`/`roleFlow`를 `repeatOnLifecycle`로 수집해 UI를 갱신하도록 변경.
+- 실행 명령: `./gradlew :app:assembleDebug :app:testDebugUnitTest` (비동기 리팩터링 반영 후)
+- 결과: `BUILD SUCCESSFUL`.
+- 실행 명령: `./gradlew :app:lintDebug` (최종)
+- 결과: 실패. 기존 프로젝트 이슈(`AndroidManifest.xml`의 `MissingClass(com.facebook.FacebookActivity)` 포함 18 errors, 577 warnings)로 동일하게 중단.
+
+### 2026-03-11
+- 무엇/왜/어떻게: 핵심 런타임 회귀 2건을 수정했다. (1) `SharedPreferenceManager`/`ChatRoomPreferenceManager`가 초기 캐시 반영 전에 기본값을 반환하던 문제를 막기 위해 `init()`에서 `dataStore.data.first()`로 초기 스냅샷을 먼저 로딩한 뒤 `initialized`를 설정하도록 조정했다. (2) `repeatOnLifecycle(STARTED)` 재수집 시 미니플레이어가 중복 연결되던 문제를 막기 위해 `MainActivity`/`AudioContentPlaylistDetailActivity`에 `mediaControllerFuture` 가드와 지연 실행 runnable 정리(`removeCallbacks`)를 추가했다.
+- 반영 파일: `SharedPreferenceManager.kt`, `ChatRoomPreferenceManager.kt`, `MainActivity.kt`, `AudioContentPlaylistDetailActivity.kt`.
+- 실행 명령: `lsp_diagnostics` (변경 Kotlin 파일 4개)
+- 결과: 현재 실행 환경에 Kotlin LSP 서버가 없어 진단 불가(`No LSP server configured for extension: .kt`).
+- 실행 명령: `./gradlew --stop && ./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: `BUILD SUCCESSFUL`.
+- 실행 명령: `./gradlew :app:lintDebug`
+- 결과: 실패. 기존 프로젝트 이슈(`AndroidManifest.xml`의 `MissingClass(com.facebook.FacebookActivity)` 포함 18 errors, 577 warnings)로 동일하게 중단.
+- 무엇/왜/어떻게: 수동 재현에 의존하지 않도록 런타임 회귀 자동 검증을 위한 계측 테스트를 추가했다. `DataStoreRuntimeRegressionTest`에서 초기 스냅샷 재초기화 경로를 검증하고, `MiniPlayerConnectionGuardTest`에서 `mediaControllerFuture`가 이미 존재할 때 `connectPlayerService()`가 조기 반환되는 가드를 검증한다. 이를 위해 `androidTest` 실행 환경(`testInstrumentationRunner`, `androidTestImplementation`)을 설정했고, 테스트 재초기화를 위해 `SharedPreferenceManager`/`ChatRoomPreferenceManager`/`AppPreferencesDataStoreProvider`에 `resetForTest()` 훅을 추가했다.
+- 반영 파일: `app/build.gradle`, `AppPreferencesDataStoreProvider.kt`, `SharedPreferenceManager.kt`, `ChatRoomPreferenceManager.kt`, `app/src/androidTest/java/kr/co/vividnext/sodalive/runtime/DataStoreRuntimeRegressionTest.kt`, `app/src/androidTest/java/kr/co/vividnext/sodalive/runtime/MiniPlayerConnectionGuardTest.kt`.
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:assembleDebugAndroidTest`
+- 결과: `BUILD SUCCESSFUL`.
+- 실행 명령: `./gradlew :app:connectedDebugAndroidTest`
+- 결과: `BUILD SUCCESSFUL` (SM-G960N - 10, 4 tests passed).
+- 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+- 결과: `BUILD SUCCESSFUL`.
+- 실행 명령: `./gradlew :app:lintDebug`
+- 결과: 실패. 기존 프로젝트 이슈(`AndroidManifest.xml`의 `MissingClass(com.facebook.FacebookActivity)` 포함 18 errors, 577 warnings)로 동일하게 중단.

docs/plan-task/20260311_ide테스트결과파일gitignore추가.md

@@ -0,0 +1,18 @@
+# 2026-03-11 IDE 테스트 결과 파일 gitignore 추가
+
+## 체크리스트
+- [x] `.idea/androidTestResultsUserPreferences.xml` 파일 성격 확인
+- [x] `.gitignore`에 필요한 ignore 패턴 반영
+- [x] 변경사항 검증 및 결과 기록
+
+## 검증 기록
+- 2026-03-11
+  - 무엇/왜/어떻게: `.idea/androidTestResultsUserPreferences.xml`은 Android Studio의 사용자별 테스트 결과 테이블 상태(컬럼 폭, 로컬 디바이스명) 저장 파일로 확인되어 저장소 공용 추적 대상에서 제외했다.
+  - 실행 명령: `git check-ignore -v .idea/androidTestResultsUserPreferences.xml`
+  - 결과: `.gitignore`의 신규 규칙(`.idea/androidTestResultsUserPreferences.xml`)에 의해 ignore 처리됨을 확인.
+  - 실행 명령: `git status --short`
+  - 결과: 기존 미추적 IDE 파일 노출이 사라지고, 의도한 변경 파일(`.gitignore`, 본 문서)만 상태에 표시됨.
+  - 실행 명령: `./gradlew :app:test && ./gradlew :app:assembleDebug`
+  - 결과: 테스트/빌드 모두 `BUILD SUCCESSFUL`.
+  - 실행 명령: `lsp_diagnostics(.gitignore)`, `lsp_diagnostics(docs/20260311_ide테스트결과파일gitignore추가.md)`
+  - 결과: `.gitignore`는 LSP 미지원 확장자로 진단 불가, 문서 파일은 진단 이슈 없음.

docs/plan-task/20260312_알림리스트구현.md

@@ -0,0 +1,52 @@
+# 2026-03-12 알림 리스트 구현
+
+## 체크리스트
+- [x] 기존 패턴 분석 (Title bar, 카테고리 UI, Home 진입, 딥링크 라우팅)
+- [x] 알림 카테고리/리스트 API 모델 및 네트워크 계층 구현
+- [x] 알림 리스트 화면 UI 구현 (Title bar, Category List, Item List)
+- [x] 무한 스크롤 및 마지막 페이지/빈 데이터 처리 구현
+- [x] 알림 아이템 터치 시 deepLink 실행 및 Path 딥링크 보완
+- [x] HomeFragment의 `ic_push_notification` 진입 연결
+- [x] 검증 수행 및 결과 기록
+
+## 검증 기록
+- 2026-03-12
+  - 무엇/왜/어떻게: 작업 시작 전 기존 코드 패턴과 요구사항 반영 지점을 확인해 구현 범위를 고정했다.
+  - 실행 명령: `background_output(task_id="bg_0688c56d")`, `background_output(task_id="bg_d0442733")`, `background_output(task_id="bg_db96f80d")`
+  - 결과: Title bar/카테고리 패턴, 기존 딥링크 분기, Home 진입점 누락 상태를 확인했다.
+- 2026-03-12
+  - 무엇/왜/어떻게: 알림 리스트 구현 변경분의 빌드/테스트/코드스타일 상태를 최종 확인해 배포 전 기본 안정성을 검증했다.
+  - 실행 명령: `./gradlew :app:assembleDebug :app:testDebugUnitTest :app:ktlintCheck`
+  - 결과: `BUILD SUCCESSFUL`.
+- 2026-03-12
+  - 무엇/왜/어떻게: 수정 파일 정적 진단 수행 가능 여부를 확인했다.
+  - 실행 명령: `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListViewModel.kt")`, `lsp_diagnostics(filePath="app/src/main/res/layout/activity_push_notification_list.xml")`
+  - 결과: 현재 실행 환경에서 `.kt`, `.xml` LSP 서버가 미구성되어 진단을 수행할 수 없음을 확인했다.
+- 2026-03-12
+  - 무엇/왜/어떻게: 작업 트리 상태를 확인해 리네임 과정의 인덱스 흔적 유무를 점검했다.
+  - 실행 명령: `git status --short`
+  - 결과: `home/push_notification` 경로에 `AD` 인덱스 흔적이 남아 있어 커밋 전 스테이징 정리가 필요함을 확인했다.
+- 2026-03-12
+  - 무엇/왜/어떻게: 카테고리 리스트의 앱 내 `전체` 주입을 제거하고 서버 조회 카테고리만 사용하도록 로직을 축소했다.
+  - 실행 명령: `grep(pattern="allCategoryLabel|screen_home_theme_all|categoryAdapter.addItems\\(listOf", path="app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListActivity.kt")`
+  - 결과: `PushNotificationListActivity`에서 `allCategoryLabel` 기반 주입/비교 로직이 제거되고, 서버 응답 `categories`를 그대로 바인딩하도록 반영되었다.
+- 2026-03-12
+  - 무엇/왜/어떻게: 수정 파일 정적 진단과 빌드/테스트/코드스타일 검증을 재실행해 변경 안정성을 확인했다.
+  - 실행 명령: `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListActivity.kt")`, `lsp_diagnostics(filePath="docs/20260312_알림리스트구현.md")`, `./gradlew :app:assembleDebug :app:testDebugUnitTest :app:ktlintCheck`
+  - 결과: `.kt` LSP 서버 미구성으로 Kotlin 진단은 불가, Markdown 진단은 이슈 없음, Gradle 검증은 `BUILD SUCCESSFUL`.
+- 2026-03-12
+  - 무엇/왜/어떻게: 서버 카테고리만 사용하면서 기본 선택을 첫 번째 카테고리로 고정하도록 초기 선택 흐름을 조정했다.
+  - 실행 명령: `grep(pattern="selectCategory\\(null\\)|isInitialCategorySelected|setSelectedTheme", path="app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListActivity.kt")`, `./gradlew :app:assembleDebug :app:testDebugUnitTest :app:ktlintCheck`
+  - 결과: 앱 내 `전체` 기본 선택 호출을 제거하고 서버 카테고리 첫 항목 선택 로직을 반영했으며, Gradle 검증은 `BUILD SUCCESSFUL`.
+- 2026-03-12
+  - 무엇/왜/어떻게: 최초 진입 시 카테고리 조회/선택 과정에서 알림 리스트 API가 2회 호출될 가능성이 있는지 호출 경로를 정적 분석으로 점검했다.
+  - 실행 명령: `background_output(task_id="bg_061507b7")`, `background_output(task_id="bg_23070c8e")`, `grep(pattern="getPushNotificationList\\(|selectCategory\\(|categoryListLiveData.observe\\(|onScrolled\\(", path="app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification")`, `ast_grep_search(pattern="fun getPushNotificationList() { $$$ }", lang="kotlin", paths=["app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification"])`
+  - 결과: 최초 진입 경로에서는 `categoryListLiveData` 수신 후 `isInitialCategorySelected` 가드로 첫 카테고리 선택이 1회만 실행되고, `getPushNotificationList`는 `_isLoading`/`isLastPage` 가드로 재진입이 차단되어 2회 호출 버그 재현 경로가 확인되지 않았다.
+- 2026-03-12
+  - 무엇/왜/어떻게: `totalCount`는 정상인데 `items`가 빈 현상에 대해 파싱 모델/인프라/페이징 전달을 교차 점검했고, 저장소 전반의 페이지 규칙(`page=1` 시작 후 API 전달 시 `page-1`)과 달리 push notification만 보정이 누락된 점을 수정했다.
+  - 실행 명령: `background_output(task_id="bg_097b64e0")`, `background_output(task_id="bg_c31bdfb5")`, `grep(pattern="page = page - 1|fun getPushNotificationList\\(", path="app/src/main/java/kr/co/vividnext/sodalive/user/UserRepository.kt")`, `grep(pattern="page = page - 1", path="app/src/main/java", output_mode="content")`
+  - 결과: `UserRepository.getPushNotificationList`에 `page = page - 1` 보정을 반영해 다른 페이징 API와 동일 규칙으로 정렬했다.
+- 2026-03-12
+  - 무엇/왜/어떻게: 페이지 인덱스 보정 변경 후 컴파일/테스트/코드스타일 검증을 재실행했다.
+  - 실행 명령: `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/user/UserRepository.kt")`, `lsp_diagnostics(filePath="docs/20260312_알림리스트구현.md")`, `./gradlew :app:assembleDebug :app:testDebugUnitTest :app:ktlintCheck`
+  - 결과: `.kt` LSP 서버 미구성으로 Kotlin 진단은 불가, Markdown 진단은 이슈 없음, Gradle 검증은 `BUILD SUCCESSFUL`.

docs/plan-task/20260313_알림수신설정페이지개발.md

@@ -0,0 +1,38 @@
+# 2026-03-13 알림 수신 설정 페이지 개발
+
+## 완료 기준
+- [x] 알림 리스트 우측 상단 이미지(`iv_settings`) 터치 시 신규 알림 수신 설정 페이지로 이동한다.
+- [x] 신규 페이지는 기존 알림 설정 페이지를 대체하지 않고 별도 Activity로 생성된다.
+- [x] 페이지는 `서비스 알림` + `팔로잉 채널` 2개 섹션이며 전체가 하나의 스크롤로 동작한다.
+- [x] `서비스 알림` 섹션 UI/토글 액션은 기존 `NotificationSettingsActivity`와 동일하게 동작한다.
+- [x] `팔로잉 채널` 섹션 UI는 기존 팔로잉 리스트와 동일하며 무한 스크롤로 20개씩 로드한다.
+
+## 체크리스트
+- [x] 기존 진입/재사용 패턴 분석
+- [x] 신규 알림 수신 설정 Activity/ViewModel/Layout 구현
+- [x] 서비스 알림 토글 액션 기존 로직과 동일하게 연결
+- [x] 팔로잉 채널 리스트(20개 페이징/무한 스크롤) 연결
+- [x] 알림 리스트 우측 상단 이미지 진입 연결
+- [x] 검증(진단/테스트/빌드) 수행 및 기록
+
+## 검증 기록
+- 2026-03-13
+  - 무엇/왜/어떻게: 작업 시작 전 요구사항을 완료 기준으로 고정하고 구현 체크리스트를 문서화했다.
+  - 실행 명령: `glob(pattern="docs/*.md", path="/Users/klaus/Develop/sodalive/Android/SodaLive")`, `read(filePath="/Users/klaus/Develop/sodalive/Android/SodaLive/docs/20260312_알림리스트구현.md")`
+  - 결과: 기존 문서 형식을 확인하고 신규 계획 문서를 생성했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 알림 리스트 진입점과 재사용 가능한 알림/팔로잉 구현 패턴을 교차 확인해 신규 화면 구성 근거를 확보했다.
+  - 실행 명령: `background_output(task_id="bg_8f327a73")`, `background_output(task_id="bg_d549966d")`, `read(filePath="/Users/klaus/Develop/sodalive/Android/SodaLive/app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListActivity.kt")`, `read(filePath="/Users/klaus/Develop/sodalive/Android/SodaLive/app/src/main/java/kr/co/vividnext/sodalive/settings/notification/NotificationSettingsActivity.kt")`, `read(filePath="/Users/klaus/Develop/sodalive/Android/SodaLive/app/src/main/java/kr/co/vividnext/sodalive/following/FollowingCreatorActivity.kt")`
+  - 결과: `iv_settings` 클릭 미연결 상태를 확인했고, 토글/팔로잉 리스트 패턴 및 페이징 구조를 신규 화면에 반영했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 신규 화면/연결 코드의 정적 진단 가능 여부를 확인했다.
+  - 실행 명령: `lsp_diagnostics(filePath="/Users/klaus/Develop/sodalive/Android/SodaLive/app/src/main/java/kr/co/vividnext/sodalive/settings/notification/NotificationReceiveSettingsActivity.kt")`, `lsp_diagnostics(filePath="/Users/klaus/Develop/sodalive/Android/SodaLive/app/src/main/java/kr/co/vividnext/sodalive/settings/notification/NotificationReceiveSettingsViewModel.kt")`, `lsp_diagnostics(filePath="/Users/klaus/Develop/sodalive/Android/SodaLive/app/src/main/res/layout/activity_notification_receive_settings.xml")`
+  - 결과: 현 환경은 `.kt`, `.xml` LSP 서버 미구성으로 진단 실행이 불가함을 확인했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 구현 변경분의 컴파일/테스트/코드스타일 상태를 검증해 배포 전 안정성을 확인했다.
+  - 실행 명령: `./gradlew :app:assembleDebug :app:testDebugUnitTest :app:ktlintCheck`
+  - 결과: `BUILD SUCCESSFUL`.
+- 2026-03-13
+  - 무엇/왜/어떻게: 연결된 단말에서 수동 실행 가능성을 점검했다.
+  - 실행 명령: `adb devices`, `./gradlew :app:installDebug`, `adb shell am start -W -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.settings.notification.NotificationReceiveSettingsActivity`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.settings.notification.NotificationReceiveSettingsActivity`
+  - 결과: APK 설치는 성공했고, 쉘 직접 실행은 non-exported Activity 정책으로 차단됨을 확인했다. 내부 네비게이션(`PushNotificationListActivity`의 `iv_settings`)을 통한 진입은 앱 내 수동 확인이 필요하다.

docs/plan-task/20260313_예약라이브알림딥링크분기수정.md

@@ -0,0 +1,40 @@
+# 20260313 예약라이브알림딥링크분기수정
+
+## 작업 체크리스트
+- [x] 알림 리스트/푸시/딥링크 라이브 라우팅 경로에서 예약 라이브 분기 위치를 정리한다.
+- [x] 예약 라이브는 라이브 상세 페이지, 진행 중 라이브는 즉시 입장하도록 분기 로직을 반영한다.
+- [x] 라이브룸 입장 상태에서 푸시/딥링크 실행 시 이동 확인 팝업 로직이 동일하게 동작하는지 점검하고 보정한다.
+- [x] 관련 소스 LSP 진단, 단위 테스트, 빌드로 검증한다.
+- [x] 검증 기록을 본 문서 하단에 누적한다.
+
+## 검증 기록
+- 무엇: 예약 라이브 딥링크가 `LiveRoomActivity`로 직행해 크래시를 유발하는 경로를 우회하고, `MainActivity -> LiveFragment.enterLiveRoom` 경로로 통일해 예약/진행중 상태를 내부 상세 조회로 판별하도록 수정했다.
+  왜: 예약 라이브는 라이브 상세가 열려야 하고, 진행중 라이브만 즉시 입장해야 하기 때문이다.
+  어떻게: `DeepLinkActivity`의 foreground 라우팅(`room_id`, `deep_link_value=live`)을 `MainActivity` 전달 방식으로 변경하고, `MainActivity.executeBundleRoute`에서 room 진입을 `enterLiveRoom` 단일 경로로 정리했다.
+
+- 무엇: 라이브룸 화면에서 푸시/딥링크 실행 시 이동 확인 팝업 흐름 유지 여부를 점검했다.
+  왜: 라이브 입장 중에는 즉시 화면 전환 대신 사용자 확인이 필요하다.
+  어떻게: `LiveRoomActivity`의 `ACTION_LIVE_ROOM_DEEPLINK_CONFIRM` 수신 -> `showDeepLinkNavigationDialog` -> `MainActivity` 전달 흐름이 그대로 유지되는지 코드 경로를 확인했다.
+
+- 무엇: 정적 진단/테스트/빌드를 수행했다.
+  왜: 변경으로 인한 회귀 여부를 확인하기 위해서다.
+  어떻게/결과:
+  - `lsp_diagnostics` (`DeepLinkActivity.kt`, `MainActivity.kt`): Kotlin LSP 서버 미설정으로 도구 실행 불가(환경 제약).
+  - `./gradlew :app:testDebugUnitTest`: 성공.
+  - `./gradlew :app:assembleDebug`: 성공.
+
+- 무엇: Oracle 리뷰에서 발견된 라우팅 누락 가능성/오분기 가능성을 보완했다.
+  왜: `deep_link`가 있는 경우 원본 번들 fallback 누락과 `channelName` 빈 문자열 케이스가 실제 알림 라우팅 누락/오분기를 만들 수 있기 때문이다.
+  어떻게: `MainActivity.executeBundleDeeplink`에서 `deepLinkBundle ?: bundle` fallback으로 수정했고, `LiveFragment.enterLiveRoom` 분기 조건을 `channelName.isNullOrBlank()` 기준으로 정리했다.
+
+- 무엇: 디바이스 수동 검증(ADB)으로 foreground 딥링크 경로를 확인했다.
+  왜: 변경된 foreground 경로가 `LiveRoomActivity` 직행이 아닌 `MainActivity` 경유로 동작하는지 확인하기 위해서다.
+  어떻게/결과:
+  - `./gradlew :app:installDebug`: 성공(실기기 설치 완료).
+  - `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`: 앱 실행 성공.
+  - `adb shell am start -W -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.main.DeepLinkActivity -a android.intent.action.VIEW -d "voiceon://live/1"`: `Activity: ...MainActivity` 확인.
+  - `adb shell dumpsys activity activities | grep mResumedActivity`: `...MainActivity` 확인.
+
+- 무엇: 라이브룸 입장 중 확인 팝업 로직은 코드 경로로 재검증했다.
+  왜: 로컬브로드캐스트 기반이라 ADB로 직접 이벤트 주입이 어렵기 때문이다.
+  어떻게/결과: `DeepLinkActivity`의 `ACTION_LIVE_ROOM_DEEPLINK_CONFIRM` 송신과 `LiveRoomActivity`의 다이얼로그 후 `MainActivity` 이동 경로가 변경 없이 유지됨을 확인했다.

docs/plan-task/20260313_커뮤니티댓글알림딥링크포스트아이디연결구현.md

@@ -0,0 +1,76 @@
+# 2026-03-13 커뮤니티 댓글 알림 딥링크 postId 연결 구현 계획
+
+## 요구사항 정리
+- 입력 패턴: `$uriScheme://community/$creatorId?postId=$postId`
+- 목표 동작: `path=community`이고 `postId` 쿼리가 존재하면 `CreatorCommunityAllActivity`로 이동한 뒤 해당 게시물의 댓글 리스트를 즉시 노출한다.
+- 범위: 앱 내부 딥링크 파싱/라우팅/커뮤니티 화면 진입 동작만 다루며, 서버 API 스키마와 푸시 발송 규격 변경은 포함하지 않는다.
+
+## 완료 기준
+- [x] `DeepLinkActivity.buildDeepLinkExtras`에서 `postId` 쿼리를 파싱해 `Constants.EXTRA_COMMUNITY_POST_ID`로 보존한다.
+- [x] `MainActivity.buildBundleFromDeepLinkUrl`에서도 동일하게 `postId`를 파싱해 cold start 경로와 foreground 경로의 동작을 일치시킨다.
+- [x] `DeepLinkActivity.routeForegroundDeepLink`와 `MainActivity.executeBundleRoute`의 community 분기에서 `EXTRA_COMMUNITY_CREATOR_ID`와 `EXTRA_COMMUNITY_POST_ID`를 함께 전달한다.
+- [x] `CreatorCommunityAllActivity`가 `EXTRA_COMMUNITY_POST_ID`를 수신하면 대상 게시물을 찾은 뒤 댓글 바텀시트(`CreatorCommunityCommentFragment`)를 자동으로 띄운다.
+- [x] 대상 게시물이 첫 페이지에 없을 수 있으므로 페이징 로드 완료(`isLast`)까지 탐색 후 미발견 시 안전하게 fallback(일반 커뮤니티 목록 유지 + 사용자 안내)한다.
+- [x] 변경 파일 기준 정적 진단/단위 테스트/디버그 빌드 검증을 완료하고 결과를 문서 하단 검증 기록에 누적한다.
+
+## 작업 체크리스트
+- [x] 딥링크 파라미터 매핑 확장
+  - [x] `DeepLinkActivity.kt`의 query 파싱 키 목록에 `postId` 추가
+  - [x] `MainActivity.kt`의 query 파싱 키 목록에 `postId` 추가
+  - [x] `postId -> Constants.EXTRA_COMMUNITY_POST_ID` 매핑 규칙을 두 파일에 동일하게 반영
+- [x] community 라우팅 인텐트 확장
+  - [x] `CreatorCommunityAllActivity` 호출 시 creatorId/postId 동시 전달
+  - [x] 포그라운드 라우팅과 앱 재실행 라우팅의 동작 일관성 검증
+- [x] 커뮤니티 화면 자동 댓글 오픈 처리
+  - [x] `CreatorCommunityAllActivity`에 목표 `postId` 상태(1회성 플래그 포함) 추가
+  - [x] 목록 수신 시 target `postId` 존재 여부 확인 후 댓글 바텀시트 자동 오픈
+  - [x] 미발견 시 다음 페이지 로드 트리거 및 `isLast` 도달 시 graceful fallback
+- [x] 회귀 방지 검증
+  - [x] community 외 기존 딥링크(`live`, `content`, `series`, `message`, `audition`) 경로 영향 점검
+  - [x] 푸시 경유(`SodaFirebaseMessagingService`)와 직접 URL 실행(`Intent.ACTION_VIEW`) 모두 동작 확인
+
+## 예상 영향 파일
+- `app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/creator_community/all/CreatorCommunityAllActivity.kt`
+
+## 검증 계획
+- `./gradlew :app:testDebugUnitTest`
+- `./gradlew :app:assembleDebug`
+- 필요 시 `./gradlew :app:ktlintCheck`
+
+## 외부 레퍼런스(구현 기준)
+- Android Intent/Filter 가이드: `https://developer.android.com/guide/components/intents-filters`
+- Android `<data>` element 가이드: `https://developer.android.com/guide/topics/manifest/data-element`
+- Android App Links 가이드: `https://developer.android.com/training/app-links`
+- Navigation deep link 가이드: `https://developer.android.com/guide/navigation/navigation-deep-link`
+
+## 검증 기록
+- 2026-03-13
+  - 무엇/왜/어떻게: 커뮤니티 댓글 알림 딥링크 구현 계획에 필요한 내부 라우팅 근거를 확보하기 위해 딥링크/커뮤니티/댓글/푸시 경로를 저장소 전역에서 탐색했다.
+  - 실행 명령: `grep(pattern="postId|community|deeplink|intent-filter|uriScheme|scheme", include="*.{kt,kts,xml,md}")`, `grep(pattern="getQueryParameter|Uri\\.parse|intent\\.data|ACTION_VIEW", include="*.{kt,kts,xml}")`, `ast_grep_search(pattern="Uri.parse($URL)", lang="kotlin")`, `ast_grep_search(pattern="$URI.getQueryParameter($NAME)", lang="kotlin")`, `rg ...` 시도
+  - 결과: 핵심 경로를 `DeepLinkActivity`/`MainActivity`/`SodaFirebaseMessagingService`/`CreatorCommunityAllActivity`로 특정했고, 현재 community 딥링크는 creatorId만 전달하며 `postId`는 파싱/전달하지 않음을 확인했다. 또한 실행 환경에 `rg` 바이너리가 없어 `command not found: rg`가 발생했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 공식 문서 및 OSS 예시를 기반으로 안전한 딥링크 파라미터 처리 계획을 보강하기 위해 librarian 탐색 결과를 수집했다.
+  - 실행 명령: `task(subagent_type="librarian", run_in_background=true, ...)` 2건 수행 후 `session_read(session_id=...)`로 결과 수집
+  - 결과: Android 공식 딥링크/App Links 가이드와 쿼리 파라미터 처리 예시를 확보했고, 계획 문서의 구현 기준/검증 항목에 반영했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 계획 문서 기준 구현을 위해 community 딥링크 파싱/라우팅/화면 자동 댓글 오픈 경로를 수정했다.
+  - 실행 명령: `git diff -- app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/creator_community/all/CreatorCommunityAllActivity.kt`
+  - 결과: `postId` 쿼리(`postId`)를 `Constants.EXTRA_COMMUNITY_POST_ID`로 맵핑하고, community 이동 인텐트에 함께 전달되며, 커뮤니티 화면에서 target post의 댓글 바텀시트를 자동 오픈하도록 반영했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 수정 파일 정적 진단 가능 여부와 회귀를 점검했다.
+  - 실행 명령: `lsp_diagnostics(DeepLinkActivity.kt/MainActivity.kt/CreatorCommunityAllActivity.kt)`, `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과: Kotlin LSP 서버 미구성으로 `.kt` 진단은 불가했으며, Gradle 검증은 `BUILD SUCCESSFUL`.
+- 2026-03-13
+  - 무엇/왜/어떻게: 수동 딥링크 실행으로 실제 인텐트 라우팅 경로를 확인했다.
+  - 실행 명령: `adb devices`, `./gradlew :app:installDebug`, `adb shell am start -a android.intent.action.VIEW -d "voiceon://community/1?postId=1"`, `adb shell dumpsys activity activities`
+  - 결과: 단말 연결/설치 성공 후 `voiceon://community/1?postId=1` 인텐트가 앱 `DeepLinkActivity`로 전달되고 `SplashActivity` 경유 태스크로 진입하는 것을 확인했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 구현 누락 여부를 줄이기 위해 Oracle 리뷰를 수행하고 지적된 분기 불일치/누락을 보정했다.
+  - 실행 명령: `task(subagent_type="oracle", run_in_background=false, ...)`, `git diff -- app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/creator_community/all/CreatorCommunityAllActivity.kt`
+  - 결과: `MainActivity`에 `deep_link_value/deep_link_sub5` 승격 로직을 추가해 cold start 경로를 정렬했고, `CreatorCommunityAllActivity`의 마지막 페이지 fallback 트리거 보완 및 invalid creator 조기 반환을 반영했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: Oracle 보정 반영 후 회귀 여부를 다시 확인했다.
+  - 실행 명령: `lsp_diagnostics(DeepLinkActivity.kt/MainActivity.kt/CreatorCommunityAllActivity.kt)`, `./gradlew :app:testDebugUnitTest :app:assembleDebug`, `adb shell am start -a android.intent.action.VIEW -d "voiceon://community/1?postId=1" && adb shell dumpsys activity activities`
+  - 결과: Kotlin LSP 서버 미구성으로 `.kt` 진단은 불가했고, Gradle은 `BUILD SUCCESSFUL`, ADB 수동 검증에서 딥링크 인텐트(`voiceon://community/1?postId=1`)가 `DeepLinkActivity` 인텐트로 전달됨을 재확인했다.

docs/plan-task/20260313_푸시메시지터치딥링크우선처리.md

@@ -0,0 +1,44 @@
+# 2026-03-13 푸시 메시지 터치 딥링크 우선 처리
+
+## 체크리스트
+- [x] 기존 푸시 터치/딥링크 라우팅 경로 분석
+- [x] 푸시 터치 시 `deep_link` 비어있지 않으면 딥링크 우선 실행, 비어 있으면 기존 로직 유지
+- [x] 앱 실행 중 딥링크 실행 시 메인 페이지 호출 없이 현재 페이지에서 목적지로 이동하도록 수정
+- [x] 앱 미실행 후 `MainActivity` 진입 로직에도 동일한 `deep_link` 우선 분기 반영
+- [x] `deep_link` 존재 시 번들에 `deep_link`만 넣고, 미존재 시 fallback(`room_id` 등)만 넣도록 상호배타 분기 적용
+- [x] `MainActivity` 딥링크/푸시 처리에서도 `deep_link` 존재 시 fallback과 병합하지 않도록 상호배타 분기 적용
+- [x] 정적 진단/빌드/테스트 및 결과 기록
+
+## 검증 기록
+- 2026-03-13
+  - 무엇/왜/어떻게: 작업 착수 전 요구사항에 맞는 푸시 터치/딥링크 처리 지점을 찾기 위해 코드베이스 탐색을 시작했다.
+  - 실행 명령: `grep(pattern="deep_link|deeplink|deepLink", path=".", include="*.{kt,kts,xml,java}")`, `grep(pattern="FirebaseMessagingService|notification|push|PendingIntent|MainActivity", path=".", include="*.{kt,java,xml}")`
+  - 결과: `SodaFirebaseMessagingService`, `MainActivity`, `DeepLinkActivity`를 핵심 수정 후보로 확인했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 푸시 탭 시 raw `deep_link` 유무로 분기하기 위해 FCM payload 전달/포그라운드 라우팅/MainActivity 파싱 로직을 함께 수정했다.
+  - 실행 명령: `git diff -- app/src/main/java/kr/co/vividnext/sodalive/fcm/SodaFirebaseMessagingService.kt app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt`
+  - 결과: `deep_link` 전달(`SodaFirebaseMessagingService`) + 포그라운드 직접 이동 분기(`DeepLinkActivity`) + cold start 시 `MainActivity`의 `deep_link` 우선 파싱 분기가 반영됨을 확인했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 수정 파일 정적 진단 가능 여부를 확인했다.
+  - 실행 명령: `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/fcm/SodaFirebaseMessagingService.kt")`, `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/main/DeepLinkActivity.kt")`, `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt")`
+  - 결과: 현재 실행 환경에서 Kotlin(`.kt`) LSP 서버가 미구성되어 진단을 수행할 수 없음을 확인했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 변경으로 인한 컴파일/단위테스트 회귀 여부를 확인하기 위해 Debug 빌드와 단위 테스트를 실행했다.
+  - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과: `BUILD SUCCESSFUL`.
+- 2026-03-13
+  - 무엇/왜/어떻게: `deep_link`와 fallback 파라미터가 섞이지 않도록 FCM 번들 생성을 상호배타 분기로 변경했다.
+  - 실행 명령: `grep(pattern="val deepLinkExtras = if \(!deepLinkUrl.isNullOrBlank\(\)\)|putString\(\"deep_link\"|messageData\[\"room_id\"\]", path="app/src/main/java/kr/co/vividnext/sodalive/fcm/SodaFirebaseMessagingService.kt", output_mode="content")`
+  - 결과: `deep_link` 존재 시 `putString("deep_link", deepLinkUrl)`만 수행하고, fallback 필드(`room_id` 등)는 else 블록에서만 채워지도록 분리가 확인되었다.
+- 2026-03-13
+  - 무엇/왜/어떻게: 상호배타 분기 변경 이후 컴파일/테스트 회귀 여부를 재검증했다.
+  - 실행 명령: `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/fcm/SodaFirebaseMessagingService.kt")`, `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과: Kotlin LSP 서버 미구성으로 `.kt` 진단은 불가, Gradle 검증은 `BUILD SUCCESSFUL`.
+- 2026-03-13
+  - 무엇/왜/어떻게: cold start 구간에서도 섞임이 없도록 `MainActivity.executeBundleDeeplink`의 `deep_link` 처리에서 기존 fallback 번들과 병합 로직을 제거했다.
+  - 실행 명령: `grep(pattern="mergedBundle|putAll\\(deepLinkBundle\\)|return executeBundleRoute\\(deepLinkBundle\\)|return executeBundleRoute\\(bundle\\)", path="app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt", output_mode="content")`
+  - 결과: `putAll(deepLinkBundle)`/병합 흔적 없이 `deep_link` 경로(`return executeBundleRoute(deepLinkBundle)`)와 fallback 경로(`return executeBundleRoute(bundle)`)가 상호배타로 분리됨을 확인했다.
+- 2026-03-13
+  - 무엇/왜/어떻게: `MainActivity` 분기 수정 후 컴파일/단위 테스트 회귀를 재확인했다.
+  - 실행 명령: `lsp_diagnostics(filePath="app/src/main/java/kr/co/vividnext/sodalive/main/MainActivity.kt")`, `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과: Kotlin LSP 서버 미구성으로 `.kt` 진단은 불가, Gradle 검증은 `BUILD SUCCESSFUL`.

docs/plan-task/20260316_그리드_유료게시물_보조메뉴_제한.md

@@ -0,0 +1,14 @@
+# 20260316_그리드_유료게시물_보조메뉴_제한.md
+
+## 개요
+그리드 모드에서 유료 게시물 중 구매하지 않은 게시물에 대해 롱클릭 시 보조 메뉴가 표시되지 않도록 수정한다.
+
+## 작업 내용
+- [x] CreatorCommunityAllGridAdapter.kt 수정: `isPaidLocked`가 `true`일 때 롱클릭 리스너를 무시하도록 처리.
+
+## 검증 기록
+- 무엇을: 그리드 모드 유료/미구매 게시물 롱클릭 시 보조 메뉴 노출 여부 확인
+- 왜: 유료 게시물을 구매하기 전에는 보조 메뉴(고정/해제, 수정, 삭제 등)가 노출되지 않아야 함
+- 어떻게: `CreatorCommunityAllGridAdapter`의 `isPaidLocked` 조건 확인 및 롱클릭 리스너 수정
+- 실행 명령: `./gradlew :app:assembleDebug`
+- 결과: `./gradlew :app:assembleDebug` 성공. `isPaidLocked`일 때 롱클릭 리스너 내 조건 처리가 정상적으로 추가됨.

docs/plan-task/20260316_커뮤니티_고정게시물_핀표시_그리드전용_수정.md

@@ -0,0 +1,22 @@
+# 20260316_커뮤니티_고정게시물_핀표시_그리드전용_수정.md
+
+## 개요
+- 커뮤니티 게시물 고정 기능을 리스트 형태와 그리드 형태 모두에 적용했으나, 요구사항 변경에 따라 리스트 형태에서는 핀 아이콘을 제거하고 그리드 형태에서만 표시하도록 수정한다.
+
+## 작업 내용
+- [x] `item_creator_community_all.xml` (리스트 아이템)에서 `iv_pin` 제거
+- [x] `item_creator_community.xml` (리스트 아이템)에서 `iv_pin` 제거
+- [x] `CreatorCommunityAllAdapter.kt` (리스트 어댑터)에서 `iv_pin` 표시 로직 제거
+- [x] `CreatorCommunityAdapter.kt` (리스트 어댑터)에서 `iv_pin` 표시 로직 제거
+- [x] 빌드 및 린트 체크 (`./gradlew :app:assembleDebug`, `./gradlew :app:ktlintCheck`)
+
+## 검증 기록
+- 무엇을: 리스트 형태에서 고정 핀 아이콘 노출 여부 확인
+- 왜: 요구사항에 따라 그리드 형태에서만 핀을 노출하기 위함
+- 어떻게: 코드 수정 후 빌드 성공 여부 및 린트 확인
+- 결과:
+    - 리스트 형태 아이템 레이아웃에서 `iv_pin` 뷰를 삭제함.
+    - 리스트 어댑터들에서 `iv_pin`을 참조하거나 가시성을 변경하는 코드를 삭제함.
+    - 그리드 형태(`item_creator_community_all_grid.xml`, `CreatorCommunityAllGridAdapter.kt`)는 기존대로 유지하여 핀 아이콘이 노출되도록 함.
+    - `./gradlew :app:assembleDebug` 성공.
+    - `./gradlew :app:ktlintCheck` 결과, 패키지명 규칙 외의 다른 스타일 위반 사항(빈 줄, 후행 쉼표 등)을 수정 완료함.

docs/plan-task/20260317_프로필후원순위왕관UI동일화.md

@@ -0,0 +1,39 @@
+# 20260317_프로필후원순위왕관UI동일화.md
+
+## 개요
+- `UserProfileDonationAdapter`의 순위 왕관 표시 UI를 `CreatorRankingAdapter`의 랭킹 배지 UI와 동일한 리소스/표시 방식으로 맞춘다.
+
+## 작업 내용
+- [x] `UserProfileDonationAdapter.kt`의 순위 UI 로직을 `img_rank_1`, `img_rank_2`, `img_rank_3` 기반으로 변경
+- [x] 기존 원형 배경(`iv_bg`) 및 왕관 아이콘(`ic_crown_*`) 노출 로직 제거
+- [x] `item_user_profile_donation.xml`에서 `iv_crown` 위치를 중앙 고정으로 변경
+- [x] `item_user_profile_donation.xml`에서 `iv_crown` 크기를 `match_parent`로 조정하고 `fitCenter` 적용
+- [x] `UserProfileDonationAdapter.kt`에서 런타임 `LayoutParams` 위치 세팅 코드 제거
+- [x] 검증 수행 (`lsp_diagnostics`, `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`)
+
+## 검증 기록
+- 무엇을: 유저 프로필 후원 랭킹의 상위 3위 왕관 표시 UI를 홈 크리에이터 랭킹 배지와 동일 리소스로 변경
+- 왜: 화면 간 순위 표현의 일관성을 맞추기 위함
+- 어떻게:
+    - `UserProfileDonationAdapter.kt`에서 상위 3위 리소스를 `img_rank_1~3`로 교체
+    - `iv_bg`는 항상 `GONE` 처리하고 `iv_crown`을 중앙 정렬하여 배지 오버레이 방식으로 통일
+    - `lsp_diagnostics` 시도(현재 환경은 Kotlin LSP 미구성), Gradle 테스트/빌드로 컴파일 및 동작 가능 여부 확인
+- 결과:
+    - `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/donation/UserProfileDonationAdapter.kt` 반영 완료
+    - `./gradlew :app:testDebugUnitTest` 성공
+    - `./gradlew :app:assembleDebug` 성공
+    - LSP 진단은 `.kt` 서버 미설정으로 미실행(대신 Gradle 검증으로 대체)
+
+### 추가 수정 (왕관 위치/크기)
+- 무엇을: 왕관 배지의 위치를 XML 고정으로 전환하고 배지 크기를 조정
+- 왜: 바인딩마다 위치를 재설정하는 중복 코드를 제거하고, 프로필 이미지가 배지 밖으로 보이는 문제를 방지하기 위함
+- 어떻게:
+    - `item_user_profile_donation.xml`의 `iv_crown`을 `layout_centerInParent="true"`, `layout_width/height="match_parent"`, `scaleType="fitCenter"`로 수정
+    - `UserProfileDonationAdapter.kt`에서 `RelativeLayout.LayoutParams`를 조작하던 코드와 import 제거
+    - `lsp_diagnostics` 재시도(현재 환경은 `.kt`, `.xml` LSP 미구성), Gradle 테스트/빌드 재검증
+- 결과:
+    - `app/src/main/res/layout/item_user_profile_donation.xml` 반영 완료
+    - `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/donation/UserProfileDonationAdapter.kt` 반영 완료
+    - `./gradlew :app:testDebugUnitTest` 성공
+    - `./gradlew :app:assembleDebug` 성공
+    - LSP 진단은 `.kt`, `.xml` 서버 미설정으로 미실행(대신 Gradle 검증으로 대체)

docs/plan-task/20260318_라이브룸채팅왕관표시수정.md

@@ -0,0 +1,84 @@
+# 20260318_라이브룸채팅왕관표시수정.md
+
+## 개요
+- 라이브룸 일반 채팅(`LiveRoomNormalChat`)의 랭킹 왕관 표시를 요청사항에 맞게 수정한다.
+
+## 작업 내용
+- [x] 기존 랭킹 분기(`-2`, `-1`, `1`, `2`, `3`) 및 레이아웃 구조 확인
+- [x] `item_live_room_chat.xml`에서 왕관 parent/자식 크기 제어 구조 반영
+- [x] `LiveRoomChat.kt`에서 `1`, `2`, `3`위 왕관 리소스/배경 처리 로직 반영
+- [x] `-2`, `-1` 표시 및 크기 유지 확인
+- [x] 검증 수행 (`lsp_diagnostics`, `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`)
+- [x] 사용자 피드백 반영: `fl_crown` 제거 후 `fl_profile`/`iv_crown` 직접 크기 조절로 재수정
+- [x] `1`, `2`, `3`위에서만 `iv_crown=match_parent`, `fl_profile=39x38dp` 적용 및 나머지 기본 크기 유지
+
+## 검증 기록
+- 무엇을: 라이브룸 일반 채팅의 랭킹 왕관 표시에서 `1`, `2`, `3`위 리소스를 `img_rank_1~3`로 변경하고, 해당 경우에만 왕관 parent 크기를 `39dp x 38dp`로 적용
+- 왜: 상위 3위 왕관 표시 규격을 신규 디자인 리소스에 맞추고, `-2`, `-1` 표시 크기는 기존과 동일하게 유지하기 위함
+- 어떻게:
+    - `item_live_room_chat.xml`에 `iv_crown` 전용 parent(`fl_crown`)를 추가하고 `iv_crown`을 `match_parent`로 변경
+    - `LiveRoomChat.kt`에서 기본 왕관 parent 크기를 `16.7dp`로 초기화 후, `1`, `2`, `3`위에서만 `39dp x 38dp`로 변경
+    - `1`, `2`, `3`위에서는 `iv_bg`를 `null` 처리하고 `img_rank_1`, `img_rank_2`, `img_rank_3`를 사용
+    - `-2`, `-1` 분기의 왕관/배경 리소스는 기존 로직을 유지
+    - `lsp_diagnostics` 실행(현재 환경 `.kt`, `.xml` LSP 미구성), Gradle 테스트/빌드 검증 수행
+- 실행 명령:
+    - `lsp_diagnostics filePath=app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt`
+    - `lsp_diagnostics filePath=app/src/main/res/layout/item_live_room_chat.xml`
+    - `./gradlew :app:testDebugUnitTest`
+    - `./gradlew :app:assembleDebug`
+- 결과:
+    - `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt` 반영 완료
+    - `app/src/main/res/layout/item_live_room_chat.xml` 반영 완료
+    - `./gradlew :app:testDebugUnitTest` 성공
+    - `./gradlew :app:assembleDebug` 성공
+    - LSP 진단은 `.kt`, `.xml` 서버 미설정으로 미실행(Gradle 검증으로 대체)
+
+### 추가 검증 (lint)
+- 무엇을: 변경 영향 확인을 위해 `:app:lintDebug` 추가 실행
+- 왜: XML/Kotlin 수정 후 정적 분석 경고/오류 여부를 확인하기 위함
+- 실행 명령:
+    - `./gradlew :app:lintDebug`
+- 결과:
+    - 실패(기존 이슈): `AndroidManifest.xml`의 `com.facebook.FacebookActivity` MissingClass 포함 기존 lint 오류 21건, 경고 593건
+    - 이번 변경 파일(`LiveRoomChat.kt`, `item_live_room_chat.xml`) 직접 오류는 로그상 확인되지 않음
+
+### 추가 수정 (요청 반영: fl_profile/iv_crown 직접 조절)
+- 무엇을: `fl_crown` 방식 대신 `fl_profile`과 `iv_crown`의 크기를 직접 제어하도록 변경
+- 왜: 왕관 전용 container가 프로필 container보다 커져 표시가 깨질 수 있는 문제를 방지하기 위함
+- 어떻게:
+    - `item_live_room_chat.xml`에서 `fl_crown`을 제거하고 `iv_crown`을 `fl_profile` 직계 자식으로 복원
+    - `LiveRoomChat.kt`에서 `LiveRoomNormalChat` 바인딩 시 기본값을 `fl_profile=33.3dp`, `iv_crown=16.7dp`로 초기화
+    - `1`, `2`, `3`위일 때만 `fl_profile=39x38dp`, `iv_crown=match_parent`로 변경하고 `img_rank_1~3` 적용
+    - `-2`, `-1`, 그 외 분기는 기본 크기를 유지
+    - 뷰 재활용 영향 방지를 위해 `LiveRoomDonationChat`, `LiveRoomRouletteDonationChat`에서도 기본 크기 초기화 추가
+- 실행 명령:
+    - `lsp_diagnostics filePath=app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt`
+    - `lsp_diagnostics filePath=app/src/main/res/layout/item_live_room_chat.xml`
+    - `./gradlew :app:testDebugUnitTest`
+    - `./gradlew :app:assembleDebug`
+- 결과:
+    - `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt` 재반영 완료
+    - `app/src/main/res/layout/item_live_room_chat.xml` 재반영 완료
+    - `LiveRoomDonationChat`, `LiveRoomRouletteDonationChat`의 기본 크기 초기화 반영 완료
+
+### 재검증 결과 (요청 반영 후)
+- 실행 명령:
+    - `lsp_diagnostics filePath=app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt`
+    - `lsp_diagnostics filePath=app/src/main/res/layout/item_live_room_chat.xml`
+    - `./gradlew :app:testDebugUnitTest`
+    - `./gradlew :app:assembleDebug`
+- 결과:
+    - `lsp_diagnostics`는 현재 환경 `.kt`, `.xml` 서버 미설정으로 미실행
+    - `./gradlew :app:testDebugUnitTest` 성공
+    - `./gradlew :app:assembleDebug` 성공
+
+### 최종 재검증
+- 실행 명령:
+    - `lsp_diagnostics filePath=app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt`
+    - `lsp_diagnostics filePath=app/src/main/res/layout/item_live_room_chat.xml`
+    - `./gradlew :app:testDebugUnitTest`
+    - `./gradlew :app:assembleDebug`
+- 결과:
+    - `lsp_diagnostics`는 현재 환경 `.kt`, `.xml` 서버 미설정으로 미실행
+    - `./gradlew :app:testDebugUnitTest` 성공(UP-TO-DATE 포함)
+    - `./gradlew :app:assembleDebug` 성공(UP-TO-DATE 포함)

docs/plan-task/20260319_라이브룸채팅삭제기능구현계획.md

@@ -0,0 +1,176 @@
+# 20260319_라이브룸채팅삭제기능구현계획.md
+
+## 개요
+- 라이브 룸에서 방장(크리에이터) 전용 채팅 삭제 기능을 추가하기 위한 구현 계획 문서다.
+- 기능 범위는 단건 삭제(길게 누름 + 확인 다이얼로그)와 강퇴 연계 일괄 삭제(다이얼로그 없이 즉시 삭제)다.
+- 본 문서는 계획을 먼저 확정하고, 구현/검증 결과는 하단 `검증 기록`에 누적한다.
+
+## 요구사항 해석(확정)
+- 채팅 삭제 권한은 방장(크리에이터)만 가진다.
+- 삭제 대상 채팅을 길게 누르면 삭제 확인 다이얼로그를 띄운다.
+- 다이얼로그 본문은 `[닉네임]: [채팅 내용]` 형식으로 노출한다.
+- 다이얼로그 버튼은 `취소/삭제` 두 가지다.
+- 삭제 확정 시 모든 사용자 화면에서 동일 채팅이 제거되어야 한다.
+- 강퇴 시에는 다이얼로그 없이 해당 유저의 채팅을 즉시 일괄 삭제하고, 이 결과가 모든 사용자에게 동기화되어야 한다.
+
+## 현재 구조 조사 요약
+- 일반 채팅은 `LiveRoomActivity.inputChat()`에서 `agora.inputChat(message)`로 RTM STRING 발송하고, 수신 측은 `onMessageEvent` STRING 분기에서 `LiveRoomNormalChat`을 리스트에 append 한다.
+- 실시간 제어 이벤트(방정보 수정, 채팅 얼림, 룰렛 등)는 `LiveRoomChatRawMessageType` + `agora.sendRawMessageToGroup()` + `onMessageEvent` BINARY 분기 패턴을 이미 사용 중이다.
+- 강퇴는 `LiveRoomActivity.kickOut()` -> `LiveRoomViewModel.kickOut()`(API) + `LiveRoomRequestType.KICK_OUT` peer 메시지 전송으로 처리되며, 강퇴 대상 단말은 수신 후 `finish()`로 종료한다.
+- 현재 라이브룸 채팅 모델/어댑터에는 단건 삭제를 위한 명시적 식별자/long-press 콜백/삭제 브로드캐스트 타입이 없다.
+
+## 설계 결정
+- 삭제 동기화는 기존 제어 이벤트와 동일하게 RTM BINARY raw message로 처리한다.
+- 단건 삭제 정합성을 위해 라이브룸 일반 채팅에 식별자(`chatId`)를 추가한다.
+- 강퇴 연계 일괄 삭제는 `targetUserId` 기반 raw message 이벤트로 처리한다.
+- 롱프레스 진입은 `LiveRoomChatAdapter`에서 `LiveRoomNormalChat` 항목에만 연결하고, 실제 권한 검증은 `LiveRoomActivity`에서 `isHost`로 최종 보장한다.
+- 기존 STRING 채팅 수신 분기는 호환성 fallback으로 유지하고, 삭제 정합성이 필요한 경로는 raw payload 기반으로 처리한다.
+
+## 완료 기준 (Acceptance Criteria)
+- [x] AC1: 방장(크리에이터)만 채팅 길게 누름 시 삭제 확인 다이얼로그를 볼 수 있다.
+- [x] AC2: 삭제 다이얼로그에 `[닉네임]: [채팅 내용]` 형식과 `취소/삭제` 버튼이 노출된다.
+- [x] AC3: 단건 삭제 확정 시 모든 사용자 화면에서 동일 채팅이 제거된다.
+- [x] AC4: 유저 강퇴 시 다이얼로그 없이 해당 유저의 채팅이 일괄 삭제된다.
+- [x] AC5: 강퇴 기반 일괄 삭제도 모든 사용자 화면에 동일하게 반영된다.
+- [x] AC6: 기존 채팅/후원/강퇴 흐름(삭제 기능 외)은 회귀 없이 유지된다.
+
+## 구현 체크리스트
+### 1) 채팅 모델/식별자 확장
+- [x] `LiveRoomNormalChat`에 단건 삭제용 `chatId` 필드를 추가한다.
+- [x] 강퇴 기반 일괄 삭제 범위를 위해 작성자 식별이 가능한 채팅 타입(`LiveRoomNormalChat`, `LiveRoomDonationChat`, 필요 시 `LiveRoomRouletteDonationChat`)의 사용자 식별 정보를 정리한다.
+
+### 2) Raw message 스키마 확장
+- [x] `LiveRoomChatRawMessageType`에 삭제 관련 타입(`NORMAL_CHAT`, `DELETE_CHAT`, `DELETE_CHAT_BY_USER`)을 추가한다.
+- [x] `LiveRoomChatRawMessage`에 삭제/일반채팅 동기화에 필요한 필드(`chatId`, `targetUserId`)를 nullable로 추가한다.
+
+### 3) `LiveRoomActivity` 송신/수신 경로 반영
+- [x] `inputChat()`에서 일반 채팅 raw payload 송신 + 로컬 리스트 반영 로직을 정리한다.
+- [x] `rtmEventListener.onMessageEvent` BINARY 분기에 `NORMAL_CHAT`, `DELETE_CHAT`, `DELETE_CHAT_BY_USER` 처리 로직을 추가한다.
+- [x] STRING 수신 분기는 fallback 경로로 유지하고, 삭제 식별자가 없는 legacy 메시지 처리 원칙을 명시한다.
+
+### 4) 방장 전용 long-press 삭제 UX
+- [x] `LiveRoomChatAdapter`에 `LiveRoomNormalChat` long-press 콜백을 추가한다.
+- [x] `LiveRoomActivity`에서 방장 권한(`isHost`) 검증 후 삭제 확인 다이얼로그를 노출한다.
+- [x] 다이얼로그 본문은 문자열 포맷으로 `[닉네임]: [채팅 내용]`을 구성하고 `취소/삭제` 액션을 연결한다.
+
+### 5) 강퇴 연계 일괄 삭제
+- [x] `kickOut(userId)` 경로에서 강퇴 대상 사용자의 채팅 일괄 삭제 raw 이벤트를 다이얼로그 없이 즉시 브로드캐스트한다.
+- [x] 수신 측에서 `targetUserId`에 해당하는 채팅을 일괄 제거하고 리스트를 갱신한다.
+
+### 6) 문자열/국제화
+- [x] `values/strings.xml`에 라이브룸 채팅 삭제 다이얼로그 제목/본문 포맷 문자열을 추가한다.
+- [x] `values-en/strings.xml`, `values-ja/strings.xml`에도 동일 키를 추가한다.
+
+### 7) 검증
+- [x] `lsp_diagnostics`로 수정 파일의 신규 오류 유무를 확인한다.
+- [x] `./gradlew :app:testDebugUnitTest`를 실행한다.
+- [x] `./gradlew :app:assembleDebug`를 실행한다.
+- [ ] 수동 QA: 방장/일반유저 2계정으로 단건 삭제 및 강퇴 일괄 삭제의 전 사용자 반영을 확인한다.
+
+## 영향 파일(예상)
+### 필수
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+  - 방장 전용 long-press 삭제 진입, 삭제 확인 다이얼로그, 단건/일괄 삭제 raw 이벤트 송신, 수신 분기 삭제 처리, 강퇴 연계 삭제 처리 추가.
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt`
+  - 삭제/일반채팅 동기화용 raw message type 및 payload 필드 추가.
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt`
+  - 단건 삭제용 `chatId` 및 작성자 기반 일괄 삭제 대응 필드(필요 타입) 추가.
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatAdapter.kt`
+  - 일반 채팅 아이템 long-press 콜백 전달 경로 추가.
+- `app/src/main/res/values/strings.xml`
+  - 라이브룸 채팅 삭제 다이얼로그 문자열(제목/본문 포맷) 추가.
+- `app/src/main/res/values-en/strings.xml`
+  - 동일 문자열 키 영문 번역 추가.
+- `app/src/main/res/values-ja/strings.xml`
+  - 동일 문자열 키 일본어 번역 추가.
+
+### 참고(변경 가능성 낮음)
+- `app/src/main/java/kr/co/vividnext/sodalive/agora/Agora.kt`
+  - 기존 `sendRawMessageToGroup` API로 처리 가능해 직접 수정 가능성은 낮다.
+
+## 리스크 및 확인사항
+- 일반 채팅 송신 형식을 raw 중심으로 전환할 경우, 구버전/타플랫폼과의 프로토콜 호환성 리스크가 있다.
+- fallback STRING 메시지는 삭제 식별자 정합성이 약할 수 있으므로, 삭제 대상 식별 우선순위를 명확히 정의해야 한다.
+- `kickOut` API 호출은 현재 성공/실패 콜백을 사용하지 않으므로, “API 성공 후 삭제 이벤트 전파” 순서 보장이 필요하면 ViewModel 시그니처 확장을 검토해야 한다.
+- 동일 사용자의 동일 본문 반복 메시지 삭제 시 단건 선택 정합성(정확히 1건 삭제) 검증이 필요하다.
+
+## 외부 레퍼런스(요약)
+- Agora Signaling 메시지 페이로드 구조화 권장(문자열/바이너리 + 앱 스키마):
+  - https://docs.agora.io/en/signaling/core-functionality/message-payload-structuring
+- Stream Chat Android 삭제 권한/삭제 확인 다이얼로그/삭제 이벤트 처리 패턴:
+  - https://github.com/GetStream/stream-chat-android/blob/d7ce8ede69b0098a06fca17cacecaa9dc0bafdbd/stream-chat-android-ui-common/src/main/kotlin/io/getstream/chat/android/ui/common/utils/CapabilitiesHelper.kt#L137-L155
+  - https://github.com/GetStream/stream-chat-android/blob/d7ce8ede69b0098a06fca17cacecaa9dc0bafdbd/stream-chat-android-ui-components/src/main/kotlin/io/getstream/chat/android/ui/feature/messages/list/MessageListView.kt#L2269-L2277
+
+## 검증 기록
+- 기록 템플릿(후속 누적):
+  - YYYY-MM-DD
+    - 무엇/왜/어떻게:
+    - 실행 명령/도구:
+      - `명령 또는 사용 도구`
+    - 결과:
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 라이브룸 채팅 삭제 구현 전에 기존 채팅 송수신/강퇴/어댑터 구조를 병렬 탐색하고, 요구사항을 충족하는 상세 구현 계획(예상 수정 파일/추가 항목/검증 항목)을 문서화했다.
+  - 실행 명령/도구:
+    - `task(subagent_type="explore")` x3
+    - `task(subagent_type="librarian")` x2
+    - `grep("LiveRoomChatRawMessageType|kickOut\(|onMessageEvent|setOnLongClickListener|confirm_delete_title")`
+    - `ast_grep_search("agora.sendRawMessageToGroup($$$)")`
+    - `read(LiveRoomActivity.kt, LiveRoomChat.kt, LiveRoomChatAdapter.kt, LiveRoomChatRawMessage.kt, LiveRoomViewModel.kt, Agora.kt, LiveApi.kt, strings*.xml, dialog_live.xml)`
+    - `bash("rg -n ...")` 시도
+    - `apply_patch` (본 문서 생성/상세화)
+  - 결과:
+    - `LiveRoomActivity` 중심의 채팅 입력(STRING)/제어이벤트(BINARY)/강퇴(peer) 경로를 확인했다.
+    - 단건 삭제와 강퇴 일괄 삭제를 위해 필요한 확장 지점(모델, raw 타입, 어댑터 콜백, Activity 분기, 문자열 리소스)을 파일 단위로 확정했다.
+    - 현재 실행 환경에서 `rg` 명령은 미설치(`command not found`)로 확인되어 동일 탐색은 `grep`/`ast_grep_search`/`read`로 보완했다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 계획 문서 기준으로 라이브룸 채팅 삭제 기능(방장 long-press 단건 삭제, 강퇴 연계 일괄 삭제, 전 사용자 동기화)을 실제 코드에 반영하고 빌드/테스트/수동 실행 검증을 수행했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`LiveRoomActivity.kt`, `LiveRoomChat.kt`, `LiveRoomChatAdapter.kt`, `LiveRoomChatRawMessage.kt`, `strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`)
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt, LiveRoomChat.kt, LiveRoomChatAdapter.kt, LiveRoomChatRawMessage.kt, strings*.xml)`
+    - 테스트/빌드: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 실행: `adb devices`, `./gradlew :app:installDebug`, `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.live.room.LiveRoomActivity --el roomId 1`
+  - 결과:
+    - 방장 long-press 삭제 진입/확인 다이얼로그/단건 삭제 브로드캐스트, 강퇴 시 즉시 일괄 삭제 브로드캐스트가 코드 경로에 반영되었다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`, `:app:installDebug`가 성공했다.
+    - `lsp_diagnostics`는 Kotlin/XML LSP 미설정 환경으로 실행 불가 응답을 반환했다.
+    - 단말 앱 실행 및 `LiveRoomActivity` 인텐트 실행까지는 확인했으나, 이 환경에서는 방장/일반유저 2계정 동시 접속 시나리오를 재현할 계정/세션 준비가 없어 최종 E2E(두 사용자 화면 동시 확인)는 후속 수동 검증이 필요하다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: Oracle 리뷰에서 삭제 이벤트 수신부의 권한 검증 누락(host-only 보장 약화)과 STRING fallback 채팅 개별 삭제 취약점이 확인되어, 삭제 수신 분기에 방장 검증을 추가하고 fallback 삭제 로직을 보완했다.
+  - 실행 명령/도구:
+    - 리뷰: `task(subagent_type="oracle")`
+    - 코드 반영: `apply_patch` (`LiveRoomActivity.kt`)
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)`
+    - 테스트/빌드: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 실행: `adb devices`, `./gradlew :app:installDebug`, `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.live.room.LiveRoomActivity --el roomId 1`
+  - 결과:
+    - `DELETE_CHAT`, `DELETE_CHAT_BY_USER` 수신 처리에서 발신자가 방장인지 검증하도록 반영했다.
+    - `chatId`가 비어있는 legacy STRING 채팅도 `targetUserId + message` 기준으로 단건 삭제를 시도하도록 보완했다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`, `:app:installDebug`가 모두 성공했다.
+    - `lsp_diagnostics`는 Kotlin LSP 미설정 환경으로 실행 불가 응답을 반환했다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 사용자 요청에 따라 채팅 삭제 다이얼로그 본문 포맷에서 대괄호를 제거했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`)
+    - 검증: `grep("screen_live_room_chat_delete_message_format")`, `lsp_diagnostics(strings*.xml)`, `./gradlew :app:testDebugUnitTest :app:assembleDebug`, `adb devices`, `./gradlew :app:installDebug`, `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.live.room.LiveRoomActivity --el roomId 1`
+  - 결과:
+    - `screen_live_room_chat_delete_message_format` 값이 `[%1$s]: [%2$s]`에서 `%1$s: %2$s`로 변경되어 대괄호 없이 노출된다.
+    - 테스트/빌드/설치 및 앱/액티비티 실행이 성공했다.
+    - `lsp_diagnostics`는 XML LSP 미설정 환경으로 실행 불가 응답을 반환했다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 삭제 이벤트 payload에서 `targetChatId`를 제거하고 `chatId` 단일 필드로 통일해, 삭제 송신/수신이 동일 키를 사용하도록 정리했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`, `docs/20260319_라이브룸채팅삭제기능구현계획.md`)
+    - 참조 확인: `grep("targetChatId")`, `grep("targetChatId", include="*.md")`
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt, LiveRoomChatRawMessage.kt)`
+    - 테스트/빌드: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 실행: `adb devices`, `./gradlew :app:installDebug`, `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.live.room.LiveRoomActivity --el roomId 1`
+  - 결과:
+    - `LiveRoomChatRawMessage`에서 `targetChatId` 필드를 제거했고, `DELETE_CHAT` 송신은 `chatId`에 삭제 대상 채팅 ID를 담아 전송하도록 변경했다.
+    - `DELETE_CHAT` 수신도 `message.chatId`를 읽어 삭제하도록 변경했으며, 저장소 내 `targetChatId` 문자열 참조는 0건이다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`, `:app:installDebug`가 성공했고 앱/액티비티 실행까지 확인했다.
+    - `lsp_diagnostics`는 Kotlin LSP 미설정 환경으로 실행 불가 응답을 반환했다.

docs/plan-task/20260319_라이브룸채팅얼림터치동작수정.md

@@ -0,0 +1,70 @@
+# 20260319_라이브룸채팅얼림터치동작수정.md
+
+## 개요
+- `LiveRoomActivity`에서 비방장 청취자가 채팅 얼림 상태일 때 터치 시 경고 토스트가 안정적으로 노출되도록 보정한다.
+- `etChat.isEnabled = false`로 인해 터치 이벤트가 막히는 문제를 해결하고, 입력/전송 차단 정책은 유지한다.
+- `etChat.setOnTouchListener`의 `ClickableViewAccessibility` 경고가 표시되지 않도록 `performClick` 연계와 경고 억제를 반영한다.
+
+## 완료 기준 (Acceptance Criteria)
+- [x] AC1: 비방장이 채팅 얼림 상태에서 `et_chat`을 터치하면 `screen_live_room_chat_freeze_warning` 토스트가 노출된다.
+- [x] AC2: 비방장 + 채팅 얼림 상태에서 실제 채팅 입력과 전송은 계속 차단된다.
+- [x] AC3: 방장 또는 비얼림 상태에서는 기존 입력 동작이 유지된다.
+- [x] AC4: 경고 문구(ClickableViewAccessibility)가 코드 경로에서 재현되지 않는다.
+- [x] AC5: 문자열 리소스는 기존 `screen_live_room_chat_freeze_warning`을 재사용한다.
+- [x] AC6: 수정 코드 컴파일/테스트가 성공한다.
+
+## 구현 체크리스트
+- [x] `LiveRoomActivity`의 입력 비활성/터치 처리 코드를 재확인한다.
+- [x] `etChat` 터치 토스트 경로를 입력창 자체 `OnTouchListener`로 보정한다.
+- [x] `etChat`은 enabled 유지 + focus/cursor 제어로 입력 차단을 유지한다.
+- [x] `MotionEvent.ACTION_UP`에서 `performClick` 호출을 추가해 접근성 경고 조건을 해소한다.
+- [x] `@SuppressLint("ClickableViewAccessibility")`를 `setupView`에 적용해 IDE/Lint 경고 노출을 억제한다.
+- [x] 검증 실행 결과를 문서 하단에 누적 기록한다.
+
+## 영향 파일
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+- `docs/20260319_라이브룸채팅얼림터치동작수정.md`
+
+## 검증 기록
+- 2026-03-19
+  - 무엇/왜/어떻게: 비방장 청취자 터치 시 얼림 토스트를 먼저 보장하기 위해 입력 컨테이너 클릭 기반 경고를 적용했다.
+  - 실행 명령/도구:
+    - 탐색: `task(subagent_type="explore")` x3, `task(subagent_type="librarian")` x2
+    - 코드/리소스 확인: `grep("isChatFrozen|screen_live_room_chat_freeze_warning|setOnFocusChangeListener|etChat")`, `ast_grep_search`, `sg --lang kotlin -p ...`, `read(LiveRoomActivity.kt, activity_live_room.xml)`
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)`
+    - 빌드/테스트: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 스모크: `adb devices`, `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`, `adb shell am start -W -n ...LiveRoomActivity --el roomId 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n ...LiveRoomActivity --el roomId 1`
+  - 결과:
+    - 초기 수정에서 `binding.rlInputChat.setOnClickListener`로 토스트를 노출하도록 반영했다.
+    - 문자열 리소스는 기존 `screen_live_room_chat_freeze_warning`을 재사용했고 신규 리소스 추가는 없었다.
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`는 `BUILD SUCCESSFUL`이었다.
+    - `lsp_diagnostics`는 Kotlin LSP 미설정으로 실행 불가였다.
+    - adb 직접 `am start`는 non-exported Activity 제약으로 실패했고 `run-as` 경로로 Activity 시작 로그를 확인했다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: `etChat.isEnabled = false` 상태에서 부모(`rlInputChat`) 클릭이 전달되지 않아 토스트가 뜨지 않는 문제를 확인했고, 입력창은 enabled를 유지한 채 포커스 가능 여부로 입력 차단을 제어하도록 수정했다. 동시에 `etChat.setOnTouchListener`에서 비방장+얼림 상태 터치를 직접 소비하며 토스트를 노출하도록 보정했다.
+  - 실행 명령/도구:
+    - 분석: `read(LiveRoomActivity.kt)`, `background_output(bg_7315e113)`
+    - 코드 반영: `apply_patch` (`LiveRoomActivity.kt`, 본 문서)
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)`
+    - 빌드/테스트: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 스모크: `adb devices`, `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.live.room.LiveRoomActivity --el roomId 1`
+  - 결과:
+    - 비방장+얼림 상태에서 `etChat` 터치 시 경고 토스트가 뜨도록 이벤트 경로가 복구되었다.
+    - 입력/전송 차단은 `etChat.isFocusable/isFocusableInTouchMode/isCursorVisible=false`와 `ivSend.isEnabled=false`로 유지된다.
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`는 `BUILD SUCCESSFUL`로 통과했다.
+    - `lsp_diagnostics`는 Kotlin LSP 미설정 환경으로 실행 불가 메시지를 반환했다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: `etChat.setOnTouchListener` 구간에서 IDE 경고(`Custom view EditText has setOnTouchListener called on it but does not override performClick`)가 남아 `performClick()` 호출과 `@SuppressLint("ClickableViewAccessibility")`를 추가해 경고 노출을 제거했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`LiveRoomActivity.kt`)
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)`
+    - 린트 확인: `./gradlew :app:lintDebug`, `grep("ClickableViewAccessibility|performClick", lint-results-debug.txt)`
+    - 빌드/테스트: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 스모크: `adb devices`, `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.live.room.LiveRoomActivity --el roomId 1`
+  - 결과:
+    - `LiveRoomActivity.kt:637`의 `setOnTouchListener`에서 `view.performClick()` 호출이 반영됐다.
+    - `lint-results-debug.txt`에서 `ClickableViewAccessibility`와 `performClick` 관련 경고 매치를 찾지 못해 해당 경고가 재현되지 않았다.
+    - `:app:lintDebug`는 기존 선행 이슈(`AndroidManifest.xml`의 `MissingClass`, `com.facebook.FacebookActivity`)로 실패했으며 이번 수정 경고와는 별개였다.
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`는 `BUILD SUCCESSFUL`로 통과했다.

docs/plan-task/20260319_라이브룸채팅창얼리기기능구현계획.md

@@ -0,0 +1,181 @@
+# 20260319_라이브룸채팅창얼리기기능구현계획.md
+
+## 개요
+- `LiveRoomActivity`에 채팅창 얼리기(Freeze) 토글을 추가한다.
+- 채팅창 얼리기 상태에서는 방장을 제외한 모든 사용자가 채팅 입력/전송을 할 수 없어야 한다.
+- 본 문서는 계획과 구현/검증 결과를 함께 관리한다.
+
+## 요구사항 요약
+- 토글 버튼 위치: `activity_live_room.xml`의 `tv_signature_switch` 왼쪽.
+- 얼림(ON): 방장 제외 전체 유저 채팅 입력 불가(포커스/입력/전송 모두 차단).
+- 녹임(OFF): 기존 채팅금지 해제와 동일하게 채팅 가능 상태로 복귀.
+- 상태 메시지: 얼림/녹임 시 모든 유저 채팅 리스트에 시스템 메시지 노출.
+- 상태 메시지 UI: 사용자 입장 알림(`LiveRoomJoinChat`)과 동일한 UI 사용.
+- 지연 입장: 채팅창이 얼려진 상태로 입장한 사용자도 즉시 상태를 받아 입력 불가여야 함.
+- 상태 변경 패턴: 룰렛과 동일하게 방장 ON/OFF 시 서버 API로 상태를 먼저 반영하고, 성공 시 RTM으로 실시간 전파.
+
+## 상태 저장 전략 판단 (ROOM_INFO vs 별도 상태)
+### 결론
+- **ROOM_INFO에 `isChatFrozen` 상태를 저장**하고, RTM 이벤트는 즉시 반영용으로 병행하는 전략을 채택한다.
+
+### 판단 근거
+- ROOM_INFO 기반 초기 동기화 경로가 이미 존재한다.
+  - `LiveRoomViewModel.getRoomInfo` -> `roomInfoResponse`/`roomInfoLiveData` 갱신.
+  - `LiveRoomActivity`는 `onCreate`, `onPresenceEvent(REMOTE_JOIN)` 등에서 `getRoomInfo`를 재호출한다.
+- 룸 전역 상태 선례가 존재한다.
+  - `GetRoomInfoResponse.isActiveRoulette` + `LiveRoomChatRawMessageType.TOGGLE_ROULETTE` 조합으로 운용 중이다.
+- 별도 로컬 상태(예: SharedPreferences)는 디바이스 단위라 전역 정합성에 취약하다.
+  - 현재 `noChatRoomList`는 로컬 단말 재진입 보조 용도이며, 전 유저 상태의 단일 진실원천(SSOT)으로는 부적합하다.
+- 외부 근거(Agora Signaling)상 메시지 채널은 pub/sub 모델이므로, 지연 입장자 상태 보장은 저장소(메타데이터/룸 정보) 병행이 유리하다.
+
+### 외부 레퍼런스(요약)
+- Agora Signaling 문서: channel metadata는 room attributes 저장/변경 알림/지속성을 제공하므로 지연 입장 정합성 확보에 적합.
+  - https://github.com/AgoraIO/Docs-Source/blob/b0d41f805f49a43c041453ce3ca73db2b8292b2f/shared/signaling/store-channel-metadata/index.mdx
+- Stream Chat Android: `Channel.frozen` 권위 상태 + 이벤트 병합(`mergeChannelFromEvent`) 패턴으로 freeze 상태를 모델에 유지.
+  - https://github.com/GetStream/stream-chat-android/blob/40119da704abfd56334db18c0f9fbb29f103f216/stream-chat-android-core/src/main/java/io/getstream/chat/android/models/Channel.kt
+- Matrix SDK: `m.room.power_levels` 기반 `maySendMessage` 권한 판별로 room-wide 전송 제한을 구현.
+  - https://github.com/matrix-org/matrix-js-sdk/blob/028357f15f173770f2dc695e7b2e20d3120bf71a/src/models/room-state.ts
+- LiveKit Android: participant metadata/attributes를 서버 권위 상태로 동기화하고 변경 이벤트를 분리 처리.
+  - https://github.com/livekit/client-sdk-android/blob/c91c476a5d6a674f4ff7f40f5b8326592754dabf/livekit-android-sdk/src/main/java/io/livekit/android/room/participant/Participant.kt
+
+## 완료 기준 (Acceptance Criteria)
+- [x] AC1: 방장이 얼림 ON 시, 방장을 제외한 사용자는 `et_chat`에 포커스/입력/전송이 모두 불가능하다.
+- [x] AC2: 방장이 얼림 OFF 시, 방장을 제외한 사용자의 채팅 입력/전송이 즉시 복구된다.
+- [x] AC3: 얼림/녹임 이벤트마다 모든 사용자 채팅 리스트에 시스템 상태 메시지가 1회씩 노출된다.
+- [x] AC4: 얼림 상태에서 새로 입장한 사용자는 입장 직후 입력 불가 상태를 즉시 적용받는다.
+- [x] AC5: 얼리기 토글 버튼은 `tv_signature_switch`의 왼쪽에 배치된다.
+- [x] AC6: 방장 얼림 ON/OFF 시 서버 API가 선행 호출되고, 성공한 경우에만 RTM 상태 브로드캐스트가 전송된다.
+
+## 구현 체크리스트
+### 1) UI/입력 제어
+- [x] `app/src/main/res/layout/activity_live_room.xml` 상단 토글 영역에 `tv_chat_freeze_switch` 추가 (`tv_signature_switch` 왼쪽).
+- [x] `LiveRoomActivity`에 전역 상태 변수(`isChatFrozen`) 및 UI 바인딩 로직 추가.
+- [x] `etChat` 포커스/입력/전송 경로(`setOnFocusChangeListener`, `inputChat`)를 통합 가드로 정리하여 Freeze 상태에서 완전 차단.
+
+### 2) 상태 전파/수신
+- [x] 서버 API 경로 반영: 전용 endpoint `PUT /live/room/info/set/chat-freeze` + `SetChatFreezeRequest(roomId, isChatFrozen)`로 ON/OFF를 서버 선반영.
+- [x] 저장소/뷰모델 경로 추가: `LiveRepository`/`LiveRoomViewModel`에 chat freeze ON/OFF API 호출 메서드 추가.
+- [x] 방장 토글 액션은 API 성공 콜백에서만 RTM 브로드캐스트를 전송하도록 순서 보장(룰렛과 동일).
+- [x] API 실패 시 RTM 미전송 + 오류 토스트 처리 시나리오 포함.
+- [x] `LiveRoomChatRawMessageType`에 Freeze 이벤트 타입 추가(예: `TOGGLE_CHAT_FREEZE`).
+- [x] `LiveRoomChatRawMessage`에 Freeze 상태 전달 필드 추가(예: `isChatFrozen`).
+- [x] 방장 토글 시 RTM 그룹 브로드캐스트 전송 + 수신 분기 처리(`rtmEventListener.onMessageEvent`) 구현.
+
+### 3) 지연 입장 동기화
+- [x] `GetRoomInfoResponse`에 `isChatFrozen` 필드 추가.
+- [x] `roomInfoLiveData.observe`에서 `isChatFrozen`을 입력 제어 상태에 반영.
+- [x] 입장/재연결/REMOTE_JOIN 시점에서 ROOM_INFO 재조회 흐름으로 상태 재적용이 가능하도록 적용.
+
+### 4) 시스템 메시지(UI 동일성)
+- [x] 입장 알림과 동일한 UI(`item_live_room_join_chat.xml`)를 재사용할 수 있도록 시스템 메시지 모델 경로 확장.
+- [x] 얼림/녹임 메시지를 `chatAdapter.items.add(...)` + `invalidateChat()` 경로로 주입.
+
+### 5) 문자열/국제화
+- [x] `values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml`에 Freeze ON/OFF 라벨/상태 메시지 문구 추가.
+
+### 6) 검증
+- [x] 정적 진단: 수정 파일 대상 `lsp_diagnostics` 확인.
+- [x] 빌드/테스트: `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug` 실행.
+- [x] 수동 QA: 연결 단말 설치/실행 경로 확인 및 Activity 진입 시도 결과 기록.
+
+## 영향 파일(예상)
+- `app/src/main/res/layout/activity_live_room.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChatRawMessage.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/chat/LiveRoomChat.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt`
+- `app/src/main/res/values/strings.xml`
+- `app/src/main/res/values-en/strings.xml`
+- `app/src/main/res/values-ja/strings.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/LiveApi.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/LiveRepository.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt`
+
+## 리스크 및 의존성
+- 서버 ROOM_INFO에 `isChatFrozen` 필드가 제공되지 않으면 지연 입장 정합성 보장이 어렵다.
+- RTM 메시지만으로 구현하면 pub/sub 특성상 지연 입장 사용자에게 과거 상태 스냅샷이 누락될 수 있다.
+- API 성공 이전 RTM을 먼저 전송하면 서버 상태와 클라이언트 UI가 불일치할 수 있으므로, 전송 순서를 API 성공 이후로 강제해야 한다.
+- UI 차단을 포커스 차단만으로 처리하면 키보드/입력 우회가 가능하므로 `EditText` 자체 비활성 포함이 필요하다.
+
+## 검증 기록
+- 2026-03-19
+  - 무엇/왜/어떻게: 채팅창 얼리기 기능의 저장 전략 판단을 위해 LiveRoom 내부 구현 패턴, RTM 메시지 경로, ROOM_INFO 동기화 지점을 조사하고 계획 문서로 정리했다.
+  - 실행 명령/도구:
+    - `task(subagent_type="explore")` x3 (no-chat 흐름, room state sync, system UI 패턴)
+    - `task(subagent_type="librarian")` x2 (Agora 상태 전파 문서/실사례)
+    - `grep("isNoChatting|NO_CHATTING|...")`, `grep("LiveRoomChatRawMessageType|ROOM_INFO|...")`
+    - `ast_grep_search("LiveRoomChatRawMessage($$$)")`
+    - `read(LiveRoomActivity.kt, LiveRoomViewModel.kt, Agora.kt, GetRoomInfoResponse.kt, activity_live_room.xml, strings.xml 등)`
+    - `bash("rg -n ...")` 시도
+  - 결과:
+    - no-chat 기존 구현(로컬 저장 + peer 명령 + 타이머)과 ROOM_INFO 기반 전역 상태 동기화 패턴을 분리 확인.
+    - `isActiveRoulette` 선례를 통해 ROOM_INFO + RTM 병행 전략이 지연 입장 정합성에 유리함을 확인.
+    - 시스템 메시지 UI는 `LiveRoomJoinChat`/`item_live_room_join_chat.xml` 재사용이 가장 요구사항에 부합함을 확인.
+    - 환경에서 `rg` 명령은 미설치(`command not found`)로 확인되어, 동일 탐색은 `grep`/`ast_grep_search`/에이전트 결과로 보완.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 계획 문서 기준으로 채팅창 얼리기 기능을 구현하고, 룰렛과 동일하게 서버 API 성공 후 RTM 브로드캐스트 순서를 적용했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`LiveRoomActivity.kt`, `LiveRoomViewModel.kt`, `LiveRepository.kt`, `LiveRoomChat.kt`, `LiveRoomChatRawMessage.kt`, `GetRoomInfoResponse.kt`, `EditLiveRoomInfoRequest.kt`, `activity_live_room.xml`, `strings*.xml`)
+    - 정적 진단: `lsp_diagnostics` (현재 환경 `.kt`, `.xml` 서버 미설정)
+    - 빌드/테스트: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 스타일 검증: `./gradlew :app:ktlintCheck`
+    - 디바이스 수동 확인: `adb devices`, `./gradlew :app:installDebug`, `adb shell am start -W -n ...LiveRoomActivity --el roomId 1`, `adb shell run-as kr.co.vividnext.sodalive.debug am start --user 0 -n ...LiveRoomActivity --el roomId 1`
+  - 결과:
+    - 초기 빌드에서 `values-en/strings.xml` 신규 문구 1건(`screen_live_room_chat_freeze_warning`) 리소스 컴파일 오류를 확인하고 문구를 수정했다.
+    - 재실행 결과 `./gradlew :app:testDebugUnitTest :app:assembleDebug` 성공.
+    - `./gradlew :app:ktlintCheck` 성공.
+    - `./gradlew :app:installDebug` 성공(연결 단말 1대 설치 확인).
+    - 셸 직접 실행은 non-exported Activity 제약으로 일반 `am start`가 차단되었고, `run-as` 기반 실행은 가능했으나 디버그 앱 사용자 데이터(`shared_prefs/kr.co.vividnext.sodalive.debug_preferences.xml`)가 비어 있어 실제 라이브룸 시나리오(방장/일반유저 2계정)까지는 환경 제약으로 진행하지 못했다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 사용자 요청에 따라 채팅 얼리기 API를 `editLiveRoomInfo`에서 완전히 분리해 전용 URL(`/live/room/info/set/chat-freeze`)로 교체했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`LiveApi.kt`, `LiveRepository.kt`, `LiveRoomViewModel.kt`, `SetChatFreezeRequest.kt`, `EditLiveRoomInfoRequest.kt`)
+    - 확인: `grep("setChatFreeze|editLiveRoomInfo|/live/room/info/set/chat-freeze")`, `git diff -- LiveApi.kt LiveRepository.kt LiveRoomViewModel.kt SetChatFreezeRequest.kt`
+  - 결과:
+    - `setChatFreeze` 호출은 전용 endpoint로 분리되었고 `api.editLiveRoomInfo(...)` 재사용이 제거되었다.
+    - `EditLiveRoomInfoRequest`의 `isChatFrozen` 필드는 제거되어 채팅 얼리기와 라이브 정보 수정 API 계약이 분리되었다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 전용 API 분리 이후 실제 단말 실행 가능 여부를 확인해 수동 QA 착수 가능 상태를 점검했다.
+  - 실행 명령/도구:
+    - `adb devices`
+    - `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`
+  - 결과:
+    - 연결 단말 1대(`2cec640c34017ece`)가 확인되었고, debug 앱 런처 실행 이벤트 주입이 성공했다.
+    - 채팅 얼리기 엔드투엔드 검증(방장/일반 유저 2계정, 동일 룸 입장, ON/OFF 동기화)은 로그인 세션/테스트 계정/실제 룸 시나리오 준비가 필요해 후속 수동 QA 항목으로 유지한다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: TODO 잔여 항목(회귀 검증)을 완료하기 위해 테스트/빌드/코드스타일 검증을 단일 Gradle 실행으로 재확인했다.
+  - 실행 명령/도구:
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck`
+  - 결과:
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`, `:app:ktlintCheck` 모두 `UP-TO-DATE` 상태로 성공했고 전체 `BUILD SUCCESSFUL`을 확인했다.
+    - 추가 회귀 및 스타일 위반은 재현되지 않았다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 사용자 요청에 따라 채팅창 얼림/해제 시스템 메시지에서 크리에이터 닉네임 노출을 제거하고 고정 문구만 표시되도록 문자열 리소스를 수정했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`)
+    - 수동 확인: `read(.../values*/strings.xml)`로 `screen_live_room_chat_freeze_started/ended` 값에서 `%1$s` 제거 확인
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)`, `lsp_diagnostics(strings.xml)` (환경상 `.kt`/`.xml` LSP 미구성)
+    - 회귀 검증: `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck`
+  - 결과:
+    - 한국어 메시지는 요청대로 `채팅창을 얼렸습니다.`, `채팅창 얼리기를 해제했습니다`로 고정되어 닉네임이 표시되지 않는다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`는 성공했다.
+    - `:app:ktlintCheck`는 `LiveRoomActivity.kt`의 기존 광범위 스타일 위반으로 실패했으며, 본 요청에서 수정한 문자열 리소스 3개 파일에서는 신규 위반이 관찰되지 않았다.
+
+- 2026-03-19
+  - 무엇/왜/어떻게: 지연 입장 사용자가 얼림 상태를 인지하지 못하는 문제를 해결하기 위해 `isChatFrozen == true` 초기 동기화 시 시스템 메시지를 1회 노출하고, 채팅 입력 영역 터치 시 얼림 토스트를 표시하도록 `LiveRoomActivity`를 수정했다.
+  - 실행 명령/도구:
+    - 코드 반영: `apply_patch` (`app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`)
+    - 정적 확인: `read(LiveRoomActivity.kt)`로 `hasShownInitialChatFreezeNotice`, `rlInputChat.setOnTouchListener`, `roomInfoLiveData.observe` 분기 추가 확인
+    - 정적 진단: `lsp_diagnostics(LiveRoomActivity.kt)` (환경상 `.kt` LSP 미구성)
+    - 검증: `./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck`, `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 수동 스모크: `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`
+  - 결과:
+    - 지연 입장 초기 동기화에서 non-host + `isChatFrozen=true`일 때 채팅 리스트에 얼림 메시지가 1회 표시되도록 반영했다.
+    - non-host가 채팅 입력 영역(`rl_input_chat`)을 터치하면 `screen_live_room_chat_freeze_warning` 토스트가 노출되도록 반영했다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`는 성공했다.
+    - `:app:ktlintCheck`는 `LiveRoomActivity.kt`의 기존 광범위 스타일 위반으로 실패했으며, 이번 수정 라인에서 신규 위반은 확인되지 않았다.

docs/plan-task/20260320_라이브룸채팅창얼리기국제화.md

@@ -0,0 +1,21 @@
+# 20260320_라이브룸채팅창얼리기국제화
+
+## 개요
+라이브룸 채팅창 얼리기(Freeze) 기능과 관련된 텍스트가 `LiveRoomActivity.kt`에 하드코딩되어 있어, 이를 `strings.xml`로 추출하고 국제화(en, ja)를 적용한다.
+
+## 작업 내용
+- [x] 다국어 리소스 파일 존재 여부 확인 및 생성 (ko, en, ja)
+- [x] `strings.xml`에 채팅창 얼리기 관련 리소스 추가
+    - `chat_freeze_status_creator`
+    - `chat_freeze_status_listener`
+    - `chat_freeze_status_off`
+    - `chat_freeze_blocked`
+- [x] `LiveRoomActivity.kt`의 하드코딩된 문자열을 리소스 참조로 변경
+- [x] 빌드 및 코드 변경 사항 검증
+
+## 검증 기록
+### 2026-03-20
+- 무엇: 채팅창 얼리기 관련 텍스트 국제화 적용
+- 왜: 하드코딩된 텍스트를 리소스로 관리하여 다국어 지원이 가능하게 함
+- 어떻게: `strings.xml` (ko, en, ja)에 리소스 추가 및 `LiveRoomActivity.kt` 수정
+- 결과: `./gradlew :app:assembleDebug` 빌드 성공 및 코드 수정 사항 확인 완료

docs/plan-task/20260320_채팅창얼림아이콘이동및문구정리.md

@@ -0,0 +1,30 @@
+# 2026-03-20 채팅창 얼림 아이콘 이동 및 문구 정리
+
+## 구현 체크리스트
+- [x] LiveRoom 화면에서 채팅창 얼림 아이콘 위치를 마이크 음소거 아이콘 아래로 이동한다. (QA: 레이아웃 계층에서 마이크 음소거 컨트롤 다음 위치로 배치되었는지 확인)
+- [x] `showChatFreezeWarning` 표시 문구를 `🧊 채팅창이 얼었습니다.`로 변경한다. (QA: 코드 상수/리소스 참조가 아닌 해당 문자열로 토스트 호출되는지 확인)
+- [x] `docs/*`를 제외한 실제 코드 기준 미사용 얼림 관련 문구를 제거한다. (QA: 검색 결과에서 제거 대상 문구가 코드 경로에 남아있지 않은지 확인)
+- [x] 변경 파일 진단 및 Gradle 검증을 수행한다. (QA: LSP 오류 0건, 관련 Gradle 테스트/체크 명령 성공)
+
+## 검증 기록
+- [x] 작업 완료 후 아래에 무엇/왜/어떻게, 실행 명령, 결과를 누적 기록한다.
+
+- 무엇/왜/어떻게: 채팅 얼림 컨트롤의 실제 배치를 정확히 바꾸기 위해 코드베이스 전수 검색(직접 검색 + background explore/librarian)을 수행했고, `ll_option_buttons` 내부 순서 변경만으로 요구사항을 충족하도록 최소 수정했다.
+  - 실행 명령/도구: `grep`, `ast_grep_search`, `task(subagent_type=explore/librarian, run_in_background=true)`, `read`
+  - 결과: `activity_live_room.xml`에서 `tv_chat_freeze_switch`를 `fl_microphone_mute` 아래로 이동할 위치를 확정했고, 얼림 관련 리소스 사용/미사용 목록을 확보했다.
+
+- 무엇/왜/어떻게: 경고 문구를 요청 텍스트로 고정하기 위해 `showChatFreezeWarning`의 리소스 참조를 리터럴 문자열로 교체했다.
+  - 실행 명령/도구: `apply_patch`, `grep`
+  - 결과: `LiveRoomActivity.kt`에서 토스트 문구가 `🧊 채팅창이 얼었습니다.`로 반영됨을 확인했다.
+
+- 무엇/왜/어떻게: docs 제외 실제 코드에서 미사용 얼림 문구를 제거하기 위해 얼림 키 참조를 재검색하고 미참조 리소스를 삭제했다.
+  - 실행 명령/도구: `grep(pattern="screen_live_room_chat_freeze_...")`, `apply_patch`
+  - 결과: `screen_live_room_chat_freeze_off_label`, `screen_live_room_chat_freeze_on_label`, `screen_live_room_chat_freeze_warning`, `screen_live_room_chat_freeze_started`, `screen_live_room_chat_freeze_ended`를 `values*` 문자열 파일에서 제거했고, `app/src/main` 기준 재검색 시 잔여 참조가 없음을 확인했다.
+
+- 무엇/왜/어떻게: 변경 안정성 검증을 위해 진단/테스트/빌드를 실행했다.
+  - 실행 명령: `lsp_diagnostics`(kt/xml), `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`, `./gradlew :app:lintDebug`
+  - 결과: LSP는 환경에 Kotlin/XML 서버가 없어 실행 불가, `:app:testDebugUnitTest` 성공, `:app:assembleDebug` 성공, `:app:lintDebug`는 기존 이슈(`AndroidManifest.xml`의 `com.facebook.FacebookActivity` MissingClass)로 실패했다.
+
+- 무엇/왜/어떻게: 사용자 요청된 검색 모드 이행 여부를 확인하기 위해 `rg` 실행 가능성을 점검했다.
+  - 실행 명령: `rg -n --hidden --glob '!docs/**' ...`
+  - 결과: 현 환경에서 `rg` 바이너리가 없어 `command not found`가 발생했고, 대신 `grep`/`ast_grep_search`로 동일 범위 검증을 완료했다.

docs/plan-task/20260320_채팅창얼림온오프수정.md

@@ -0,0 +1,38 @@
+# 20260320 채팅창 얼림 on/off 수정 계획
+
+## 구현 체크리스트
+- [x] 얼림 버튼 위치를 스피커 음소거 버튼 위로 이동하고 하단 마진을 13.3으로 적용한다. (QA: 레이아웃 속성 확인)
+- [x] 얼림 OFF 상태 배경을 동일 위치의 기존 버튼 스타일과 동일하게 적용한다. (QA: 배경 리소스 확인)
+- [x] 얼림 ON 상태 배경을 라운드 코너 10, `#3bb9f1` 50% 투명도로 적용하고 아이콘 `ic_ice`를 노출한다. (QA: 배경/아이콘 리소스 확인)
+- [x] 얼림 버튼은 방장(크리에이터)에게만 보이도록 유지한다. (QA: `isHost` 분기 확인)
+- [x] 얼림 ON/OFF 시스템 문구를 방장/일반 유저 조건에 맞게 변경한다. (QA: 메시지 생성/수신 분기 확인)
+- [x] 수정 파일 진단, 테스트, 빌드를 실행하고 결과를 기록한다. (QA: 명령 실행 결과 확인)
+
+## 검증 기록
+- 2026-03-20
+  - 무엇: 얼림 버튼을 상단 텍스트 토글에서 우측 옵션 버튼 영역으로 이동하고, ON/OFF 배경 및 아이콘을 요구 조건으로 변경했다.
+  - 왜: 스피커 음소거 버튼 위 배치, `13.3dp` 하단 마진, OFF 동일 스타일/ON 50% 투명 `#3BB9F1` 스타일 요구사항을 충족하기 위해서다.
+  - 어떻게: `activity_live_room.xml`에서 `tv_chat_freeze_switch`를 `ll_option_buttons` 최상단 `FrameLayout`로 재배치하고 `ic_ice` 아이콘을 적용했으며, `LiveRoomActivity.kt`에서 토글 UI 배경 리소스 분기를 `bg_round_corner_10_99525252`/`bg_round_corner_10_803bb9f1`로 변경했다.
+- 2026-03-20
+  - 무엇: 얼림 ON/OFF 시스템 문구를 방장/리스너 조건으로 분기했다.
+  - 왜: 방장은 "채팅창을 얼렸습니다." 문구, 리스너는 "채팅창이 얼었습니다." 문구를 요구받았고 OFF 문구는 동일하게 맞춰야 했기 때문이다.
+  - 어떻게: `LiveRoomActivity.kt`의 `buildChatFreezeStatusMessage`를 호스트 여부 기반으로 재작성하고, 토글 송신/수신 및 입장 시 초기 얼림 공지에서 각각 호스트/리스너 문구를 사용하도록 반영했다.
+- 2026-03-20
+  - 무엇: 수정분 정합성 검증을 수행했다.
+  - 왜: 컴파일/테스트 성공 여부와 런타임 반영 가능성을 확인하기 위해서다.
+  - 어떻게:
+    - LSP 진단: `.kt`/`.xml`에 대한 로컬 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가 확인.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL` (테스트 및 디버그 빌드 성공, 기존 경고만 출력)
+- 2026-03-20
+  - 무엇: 요구사항 기반 수동 QA(소스 기준)를 수행했다.
+  - 왜: 얼림 버튼 위치/마진/배경/아이콘과 방장·리스너 문구가 요구 문자열과 정확히 일치하는지 최종 확인하기 위해서다.
+  - 어떻게:
+    - 실행 명령: `python3` 스크립트로 `activity_live_room.xml`의 뷰 순서·속성(`tv_chat_freeze_switch`가 `fl_speaker_mute` 위, `13.3dp`, OFF 배경, `ic_ice`)과 `LiveRoomActivity.kt` 문구를 자동 검증
+    - 결과: `MANUAL QA PASS: Layout placement/style and freeze notice phrases verified from source.`
+- 2026-03-20
+  - 무엇: 최종 빌드 재검증을 수행했다.
+  - 왜: 최종 응답 직전 변경 상태에서 디버그 조립 성공을 다시 확인하기 위해서다.
+  - 어떻게:
+    - 실행 명령: `./gradlew :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL` (기존 경고만 출력)

docs/plan-task/20260324_라이브룸캡처녹화정합개선.md

@@ -0,0 +1,39 @@
+# 20260324 라이브룸 캡처/녹화 정합 개선
+
+## 구현 체크리스트
+- [x] 기존 구현에서 `FLAG_SECURE`와 스크린샷/녹화 콜백 결합 지점을 다시 점검한다. (QA: `LiveRoomActivity` 캡처 보안 관련 함수 흐름 확인)
+- [x] `FLAG_SECURE` 유지 기준으로 dead path인 스크린샷 콜백 경로를 제거한다. (QA: `registerScreenCaptureCallback`/관련 상태 플래그 제거 확인)
+- [x] 녹화 상태 기반 강제 mute 경로만 유지되도록 로직과 주석을 정리한다. (QA: `addScreenRecordingCallback` 경로 단일화 확인)
+- [x] Manifest에서 불필요해진 스크린샷 감지 권한을 제거한다. (QA: `DETECT_SCREEN_CAPTURE` 선언 제거 확인)
+- [x] 진단/테스트/빌드 및 수동 QA 결과를 누적 기록한다. (QA: 실행 명령과 결과 로그 확인)
+
+## 검증 기록
+- 2026-03-24
+  - 무엇: 후속 정합 개선 작업 계획 문서를 생성했다.
+  - 왜: 사용자 요청(더 나은/최신 방식 반영)에 맞춰 변경 범위와 완료 기준을 명확히 고정하기 위해서다.
+  - 어떻게: `docs/20260324_라이브룸캡처녹화정합개선.md` 파일을 생성하고 체크리스트/검증 섹션을 작성했다.
+- 2026-03-24
+  - 무엇: 스크린샷 콜백 경로를 제거하고 녹화 기반 강제 mute 경로만 유지하도록 구현을 단순화했다.
+  - 왜: `FLAG_SECURE`를 유지하는 현재 전략에서 스크린샷 콜백 기반 강제 mute는 실질 동작하지 않는 dead path였기 때문이다.
+  - 어떻게:
+    - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`에서 `registerScreenCaptureCallback`/`unregisterScreenCaptureCallback` 관련 함수, 스크린샷 상태 플래그(`isScreenshotMuteActive`) 및 타이머 상수/러너블을 제거했다.
+    - 강제 mute 계산을 `isScreenRecordingActive` 단일 상태로 정리했다.
+- 2026-03-24
+  - 무엇: Manifest에서 불필요 권한을 제거했다.
+  - 왜: 스크린샷 콜백 경로를 제거했으므로 `DETECT_SCREEN_CAPTURE` 권한이 더 이상 필요하지 않다.
+  - 어떻게: `app/src/main/AndroidManifest.xml`에서 `<uses-permission android:name="android.permission.DETECT_SCREEN_CAPTURE" />` 선언을 삭제하고 `DETECT_SCREEN_RECORDING`만 유지했다.
+- 2026-03-24
+  - 무엇: 설계 근거와 실행 검증을 완료했다.
+  - 왜: 변경이 실제로 dead path 제거 + 기존 보안 전략 유지를 만족하는지 객관적으로 확인하기 위해서다.
+  - 어떻게:
+    - 외부 근거 확인:
+      - Android `Activity.ScreenCaptureCallback` 문구 "This is not invoked if the activity window has WindowManager.LayoutParams.FLAG_SECURE set."를 근거로 스크린샷 콜백 비동작 조건을 재확인했다.
+      - `WindowManager` API 레퍼런스(`addScreenRecordingCallback`, `SCREEN_RECORDING_STATE_VISIBLE`, Added in API level 35)와 `WindowManager.LayoutParams.FLAG_SECURE` 레퍼런스를 확인해 녹화 상태 콜백/보안 플래그의 현재 문서 기준을 재점검했다.
+    - 정적 진단:
+      - `lsp_diagnostics` 결과: `.kt`/`.xml` LSP 서버 미구성으로 진단 불가, `.md` 파일은 diagnostics 없음.
+    - 빌드/테스트:
+      - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+      - 결과: `BUILD SUCCESSFUL`
+    - 수동 QA:
+      - 실행 명령: `python3` 검증 스크립트(FLAG_SECURE 유지, 스크린샷 API 제거, recording-only mute 계산, Manifest 권한 정합 확인)
+      - 결과: `MANUAL QA PASS: FLAG_SECURE 유지 + dead screenshot path 제거 + recording-only mute flow verified.`

docs/plan-task/20260324_라이브룸화면캡쳐녹화차단처리.md

@@ -0,0 +1,56 @@
+# 20260324 라이브룸 화면 캡쳐/녹화 차단 처리 계획
+
+## 구현 체크리스트
+- [x] LiveRoomActivity의 기존 오디오 음소거/복원 흐름을 탐색해 캡쳐/녹화 감지 시 재사용 지점을 확정한다. (QA: 기존 `muteAllRemoteAudioStreams`/마이크 음소거 관련 코드 경로 확인)
+- [x] 화면 캡쳐/녹화 시작 상태를 감지하는 Android API 적용 방식을 확정한다. (QA: 코드베이스 탐색 + 공식 문서 근거 확인)
+- [x] 감지 시 캡쳐 결과 배경이 검정색이 되도록 처리한다. (QA: `FLAG_SECURE` 또는 동등 보호 처리 코드 반영 확인)
+- [x] 감지 시 음소거가 적용되고 종료 시 원복되도록 처리한다. (QA: 상태 플래그 기반 mute/unmute 분기 확인)
+- [x] 수정 코드 진단/테스트/빌드/수동 검증 결과를 기록한다. (QA: 실행 명령과 결과 로그 확인)
+
+## 검증 기록
+- 2026-03-24
+  - 무엇: 작업 계획 문서를 생성하고 구현/검증 체크리스트를 정의했다.
+  - 왜: 구현 범위와 완료 기준을 명확히 고정한 상태에서 안전하게 변경하기 위해서다.
+  - 어떻게: `docs/20260324_라이브룸화면캡쳐녹화차단처리.md` 파일을 생성해 체크박스와 QA 기준을 작성했다.
+- 2026-03-24
+  - 무엇: 코드베이스/외부 문서 병렬 탐색으로 캡쳐·녹화 보호 및 음소거 적용 근거를 확정했다.
+  - 왜: 기존 구현 패턴과 Android/Agora API 제약을 확인한 뒤 안전한 최소 변경으로 적용하기 위해서다.
+  - 어떻게:
+    - 코드 탐색: `grep`, `ast_grep_search`, `sg run`, `read`로 `LiveRoomActivity`, `Agora.kt`, `BaseActivity`, `AndroidManifest.xml` 확인.
+    - 배경 탐색: `explore` 3건(`bg_7ba54780`, `bg_885fde99`, `bg_bbf958e8`), `librarian` 2건(`bg_ad1f9b7a`, `bg_486409ac`) 결과 수집.
+    - API 레벨 검증: `/Users/klaus/Library/Android/sdk/platforms/android-35/data/api-versions.xml`에서 `addScreenRecordingCallback`/`removeScreenRecordingCallback`/`SCREEN_RECORDING_STATE_VISIBLE`가 `since="35"`임을 확인.
+- 2026-03-24
+  - 무엇: LiveRoomActivity에 캡쳐/녹화 보안 처리와 음소거 동기화 로직을 구현했다.
+  - 왜: 화면 캡쳐/녹화 시 민감 화면이 노출되지 않고 오디오가 즉시 음소거되도록 하기 위해서다.
+  - 어떻게:
+    - `window.addFlags(WindowManager.LayoutParams.FLAG_SECURE)`를 `onCreate`에 추가해 캡쳐 결과 비표시(검정/빈 화면) 처리.
+    - API 34+ `registerScreenCaptureCallback`(스크린샷), API 35+ `addScreenRecordingCallback`(녹화 상태) 등록/해제 로직을 `onStart`/`onStop`에 추가.
+    - `isCapturePrivacyMuted`, `isScreenRecordingActive`, `isScreenshotMuteActive` 상태를 기반으로 `agora.muteLocalAudioStream`/`agora.muteAllRemoteAudioStreams`를 일괄 적용하고 종료 시 원복.
+    - 기존 마이크/스피커 토글 로직을 `applyEffectiveAudioMuteState()`로 통합해 UI/실제 mute 상태를 동기화.
+- 2026-03-24
+  - 무엇: 스크린샷/녹화 감지 콜백 동작을 위한 권한을 Manifest에 반영했다.
+  - 왜: Android 14+ 스크린샷 감지와 Android 15+ 녹화 상태 감지 콜백의 권한 요구사항을 충족하기 위해서다.
+  - 어떻게: `app/src/main/AndroidManifest.xml`에 `<uses-permission android:name="android.permission.DETECT_SCREEN_CAPTURE" />`, `<uses-permission android:name="android.permission.DETECT_SCREEN_RECORDING" />`를 추가했다.
+- 2026-03-24
+  - 무엇: 구현 완료 후 Oracle 리뷰로 API/권한 회귀 위험을 점검하고 보완 반영했다.
+  - 왜: `addScreenRecordingCallback` 사용 시 Android 15 권한 누락으로 인한 `SecurityException` 가능성을 제거하기 위해서다.
+  - 어떻게: Oracle 결과(`ses_2e18fd285ffefWU6DrqSIJbgWY`)를 수집해 `DETECT_SCREEN_RECORDING` 권한을 추가하고 재빌드/재검증했다.
+- 2026-03-24
+  - 무엇: 수정분 정합성 검증(진단/테스트/빌드/수동 QA)을 수행했다.
+  - 왜: 컴파일 안정성과 요구사항 반영 여부를 객관적으로 확인하기 위해서다.
+  - 어떻게:
+    - LSP 진단: `.kt` LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가 확인.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL` (수정 단계별 반복 실행 모두 성공, 기존 Gradle deprecation/namespace 경고만 존재)
+    - 수동 QA 명령: `python3` 스크립트로 `FLAG_SECURE`, API 34/35 콜백 등록/해제, 캡쳐 기반 음소거 동기화, Manifest 권한 선언을 검증.
+    - 수동 QA 결과: `MANUAL QA PASS: capture/record security + mute flow + required permissions verified from source.`
+- 2026-03-24
+  - 무엇: 사용자 요청에 맞춰 캡처/녹화 관련 추가 코드 전반에 의미 단위 주석을 보강했다.
+  - 왜: API 레벨 분기(34/35), 콜백 등록/해제 대칭, 강제 mute 원복 의도를 유지보수 시 즉시 파악할 수 있도록 하기 위해서다.
+  - 어떻게:
+    - `LiveRoomActivity.kt`의 신규 상태 변수, 라이프사이클 훅, 콜백 등록/해제, 강제 mute 계산/적용 함수에 한 문장 주석을 추가했다.
+    - `AndroidManifest.xml`의 `DETECT_SCREEN_CAPTURE`/`DETECT_SCREEN_RECORDING` 권한 선언 위에 목적 주석을 추가했다.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`
+    - 수동 QA 명령: `python3` 스크립트로 주석 반영 지점을 점검.
+    - 수동 QA 결과: `MANUAL QA PASS: meaning-unit comments added for all capture/recording additions.`

docs/plan-task/20260324_라이브상세sns아이콘변경.md

@@ -0,0 +1,22 @@
+# 라이브 상세 SNS 아이콘 변경
+
+## 구현 체크리스트
+- [x] `LiveRoomDetailFragment`의 SNS 아이콘 렌더링을 `CreatorDetailDialog`와 동일한 아이콘 세트(`ic_sns_*`) 및 동적 노출 방식으로 변경한다.
+- [x] `GetRoomDetailManager`의 `youtubeUrl`, `instagramUrl`, `kakaoOpenChatUrl`, `fancimmUrl`, `xUrl`를 모두 SNS 표시 대상에 포함한다.
+- [x] 레이아웃에서 매니저 SNS 아이콘 영역을 동적 추가 구조로 정리한다.
+- [x] 수정 파일 진단, 테스트/빌드를 실행해 결과를 확인한다.
+
+## 검증 기록
+- LSP 진단 시도
+  - 명령: `lsp_diagnostics` (`LiveRoomDetailFragment.kt`, `fragment_live_room_detail.xml`)
+  - 결과: 현재 실행 환경에 Kotlin/XML LSP 서버가 설정되어 있지 않아 진단 불가(`No LSP server configured for extension: .kt/.xml`).
+- 단위 테스트 + 빌드
+  - 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과: `BUILD SUCCESSFUL`
+- 디바이스 설치 확인
+  - 명령: `./gradlew :app:installDebug`
+  - 결과: `Installed on 1 device.`
+- 수동 QA 실행(실기기)
+  - 명령: `adb shell am start -n kr.co.vividnext.sodalive/.splash.SplashActivity`
+  - 결과: 앱 실행은 성공했으나 원격 설정에 의한 필수 업데이트 다이얼로그(`업데이트 후 사용가능합니다.`)가 표시되어 라이브 상세 진입 경로까지 진행 불가.
+  - 추가 확인: `adb shell am start -n kr.co.vividnext.sodalive/.live.now.all.LiveNowAllActivity` 실행 시 비-exported Activity로 `Permission Denial` 발생.

docs/plan-task/20260326_멤버정보응답확장및콘텐츠보기설정동기화.md

@@ -0,0 +1,284 @@
+# 20260326_멤버정보응답확장및콘텐츠보기설정동기화.md
+
+## 개요
+- `/member/info` 응답 스펙 확장(`countryCode`, `isAdultContentVisible`, `contentType`)을 앱 데이터 모델과 로컬 상태에 반영한다.
+- 설정 화면의 `콘텐츠 보기 설정` 노출 조건을 기존 `SharedPreferenceManager.isAuth == true` 유지 + `countryCode != "KR"` 조건 추가로 확장한다.
+- `ContentSettings`에서 값 변경 시 `/member/content-preference`(PATCH) API로 서버 동기화를 수행하고, API 호출 구간에 `LoadingDialog`를 표시한다.
+- 빠른 연타 상황에서는 **RxJava debounce를 사용하지 않고** 마지막 상태만 서버로 전송되도록 처리한다.
+
+## 요구사항 해석(확정)
+- `/member/info` 응답 모델에 아래 필드를 추가한다.
+  - `countryCode: String`
+  - `isAdultContentVisible: Boolean`
+  - `contentType: ContentType`
+- `/member/info`에서 수신한 `countryCode`, `isAdultContentVisible`, `contentType`을 로컬 저장소(`SharedPreferenceManager`)에 동기화한다.
+- `SettingsActivity`의 `콘텐츠 보기 설정` 메뉴 노출은 아래 중 하나라도 만족하면 표시한다.
+  - `SharedPreferenceManager.isAuth == true`
+  - `countryCode != "KR"`
+- `ContentSettingsActivity`에서 성인 콘텐츠 토글/콘텐츠 타입 변경 시 `/member/content-preference` PATCH를 호출한다.
+- `/member/content-preference` PATCH 요청은 실제로 변경된 필드만 전송할 수 있도록 request 파라미터를 optional로 지원한다.
+- API 호출 동안 Loading UI를 노출한다.
+- 연속 입력 시 debounce 처리하여 마지막 값만 전송한다.
+- debounce 구현은 RxJava 연산자(`debounce`, `switchMap` 등)를 사용하지 않는다.
+
+## 현재 구조 조사 요약
+- `UserApi.getMemberInfo()`는 이미 `@GET("/member/info")`로 연결되어 있고 응답은 `GetMemberInfoResponse`를 사용한다.
+- `MainViewModel.getMemberInfo()`가 `SharedPreferenceManager.isAuth`를 갱신하는 현재 유일 경로다.
+- `SettingsActivity`에서 `rlContentSettings` 노출 조건은 현재 `SharedPreferenceManager.isAuth` 단일 조건이다.
+- `ContentSettingsActivity`/`ContentSettingsViewModel`은 현재 로컬 `SharedPreferenceManager`만 갱신하며 서버 PATCH 연동이 없다.
+- `ContentSettingsViewModel`은 현재 `UserRepository`를 주입받지 않으며(`AppDI.kt`에서 `ContentSettingsViewModel()`), 로딩/오류 상태 LiveData도 없다.
+
+## 설계 결정
+- `GetMemberInfoResponse`를 확장하고, `MainViewModel.getMemberInfo()`에서 신규 필드를 `SharedPreferenceManager`에 동기화한다.
+- 국가 코드 저장을 위해 `Constants.PREF_COUNTRY_CODE` + `SharedPreferenceManager.countryCode`를 추가한다.
+- 설정 메뉴 노출 조건은 `isAuth || countryCode != "KR"`로 통합한다.
+  - `countryCode` 미존재/공백 시 기본값은 `"KR"`로 간주하여 기존 노출 정책을 깨지 않도록 한다.
+- `/member/content-preference` PATCH API를 `UserApi`/`UserRepository`에 추가하고, 요청/응답 DTO를 분리한다.
+- `ContentSettingsViewModel`에 `UserRepository`를 주입해 서버 동기화 책임을 이동한다.
+- debounce는 RxJava 없이 `Handler(Looper.getMainLooper()) + Runnable`로 구현한다.
+  - 입력마다 이전 Runnable을 취소하고 지연 전송을 재등록한다.
+  - 지연 종료 시점의 최신 상태(`isAdultContentVisible`, `contentType`)만 전송한다.
+  - API 진행 중 추가 변경이 들어오면 최신 상태를 대기열로 유지하고, 현재 요청 완료 직후 마지막 상태 1회만 추가 전송한다.
+- `LoadingDialog`는 **실제 PATCH 요청 수행 구간**에만 표시한다(디바운스 대기 시간에는 미표시).
+
+## 완료 기준 (Acceptance Criteria)
+- [x] AC1: `/member/info` 응답 확장 필드 3개가 모델에 반영되고, 로컬 저장소 동기화까지 정상 동작한다.
+- [x] AC2: 설정 화면에서 `isAuth == true` 또는 `countryCode != "KR"`이면 `콘텐츠 보기 설정` 메뉴가 노출된다.
+- [x] AC3: `ContentSettings`의 토글/타입 변경이 `/member/content-preference` PATCH로 서버에 전달된다.
+- [x] AC4: PATCH 요청 수행 중 `LoadingDialog`가 표시되고 완료/실패 시 정상 해제된다.
+- [x] AC5: 연속 탭 시 마지막 상태만 서버로 전송된다.
+- [x] AC6: debounce 구현에서 RxJava debounce 계열 연산자를 사용하지 않는다.
+
+## 구현 체크리스트
+### 1) `/member/info` 응답 모델 확장
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/settings/notification/GetMemberInfoResponse.kt`
+  - `countryCode`, `isAdultContentVisible`, `contentType` 필드 추가
+- [x] `contentType`은 현재 로컬에서 사용하는 `ContentType` enum과 동일 타입으로 사용하도록 매핑 정합을 유지한다.
+
+### 2) 로컬 저장소 키/상태 확장
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/common/Constants.kt`
+  - `PREF_COUNTRY_CODE` 상수 추가
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/common/SharedPreferenceManager.kt`
+  - `countryCode: String` 프로퍼티 추가
+  - 필요 시 멤버 정보 기반 기본값 동기화 로직 정의
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/main/MainViewModel.kt`
+  - `getMemberInfo()` 성공 시 `countryCode`, `isAdultContentVisible`, `contentType`을 각각 `SharedPreferenceManager.countryCode`, `SharedPreferenceManager.isAdultContentVisible`, `SharedPreferenceManager.contentPreference`로 동기화한다.
+
+### 3) 설정 메뉴 노출 조건 확장
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/settings/SettingsActivity.kt`
+  - `rlContentSettings` 표시 조건을 `isAuth || countryCode != "KR"`로 변경
+  - 기존 숨김/표시 및 클릭 연결 흐름 유지
+
+### 4) 콘텐츠 설정 PATCH API 추가
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/user/UserApi.kt`
+  - `@PATCH("/member/content-preference")` API 정의 추가
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/user/UserRepository.kt`
+  - content preference 업데이트 메서드 추가
+- [x] 신규 DTO 파일 추가
+  - 요청: `UpdateContentPreferenceRequest` (`isAdultContentVisible`, `contentType`)
+  - 응답: `UpdateContentPreferenceResponse` (`isAdultContentVisible`, `contentType`)
+
+### 5) ContentSettings 서버 동기화 + Non-Rx debounce
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/settings/ContentSettingsViewModel.kt`
+  - `UserRepository` 주입으로 생성자 변경
+  - 로딩/오류 상태 LiveData 추가
+  - 로컬 상태 반영 후 debounce 스케줄링 함수 추가(Handler/Runnable)
+  - in-flight + pending 상태를 분리해 마지막 상태 1회 전송 보장
+  - `onCleared()`에서 callback 정리
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`
+  - `viewModel { ContentSettingsViewModel(get()) }`로 DI 갱신
+
+### 6) ContentSettings 화면 로딩 UI 반영
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/settings/ContentSettingsActivity.kt`
+  - `LoadingDialog` 초기화 및 `viewModel.isLoading` 관찰
+  - 요청 중 표시/요청 완료 해제 처리
+
+### 7) 검증
+- [ ] `lsp_diagnostics`로 수정 파일 신규 오류 확인
+- [x] `./gradlew :app:testDebugUnitTest` 실행
+- [x] `./gradlew :app:assembleDebug` 실행
+- [ ] 수동 QA
+  - 인증 사용자 + 비인증/해외 국가 코드 조합별 메뉴 노출 확인
+  - 콘텐츠 설정 연타 시 네트워크 요청이 마지막 값 위주로 수렴되는지 확인
+  - 요청 중 LoadingDialog 표시/해제 확인
+
+### 8) 추가 요구사항 반영 (2026-03-27)
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`
+  - 본인인증/인증완료 아이템(`btnIdentityVerification`)을 `countryCode == "KR"`일 때만 노출
+  - 비KR에서는 본인인증 버튼을 숨김 처리
+
+### 9) 콘텐츠 설정 PATCH optional request 반영 (2026-03-27)
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/settings/UpdateContentPreferenceRequest.kt`
+  - `isAdultContentVisible`, `contentType`를 nullable optional 파라미터로 변경
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/settings/ContentSettingsViewModel.kt`
+  - 변경된 필드만 request에 담아 PATCH 호출하도록 분기
+
+### 10) 캐릭터 상세 진입 인증 체크 국가 분기 반영 (2026-03-27)
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/home/HomeFragment.kt`
+  - 캐릭터 상세 진입 전 `ensureLoginAndAuth`를 KR/비KR 분기로 조정
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/chat/character/CharacterTabFragment.kt`
+  - 캐릭터 상세 진입 전 `ensureLoginAndAuth`를 KR/비KR 분기로 조정
+
+### 11) KR 인증완료 + 민감 콘텐츠 OFF 케이스 동작 일치화 (2026-03-27)
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/home/HomeFragment.kt`
+  - `ensureLoginAndAdultAuth`(19금 라이브 상세)에서 KR 인증완료 상태라도 `isAdultContentVisible == false`면 설정 가이드로 이동
+  - `ensureLoginAndAuth`(캐릭터 상세)에서 KR 인증완료 상태라도 `isAdultContentVisible == false`면 설정 가이드로 이동
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/live/LiveFragment.kt`
+  - `ensureLoginAndAdultAuth`(19금 라이브 상세)에서 KR 인증완료 + 민감 콘텐츠 OFF를 비KR OFF와 동일 처리
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/live/now/all/LiveNowAllActivity.kt`
+  - `ensureLoginAndAdultAuth`(19금 라이브 상세)에서 KR 인증완료 + 민감 콘텐츠 OFF를 비KR OFF와 동일 처리
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/chat/character/CharacterTabFragment.kt`
+  - `ensureLoginAndAuth`(캐릭터 상세)에서 KR 인증완료 + 민감 콘텐츠 OFF를 비KR OFF와 동일 처리
+
+## 영향 파일(예상)
+### 필수
+- `app/src/main/java/kr/co/vividnext/sodalive/settings/notification/GetMemberInfoResponse.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/user/UserApi.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/user/UserRepository.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/common/Constants.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/common/SharedPreferenceManager.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/main/MainViewModel.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/settings/SettingsActivity.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/settings/ContentSettingsViewModel.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/settings/ContentSettingsActivity.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt`
+
+### 신규 파일(예상)
+- `app/src/main/java/kr/co/vividnext/sodalive/settings/UpdateContentPreferenceRequest.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/settings/UpdateContentPreferenceResponse.kt`
+
+## 리스크 및 확인사항
+- `contentType`은 현재 로컬에서 사용하는 `ContentType`과 동일 타입을 사용한다.
+- 멤버 정보 API 호출 시점은 앱 실행 후 3번째 실행 흐름으로, 메뉴 노출 조건 반영 타이밍상 문제는 없는 것으로 본다.
+- PATCH 실패 시 직전 값으로 롤백한다(값 변경 시 API 호출 + LoadingDialog 표시 구간에서 사용자 대기가 가능한 UX를 전제로 함).
+- 연타 + 네트워크 지연 상황에서 LoadingDialog 과도 점멸을 방지하기 위해 표시 조건을 실제 API 요청 구간으로 제한한다(반영).
+
+## 검증 계획
+- 정적 확인: 응답/요청 DTO 필드, 메뉴 노출 조건식, debounce 상태 변수 흐름 점검
+- 자동 검증: 단위 테스트 및 디버그 빌드 성공 확인
+- 수동 검증: 한국/비한국 노출 케이스, 토글 연타 케이스, 마지막 값 전송 케이스
+
+## 검증 기록
+- 기록 템플릿(후속 누적):
+  - YYYY-MM-DD
+    - 무엇/왜/어떻게:
+    - 실행 명령/도구:
+      - `명령 또는 사용 도구`
+    - 결과:
+
+- 2026-03-26
+  - 무엇/왜/어떻게: `/member/info` 응답 확장, 설정 메뉴 노출 확장, `/member/content-preference` PATCH, Non-Rx debounce 제약을 반영한 구현 계획 문서를 작성했다.
+  - 실행 명령/도구:
+    - `read(docs/*, UserApi.kt, GetMemberInfoResponse.kt, SettingsActivity.kt, ContentSettingsActivity.kt, ContentSettingsViewModel.kt, SharedPreferenceManager.kt, AppDI.kt)`
+    - `grep("/member/info|content-preference|isAuth|countryCode|ContentType")`
+    - `apply_patch(docs/20260326_멤버정보응답확장및콘텐츠보기설정동기화.md 생성)`
+  - 결과:
+    - 요구사항과 추가 제약("debounce는 RxJava 미사용")이 반영된 체크리스트 중심 계획 문서를 생성했다.
+
+- 2026-03-26
+  - 무엇/왜/어떻게: 사용자 피드백에 따라 리스크/확인사항을 확정 대응안으로 갱신하고, `/member/info` 수신 필드 3종의 로컬 저장소 동기화 요구를 문서에 명시했다.
+  - 실행 명령/도구:
+    - `read(docs/20260326_멤버정보응답확장및콘텐츠보기설정동기화.md)`
+    - `apply_patch(docs/20260326_멤버정보응답확장및콘텐츠보기설정동기화.md 수정)`
+  - 결과:
+    - `contentType 동일 타입 사용`, `멤버 정보 호출 타이밍 이슈 없음`, `PATCH 실패 롤백`, `LoadingDialog API 구간 제한`이 문서에 반영되었다.
+    - `/member/info` 확장 필드(`countryCode`, `isAdultContentVisible`, `contentType`)의 로컬 저장소 동기화 요구가 AC/체크리스트에 반영되었다.
+
+- 2026-03-26
+  - 무엇/왜/어떻게: 계획 문서 기준으로 `/member/info` 응답 확장 필드 로컬 동기화, 설정 메뉴 노출 조건 확장, `/member/content-preference` PATCH 연동, ContentSettings의 Non-Rx debounce + in-flight/pending 마지막 값 전송 보장, LoadingDialog 연동을 구현했다.
+  - 실행 명령/도구:
+    - `task(explore x2)`
+    - `grep/read(app/src/main/java/**)`
+    - `apply_patch(소스 12개 파일 + DTO 2개 파일)`
+    - `lsp_diagnostics(수정된 .kt 파일 일괄 시도)`
+    - `./gradlew :app:testDebugUnitTest`
+    - `./gradlew :app:assembleDebug`
+  - 결과:
+    - `GetMemberInfoResponse`에 `countryCode/isAdultContentVisible/contentType`가 추가되고 `MainViewModel.getMemberInfo()`에서 `SharedPreferenceManager`로 동기화된다.
+    - `SettingsActivity`의 `콘텐츠 보기 설정` 노출 조건이 `isAuth || countryCode != "KR"`로 확장되었다.
+    - `UserApi/UserRepository`에 `/member/content-preference` PATCH와 요청/응답 DTO가 추가되었다.
+    - `ContentSettingsViewModel`에 `Handler + Runnable` 기반 debounce와 in-flight/pending 제어를 적용해 연타 시 마지막 상태만 서버로 전송되며, 요청 중에만 `isLoading`이 true가 된다.
+    - `ContentSettingsActivity`가 `isLoading`을 관찰해 `LoadingDialog`를 표시/해제하고 오류 토스트를 노출한다.
+    - `lsp_diagnostics`는 현재 환경에 Kotlin LSP가 없어 실행 불가 메시지를 확인했다.
+    - 자동 검증: `:app:testDebugUnitTest`, `:app:assembleDebug` 모두 성공했다.
+
+- 2026-03-26
+  - 무엇/왜/어떻게: 정적 검사 대체 검증과 실제 단말 스모크 실행으로 구현 안정성을 추가 확인했다.
+  - 실행 명령/도구:
+    - `./gradlew :app:ktlintCheck`
+    - `adb devices`
+    - `adb install -r app/build/outputs/apk/debug/app-debug.apk`
+    - `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`
+    - `adb shell dumpsys activity | grep -E "ResumedActivity|mFocusedApp|topResumedActivity|mCurrentFocus"`
+    - `adb logcat -d -s AndroidRuntime`
+    - `adb shell pidof kr.co.vividnext.sodalive.debug`
+  - 결과:
+    - `ktlintCheck`는 기존 코드베이스(주로 `LiveRoomActivity` 등) 기등록 스타일 위반으로 실패했다.
+    - 이번 변경 파일 기준으로는 `ContentSettingsActivity`, `GetMemberInfoResponse` 지적 항목을 정리 후 재빌드하여 `:app:testDebugUnitTest`, `:app:assembleDebug` 재성공을 확인했다.
+    - 디버그 APK 설치 및 런처 실행(monkey) 후 `SplashActivity`가 resumed 상태이며 앱 프로세스(pid) 실행 중임을 확인했다.
+
+- 2026-03-27
+  - 무엇/왜/어떻게: 추가 요청에 따라 `MyPageFragment`의 본인인증/인증완료 아이템을 한국 접속국가에서만 노출하도록 분기했다.
+  - 실행 명령/도구:
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `./gradlew :app:testDebugUnitTest`
+    - `./gradlew :app:assembleDebug`
+  - 결과:
+    - `countryCode.ifBlank { "KR" } == "KR"` 조건에서만 `btnIdentityVerification`이 표시되며, 비KR에서는 숨김 처리된다.
+    - `lsp_diagnostics`는 현재 환경에서 Kotlin LSP 미구성으로 실행 불가 메시지를 확인했다.
+    - 자동 검증: `:app:testDebugUnitTest`, `:app:assembleDebug` 모두 성공했다.
+
+- 2026-03-27
+  - 무엇/왜/어떻게: `/member/content-preference` 요청에 변경된 값만 전송하기 위해 request 필드를 optional로 전환하고, `confirmedState` 대비 변경 필드만 body에 담아 PATCH 호출하도록 조정했다.
+  - 실행 명령/도구:
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/settings/UpdateContentPreferenceRequest.kt)`
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/settings/ContentSettingsViewModel.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/settings/UpdateContentPreferenceRequest.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/settings/ContentSettingsViewModel.kt)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과:
+    - `UpdateContentPreferenceRequest`의 `isAdultContentVisible`, `contentType`가 nullable optional로 변경되었다.
+    - `ContentSettingsViewModel.syncContentPreference()`에서 `confirmedState`와 비교해 변경된 필드만 request에 포함하며, 변경 필드가 없으면 API 호출을 생략한다.
+    - `lsp_diagnostics`는 현재 환경에서 Kotlin LSP 미구성으로 실행 불가 메시지를 확인했다.
+    - 자동 검증: `:app:testDebugUnitTest`, `:app:assembleDebug` 모두 성공했다.
+
+- 2026-03-27
+  - 무엇/왜/어떻게: 캐릭터 터치 후 상세 진입 시 사용되는 `ensureLoginAndAuth` 인증 체크를 접속국가 기준으로 분기했다. KR은 기존 본인인증 다이얼로그 흐름을 유지하고, 비KR은 `isAdultContentVisible`이 꺼져 있으면 `ContentSettingsActivity`로 이동해 민감한 콘텐츠 스위치 안내 흐름을 사용하도록 맞췄다.
+  - 실행 명령/도구:
+    - `task(explore x2: 캐릭터 상세 진입 경로/인증 게이트 탐색)`
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/home/HomeFragment.kt)`
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/chat/character/CharacterTabFragment.kt)`
+    - `lsp_diagnostics(HomeFragment.kt, CharacterTabFragment.kt)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - `adb devices`
+    - `adb install -r app/build/outputs/apk/debug/app-debug.apk`
+    - `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`
+    - `adb shell uiautomator dump /sdcard/window_dump.xml`
+    - `adb pull /sdcard/window_dump.xml /tmp/sodalive_window_dump.xml`
+  - 결과:
+    - `HomeFragment`와 `CharacterTabFragment`의 캐릭터 상세 진입 전 인증 체크가 `countryCode.ifBlank { "KR" } == "KR"` 기준으로 분기된다.
+    - KR에서 미인증이면 기존 인증 다이얼로그/인증 플로우를 유지한다.
+    - 비KR에서 `isAdultContentVisible == false`이면 `ContentSettingsActivity`로 이동하고 `EXTRA_SHOW_SENSITIVE_CONTENT_GUIDE`를 전달한다.
+    - `lsp_diagnostics`는 현재 환경에서 Kotlin LSP 미구성으로 실행 불가 메시지를 확인했다.
+    - 자동 검증: `:app:testDebugUnitTest`, `:app:assembleDebug` 모두 성공했다.
+    - 수동 검증 시도 중 ADB 장치 연결이 해제되어 캐릭터 탭 실제 터치 시나리오를 끝까지 완료하지 못했다.
+
+- 2026-03-27
+  - 무엇/왜/어떻게: 한국 접속 + 본인인증 완료 상태에서도 `isAdultContentVisible == false`이면 19금 라이브 상세와 채팅 캐릭터 상세를 비KR OFF와 동일하게 처리하도록 게이트 조건을 조정했다.
+  - 실행 명령/도구:
+    - `task(explore: live/character gate 위치 점검)`
+    - `grep("ensureLoginAndAdultAuth|ensureLoginAndAuth|onCharacterClick")`
+    - `apply_patch(HomeFragment.kt, LiveFragment.kt, LiveNowAllActivity.kt, CharacterTabFragment.kt)`
+    - `lsp_diagnostics(수정된 .kt 파일 4개)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - `adb devices`
+    - `adb shell am force-stop kr.co.vividnext.sodalive.debug`
+    - `adb shell monkey -p kr.co.vividnext.sodalive.debug -c android.intent.category.LAUNCHER 1`
+    - `adb shell uiautomator dump /sdcard/window_dump.xml`
+  - 결과:
+    - KR에서 `isAuth=true`라도 `isAdultContentVisible=false`이면 19금 라이브 상세/캐릭터 상세 진입 시 `ContentSettingsActivity` 안내 흐름으로 분기된다.
+    - 기존 KR 미인증 케이스의 본인인증 다이얼로그 흐름은 유지된다.
+    - 자동 검증: `:app:testDebugUnitTest`, `:app:assembleDebug` 성공.
+    - `lsp_diagnostics`는 현재 환경에서 Kotlin LSP 미구성으로 실행 불가 메시지를 확인했다.
+    - 수동 QA는 디바이스 연결이 반복 해제되어 조건 기반 실제 탭 시나리오를 끝까지 수행하지 못했다.

docs/plan-task/20260327_연령제한표시조건수정.md

@@ -0,0 +1,35 @@
+# 연령제한 설정 UI 표시 조건 수정
+
+## 작업 목표
+- 라이브 생성, 콘텐츠 업로드 페이지의 연령제한 설정 UI 표시 조건을 접속국가와 `isAdultContentVisible` 기준으로 조정한다.
+
+## 체크리스트
+- [x] AC1: 공통 필수조건으로 `isAdultContentVisible == true`일 때만 연령제한 설정 UI를 표시한다.  
+  - QA: `isAdultContentVisible=false`에서 UI 미표시, `isAdultContentVisible=true`에서 국가별 추가 조건 적용 확인
+- [x] AC2: 접속국가가 한국(`countryCode == "KR"`)인 경우 `isAuth == true`일 때만 연령제한 설정 UI를 표시한다.  
+  - QA: KR + `isAuth=false` 미표시, KR + `isAuth=true` 표시
+- [x] AC3: 접속국가가 한국이 아닌 경우 `isAuth`와 무관하게 AC1만 충족하면 UI를 표시한다.  
+  - QA: non-KR + `isAdultContentVisible=true`에서 `isAuth` true/false 모두 표시
+- [x] AC4: 라이브 생성/콘텐츠 업로드 양쪽 페이지에 동일 규칙이 적용된다.  
+  - QA: 두 화면에서 동일 입력 조건 대비 동일 표시 결과 확인
+- [x] AC5: 변경 파일 진단/테스트/빌드 검증을 통과한다.  
+  - QA: Kotlin LSP 미지원 환경 확인, `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`
+
+## 검증 기록
+- 무엇/왜/어떻게: 라이브 생성(`LiveRoomCreateActivity`)과 콘텐츠 업로드(`AudioContentUploadActivity`)의 연령제한 UI 노출 조건을 공통 정책(`AdultContentVisibilityPolicy`)으로 통합했다. 요청 조건(필수 `isAdultContentVisible=true`, KR 추가 `isAuth=true`)을 두 화면에서 동일하게 적용하기 위해 기존 `isAuth` 단일 조건을 정책 함수 호출로 교체했다.
+  - 실행 명령: 코드 수정(해당 3개 Kotlin 파일 + 정책 테스트 1개 파일 추가)
+  - 결과: 두 화면 모두 `shouldShowAdultRestrictionSetting()` 기반으로 `llSetAdult` 표시 및 연령선택 핸들러 등록 조건이 동작하도록 반영됨
+
+- 무엇/왜/어떻게: 정책 로직의 조건 분기 오동작을 방지하기 위해 단위 테스트(`AdultContentVisibilityPolicyTest`)로 KR/non-KR, `isAdultContentVisible`, `isAuth`, 빈 `countryCode` 조합을 검증했다.
+  - 실행 명령: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.common.AdultContentVisibilityPolicyTest"`
+  - 결과: BUILD SUCCESSFUL
+
+- 무엇/왜/어떻게: 변경 영향 범위의 회귀 확인을 위해 디버그 단위 테스트 전체와 디버그 빌드를 수행했다.
+  - 실행 명령: `./gradlew :app:testDebugUnitTest`
+  - 결과: BUILD SUCCESSFUL
+  - 실행 명령: `./gradlew :app:assembleDebug`
+  - 결과: BUILD SUCCESSFUL
+
+- 무엇/왜/어떻게: 정적 진단 요구사항 확인을 위해 LSP diagnostics를 시도했으나 현재 실행 환경에는 `.kt`용 LSP 서버가 구성되어 있지 않음을 확인했다. 대신 Gradle 컴파일/테스트/빌드 성공으로 Kotlin 컴파일 오류 유무를 검증했다.
+  - 실행 명령: `lsp_diagnostics` (4개 Kotlin 파일)
+  - 결과: `No LSP server configured for extension: .kt`

docs/plan-task/20260327_콘텐츠보기설정파라미터전송정리.md

@@ -0,0 +1,36 @@
+# 20260327_콘텐츠보기설정파라미터전송정리
+
+## 작업 목적
+- `PATCH /member/content-preference`를 제외한 모든 API 요청에서 `isAdultContentVisible`, `contentType` 전송을 제거한다.
+
+## 구현 체크리스트
+- [x] 코드베이스에서 `isAdultContentVisible`, `contentType` 전송 위치를 전수 확인한다.
+- [x] 예외 API(`PATCH /member/content-preference`) 선언 및 호출 경로를 확인한다.
+- [x] 예외 API 외 DTO/호출부에서 두 파라미터를 제거한다.
+- [x] 수정 파일 진단, 테스트, 빌드 검증을 수행한다.
+- [x] 검증 기록을 문서 하단에 누적한다.
+
+## 수용 기준 (Pass/Fail)
+- [x] PASS: `PATCH /member/content-preference`에서는 `isAdultContentVisible`, `contentType`가 유지된다.
+- [x] PASS: 그 외 API 요청에서는 `isAdultContentVisible`, `contentType`가 전송되지 않는다.
+- [x] PASS: `./gradlew :app:testDebugUnitTest`가 성공한다.
+- [x] PASS: `./gradlew :app:assembleDebug`가 성공한다.
+
+## 검증 기록
+- 2026-03-27
+  - 무엇/왜/어떻게: `/member/content-preference` PATCH를 제외한 API 요청에서 `isAdultContentVisible`, `contentType` 전송을 제거했다. Retrofit API 시그니처와 각 Repository 호출 인자를 함께 정리해 누락 없이 제거했다.
+  - 실행 명령/도구:
+    - `task(explore: 전송 경로 탐색 2건)`
+    - `grep("@Query(\"isAdultContentVisible\")|@Query(\"contentType\")", include="*Api.kt")`
+    - `apply_patch(Live/Home/Search/Explorer/AudioContent/Series API·Repository 수정)`
+    - `lsp_diagnostics(수정된 .kt 파일 14개)`
+    - `grep("@PATCH(\"/member/content-preference\")", include="UserApi.kt")`
+    - `grep("@Query(\"isAdultContentVisible\")|@Query(\"contentType\")", include="*Api.kt")`
+    - `grep("isAdultContentVisible|contentType", include="*Request*.kt")`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과:
+    - `UserApi.kt`의 `@PATCH("/member/content-preference")`는 유지됨을 확인했다.
+    - 전체 `*Api.kt`에서 `@Query("isAdultContentVisible")`, `@Query("contentType")`가 0건임을 확인했다.
+    - `*Request*.kt`에서 두 필드는 `UpdateContentPreferenceRequest.kt` 1건만 남아 예외 API 요청으로 제한됨을 확인했다.
+    - `lsp_diagnostics`는 Kotlin LSP 미구성으로 진단 불가 메시지를 확인했다.
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug` 성공(`BUILD SUCCESSFUL`).

docs/plan-task/20260328_라이브룸방장캡쳐녹화허용.md

@@ -0,0 +1,43 @@
+# 20260328 라이브룸 방장 캡쳐/녹화 허용
+
+## 구현 체크리스트
+- [x] 방장 판별 시점과 캡처 보안 적용 지점을 확인한다. (QA: `isHost` 갱신 지점과 `FLAG_SECURE` 적용 지점 라인 확인)
+- [x] 방장일 때만 `FLAG_SECURE`를 해제하고, 청취자는 기존 차단 상태를 유지한다. (QA: 방장/비방장 분기에서 `addFlags`/`clearFlags` 동작 확인)
+- [x] 방장일 때 녹화 감지 기반 강제 mute가 적용되지 않도록 정합을 맞춘다. (QA: `syncCapturePrivacyMuteState` 분기 및 콜백 등록/해제 흐름 확인)
+- [x] 진단/빌드/테스트/수동 QA를 수행하고 결과를 기록한다. (QA: 실행 명령과 결과 로그 확인)
+
+## 검증 기록
+- 2026-03-28
+  - 무엇: 방장 예외 적용을 위한 코드베이스/외부 레퍼런스 병렬 탐색을 수행했다.
+  - 왜: `FLAG_SECURE`를 역할 기반으로 런타임 토글할 때 라이프사이클/콜백 경합 없이 최소 변경으로 구현하기 위해서다.
+  - 어떻게:
+    - 내부 탐색(`explore`):
+      - `bg_016c0dfd` (host 보안 플로우 맵)
+      - `bg_ba4aa673` (host 판별 지연 시 race 위험 분석)
+      - `bg_3132d80b` (저장소 내 역할 기반 secure 패턴 탐색)
+    - 외부 탐색(`librarian`):
+      - `bg_1875bb8f` (Android 공식 문서/AOSP의 addFlags/clearFlags 근거)
+      - `bg_d010820d` (OSS 동적 토글 사례: Fenix/Signal/Bitwarden)
+    - 직접 검색:
+      - `grep`/`ast_grep_search`/`sg run`으로 `FLAG_SECURE`, `isHost`, 콜백 등록/해제, mute 계산식을 교차 확인
+      - `rg`는 로컬 환경에 설치되어 있지 않아(`command -v rg` 결과 없음) `grep`/`sg`로 대체 검증
+
+- 2026-03-28
+  - 무엇: `LiveRoomActivity`에 방장 전용 캡처/녹화 허용 정책을 구현했다.
+  - 왜: 사용자 요청대로 방장(host)은 캡처/화면녹화를 허용하고, 청취자는 기존 차단 정책을 유지해야 하기 때문이다.
+  - 어떻게:
+    - `isHost` 판별 직후 정책 동기화를 위해 `syncCaptureSecurityPolicyByRole()`를 추가했다.
+      - 방장(`isHost=true`): `window.clearFlags(WindowManager.LayoutParams.FLAG_SECURE)` + 녹화 콜백 해제 + 강제 mute 상태 정리
+      - 청취자(`isHost=false`): `window.addFlags(WindowManager.LayoutParams.FLAG_SECURE)` + 포그라운드에서 녹화 콜백 등록 유지
+    - `viewModel.roomInfoLiveData.observe`에서 `isHost` 갱신 직후 `syncCaptureSecurityPolicyByRole()`를 호출해 비동기 roomInfo 도착 시점에도 즉시 반영되도록 했다.
+    - `syncCapturePrivacyMuteState()`를 `val shouldMute = !isHost && isScreenRecordingActive`로 변경해 방장은 녹화 중에도 강제 mute 대상에서 제외했다.
+
+- 2026-03-28
+  - 무엇: 진단/빌드/테스트/수동 QA를 완료했다.
+  - 왜: 컴파일 안정성과 요청 동작(방장 허용, 청취자 유지)을 실제 증거로 확인하기 위해서다.
+  - 어떻게:
+    - LSP 진단: `.kt` 서버 미구성으로 `lsp_diagnostics` 불가(환경 제약 확인), `.md` 파일 diagnostics는 없음.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`
+    - 수동 QA 명령: `python3` 스크립트로 정책 함수/분기/호출 순서/mute 계산식을 점검
+    - 수동 QA 결과: `MANUAL_QA_PASS: host can bypass capture security while listeners remain protected in source flow`

docs/plan-task/20260328_라이브룸캡쳐녹화차단점검.md

@@ -0,0 +1,42 @@
+# 20260328 라이브룸 캡쳐/화면녹화 차단 점검
+
+## 구현/점검 체크리스트
+- [x] `LiveRoomActivity` 내 캡쳐/화면녹화 차단 적용 지점 확인
+- [x] 전체 코드베이스에서 차단 해제/우회 가능 경로(`clearFlags`, `FLAG_SECURE` 재설정 등) 탐색
+- [x] 화면녹화 감지 및 후속 처리(음소거/콜백 등록 해제) 로직 검증
+- [x] 외부 레퍼런스(Android 공식 동작)와 현재 구현 정합성 검증
+- [x] 점검 결과 및 근거(명령/파일/라인) 기록
+
+## 검증 기록
+- 2026-03-28
+  - 무엇: 라이브룸 캡처/화면녹화 차단 적용 여부를 코드베이스 전역과 외부 레퍼런스로 교차 점검했다.
+  - 왜: 사용자 질문("현재 모든 사람이 캡쳐와 화면녹화가 불가능한지")에 대해 단일 파일 확인이 아닌 우회 경로/플랫폼 제약까지 포함한 근거를 확보해야 했기 때문이다.
+  - 어떻게:
+    - 병렬 탐색(내부): `explore` 에이전트 3건
+      - `bg_baa23d06` (LiveRoomActivity 보안 플로우 추적)
+      - `bg_c991f78f` (우회/해제 경로 탐색)
+      - `bg_a5c8b08e` (대체 라이브 진입 화면 탐색)
+    - 병렬 탐색(외부): `librarian` 에이전트 2건
+      - `bg_b2336b84` (Android 공식 동작/제약)
+      - `bg_320d7f9b` (OSS 구현 패턴 비교)
+    - 직접 검색/정적 검증 명령:
+      - `grep "FLAG_SECURE|registerScreenRecordingCallback|addScreenRecordingCallback|removeScreenRecordingCallback"` (저장소 전역)
+      - `ast_grep_search`/`sg run`으로 `window.addFlags(WindowManager.LayoutParams.FLAG_SECURE)` 및 `window.clearFlags(...)` 존재 여부 확인
+      - `grep "clearFlags\(|setFlags\("` (app/src/main/java 전역)
+      - `read`로 `LiveRoomActivity.kt` 라이프사이클/콜백/mute 처리 라인 직접 확인
+      - SDK 레퍼런스 확인: `/Users/klaus/Library/Android/sdk/platforms/android-35/data/api-versions.xml`
+  - 결과(핵심 근거):
+    - `LiveRoomActivity.kt:390`에서 `window.addFlags(WindowManager.LayoutParams.FLAG_SECURE)`가 무조건 적용된다.
+    - 앱 코드에서 `window.clearFlags(WindowManager.LayoutParams.FLAG_SECURE)`는 발견되지 않았다(`sg run`/`ast_grep_search`/`grep` 교차 검증).
+    - 녹화 감지/후처리 로직:
+      - 등록: `LiveRoomActivity.kt:1627` (`windowManager.addScreenRecordingCallback`)
+      - 해제: `LiveRoomActivity.kt:1654` (`windowManager.removeScreenRecordingCallback`)
+      - 상태 반영: `LiveRoomActivity.kt:1659-1693` (`isScreenRecordingActive` -> `isCapturePrivacyMuted` -> `applyEffectiveAudioMuteState`)
+    - API 레벨 근거:
+      - `addScreenRecordingCallback`/`removeScreenRecordingCallback`/`SCREEN_RECORDING_STATE_VISIBLE`는 API 35부터(`api-versions.xml:70441,70451,70475`).
+      - `FLAG_SECURE`는 Android 플랫폼 상수로 존재(`api-versions.xml:70558`).
+    - 권한 근거:
+      - `AndroidManifest.xml:19`에 `<uses-permission android:name="android.permission.DETECT_SCREEN_RECORDING" />` 선언이 존재한다.
+  - 결론:
+    - **LiveRoomActivity 화면에 입장한 사용자 기준으로는 캡처/녹화 노출이 차단되도록 구현되어 있다(FLAG_SECURE 적용 + 해제 경로 부재).**
+    - 다만 Android 공식 문서 범위상 `FLAG_SECURE`는 기본적으로 스크린샷/비보안 디스플레이 노출 차단을 보장하며, 모든 녹화 시나리오 100% 차단을 플랫폼이 절대 보장한다고 단정할 수는 없다.

docs/plan-task/20260328_마이페이지본인인증버튼숨김정렬유지.md

@@ -0,0 +1,29 @@
+# 마이페이지 본인인증 버튼 숨김 시 정렬 유지 수정
+
+## 작업 목표
+- 국가가 한국이 아닌 경우 `btn_identity_verification`을 숨기더라도 Function Buttons Grid의 다른 아이콘 위치가 기존과 동일하게 유지되도록 수정한다.
+
+## 체크리스트
+- [x] AC1: `countryCode != "KR"`인 경우 `btn_identity_verification`이 화면에 보이지 않는다.
+  - QA: `btnIdentityVerification.root.visibility`가 `View.INVISIBLE`로 설정되어 슬롯 공간이 유지되는지 코드 확인
+- [x] AC2: `countryCode != "KR"`인 경우에도 같은 행의 다른 버튼(`btn_notice`, `btn_event`, `btn_customer_service`) 위치가 기존과 동일하게 유지된다.
+  - QA: `View.GONE` 대신 `View.INVISIBLE` 사용 여부 확인
+- [x] AC3: `countryCode == "KR"`인 경우 기존 본인인증 버튼 노출/동작 로직이 유지된다.
+  - QA: KR 분기에서 기존 `View.VISIBLE` + 인증 상태별 버튼 설정 코드 보존 확인
+- [x] AC4: 변경 파일 진단/테스트/빌드 검증을 통과한다.
+  - QA: `lsp_diagnostics`, `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`
+
+## 검증 기록
+- 2026-03-28
+  - 무엇/왜/어떻게: Function Buttons Grid 두 번째 행이 `LinearLayout`의 `layout_weight` 기반이어서 `btn_identity_verification`을 `GONE` 처리하면 남은 버튼이 재배치된다. 슬롯은 유지하고 아이콘만 숨기기 위해 non-KR 분기에서 `View.GONE`을 `View.INVISIBLE`로 변경했다.
+  - 실행 명령/도구:
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(docs/20260328_마이페이지본인인증버튼숨김정렬유지.md)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과:
+    - non-KR 분기에서 `btnIdentityVerification.root.visibility = View.INVISIBLE`로 반영되어 버튼 슬롯 유지 조건을 충족했다.
+    - KR 분기의 `View.VISIBLE` 및 인증 상태별 버튼 구성 로직은 변경 없이 유지됐다.
+    - `.kt` 파일 대상 `lsp_diagnostics`는 현재 환경에 Kotlin LSP가 없어 실행 불가(`No LSP server configured for extension: .kt`)였고, 문서 파일 진단은 이슈 없음.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug`를 포함한 Gradle 실행이 `BUILD SUCCESSFUL`로 완료됐다.

docs/plan-task/20260328_멤버정보응답하위호환수정.md

@@ -0,0 +1,49 @@
+# 20260328_멤버정보응답하위호환수정.md
+
+## 개요
+- 이전 서버의 `/member/info` 응답에 `countryCode`, `isAdultContentVisible`, `contentType`가 없어도 신규 앱이 동일하게 동작하도록 하위 호환을 보장한다.
+
+## 요구사항 해석(확정)
+- `GetMemberInfoResponse`의 신규 필드 3개는 구서버 응답에서 누락될 수 있으므로 nullable로 처리한다.
+- `MainViewModel.getMemberInfo()` 동기화 시 누락된 값은 로컬 저장값(없으면 안전 기본값)으로 대체한다.
+
+## 완료 기준 (Acceptance Criteria)
+- [x] AC1: 구서버 응답(JSON에 신규 3개 필드 누락) 역직렬화가 실패하지 않는다.
+- [x] AC2: 구서버 응답 수신 시 `SharedPreferenceManager.countryCode/isAdultContentVisible/contentPreference`가 null로 오염되지 않고 기존 동작을 유지한다.
+- [x] AC3: 관련 단위 테스트와 디버그 빌드가 성공한다.
+
+## 구현 체크리스트
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/settings/notification/GetMemberInfoResponse.kt`
+  - 신규 필드(`countryCode`, `isAdultContentVisible`, `contentType`)를 nullable + default null로 변경
+- [x] `app/src/main/java/kr/co/vividnext/sodalive/main/MainViewModel.kt`
+  - 멤버 정보 동기화 시 신규 필드 null-safe fallback 적용
+- [x] `app/src/test/java/kr/co/vividnext/sodalive/settings/notification/GetMemberInfoResponseCompatibilityTest.kt`
+  - 구서버 응답 누락 필드 역직렬화 및 fallback 동작 검증 테스트 추가
+- [x] 검증 실행
+  - `lsp_diagnostics`(수정 파일)
+  - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.settings.notification.GetMemberInfoResponseCompatibilityTest"`
+  - `./gradlew :app:testDebugUnitTest`
+  - `./gradlew :app:assembleDebug`
+
+## 검증 기록
+- 기록 템플릿(후속 누적):
+  - YYYY-MM-DD
+    - 무엇/왜/어떻게:
+    - 실행 명령/도구:
+      - `명령 또는 사용 도구`
+    - 결과:
+
+- 2026-03-28
+  - 무엇/왜/어떻게: 구서버(`/member/info`)에서 신규 필드 3종이 누락돼도 신규 앱이 동일 동작하도록 응답 모델 nullable 처리 + 멤버 정보 동기화 fallback 로직을 적용했고, 역직렬화 호환 테스트를 추가했다.
+  - 실행 명령/도구:
+    - `apply_patch(GetMemberInfoResponse.kt, MainViewModel.kt, GetMemberInfoResponseCompatibilityTest.kt, docs/20260328_멤버정보응답하위호환수정.md)`
+    - `lsp_diagnostics(GetMemberInfoResponse.kt, MainViewModel.kt, GetMemberInfoResponseCompatibilityTest.kt)`
+    - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.settings.notification.GetMemberInfoResponseCompatibilityTest"`
+    - `./gradlew :app:testDebugUnitTest`
+    - `./gradlew :app:assembleDebug`
+    - `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.settings.notification.GetMemberInfoResponseCompatibilityTest" :app:assembleDebug`
+    - `read(app/build/test-results/testDebugUnitTest/TEST-kr.co.vividnext.sodalive.settings.notification.GetMemberInfoResponseCompatibilityTest.xml)`
+  - 결과:
+    - `lsp_diagnostics`는 `.kt` LSP 서버 미구성으로 실행 불가를 확인했다.
+    - 호환성 테스트 2건(구서버 누락 필드 역직렬화/신규 필드 정상 매핑)이 모두 통과했다.
+    - 전체 단위 테스트와 디버그 빌드가 모두 성공했고, 마지막 재검증 명령에서도 성공을 재확인했다.

docs/plan-task/20260329_라이브룸_UI미갱신_버그수정.md

@@ -0,0 +1,57 @@
+# 라이브룸 UI 미갱신 버그 수정
+
+## 현상
+- 라이브 입장 후 공지, 메뉴판 터치 시 UI가 보이지 않음
+- 상대방 채팅이 화면에 갱신되지 않음
+- 방장이 아닌 유저에게서 두드러지게 나타남
+- 키보드가 올라오거나 화면에 변화가 생기면 모든 것이 해결됨
+
+## 원인 분석
+- `BaseActivity`에서 `WindowCompat.setDecorFitsSystemWindows(window, false)` (edge-to-edge) 적용
+- `LiveRoomActivity`의 manifest에 `adjustPan` 설정과 edge-to-edge가 충돌
+- `adjustPan`은 시스템이 창을 pan 하려 하지만, edge-to-edge 모드에서는 앱이 insets을 직접 처리
+- 이 충돌로 DecorView 내부 스크롤 트래킹 상태가 불일치하여 `invalidate()` 더티 영역 계산 오류 발생
+- 키보드가 올라가면 시스템이 WindowInsets를 재분배하고, `OnApplyWindowInsetsListener`에서 `setPadding()` 호출 → `requestLayout()` → 전체 레이아웃 패스가 강제 수행되어 해결됨
+
+## 수정 방법
+- RTM과 RTC가 모두 연결 완료된 시점에 키보드를 프로그래밍적으로 올렸다 내려 레이아웃을 강제 갱신
+- `isRtcJoined`, `isRtmJoined` 플래그로 두 연결 상태를 추적
+- 두 플래그가 모두 true가 되면 `tryForceLayoutRefresh()`를 호출
+
+### 눈속임 처리 (사용자에게 변화가 보이지 않도록)
+1. 로딩 다이얼로그가 화면을 덮고 있는 동안 키보드 트릭을 수행
+2. `adjustNothing`으로 임시 전환하여 키보드가 화면을 밀어올리지 않도록 방지
+3. 키보드 show → 200ms 후 hide → `adjustPan` 복원 → 로딩 다이얼로그 dismiss
+4. RTM 콜백의 `loadingDialog.dismiss()`를 `tryForceLayoutRefresh()` 내부로 이동
+
+## 수정 계획
+
+- [x] `isRtcJoined`, `isRtmJoined` 플래그 추가
+- [x] `onJoinChannelSuccess`에서 `isRtcJoined = true` 설정 및 `tryForceLayoutRefresh()` 호출
+- [x] RTM 성공 콜백에서 `isRtmJoined = true` 설정 및 `tryForceLayoutRefresh()` 호출
+- [x] `tryForceLayoutRefresh()` 메서드 구현
+  - [x] adjustNothing 임시 전환으로 화면 이동 방지
+  - [x] 로딩 다이얼로그 뒤에서 키보드 트릭 수행
+  - [x] 완료 후 adjustPan 복원 및 로딩 다이얼로그 dismiss
+  - [x] Boolean 반환으로 RTM 콜백에서 fallback dismiss 처리
+- [x] 빌드 검증
+
+## 검증 기록
+
+### 2026-03-29 빌드 검증 (1차 - adjustNothing 방식)
+- 명령: `./gradlew :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL (16s, 46 tasks)
+- 변경 파일: `AndroidManifest.xml` (adjustPan→adjustNothing), `LiveRoomActivity.kt` (API S→R)
+- 비고: 실기기에서 효과 없음 → 되돌림
+
+### 2026-03-29 빌드 검증 (2차 - 키보드 강제 갱신 방식)
+- 명령: `./gradlew :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL (21s, 46 tasks)
+- 변경 파일: `LiveRoomActivity.kt` (RTM/RTC 연결 완료 후 키보드 올렸다 내리기)
+- 비고: 키보드가 화면을 위로 밀어올리는 것이 사용자에게 보임 → 눈속임 개선 필요
+
+### 2026-03-29 빌드 검증 (3차 - 눈속임 개선)
+- 명령: `./gradlew :app:assembleDebug`
+- 결과: BUILD SUCCESSFUL (18s, 46 tasks)
+- 변경 파일: `LiveRoomActivity.kt`
+- 방식: adjustNothing 임시 전환 + 로딩 다이얼로그 뒤에서 키보드 트릭 수행

docs/plan-task/20260330_라이브룸스탭해제미갱신수정.md

@@ -0,0 +1,23 @@
+# 20260330 라이브룸 스탭 해제 미갱신 수정
+
+## 작업 체크리스트
+- [x] 스탭 지정/해제 데이터 흐름을 확인해 해제 시점 UI 갱신 누락 원인을 특정한다.  
+  QA: 스탭 해제 직후 `LiveRoomProfileListAdapter` 항목에서 스탭 표시가 사라지는지 코드 경로로 검증.
+- [x] 원인에 맞춰 최소 수정으로 갱신 로직을 반영한다.  
+  QA: 스탭 지정 시 표시 유지 + 스탭 해제 시 즉시 표시 해제 로직이 함께 성립.
+- [x] 변경 파일 진단/테스트/빌드 검증을 수행한다.  
+  QA: `lsp_diagnostics` 무오류, 관련 테스트 통과, `:app:assembleDebug` 성공.
+
+## 검증 기록
+- 2026-03-30
+  - 무엇: `LiveRoomRequestType.CHANGE_LISTENER` 수신 후 `setListener` 성공 콜백에서 `setManagerMessage()`를 추가하고, 요청자 쪽의 조기 `getRoomInfo`/`setManagerMessage` 호출을 제거해 역할 변경 완료 시점에만 전체 동기화가 일어나도록 수정했다.
+  - 왜: 기존에는 스탭 해제 요청 직후 방장이 먼저 목록을 새로고침해 구 상태를 다시 받아오고, 실제 역할 전환 완료 시점의 재동기화가 늦어 `LiveRoomProfileListAdapter`에서 스탭 표시가 남는 race가 발생할 수 있었다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL` (2회 재실행으로 수정 후 동일 확인)
+    - 실행 명령: `./gradlew :app:lintDebug`
+    - 결과: `AndroidManifest.xml`의 `com.facebook.FacebookActivity` MissingClass 포함 기존 lint 오류(총 20 errors)로 실패
+    - 실행 명령: `./gradlew :app:ktlintCheck`
+    - 결과: `LiveRoomActivity.kt` 전역(기존 구간 포함) ktlint 위반 다수로 실패
+    - 진단 도구: Kotlin(`.kt`)용 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가 확인

docs/plan-task/20260330_라이브룸캡쳐녹화스탭권한확장.md

@@ -0,0 +1,51 @@
+# 20260330 라이브룸 캡쳐/녹화 스탭 권한 확장
+
+## 구현 체크리스트
+- [x] 화면 캡쳐/녹화 정책이 적용되는 분기(`isHost`, `FLAG_SECURE`, 녹화 감지 mute)와 스탭 판별 소스를 확인한다. (QA: `LiveRoomActivity`에서 정책 함수/호출 지점과 스탭 판별 API 확인)
+- [x] 화면 캡쳐/녹화 허용 대상을 방장에서 방장+스탭으로 확장한다. (QA: 정책 분기에서 방장/스탭 공통 허용, 일반 청취자 차단 유지 확인)
+- [x] 정책 변경 후 연관 UI/상태 동기화 로직의 정합성을 검증한다. (QA: 룸 정보 수신 시점과 포그라운드 전환 시점 모두에서 동일 정책 적용 확인)
+- [x] 진단/테스트/빌드 및 수동 QA를 수행하고 결과를 기록한다. (QA: 실행 명령과 결과 로그, 수동 검증 결과 기록)
+
+## 검증 기록
+- 2026-03-30
+  - 무엇: 작업 계획 문서를 생성하고 요청 범위를 방장+스탭 캡쳐/녹화 허용으로 고정했다.
+  - 왜: 구현 전 체크리스트 기반으로 정확한 범위와 검증 기준을 고정해 과/미구현을 방지하기 위해서다.
+  - 어떻게:
+    - `docs/20260330_라이브룸캡쳐녹화스탭권한확장.md` 신규 작성
+    - 체크리스트에 QA 기준(정책 분기/동기화/검증)을 명시
+
+- 2026-03-30
+  - 무엇: 캡쳐/녹화 권한 및 스탭 판별 로직을 병렬 탐색하고 변경 지점을 확정했다.
+  - 왜: 기존 정책이 방장(`isHost`) 기준으로 고정되어 있어 스탭 동적 권한 부여/회수 상황을 반영하려면 정확한 동기화 지점을 먼저 확보해야 했기 때문이다.
+  - 어떻게:
+    - 내부 탐색(`explore`):
+      - `bg_dd2bd641` (캡쳐 보안 플로우 맵)
+      - `bg_9c629910` (host-only guard 분류)
+      - `bg_649ec034` (스탭 판별 canonical predicate)
+    - 외부 탐색(`librarian`):
+      - `bg_22584dd7` (OSS 역할 기반 사례 탐색 시도)
+      - `bg_7d687143` (Android `FLAG_SECURE` 공식 레퍼런스 탐색)
+    - 직접 검색:
+      - `grep`으로 `syncCaptureSecurityPolicyByRole`, `syncCapturePrivacyMuteState`, `isEqualToManagerId`, `managerList` 교차 확인
+      - `ast_grep_search`로 `if (!isHost)` guard 위치 점검
+      - `rg`는 로컬 환경 미설치(`command -v rg` 결과 없음)로 `grep`/`ast-grep` 기반으로 대체 탐색
+
+- 2026-03-30
+  - 무엇: `LiveRoomActivity`의 캡쳐/녹화 허용 대상을 방장+스탭으로 확장했다.
+  - 왜: 스탭 권한은 입장 시 고정이 아니라 라이브 중간에 부여/해제되므로, 룸 정보 갱신 시점마다 권한을 재계산해 정책을 즉시 재동기화해야 하기 때문이다.
+  - 어떻게:
+    - `isStaff` 상태 필드와 `syncRoomRoleState(response)`를 추가해 `response.managerList` 기반으로 현재 사용자 스탭 여부를 계산
+    - `viewModel.roomInfoLiveData.observe`에서 `syncRoomRoleState(response)` 직후 `syncCaptureSecurityPolicyByRole()`를 호출하도록 변경
+    - `hasCapturePermissionByRole()` 헬퍼를 추가하고 캡쳐 정책/녹화 mute 계산을 `isHost` 단일 조건에서 `isHost || isStaff` 조건으로 확장
+      - `syncCaptureSecurityPolicyByRole()`: 방장+스탭은 `FLAG_SECURE` 해제/녹화 콜백 해제
+      - `syncCapturePrivacyMuteState()`: 일반 청취자만 녹화 감지 시 강제 mute
+
+- 2026-03-30
+  - 무엇: 진단/테스트/빌드/수동 QA를 수행했다.
+  - 왜: 변경이 컴파일 안정성과 요청 동작(방장+스탭 허용, 일반 차단, 중간 권한 변경 반영)을 만족하는지 증거로 확인하기 위해서다.
+  - 어떻게:
+    - LSP 진단: `.kt` 서버 미구성으로 `lsp_diagnostics` 실행 불가(환경 제약 확인)
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`
+    - 수동 QA 명령: `python3` 검증 스크립트로 정책 함수/역할 동기화/조건식을 점검
+    - 수동 QA 결과: `MANUAL_QA_PASS: host+staff 캡쳐/녹화 허용 분기와 런타임 재동기화 경로를 소스 기준으로 확인했습니다.`

docs/plan-task/20260330_라이브캡쳐녹화가능여부반영.md

@@ -0,0 +1,33 @@
+# 20260330 라이브 캡쳐/녹화 가능여부 반영
+
+## 구현 체크리스트
+- [x] 라이브 정보 응답 모델(`GetRoomInfoResponse`)에 `isCaptureRecordingAvailable` 필드를 추가한다.  
+  - QA: `GetRoomInfoResponse` 역직렬화 시 필드가 누락되어도 기본값으로 동작한다.
+- [x] `LiveRoomActivity`의 캡쳐/녹화 정책을 `isCaptureRecordingAvailable || isHost || isStaff` 기준으로 적용한다.  
+  - QA: 정책 함수와 `FLAG_SECURE`/녹화 콜백/강제 음소거 계산이 동일 기준으로 동작한다.
+- [x] 라이브 생성 경로(`LiveRoomCreateActivity`, `LiveRoomCreateViewModel`, `CreateLiveRoomRequest`)에 설정 UI/상태/요청 필드를 추가한다.  
+  - QA: 생성 화면 선택값이 `CreateLiveRoomRequest.isCaptureRecordingAvailable`로 전송된다.
+- [x] 라이브 수정 경로에서는 해당 설정을 변경하지 않도록 유지한다(생성 시에만 설정).  
+  - QA: `LiveRoomInfoEditDialog`/`EditLiveRoomInfoRequest`에 신규 항목을 추가하지 않는다.
+- [x] 변경 파일에 대해 정적 진단/테스트/빌드를 수행하고 결과를 기록한다.  
+  - QA: `lsp_diagnostics` 오류 0, 관련 테스트 및 빌드 명령 성공.
+
+## 검증 기록
+- `lsp_diagnostics` (`.kt`)  
+  - 무엇/왜/어떻게: 수정한 Kotlin 파일 정적 진단을 도구로 확인해 타입/문법 오류를 사전 점검했다.  
+  - 실행 명령: `lsp_diagnostics(filePath=<modified .kt>, severity="all")`  
+  - 결과: 현재 실행 환경에 Kotlin LSP가 없어(`No LSP server configured for extension: .kt`) 도구 기반 진단을 수행할 수 없었다.
+- Ktlint + 테스트 + 빌드 1차  
+  - 무엇/왜/어떻게: 코드 스타일/단위 테스트/디버그 빌드를 한 번에 검증해 회귀 가능성을 확인했다.  
+  - 실행 명령: `./gradlew :app:ktlintCheck :app:testDebugUnitTest :app:assembleDebug`  
+  - 결과: `:app:ktlintMainSourceSetCheck` 실패. 기존 `LiveRoomActivity.kt` 전역 스타일 위반(다수 라인)과 기존 `LiveRoomCreateViewModel.kt` unused import 경고로 실패했고, 이번 변경 기능 자체 컴파일/테스트 실패는 아님.
+- 테스트 + 빌드 2차  
+  - 무엇/왜/어떻게: 스타일 태스크 제외 후 기능 반영 코드가 실제로 컴파일/테스트를 통과하는지 재검증했다.  
+  - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`  
+  - 결과: `BUILD SUCCESSFUL`.
+- 수동 기능 검증(정책 반영 범위 확인)  
+  - 무엇/왜/어떻게: 생성 전용 제약과 라이브룸 정책 반영 범위를 텍스트 검색으로 직접 확인했다.  
+  - 실행 명령: 
+    - `grep("isCaptureRecordingAvailable", app/src/main/java/**/*.kt)`
+    - `grep("isCaptureRecordingAvailable", app/src/main/java/.../live/room/update/*.kt)`
+  - 결과: 신규 필드는 `GetRoomInfoResponse`, `CreateLiveRoomRequest`, `LiveRoomCreateViewModel`, `LiveRoomCreateActivity`, `LiveRoomActivity`에만 존재하며, 수정 경로(`live/room/update`)에는 미추가로 확인됨.

docs/plan-task/20260402_오디션배너숨기기.md

@@ -0,0 +1,29 @@
+# 홈 오디션 배너 숨기기
+
+## 작업 목표
+- 홈 화면의 오디션 배너(`iv_audition`)를 사용자에게 노출하지 않도록 수정한다.
+
+## 체크리스트
+- [x] AC1: 홈 화면에서 오디션 배너 뷰가 화면에 표시되지 않는다.
+  - QA: `fragment_home.xml`의 `iv_audition` 기본 가시성과 `HomeFragment`의 추가 노출 코드 부재를 확인
+- [x] AC2: 오디션 배너 숨김으로 인해 다른 홈 섹션 로직에는 영향이 없다.
+  - QA: `HomeFragment.kt`에서 `setupAudition()` 호출 제거 또는 무력화 범위가 오디션 배너에만 한정되는지 확인
+- [x] AC3: 변경 파일 진단/테스트/빌드 검증을 수행한다.
+  - QA: `lsp_diagnostics`, `./gradlew :app:testDebugUnitTest`, `./gradlew :app:assembleDebug`
+
+## 검증 기록
+- 2026-04-02
+  - 무엇/왜/어떻게: 홈 오디션 배너는 `fragment_home.xml`의 독립 `ImageView`(`iv_audition`)와 `HomeFragment.setupAudition()`에만 연결되어 있었다. 요청 범위만 정확히 반영하기 위해 XML 기본 가시성을 `gone`으로 바꾸고, 더 이상 필요 없는 `setupAudition()` 호출·함수·`AuditionActivity` import를 제거했다.
+  - 실행 명령/도구:
+    - `grep(ivAudition|setupAudition|AuditionActivity)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/home/HomeFragment.kt)`
+    - `read(app/src/main/res/layout/fragment_home.xml)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/home/HomeFragment.kt)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - `adb devices`
+  - 결과:
+    - `fragment_home.xml`의 `iv_audition`가 `android:visibility="gone"`으로 반영되어 기본 노출이 차단됐다.
+    - `HomeFragment.kt`에서 `setupAudition()` 호출과 구현이 제거되어 런타임에서 배너를 다시 노출하거나 클릭을 연결하는 코드가 남지 않았다.
+    - `lsp_diagnostics`는 현재 환경에 Kotlin LSP가 없어 실행 불가(`No LSP server configured for extension: .kt`)였고, 대신 Gradle 컴파일·테스트로 변경 정합성을 확인했다.
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`는 `BUILD SUCCESSFUL`로 완료됐다.
+    - `adb devices` 결과 연결된 기기/에뮬레이터가 없어 실제 홈 화면 수동 QA는 이 환경에서 수행할 수 없었다.

docs/plan-task/20260402_쿠폰등록해외사용자본인인증예외.md

@@ -0,0 +1,98 @@
+# 쿠폰 등록 버튼 노출 및 해외 사용자 본인인증 예외 수정
+
+## 작업 목표
+- 마이페이지 `btnCoupon` 터치 시 한국 사용자는 기존처럼 본인인증이 필요하고, 한국이 아닌 사용자는 본인인증 없이 쿠폰 등록 화면으로 이동하도록 수정한다.
+- 마이페이지 `btnCoupon`은 한국이 아닌 사용자에 한해 민감한 콘텐츠 보기 설정이 켜져 있을 때만 화면에 보이도록 수정한다.
+- 마이페이지 기능 버튼 영역을 `RecyclerView` 기반 그리드로 전환해 숨겨진 버튼이 있어도 중간 빈 슬롯 없이 왼쪽부터 자연스럽게 재배치되도록 수정한다.
+- `MyPageFragment`에 혼합된 기능 버튼 모델/어댑터 책임을 분리해 화면 제어와 렌더링 관심사를 정리한다.
+
+## 체크리스트
+- [x] AC1: `countryCode == "KR"` 이고 `isAuth == false`인 경우 기존처럼 인증 필요 토스트와 `showAuthDialog()`가 실행된다.
+  - QA: 한국 사용자 분기에서 기존 인증 요구 동작 유지 코드 확인
+- [x] AC2: `countryCode != "KR"` 이고 `isAuth == false`인 경우에도 `CanCouponActivity`로 이동한다.
+  - QA: 쿠폰 버튼 분기가 `isAuth || !isKoreanUser` 조건으로 허용되는지 코드 확인
+- [x] AC3: 이미 인증된 사용자는 국가와 무관하게 기존처럼 `CanCouponActivity`로 이동한다.
+  - QA: 인증 완료 사용자의 쿠폰 등록 진입 동작 유지 코드 확인
+- [x] AC4: 변경 파일 진단/검증 명령 결과를 기록한다.
+  - QA: `lsp_diagnostics`, 관련 Gradle 검증 명령 결과 기록
+- [x] AC5: `countryCode != "KR"` 이고 `SharedPreferenceManager.isAdultContentVisible == true`인 경우에만 쿠폰 버튼이 기능 버튼 목록에 포함되어 화면에 보인다.
+  - QA: 비한국 사용자에서 쿠폰 버튼 아이템이 민감한 콘텐츠 보기 설정값에 따라 리스트에 포함되는지 코드 확인
+- [x] AC6: `countryCode != "KR"` 이고 `SharedPreferenceManager.isAdultContentVisible == false`인 경우 쿠폰 버튼이 기능 버튼 목록에서 제외되어 화면에 보이지 않는다.
+  - QA: 비한국 사용자에서 쿠폰 버튼 아이템이 리스트에 추가되지 않는지 코드 확인
+- [x] AC7: `countryCode == "KR"` 인 경우 쿠폰 버튼 노출과 기존 한국/비한국 클릭 분기는 유지된다.
+  - QA: 한국 사용자에서는 버튼이 계속 보이고, 클릭 시 기존 인증 분기가 유지되는지 코드 확인
+- [x] AC8: 기능 버튼 영역이 `RecyclerView` 기반으로 렌더링되고, 숨겨진 버튼은 데이터 목록에서 제외되어 남은 버튼이 좌→우/상→하로 자연스럽게 압축 배치된다.
+  - QA: `fragment_my.xml`이 `RecyclerView`를 사용하고, `MyPageFragment`가 쿠폰/본인인증 버튼을 조건에 따라 아이템 리스트에 포함/제외하는지 코드 확인
+- [x] AC9: 쿠폰 버튼이 숨겨지는 비한국 사용자(`isAdultContentVisible == false`)에서도 기능 버튼 간 가로/세로 간격이 기존 4열 그리드와 동일하게 유지된다.
+  - QA: `GridLayoutManager(4)`와 `GridSpacingItemDecoration(..., 16dp, false)` 적용으로 기존 16dp 간격 패턴을 유지하는지 코드 확인
+- [x] AC10: `FunctionButtonItem`과 `FunctionButtonAdapter`가 `MyPageFragment` 밖 별도 파일로 분리되어 Fragment가 화면 상태/버튼 목록 조립에 집중한다.
+  - QA: 모델/어댑터 클래스가 별도 파일로 이동하고 `MyPageFragment` 하단 정의가 제거됐는지 코드 확인
+- [x] AC11: 기능 버튼 조립 로직은 `buildFunctionButtonItems()`로 분리되며, 기존 버튼 순서/조건/클릭 동작은 유지된다.
+  - QA: `MyPageFragment`가 `updateFunctionButtons()`에서 조립 함수 결과만 어댑터에 전달하는지, 버튼 분기 로직이 동일한지 코드 확인
+
+## 검증 기록
+- 2026-04-02
+  - 무엇/왜/어떻게: `MyPageFragment`의 쿠폰 등록 버튼은 기존에 `isAuth`만으로 진입 가능 여부를 판단해서 해외 사용자도 본인인증이 강제됐다. 한국 사용자만 인증이 필요하도록 `if (it.isAuth || !isKoreanUser)` 조건으로 최소 수정했다.
+  - 실행 명령/도구:
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과:
+    - `btnCoupon` 분기가 `it.isAuth || !isKoreanUser`로 반영되어 비한국 사용자는 미인증 상태에서도 `CanCouponActivity`로 진입하게 됐다.
+    - 한국 사용자이면서 미인증인 경우의 토스트 노출과 `showAuthDialog()` 호출 로직은 그대로 유지됐다.
+    - `.kt` 파일 대상 `lsp_diagnostics`는 현재 환경에 Kotlin LSP가 없어 실행 불가(`No LSP server configured for extension: .kt`)였다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug` 실행은 `BUILD SUCCESSFUL`로 완료됐다.
+- 2026-04-02
+  - 무엇/왜/어떻게: 추가 요구사항에 따라 쿠폰 버튼 자체 노출은 한국이 아닌 사용자에게만 민감한 콘텐츠 보기 설정을 따르도록 조정했다. `isKoreanUser`면 항상 버튼을 보여 주고, 비한국 사용자는 `SharedPreferenceManager.isAdultContentVisible`이 `true`일 때만 버튼을 보이게 하며, 숨겨질 때는 `return@observe`로 클릭 설정도 중단했다.
+  - 실행 명령/도구:
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과:
+    - 비한국 사용자는 `SharedPreferenceManager.isAdultContentVisible` 값에 따라 `btnCoupon.root.visibility`가 `View.VISIBLE` 또는 `View.GONE`으로 제어된다.
+    - 한국 사용자는 쿠폰 버튼이 계속 노출되고, 기존 인증 기반 클릭 분기도 유지된다.
+    - `.kt` 파일 대상 `lsp_diagnostics`는 현재 환경에 Kotlin LSP가 없어 실행 불가(`No LSP server configured for extension: .kt`)였다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug` 실행은 `BUILD SUCCESSFUL`로 완료됐다.
+- 2026-04-02
+  - 무엇/왜/어떻게: 기능 버튼 영역이 고정 2행 x 4열 `include` 구조여서 비한국 사용자에게서 쿠폰 버튼이 숨겨질 때 중간 빈칸이 남았다. `fragment_my.xml`을 `RecyclerView` 기반 4열 그리드로 바꾸고, `MyPageFragment`가 기존 버튼 순서를 유지한 채 조건에 맞는 버튼만 리스트에 담아 렌더링하도록 리팩터링했다.
+  - 실행 명령/도구:
+    - `apply_patch(app/src/main/res/layout/fragment_my.xml)`
+    - `apply_patch(app/src/main/res/layout/item_function_button.xml)`
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `apply_patch(docs/20260402_쿠폰등록해외사용자본인인증예외.md)`
+    - `read(app/src/main/res/layout/fragment_my.xml)`
+    - `read(app/src/main/res/layout/item_function_button.xml)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(app/src/main/res/layout/fragment_my.xml)`
+    - `lsp_diagnostics(app/src/main/res/layout/item_function_button.xml)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과:
+    - 쿠폰 버튼과 본인인증 버튼은 더 이상 고정 슬롯의 `visibility`로 숨기지 않고, 조건에 맞을 때만 `RecyclerView` 데이터에 포함된다.
+    - 비한국 사용자이면서 `SharedPreferenceManager.isAdultContentVisible == false`인 경우 쿠폰 버튼이 목록에서 빠져 나머지 기능 버튼이 좌측부터 자연스럽게 압축 배치된다.
+    - 가로/세로 간격은 `GridLayoutManager(4)` + `GridSpacingItemDecoration(..., 16dp, false)`로 기존 4열 레이아웃의 16dp 간격 패턴을 유지한다.
+    - 기존 버튼 제목, 아이콘, 클릭 액션, 한국/비한국 및 인증/민감 콘텐츠 조건은 그대로 유지됐다.
+    - `.kt`/`.xml` 대상 `lsp_diagnostics`는 현재 환경에 Kotlin/XML LSP가 없어 실행 불가(`No LSP server configured for extension: .kt/.xml`)였다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug` 실행은 `BUILD SUCCESSFUL`로 완료됐다.
+- 2026-04-02
+  - 무엇/왜/어떻게: `RecyclerView` 전환 이후 `MyPageFragment` 안에 기능 버튼 모델, 어댑터, 버튼 목록 조립이 함께 들어와 관심사가 섞였다. 기존 `mypage` 패키지의 어댑터 분리 패턴에 맞춰 `FunctionButtonItem`과 `FunctionButtonAdapter`를 별도 파일로 분리하고, Fragment에는 `buildFunctionButtonItems()`를 통한 버튼 목록 조립과 화면 제어만 남기도록 정리했다.
+  - 실행 명령/도구:
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/recent/RecentContentAdapter.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/profile/tag/MemberTagAdapter.kt)`
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/function_button/FunctionButtonItem.kt)`
+    - `apply_patch(app/src/main/java/kr/co/vividnext/sodalive/mypage/function_button/FunctionButtonAdapter.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/function_button/FunctionButtonItem.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/function_button/FunctionButtonAdapter.kt)`
+    - `read(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `lsp_diagnostics(app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt)`
+    - `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+  - 결과:
+    - `FunctionButtonItem`은 `app/src/main/java/kr/co/vividnext/sodalive/mypage/function_button/FunctionButtonItem.kt`로, `FunctionButtonAdapter`는 `.../FunctionButtonAdapter.kt`로 분리됐다.
+    - `MyPageFragment` 하단의 내부 모델/어댑터 정의는 제거됐고, `updateFunctionButtons()`는 `buildFunctionButtonItems()` 결과를 어댑터에 전달하는 역할만 수행한다.
+    - 버튼 순서, 쿠폰 노출 조건, 한국/비한국 인증 분기, 각 버튼 클릭 동작은 유지됐다.
+    - `.kt` 대상 `lsp_diagnostics`는 현재 환경에 Kotlin LSP가 없어 실행 불가(`No LSP server configured for extension: .kt`)였다.
+    - `:app:testDebugUnitTest`, `:app:assembleDebug` 실행은 `BUILD SUCCESSFUL`로 완료됐다.

docs/plan-task/20260413_라이브룸방장부재중복조회방지.md

@@ -0,0 +1,47 @@
+# 20260413 라이브룸 방장 부재 중복 조회 방지
+
+## 작업 체크리스트
+- [x] `LiveRoomActivity.onUserOffline`와 방장 부재 판별 흐름을 기준으로 중복 `getRoomInfo` 호출 조건을 확정한다.  
+  QA: 방장 offline 감지 후 후속 user offline 콜백에서는 방 정보 재조회 조건이 false여야 한다.
+- [x] 방장 부재가 확정된 뒤에는 추가 `getRoomInfo(roomId)`를 호출하지 않도록 최소 가드를 반영한다.  
+  QA: 비방장 offline은 기존처럼 재조회하되, 방장 offline 이후에는 재조회가 차단되어야 한다.
+- [x] 변경 파일 검증과 결과 기록을 남긴다.  
+  QA: 관련 단위 테스트, `:app:testDebugUnitTest`, `:app:assembleDebug` 결과를 문서 하단에 기록한다.
+- [x] leave/offline 신호로 발생한 `getRoomInfo`에서 종료 race의 room-not-found 메시지만 숨길 범위를 확정한다.  
+  QA: leave/offline 재조회에서만 room-not-found suppress가 적용되고, 다른 `getRoomInfo` 실패는 기존처럼 노출되어야 한다.
+- [x] 종료 race에서 내려오는 `라이브 정보가 없습니다.` 메시지를 사용자에게 노출하지 않도록 최소 변경을 반영한다.  
+  QA: leave/offline 기반 `getRoomInfo`가 room-not-found를 받아도 토스트가 발생하지 않아야 한다.
+
+## 검증 기록
+- 2026-04-13
+  - 무엇: `shouldSuppressLiveRoomInfoError` 허용 목록에 실제 테스트에서 사용한 한국어 room-not-found 문구(`라이브 정보가 없습니다.`)를 추가했다.
+  - 왜: 정책 함수는 다국어/문구 변형을 지원하도록 의도됐지만 한국어 변형 1종이 누락돼 `LiveRoomRoomInfoErrorPolicyTest`가 실패했다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomRoomInfoErrorPolicy.kt`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`
+- 2026-04-13
+  - 무엇: `LiveRoomActivity.onUserOffline`에서 방장 부재가 한 번 확인되면 후속 offline 콜백에서는 방 정보 재조회를 하지 않도록 `hasKnownHostAbsence` 가드와 `resolveLiveRoomOfflineAction` 정책 함수를 추가했다.
+  - 왜: 여러 사용자가 동시에 나가는 상황에서 방장 offline 이후에도 비방장 offline 콜백이 이어지면 `viewModel.getRoomInfo(roomId)`가 중복 호출될 수 있어, 방장이 없는 상태에서는 재조회를 막아야 했다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+    - 추가 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomOfflineActionPolicy.kt`
+    - 추가 파일: `app/src/test/java/kr/co/vividnext/sodalive/live/room/LiveRoomOfflineActionPolicyTest.kt`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.live.room.LiveRoomOfflineActionPolicyTest"`
+    - 결과: 최초 실행은 `Unresolved reference 'resolveLiveRoomOfflineAction'`로 실패했고, 정책 함수 추가 후 `BUILD SUCCESSFUL`로 통과했다.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`
+    - 진단 도구: Kotlin(`.kt`)용 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가 확인
+- 2026-04-13
+  - 무엇: leave/offline 신호로 발생한 `getRoomInfo`에만 `suppressRoomNotFoundError` 플래그를 추가하고, 종료 race에서 내려오는 `라이브 정보가 없습니다.`/room-not-found 메시지는 토스트로 노출하지 않도록 `shouldSuppressLiveRoomInfoError` 정책 함수를 연결했다.
+  - 왜: 일반 유저 leave/offline 신호가 방장 종료 신호보다 먼저 도착하면 이미 종료된 방에 대한 재조회가 먼저 실행될 수 있고, 이때의 room-not-found는 실제 장애가 아니라 종료 경합에 따른 기대된 실패이기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt`
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+    - 추가 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomRoomInfoErrorPolicy.kt`
+    - 추가 파일: `app/src/test/java/kr/co/vividnext/sodalive/live/room/LiveRoomRoomInfoErrorPolicyTest.kt`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.live.room.LiveRoomRoomInfoErrorPolicyTest"`
+    - 결과: 최초 실행은 `Unresolved reference 'shouldSuppressLiveRoomInfoError'`로 실패했고, 정책 함수 추가 후 `BUILD SUCCESSFUL`로 통과했다.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`
+    - 진단 도구: Kotlin(`.kt`)용 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가 확인

docs/plan-task/20260420_BlurTransformation오류수정.md

@@ -0,0 +1,34 @@
+# 20260420 BlurTransformation 오류 수정
+
+## 작업 체크리스트
+- [x] `BlurTransformation` 컴파일 오류의 실제 원인을 의존성 해석 기준으로 확정한다.  
+  QA: `dependencyInsight` 결과에서 어떤 경로가 `io.coil-kt:coil`을 2.x로 올리는지 확인되어야 한다.
+- [x] 최소 수정 방향을 정하고 실패 재현 경로를 확보한다.  
+  QA: `:app:compileDebugKotlin` 또는 관련 단위 테스트가 수정 전 실패해야 한다.
+- [x] Coil 2.x 환경에서 사용할 수 있는 로컬 `BlurTransformation` 호환 구현을 추가한다.  
+  QA: 기존 호출부 시그니처 `(context, 25f, 2.5f)`를 유지한 채 컴파일 가능해야 한다.
+- [x] `BlurTransformation` 사용처 import를 최소 범위로 교체한다.  
+  QA: 기존 blur 사용 화면만 수정되고, 다른 Coil transform 사용처는 변경되지 않아야 한다.
+- [x] 관련 테스트/컴파일 검증을 수행하고 결과를 기록한다.  
+  QA: 관련 단위 테스트와 `:app:compileDebugKotlin` 결과를 문서 하단에 남겨야 한다.
+
+## 검증 기록
+- 2026-04-20
+  - 무엇: `BlurTransformation` unresolved 오류의 원인을 `Daro -> Moloco -> coil-compose:2.2.2` 경로로 확정하고, Coil 2.x에서 사용할 로컬 `BlurTransformation` 호환 구현을 추가했다.
+  - 왜: `so.daro:daro-a:1.5.3` 추가 후 Moloco SDK가 `io.coil-kt:coil-compose:2.2.2`를 끌어오면서 앱의 `io.coil-kt:coil:1.4.0`이 2.2.2로 승격됐고, Coil 2에서 제거된 `coil.transform.BlurTransformation`만 컴파일 오류가 발생했기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/common/image/BlurTransformation.kt`
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/detail/SeriesDetailActivity.kt`
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/chat/original/detail/OriginalWorkDetailActivity.kt`
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/UserProfileActivity.kt`
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/creator_community/CreatorCommunityAdapter.kt`
+    - 추가 파일: `app/src/test/java/kr/co/vividnext/sodalive/common/image/BlurTransformationTest.kt`
+    - 실행 명령: `./gradlew :app:dependencyInsight --configuration debugRuntimeClasspath --dependency io.coil-kt:coil`
+    - 결과: `so.daro:daro-a:1.5.3 -> com.google.ads.mediation:moloco -> com.moloco.sdk:moloco-sdk:4.1.1 -> io.coil-kt:coil-compose:2.2.2 -> io.coil-kt:coil:2.2.2` 경로를 확인했다.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.common.image.BlurTransformationTest"`
+    - 결과: 수정 전에는 main source의 `BlurTransformation` unresolved로 실패했고, 호환 구현 추가 후 테스트 포함 `BUILD SUCCESSFUL`로 통과했다.
+    - 실행 명령: `./gradlew :app:compileDebugKotlin`
+    - 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`
+    - 진단 도구: Kotlin(`.kt`)용 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가 확인

docs/plan-task/20260420_DARO광고제거.md

@@ -0,0 +1,40 @@
+# 20260420 DARO 광고 제거
+
+## 작업 체크리스트
+- [x] DARO 광고 관련 실제 참조 범위를 확정한다.  
+  QA: `build.gradle`, `app/build.gradle`, `app/proguard-rules.pro`, `SodaLiveApp.kt`, `MyPageFragment.kt`, `fragment_my.xml`, `LiveRoomActivity.kt`, `LiveRoomViewModel.kt`, `LiveRoomDaroLightPopupPolicy.kt`, `LiveRoomDaroLightPopupPolicyTest.kt`, `.gitignore`, 관련 `docs/*.md`의 DARO 참조 여부를 근거로 설명할 수 있어야 한다.
+- [x] Gradle/설정 레벨의 DARO 의존성과 키 관련 설정을 제거한다.  
+  QA: 루트/plugin/module 의존성, `daroAppKey` 읽기, `.gitignore`의 DARO 키 파일 예외, `app/proguard-rules.pro`의 DARO 전용 규칙이 제거되어야 한다.
+- [x] 앱 초기화와 광고 노출 UI/로직에서 DARO 코드를 제거한다.  
+  QA: `SodaLiveApp`의 SDK 초기화, `MyPageFragment` 배너, `fragment_my.xml` 배너 컨테이너, `LiveRoomActivity` 라이트 팝업 관련 코드가 제거되어야 한다.
+- [x] DARO 제거 후 불필요해진 보조 코드와 테스트를 정리한다.  
+  QA: `LiveRoomViewModel`의 DARO 전용 조회 메서드, `LiveRoomDaroLightPopupPolicy.kt`, `LiveRoomDaroLightPopupPolicyTest.kt`가 정리되어야 한다.
+- [x] DARO 관련 작업 문서를 정리하고 검증 기록을 남긴다.  
+  QA: DARO 기능 추가용 문서(`20260420_Daro광고기본세팅.md`, `20260420_마이페이지배너광고추가.md`, `20260420_무료라이브라이트팝업광고적용.md`)를 제거하고, 의존성 이력 문서(`20260420_BlurTransformation오류수정.md`)는 과거 원인 기록으로 유지한 채 이 문서 하단에 검증 결과를 누적 기록해야 한다.
+
+## 범위 메모
+- 요청 해석은 "저장소에 남아 있는 DARO 광고 관련 코드/설정/전용 문서 제거"로 한정한다.
+- `local.properties`의 `daroAppKey`는 로컬 비추적 환경 설정이므로 이번 저장소 변경 범위에서는 제외한다.
+- `coreLibraryDesugaringEnabled`, `desugar_jdk_libs`, 외부 저장소 설정은 현재 근거만으로 DARO 전용이라고 단정할 수 없어 유지한다.
+
+## 검증 계획
+- `grep`으로 저장소 내 `Daro|daro|DARO` 참조를 재검색해 잔존 항목을 확인한다.
+- `./gradlew :app:testDebugUnitTest`를 실행해 단위 테스트 회귀를 확인한다.
+- `./gradlew :app:assembleDebug`를 실행해 앱 빌드 성공을 확인한다.
+- 필요 시 `git diff`로 DARO 제거 범위가 요청 범위를 넘지 않았는지 수동 확인한다.
+
+## 검증 기록
+- 2026-04-20
+  - 무엇: DARO 광고 관련 Gradle 의존성/플러그인, 앱 초기화, 마이페이지 배너, 라이브룸 라이트 팝업, 전용 정책/테스트, 로컬 DARO 키 파일, 관련 기능 문서를 제거했다.
+  - 왜: 저장소에서 더 이상 DARO 광고 SDK와 그 진입 경로가 남지 않도록 요청 범위를 코드/설정/전용 문서 기준으로 정리해야 했기 때문이다.
+  - 어떻게:
+    - 수정 파일: `build.gradle`, `app/build.gradle`, `app/proguard-rules.pro`, `.gitignore`, `app/src/main/java/kr/co/vividnext/sodalive/app/SodaLiveApp.kt`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`, `app/src/main/res/layout/fragment_my.xml`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomViewModel.kt`, `docs/20260420_DARO광고제거.md`
+    - 삭제 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomDaroLightPopupPolicy.kt`, `app/src/test/java/kr/co/vividnext/sodalive/live/room/LiveRoomDaroLightPopupPolicyTest.kt`, `docs/20260420_Daro광고기본세팅.md`, `docs/20260420_마이페이지배너광고추가.md`, `docs/20260420_무료라이브라이트팝업광고적용.md`, `app/daro-key.txt`
+    - 유지 항목: `local.properties`의 `daroAppKey`는 로컬 비추적 설정이라 저장소 변경 대상에서 제외했고, `coreLibraryDesugaringEnabled`, `desugar_jdk_libs`, 외부 저장소 설정은 DARO 전용 근거가 없어 유지했다.
+    - 실행 명령: `grep -R -nE "Daro|daro|DARO"`에 해당하는 저장소 재검색
+    - 결과: 코드/설정 대상(`*.kt`, `*.gradle`, `*.xml`, `*.pro`, `*.gitignore`)에서는 DARO 참조가 0건이었다. 남은 문자열은 `docs/20260420_DARO광고제거.md`와 과거 이력 문서 `docs/20260420_BlurTransformation오류수정.md`뿐이다.
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 결과: `BUILD SUCCESSFUL`. 단위 테스트와 debug 빌드가 모두 성공했고, Agora/Appsflyer 관련 기존 경고만 출력됐다.
+    - 실행 명령: `git status --short`
+    - 결과: DARO 제거와 직접 연결된 파일만 수정/삭제된 것을 수동 확인했다.
+    - 진단 도구: Kotlin(`.kt`)용 LSP 서버 미구성으로 `lsp_diagnostics` 실행 불가 확인

docs/plan-task/20260421_YandexMobileAdsSDK설정.md

@@ -0,0 +1,49 @@
+# 20260421 Yandex Mobile Ads SDK 설정
+
+## 작업 체크리스트
+- [x] Yandex Mobile Ads SDK 공식 요구사항과 현재 프로젝트 삽입 지점을 최종 확정한다.  
+  QA: 공식 quick start와 `settings.gradle`, `build.gradle`, `app/build.gradle`, `app/src/main/AndroidManifest.xml`, `app/src/main/java/kr/co/vividnext/sodalive/app/SodaLiveApp.kt` 근거로 저장소별 반영 위치를 설명할 수 있어야 한다.
+- [x] `app` 모듈에 Yandex Mobile Ads SDK 의존성을 추가한다.  
+  QA: `app/build.gradle`의 `dependencies`에 SDK가 추가되고, 현재 저장소의 repository 설정과 충돌하지 않아야 한다.
+- [x] 앱 초기화와 매니페스트 설정을 현재 앱 구조에 맞게 반영한다.  
+  QA: 공식 quick start 기준 자동 초기화가 기본값이므로 `SodaLiveApp`/매니페스트 변경 없이도 설정이 성립하며, 불필요한 앱 시작 동작 변경을 만들지 않아야 한다.
+- [x] App ID가 필요한 경우 사용자가 바로 수정할 수 있는 위치로 노출한다.  
+  QA: 공식 quick start 기준 Yandex 전용 App ID 입력은 필요하지 않음을 명시하고, 추후 광고 포맷 구현 시 ad unit ID를 넣을 위치를 별도 안내할 수 있어야 한다.
+- [x] 빌드 및 수동 검증 결과를 문서 하단에 기록한다.  
+  QA: 최소 `./gradlew :app:assembleDebug` 실행 결과와, 가능한 범위의 통합 확인 방법 또는 실제 로그 확인 절차가 누적 기록되어야 한다.
+
+## 범위 메모
+- 요청 해석은 "현재 Android 프로젝트에 Yandex Mobile Ads SDK 기본 설정을 추가하고, App ID가 필요하면 즉시 수정 가능한 위치를 마련해 안내"로 한정한다.
+- 광고 포맷 구현(배너/전면/보상형 등)은 이번 범위에 포함하지 않는다.
+- 서명/배포/Firebase/기존 광고 외 로직은 요청 범위 밖이므로 건드리지 않는다.
+
+## 검증 계획
+- `./gradlew :app:assembleDebug`로 Gradle 설정과 Android 리소스/매니페스트 병합이 정상인지 확인한다.
+- 필요 시 `./gradlew :app:lintDebug` 또는 관련 진단으로 신규 오류 여부를 확인한다.
+- 공식 문서의 "Yandex Ads" Logcat 확인 절차를 따라 수동 초기화/통합 확인 방법을 정리한다.
+
+## 검증 기록
+- 2026-04-21
+  - 무엇: Yandex Mobile Ads SDK 설정 작업을 시작하기 전에 작업 범위, 반영 지점, 검증 계획을 문서화했다.
+  - 왜: 저장소 규칙에 따라 `docs` 계획 문서를 먼저 만들고, 그 문서를 기준으로 구현/검증 이력을 누적해야 하기 때문이다.
+  - 어떻게:
+    - 생성 파일: `docs/20260421_YandexMobileAdsSDK설정.md`
+    - 근거 파일: `settings.gradle`, `build.gradle`, `app/build.gradle`, `app/src/main/AndroidManifest.xml`, 공식 문서 `https://ads.yandex.com/helpcenter/ko/dev/android/quick-start`
+    - 결과: 구현 전 체크리스트와 검증 계획을 먼저 고정했다.
+- 2026-04-21
+  - 무엇: Yandex Mobile Ads SDK quick-start 범위의 실제 코드 반영 지점을 확정하고 `app` 모듈에 SDK 의존성을 추가했다.
+  - 왜: 공식 문서 기준으로 현재 프로젝트는 repository 요구사항과 Android 버전 요구사항을 이미 만족하고 있었고, 최소 설정 변경은 `app/build.gradle` 의존성 추가만으로 충분했기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/build.gradle`
+    - 유지 파일: `settings.gradle`, `app/src/main/AndroidManifest.xml`, `app/src/main/java/kr/co/vividnext/sodalive/app/SodaLiveApp.kt`
+    - 적용 내용: `implementation 'com.yandex.android:mobileads:7.18.5'` 추가
+    - App ID 판단: 공식 quick start에는 Yandex 전용 App ID 설정 단계가 없어 별도 키를 추가하지 않았다. 추후 광고 포맷 구현 시 ad unit ID가 필요하다.
+- 2026-04-21
+  - 무엇: Yandex Mobile Ads SDK 의존성 추가 후 debug 빌드와 단위 테스트를 실행해 설정이 현재 프로젝트와 충돌하지 않는지 검증했다.
+  - 왜: dependency-only 변경이라도 실제 Gradle 해석, 의존성 해상도, 매니페스트 병합, 컴파일, 테스트 회귀를 통과해야 설정 완료라고 볼 수 있기 때문이다.
+  - 어떻게:
+    - 실행 명령: `./gradlew :app:assembleDebug :app:testDebugUnitTest`
+    - 결과: `BUILD SUCCESSFUL`
+    - 비고: Agora/Appsflyer 및 기존 코드 관련 경고는 출력됐지만, 이번 변경으로 인한 신규 실패는 없었다.
+    - 수동 확인 방법: 앱 실행 후 Logcat에서 `Yandex Ads`로 검색하면 `integrated successfully` 또는 `initialized successfully` 로그로 통합 상태를 확인할 수 있다.
+    - 진단 도구: `.gradle` 파일은 현재 저장소 LSP 대상이 아니어서 `lsp_diagnostics`는 `No LSP server configured for extension: .gradle`로 확인했다.

docs/plan-task/20260421_라이브룸무료방전면광고추가.md

@@ -0,0 +1,66 @@
+# 20260421 라이브룸 무료방 전면 광고 추가
+
+## 작업 체크리스트
+- [x] 무료방 판단값과 실제 입장 완료 시점을 근거 파일로 확정한다.  
+  QA: `GetRoomInfoResponse.isFreeRoom`, `LiveRoomActivity.joinChannel(...).rtmChannelJoinSuccess`를 근거로 설명할 수 있어야 한다.
+- [x] 광고 SDK 적용 방식과 ad unit id 주입 방식을 기존 패턴과 연결해 문서에 먼저 고정한다.  
+  QA: `MyPageFragment`의 `BuildConfig` 사용 패턴과 Yandex interstitial 공식 API(`InterstitialAdLoader`, `AdRequestConfiguration.Builder`, `show(activity)`)가 문서에 반영되어야 한다.
+- [x] `app/build.gradle`에 라이브룸 interstitial ad unit id를 debug/release별로 추가한다.  
+  QA: `BuildConfig.YANDEX_INTERSTITIAL_LIVE_ROOM_AD_UNIT_ID`가 두 buildType에서 생성되어야 한다.
+- [x] `LiveRoomActivity.kt`에 무료방 전면 광고 상태와 로드/노출/정리 로직을 추가한다.  
+  QA: 무료방일 때만 광고를 준비하고, 입장 완료 시점에 한 번만 전면 광고를 시도해야 하며, 실패해도 라이브 입장은 유지되어야 한다.
+- [x] 검증 결과를 문서 하단에 누적 기록한다.  
+  QA: 최소 빌드/테스트/수동 확인 결과와 실행 명령이 남아 있어야 한다.
+
+## 범위 메모
+- 요청 해석은 `LiveRoomActivity`에서 무료방 입장 시 Yandex interstitial 광고를 한 번 표시하는 것으로 한정한다.
+- 무료방 여부는 `app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt`의 `isFreeRoom`을 사용한다.
+- 광고 노출 시점은 실제 라이브룸 입장이 완료되는 `LiveRoomActivity.joinChannel(...).rtmChannelJoinSuccess`로 고정한다.
+- ad unit id는 `MyPageFragment` 배너 광고와 같은 방식으로 `app/build.gradle`의 `debug`/`release` `buildConfigField`에 추가한다.
+- 앱 전역 Yandex SDK 기본 설정은 이미 `SodaLiveApp.kt`에 있으므로 이번 작업에서 앱 초기화 로직은 변경하지 않는다.
+- 요청 범위를 넘는 UI 변경, 광고 재시도 루프, 별도 화면 분기 추가는 제외한다.
+- 현재 ad unit id 기본값은 debug/release 모두 `demo-interstitial-yandex`로 두고, 추후 실제 값 교체 위치를 `app/build.gradle`에 고정한다.
+
+## 예상 수정 파일
+- `docs/20260421_라이브룸무료방전면광고추가.md`
+- `app/build.gradle`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+
+## 검증 계획
+- `./gradlew :app:assembleDebug`로 debug 빌드와 `BuildConfig`/컴파일 반영 여부를 확인한다.
+- `./gradlew :app:testDebugUnitTest`로 기존 단위 테스트 회귀 여부를 확인한다.
+- 가능하면 무료방 진입 동작을 실제 앱에서 실행해 광고 시도와 라이브 입장 유지 여부를 수동 확인한다.
+
+## 검증 기록
+- 2026-04-21
+  - 무엇: 라이브룸 무료방 전면 광고 작업 범위와 구현 위치를 문서화했다.
+  - 왜: 저장소 규칙에 따라 `docs` 계획 문서를 먼저 만들고, 그 문서를 기준으로 구현과 검증 이력을 누적해야 하기 때문이다.
+  - 어떻게:
+    - 생성 파일: `docs/20260421_라이브룸무료방전면광고추가.md`
+    - 근거 파일: `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/info/GetRoomInfoResponse.kt`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`, `app/build.gradle`
+    - 근거 문서: `https://ads.yandex.com/helpcenter/ko/dev/android/interstitial`
+    - 결과: 무료방 판별값, 광고 노출 시점, ad unit id 설정 위치, 검증 계획을 구현 전에 먼저 고정했다.
+- 2026-04-21
+  - 무엇: 라이브룸 무료방 전면 광고 설정과 진입 시 interstitial 노출 로직을 추가했다.
+  - 왜: 무료방 입장 시에만 전면 광고를 한 번 보여주고, MyPageFragment와 같은 방식으로 buildType별 ad unit id를 관리해야 하기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/build.gradle`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+    - Gradle 반영: `debug`/`release` 각각에 `YANDEX_INTERSTITIAL_LIVE_ROOM_AD_UNIT_ID` `buildConfigField` 추가
+    - 기본값: `debug`/`release` 모두 `demo-interstitial-yandex`
+    - 코드 반영: `GetRoomInfoResponse.isFreeRoom`일 때만 광고를 preload하고, `joinChannel(...).rtmChannelJoinSuccess`에서 1회성으로 `show(activity)` 시도
+    - 정리 로직: `onAdDismissed`, `onAdFailedToShow`, `onDestroy`에서 listener와 ad 참조 해제
+- 2026-04-21
+  - 무엇: 변경 사항의 진단, 빌드, 테스트, 수동 실행 가능 여부를 확인했다.
+  - 왜: 이번 작업은 `BuildConfig` 생성과 Activity 진입 로직을 함께 바꾸므로 실제 컴파일과 런타임 실행 가능 여부를 함께 확인해야 하기 때문이다.
+  - 어떻게:
+    - 진단 도구: `lsp_diagnostics`
+    - 진단 결과: `.kt` LSP 서버 미설정으로 `No LSP server configured for extension: .kt`
+    - 실행 명령: `./gradlew :app:assembleDebug :app:assembleRelease :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 수동 확인 시도 1: `adb devices`
+    - 결과 1: 최초 확인 시 연결 기기 1대(`2cec640c34017ece`)가 보였다.
+    - 수동 확인 시도 2: `adb -s 2cec640c34017ece install -r "/Users/klaus/Develop/sodalive/Android/SodaLive/app/build/outputs/apk/debug/app-debug.apk"`
+    - 결과 2: `adb: device '2cec640c34017ece' not found`
+    - 수동 확인 시도 3: `adb devices`
+    - 결과 3: 이후에는 연결 기기 목록이 비어 실제 무료방 진입과 광고 실노출까지는 이어서 확인하지 못했다.
+    - 비고: 기능 런타임 확인은 ADB 연결이 다시 안정화된 뒤 debug 앱에서 무료방 진입 경로로 추가 확인이 필요하다.

docs/plan-task/20260421_마이페이지Yandex인라인배너추가.md

@@ -0,0 +1,82 @@
+# 20260421 마이페이지 Yandex 인라인 배너 추가
+
+## 작업 체크리스트
+- [x] Yandex adaptive inline banner 공식 요구사항과 MyPage 화면 삽입 위치를 확정한다.  
+  QA: `app/src/main/res/layout/fragment_my.xml`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`, Yandex adaptive inline banner 문서를 근거로 스크롤 콘텐츠 최하단 삽입으로 설명할 수 있어야 한다.
+- [x] 하단 인라인 배너 구현 계획과 ad unit id 교체 위치를 문서에 먼저 고정한다.  
+  QA: 변경 파일과 ad unit id 수정 지점이 문서에 명시되어 있어야 한다.
+- [x] `fragment_my.xml` 하단에 Yandex 배너 뷰를 추가한다.  
+  QA: `NestedScrollView` 내부 콘텐츠 맨 끝에 배너 뷰가 추가되고 기존 MyPage 여백 스타일과 크게 어긋나지 않아야 한다.
+- [x] `MyPageFragment.kt`에서 adaptive inline banner 크기 계산과 광고 로드를 구현한다.  
+  QA: 측정된 너비를 기준으로 `BannerAdSize.inlineSize(...)`를 설정하고, ad unit id를 한 곳에서 교체할 수 있어야 한다.
+- [x] 프래그먼트 뷰 종료 시 배너 리소스를 정리한다.  
+  QA: `onDestroyView()`에서 배너 뷰 정리 코드가 실행되어 뷰 생명주기 종료 후 누수 가능성을 줄여야 한다.
+- [x] 검증 결과를 문서 하단에 누적 기록한다.  
+  QA: 최소 진단/빌드/수동 확인 결과와 실행 명령이 남아 있어야 한다.
+
+## 범위 메모
+- 요청 해석은 `MyPageFragment`의 스크롤 콘텐츠 최하단에 Yandex adaptive inline banner를 추가하는 것으로 한정한다.
+- 화면 하단 고정 배너(sticky)가 아니라, 마이페이지를 끝까지 스크롤했을 때 보이는 inline 배너로 구현한다.
+- 현재 프로젝트에는 `productFlavors`가 없어, 이번 변경에서는 기존 변형(`debug`/`release`)별 `buildConfigField`로 ad unit id를 분기한다.
+- 현재 사용 중인 ad unit id는 `debug`에서 유지하고, `release`는 별도 값으로 교체할 수 있게 `app/build.gradle`의 각 변형 블록에 분리해 둔다.
+- 기존 SDK 의존성과 앱 초기화 코드는 이미 존재하므로 이번 작업에서 `app/build.gradle`, `SodaLiveApp.kt`는 수정하지 않는다.
+
+## 검증 계획
+- `lsp_diagnostics`로 변경 파일의 신규 오류 여부를 확인한다.
+- `./gradlew :app:assembleDebug`로 Android 리소스 병합과 컴파일 통과 여부를 확인한다.
+- 가능하면 앱에서 MyPage를 열고 최하단까지 스크롤하는 수동 확인 절차를 기준으로 결과를 남긴다.
+
+## 검증 기록
+- 2026-04-21
+  - 무엇: 마이페이지 Yandex 인라인 배너 추가 작업의 범위와 구현 위치를 문서화했다.
+  - 왜: 저장소 규칙에 따라 `docs` 계획 문서를 먼저 만들고, 그 문서를 기준으로 구현과 검증 이력을 누적해야 하기 때문이다.
+  - 어떻게:
+    - 생성 파일: `docs/20260421_마이페이지Yandex인라인배너추가.md`
+    - 근거 파일: `app/src/main/res/layout/fragment_my.xml`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`, `app/src/main/java/kr/co/vividnext/sodalive/app/SodaLiveApp.kt`
+    - 근거 문서: `https://ads.yandex.com/helpcenter/ko/dev/android/adaptive-inline-banner`
+    - 결과: 구현 전 체크리스트, 범위, ad unit id 교체 위치, 검증 계획을 먼저 고정했다.
+- 2026-04-21
+  - 무엇: MyPage 스크롤 콘텐츠 최하단에 Yandex inline banner 뷰와 배너 로드 코드를 추가했다.
+  - 왜: 요청 범위를 넓히지 않고 `MyPageFragment` 최하단에 adaptive inline banner를 붙이기 위해서다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/res/layout/fragment_my.xml`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`
+    - 레이아웃 반영: `fragment_my.xml`의 `NestedScrollView` 콘텐츠 마지막에 `@id/yandex_inline_banner_view` 추가
+    - 코드 반영: `setupBottomInlineBanner()`에서 측정된 너비 기준 `BannerAdSize.inlineSize(...)` 적용 후 `loadAd(...)` 호출
+    - ad unit id 교체 위치: `MyPageFragment.kt` companion object의 `YANDEX_INLINE_BANNER_AD_UNIT_ID`
+    - 정리 코드: `onDestroyView()`에서 `binding.yandexInlineBannerView.destroy()` 호출
+- 2026-04-21
+  - 무엇: 변경 사항의 진단, 빌드, 설치, 수동 확인 가능 여부를 점검했다.
+  - 왜: Kotlin/XML LSP 미지원 환경에서도 실제 Android 리소스 병합과 컴파일, 기기 설치까지 통과해야 안전하게 반영됐다고 볼 수 있기 때문이다.
+  - 어떻게:
+    - 진단 도구: `lsp_diagnostics`는 `.kt`, `.xml` 서버 미설정으로 사용 불가
+    - 실행 명령: `./gradlew :app:assembleDebug :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 추가 실행 명령: `adb devices`, `./gradlew :app:installDebug`, `adb shell am start -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.splash.SplashActivity`
+    - 추가 결과: 연결 기기 1대(`2cec640c34017ece`)에 debug 앱 설치 성공
+    - 수동 확인 결과: 앱 실행 후 캡처 화면이 검은 스플래시 상태로만 남아 MyPage 진입 및 배너 실노출 확인까지는 진행하지 못했다.
+    - 비고: `MainActivity` 직접 실행은 non-exported Activity라 `SecurityException`으로 불가했고, 로그상 이번 변경으로 인한 신규 크래시는 확인되지 않았다.
+- 2026-04-21
+  - 무엇: Yandex inline banner ad unit id를 변형별로 나누도록 수정했다.
+  - 왜: 현재 저장소는 `productFlavors` 없이 `debug`/`release` 변형만 사용하므로, 배포/테스트 환경에 따라 다른 ad unit id를 안전하게 적용할 수 있어야 하기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/build.gradle`, `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`
+    - Gradle 반영: `debug`/`release` 각각에 `buildConfigField 'String', 'YANDEX_INLINE_BANNER_AD_UNIT_ID', '"..."'` 추가
+    - 코드 반영: `MyPageFragment`가 companion object 상수 대신 `BuildConfig.YANDEX_INLINE_BANNER_AD_UNIT_ID`를 읽도록 변경
+    - 현재 기본값: `debug`는 `R-M-19140297-1`, `release`는 `REPLACE_WITH_RELEASE_YANDEX_INLINE_BANNER_AD_UNIT_ID`
+    - 추후 수정 위치: `app/build.gradle`의 `debug`/`release` 블록
+- 2026-04-21
+  - 무엇: 현재 사용 중인 ad unit id를 `debug`로 옮기고 `release`는 별도 값으로 분리했다.
+  - 왜: 요청대로 기존 ad unit id는 디버그 환경에서 유지하고, 릴리스 환경에서는 독립적으로 설정할 수 있어야 하기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/build.gradle`
+    - 값 조정: `debug`의 `YANDEX_INLINE_BANNER_AD_UNIT_ID`를 `R-M-19140297-1`로 변경
+    - 값 조정: `release`의 `YANDEX_INLINE_BANNER_AD_UNIT_ID`를 `REPLACE_WITH_RELEASE_YANDEX_INLINE_BANNER_AD_UNIT_ID`로 분리
+    - 릴리스 수정 위치: `app/build.gradle`의 `release` 블록
+- 2026-04-21
+  - 무엇: debug/release 분기 변경 후 빌드와 설정값 반영 상태를 다시 확인했다.
+  - 왜: 값만 바꾼 작업이라도 두 변형 모두 실제 Gradle 해석과 컴파일을 통과해야 하고, 현재 설정된 ad unit id가 어느 변형에 들어가는지 근거를 남겨야 하기 때문이다.
+  - 어떻게:
+    - 실행 명령: `./gradlew :app:assembleDebug :app:assembleRelease :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 설정 확인: `app/build.gradle` 재확인 결과 `debug`는 `R-M-19140297-1`, `release`는 `REPLACE_WITH_RELEASE_YANDEX_INLINE_BANNER_AD_UNIT_ID`
+    - 비고: `BuildConfig` 생성 파일 경로는 이 환경에서 직접 조회되지 않았지만, 두 변형 빌드가 모두 성공해 `buildConfigField` 값 주입 자체는 통과한 것으로 확인했다.

docs/plan-task/20260424_Yandex광고추가구현계획.md

@@ -0,0 +1,221 @@
+# 20260424 Yandex 광고 추가 구현 계획
+
+## 작업 체크리스트
+- [x] 대상 화면 3곳의 광고 삽입 위치와 기존 Yandex 광고 패턴을 조사한다.  
+  QA: `LiveFragment`, `LiveRoomDetailFragment`, `AudioContentDetailActivity`, `MyPageFragment`, `LiveRoomActivity`, 공식 Yandex 문서를 근거로 각 광고 형식과 삽입 위치를 설명할 수 있어야 한다.
+- [x] AD_UNIT_ID 운영 방식을 기존 Yandex 광고와 같은 구조로 정하고, 지면별 분리 여부를 판단한다.  
+  QA: 기존 `BuildConfig` 주입 패턴을 유지하면서 어떤 지면은 반드시 분리하고 어떤 경우에만 공용이 가능한지 문서에 남아 있어야 한다.
+- [x] `app/build.gradle`에 신규 광고 지면용 ad unit id를 buildType별로 추가한다.  
+  QA: `debug`/`release` 모두에서 라이브 탭 배너, 라이브 상세 배너, 콘텐츠 상세 전면 광고, 콘텐츠 상세 배너용 `BuildConfig` 값이 생성되어야 한다.
+- [x] 라이브 탭의 최근 종료한 라이브와 라이브 다시 듣기 사이에 Yandex adaptive inline banner를 추가한다.  
+  QA: `fragment_live.xml`의 `rv_latest_finished_live_channel` 다음, `ll_replay_live` 이전에 배너 컨테이너가 추가되고, 배너 최대 높이는 90dp를 넘지 않아야 한다.
+- [x] 라이브 상세 bottom sheet의 참여자 목록과 크리에이터 프로필 사이에 Yandex adaptive inline banner를 추가한다.  
+  QA: `fragment_live_room_detail.xml`의 `ll_participate_wrapper` 다음, 크리에이터 프로필 `RelativeLayout` 이전에 배너가 배치되고, bottom sheet 해제 시 배너 리소스가 정리되어야 한다.
+- [x] 콘텐츠 상세에서 무료 콘텐츠 재생 또는 미리듣기 시작 시 Yandex interstitial 광고를 추가한다.  
+  QA: `AudioContentDetailActivity.setupPlayArea()`의 실제 재생 시작 클릭 경로에서만 광고를 1회 시도하고, 광고 실패 여부와 무관하게 기존 재생 흐름이 유지되어야 한다.
+- [x] 콘텐츠 상세의 오픈예정/theme 표시 영역과 이전화/다음화 영역 사이에 Yandex adaptive inline banner를 추가한다.  
+  QA: `activity_audio_content_detail.xml`의 `ll_previous_next_content`와 theme/open 예정 `RelativeLayout` 사이에 배너가 추가되고, 최대 높이는 90dp를 넘지 않아야 한다.
+- [x] 각 화면 생명주기에 맞는 광고 로드/정리 코드를 반영한다.  
+  QA: 배너는 화면 종료 시 `destroy()`가 호출되고, 전면 광고는 listener와 ad 참조가 화면 종료 시 정리되어야 한다.
+- [x] 검증 결과를 문서 하단에 누적 기록한다.  
+  QA: 최소 빌드, 테스트, 수동 확인 계획과 실제 실행 결과가 문서 하단에 남아 있어야 한다.
+
+## 범위 메모
+- 이번 요청 범위는 아래 4개 광고 지면 추가로 한정한다.
+  - 라이브 탭 배너 1개
+  - 라이브 상세 배너 1개
+  - 콘텐츠 상세 전면 광고 1개
+  - 콘텐츠 상세 배너 1개
+- AD_UNIT_ID는 기존 Yandex 광고와 동일하게 `app/build.gradle`의 `debug`/`release` `buildConfigField`로 관리한다.
+- 배너 광고는 모두 Yandex adaptive inline banner를 기준으로 구현한다.
+- 사용자가 명시한 제약에 따라 모든 배너의 최대 높이는 90dp를 상한으로 둔다.
+- 전면 광고는 `AudioContentDetailActivity`에서 무료 콘텐츠 재생 또는 미리듣기 시작 시점에만 노출을 시도한다.
+- 앱 전역 Yandex SDK 의존성과 기본 초기화는 이미 `app/build.gradle`, `SodaLiveApp.kt`에 존재하므로 이번 작업에서 신규 SDK 도입이나 앱 초기화 구조 변경은 제외한다.
+- 기존 구현 패턴은 배너는 `MyPageFragment`, 전면 광고는 `LiveRoomActivity`를 우선 따른다.
+- 같은 포맷이라도 페이지 목적과 노출 맥락이 다르면 AD_UNIT_ID를 분리하는 방향을 기본값으로 둔다.
+- 실제 ad unit id 값은 아직 전달되지 않아 신규 4개 지면은 `BuildConfig`에 교체용 placeholder 문자열로 추가하고, 코드 구조와 주입 경로를 먼저 확정한다.
+
+## 조사 근거
+- 기존 배너 구현
+  - `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`
+  - `app/src/main/res/layout/fragment_my.xml`
+- 기존 전면 광고 구현
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/LiveRoomActivity.kt`
+- 앱 초기화
+  - `app/src/main/java/kr/co/vividnext/sodalive/app/SodaLiveApp.kt`
+- 대상 화면
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/LiveFragment.kt`
+  - `app/src/main/res/layout/fragment_live.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/LiveRoomDetailFragment.kt`
+  - `app/src/main/res/layout/fragment_live_room_detail.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+  - `app/src/main/res/layout/activity_audio_content_detail.xml`
+- 공식 문서
+  - `https://ads.yandex.com/helpcenter/ko/dev/android/adaptive-inline-banner`
+  - `https://ads.yandex.com/helpcenter/ko/dev/android/interstitial`
+
+## 구현 계획
+
+### 1. ad unit id 주입 지점 확정
+- 수정 대상: `app/build.gradle`
+- 계획:
+  - `debug`/`release` 각각에 신규 광고 지면용 `buildConfigField`를 추가한다.
+  - 계획 후보 키
+    - `YANDEX_INLINE_BANNER_LIVE_TAB_AD_UNIT_ID`
+    - `YANDEX_INLINE_BANNER_LIVE_ROOM_DETAIL_AD_UNIT_ID`
+    - `YANDEX_INTERSTITIAL_AUDIO_CONTENT_PLAY_AD_UNIT_ID`
+    - `YANDEX_INLINE_BANNER_AUDIO_CONTENT_DETAIL_AD_UNIT_ID`
+- 이유:
+  - 기존 `YANDEX_INLINE_BANNER_MYPAGE_AD_UNIT_ID`, `YANDEX_INTERSTITIAL_LIVE_ROOM_AD_UNIT_ID`와 동일한 관리 방식을 유지해야 하기 때문이다.
+
+### 1-1. AD_UNIT_ID 분리 전략
+- 권장안:
+  - 이번 작업의 4개 지면은 모두 **서로 다른 AD_UNIT_ID**를 사용한다.
+- 근거:
+  - 라이브 탭 배너, 라이브 상세 배너, 콘텐츠 상세 배너는 모두 같은 banner 포맷이지만 화면 맥락과 가시성, 스크롤 위치, 성과 측정 대상이 다르다.
+  - 콘텐츠 상세 전면 광고는 포맷 자체가 interstitial이라 배너와는 반드시 분리해야 한다.
+  - 지면별 AD_UNIT_ID를 분리하면 추후 리포트, fill rate, CTR, 운영 정책 조정, 특정 지면만 교체하는 작업이 쉬워진다.
+- 공용 ID가 가능한 경우:
+  - 완전히 동일한 포맷이고,
+  - 동일한 UX 목적을 가지며,
+  - 운영/리포트도 합산으로 봐도 되는 경우에만 공용 사용을 검토할 수 있다.
+- 이번 요청에서의 판단:
+  - 라이브 탭 배너 ↔ 라이브 상세 배너 ↔ 콘텐츠 상세 배너는 위치와 사용자 의도가 모두 달라 공용으로 묶지 않는 것이 낫다.
+  - 따라서 이번 계획에서는 **페이지별·지면별 분리**를 기준으로 문서와 코드 반영을 진행한다.
+
+### 2. 라이브 탭 배너 추가
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_live.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/LiveFragment.kt`
+- 위치:
+  - `fragment_live.xml`의 `rv_latest_finished_live_channel` 다음, `ll_replay_live` 이전
+- 계획:
+  - 스크롤 섹션 사이에 `BannerAdView` 또는 배너 전용 컨테이너를 추가한다.
+  - `LiveFragment`에 기존 `MyPageFragment.setupBottomInlineBanner()`와 같은 크기 계산/로드 로직을 화면 구조에 맞게 추가한다.
+  - `maxAdHeightDp`는 90으로 제한한다.
+  - `onDestroyView()`에서 배너 `destroy()`를 호출한다.
+
+### 3. 라이브 상세 배너 추가
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_live_room_detail.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/LiveRoomDetailFragment.kt`
+- 위치:
+  - `ll_participate_wrapper` 아래, 크리에이터 프로필 `RelativeLayout` 위
+- 계획:
+  - bottom sheet의 세로 흐름을 유지하면서 배너 컨테이너를 삽입한다.
+  - 참가자 영역이 숨겨지는 경우와 방장 여부에 따라 UI가 달라져도 광고 영역이 레이아웃을 깨지 않도록 표시 조건을 명확히 정한다.
+  - 배너 크기 계산 시 실제 측정 너비와 90dp 상한을 사용한다.
+  - fragment 종료 또는 dialog dismiss 시 배너 리소스를 해제한다.
+
+### 4. 콘텐츠 상세 전면 광고 추가
+- 수정 대상:
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+- 진입 경로 근거:
+  - `setupPlayArea()`에서 `binding.ivPlayOrPause.setOnClickListener(playClickAction)`
+  - `binding.llPreview.setOnClickListener(playClickAction)`
+  - 실제 재생은 `playClickAction` 내부의 `AudioContentPlayService` 시작으로 이어진다.
+- 계획:
+  - `LiveRoomActivity`의 `InterstitialAdLoader` / `InterstitialAdLoadListener` / `InterstitialAdEventListener` 패턴을 재사용한다.
+  - 무료 콘텐츠 재생 또는 미리듣기 클릭 시점에만 광고 노출을 시도한다.
+  - 재생/일시정지 버튼은 서비스 브로드캐스트 상태를 단일 기준으로 삼아, 재생 중이면 무조건 `PAUSE`만 보내고 광고 로직은 타지 않도록 분리한다.
+  - 광고가 없거나 실패하면 즉시 기존 `playClickAction`을 계속 진행한다.
+  - 중복 노출 방지를 위한 1회성 상태를 Activity 생명주기에 맞춰 정의한다.
+  - `onDestroy()`에서 loader, listener, ad 참조를 정리한다.
+
+### 5. 콘텐츠 상세 배너 추가
+- 수정 대상:
+  - `app/src/main/res/layout/activity_audio_content_detail.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+- 위치:
+  - `ll_previous_next_content` 다음, `tv_scheduled_to_open`/`tv_theme`를 포함한 `RelativeLayout` 이전
+- 계획:
+  - 현재 스크롤 흐름을 유지하면서 중간 섹션으로 배너를 삽입한다.
+  - `NestedScrollView` 내부 측정 너비 기준으로 adaptive inline banner를 로드한다.
+  - `maxAdHeightDp`는 90으로 제한한다.
+  - Activity 종료 시 배너 `destroy()`를 호출한다.
+
+## 예상 수정 파일
+- `docs/20260424_Yandex광고추가구현계획.md`
+- `app/build.gradle`
+- `app/src/main/res/layout/fragment_live.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/LiveFragment.kt`
+- `app/src/main/res/layout/fragment_live_room_detail.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/LiveRoomDetailFragment.kt`
+- `app/src/main/res/layout/activity_audio_content_detail.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+
+## 검증 계획
+- 공통
+  - `./gradlew :app:assembleDebug`
+  - `./gradlew :app:testDebugUnitTest`
+- 수동 확인
+  - 라이브 탭 진입 후 최근 종료한 라이브와 라이브 다시 듣기 사이에 배너가 보이는지 확인한다.
+  - 라이브 상세 bottom sheet를 열어 참여자 목록과 크리에이터 프로필 사이 배너 위치와 높이를 확인한다.
+  - 콘텐츠 상세에서 무료 콘텐츠 재생과 미리듣기 각각에 대해 전면 광고 시도 후 기존 재생 흐름이 유지되는지 확인한다.
+  - 콘텐츠 상세에서 이전화/다음화와 theme/open 예정 영역 사이 배너 위치와 높이를 확인한다.
+  - 모든 배너가 90dp를 넘지 않는지 레이아웃 검사 또는 화면 캡처로 확인한다.
+
+## 검증 기록
+- 2026-04-24
+  - 무엇: Yandex 광고 추가 작업의 구현 계획 문서를 생성했다.
+  - 왜: 저장소 규칙에 따라 구현 전에 `docs` 아래 계획 문서를 먼저 만들고, 그 문서를 기준으로 범위와 검증 기준을 고정해야 하기 때문이다.
+  - 어떻게:
+    - 생성 파일: `docs/20260424_Yandex광고추가구현계획.md`
+    - 근거 파일: `app/build.gradle`, `SodaLiveApp.kt`, `MyPageFragment.kt`, `LiveRoomActivity.kt`, `LiveFragment.kt`, `LiveRoomDetailFragment.kt`, `AudioContentDetailActivity.kt`, 각 대응 XML 레이아웃
+    - 근거 문서: `https://ads.yandex.com/helpcenter/ko/dev/android/adaptive-inline-banner`, `https://ads.yandex.com/helpcenter/ko/dev/android/interstitial`
+    - 결과: 광고 형식, 삽입 위치, 90dp 배너 높이 제한, 예상 수정 파일, 검증 계획을 구현 전에 확정했다.
+- 2026-04-24
+  - 무엇: AD_UNIT_ID 운영 전략을 기존 Yandex 광고와 같은 `BuildConfig` 방식으로 정리하고, 지면별 분리 여부 판단을 문서에 반영했다.
+  - 왜: 구현 전에 ad unit 관리 방식을 고정해야 이후 코드 반영과 운영 기준이 흔들리지 않고, 지면별 성과 측정 단위도 명확해지기 때문이다.
+  - 어떻게:
+    - 기준 패턴: `MyPageFragment`의 inline banner id, `LiveRoomActivity`의 interstitial id
+    - 판단 결과: 이번 작업의 4개 지면은 화면 맥락과 포맷이 달라 모두 별도 AD_UNIT_ID를 사용하는 방향으로 계획을 확정했다.
+    - 결과: `app/build.gradle`의 `buildConfigField`를 지면별로 추가하는 방향이 계획 문서에 반영됐다.
+- 2026-04-24
+  - 무엇: 계획 문서 기준으로 라이브 탭, 라이브 상세, 콘텐츠 상세의 Yandex 광고 코드를 실제 반영했다.
+  - 왜: 사용자 요청대로 3개 화면의 지정 위치에 배너/전면 광고를 추가하고, 기존 저장소의 Yandex 광고 패턴을 동일하게 확장해야 했기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/build.gradle`, `app/src/main/res/layout/fragment_live.xml`, `app/src/main/java/kr/co/vividnext/sodalive/live/LiveFragment.kt`, `app/src/main/res/layout/fragment_live_room_detail.xml`, `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/LiveRoomDetailFragment.kt`, `app/src/main/res/layout/activity_audio_content_detail.xml`, `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+    - BuildConfig 반영: 신규 4개 지면용 `YANDEX_*` ad unit id 필드를 `debug`/`release`에 각각 추가했다.
+    - 라이브 탭: `rv_latest_finished_live_channel`과 `ll_replay_live` 사이에 `BannerAdView`를 추가하고, `LiveFragment`에서 90dp 상한의 adaptive inline banner를 로드하도록 구현했다.
+    - 라이브 상세: `ll_participate_wrapper`와 크리에이터 프로필 블록 사이에 `BannerAdView`를 추가하고, `LiveRoomDetailFragment`에서 90dp 상한의 adaptive inline banner를 로드하도록 구현했다.
+    - 콘텐츠 상세: `ll_previous_next_content`와 theme/open 예정 블록 사이에 `BannerAdView`를 추가하고, `AudioContentDetailActivity`에서 90dp 상한의 adaptive inline banner를 로드하도록 구현했다.
+    - 콘텐츠 상세 전면 광고: 무료 재생 또는 미리듣기 클릭 경로만 interstitial로 감싸고, 광고가 없거나 실패하면 기존 재생 액션을 즉시 이어가도록 구현했다.
+    - 정리 코드: `LiveFragment.onDestroyView()`, `LiveRoomDetailFragment.onDestroyView()`, `AudioContentDetailActivity.onDestroy()`에서 배너/전면 광고 리소스를 정리했다.
+- 2026-04-24
+  - 무엇: 빌드, 테스트, 린트, 수동 확인 가능 여부를 점검했다.
+  - 왜: 이번 변경은 `BuildConfig`, Kotlin, XML, 화면 생명주기를 함께 건드리므로 최소 컴파일·테스트와 실제 실행 가능 여부를 함께 확인해야 하기 때문이다.
+  - 어떻게:
+    - 진단 도구: `lsp_diagnostics`
+    - 진단 결과: `.kt` LSP 서버 미설정으로 `No LSP server configured for extension: .kt`
+    - 실행 명령: `./gradlew :app:assembleDebug`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:ktlintCheck`
+    - 실행 결과: 실패
+    - 린트 실패 원인: `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt:1:1 Package name must not contain underscore`
+    - 린트 판단: 현재 저장소의 기존 패키지 경로 `audio_content` 때문에 발생한 규칙 위반으로, 이번 작업에서 새로 만든 오류는 확인되지 않았다.
+    - 실행 명령: `adb devices`
+    - 실행 결과: 연결 기기 없음
+    - 수동 확인 결과: ADB 연결 기기가 없어 앱 설치 및 실제 광고 노출 경로 수동 검증까지는 진행하지 못했다.
+    - 비고: 신규 ad unit id는 placeholder 문자열로 넣었으므로, 실제 광고 서버 응답 검증은 실 ad unit id 교체 후 추가 확인이 필요하다.
+- 2026-04-24
+  - 무엇: Oracle 검토 의견을 반영해 배너 높이 상한과 interstitial 종료 경로 안전장치를 보강한 뒤 다시 빌드와 테스트를 확인했다.
+  - 왜: 코드상 `maxAdHeightDp = 90`만으로 끝내지 않고 XML 레벨에서도 90dp 상한을 명시해 두는 편이 안전하고, Activity 종료 중 광고 콜백이 들어와도 재생 동작이 이어지지 않도록 방어해야 하기 때문이다.
+  - 어떻게:
+    - 수정 파일: `fragment_live.xml`, `fragment_live_room_detail.xml`, `activity_audio_content_detail.xml`, `AudioContentDetailActivity.kt`
+    - 추가 반영: 각 `BannerAdView`에 `android:maxHeight="90dp"`를 명시했다.
+    - 추가 반영: `AudioContentDetailActivity.continuePendingAudioContentPlayAction()`에서 `isFinishing || isDestroyed`일 때 재생 액션을 중단하도록 보강했다.
+    - 실행 명령: `./gradlew :app:assembleDebug`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+- 2026-04-24
+  - 무엇: 콘텐츠 상세의 재생/일시정지 버튼과 전면 광고 게이팅 로직을 사용자 의도에 맞게 분리했다.
+  - 왜: 기존 구현은 pause 아이콘이 보여도 클릭 리스너가 재생 경로를 유지해, 무료 콘텐츠 또는 미리듣기에서 pause 클릭 시 전면 광고가 늦게 뜨는 문제가 있었기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+    - 상태 기준: `AudioContentPlayService` 브로드캐스트의 `EXTRA_AUDIO_CONTENT_PLAYING` 값을 단일 기준으로 사용하도록 정리했다.
+    - 버튼 동작: 재생 중이면 `PAUSE`만 보내고, 재생 시작 시점에만 무료/미리듣기 대상 여부를 판단해 interstitial을 시도하도록 분리했다.
+    - 기대 효과: 무료 콘텐츠 또는 유료 콘텐츠 미리듣기에서 “재생 시작 시”에만 전면 광고가 걸리고, pause 클릭은 즉시 pause로 동작한다.

docs/plan-task/20260424_커뮤니티시리즈알림Yandex배너광고추가계획.md

@@ -0,0 +1,238 @@
+# 20260424 커뮤니티/시리즈/알림 Yandex 배너 광고 추가 계획
+
+## 작업 체크리스트
+- [x] 대상 6개 화면의 배너 삽입 위치와 기존 Yandex inline banner 패턴을 최종 확정한다.  
+  QA: `CreatorCommunityAllActivity`, `SeriesMainHomeFragment`, `SeriesMainDayOfWeekFragment`, `SeriesMainByGenreFragment`, `PushNotificationListActivity`, `NotificationReceiveSettingsActivity`와 기존 `MyPageFragment`, `LiveFragment`, `LiveRoomDetailFragment`, `AudioContentDetailActivity`를 근거로 각 위치를 설명할 수 있어야 한다.
+- [x] AD_UNIT_ID 운영 방식을 기존 광고와 동일한 조건으로 정리하고, 생성/재사용 기준을 문서에 고정한다.  
+  QA: `app/build.gradle`의 기존 `YANDEX_INLINE_BANNER_*` `buildConfigField` 패턴을 기준으로, 어떤 지면이 기존 ID를 재사용하고 어떤 경우에만 신규 ID를 만드는지 설명할 수 있어야 한다.
+- [x] 크리에이터 커뮤니티 전체보기 화면의 탭과 `RecyclerView` 사이 배너 추가 계획을 수립한다.  
+  QA: `activity_creator_community_all.xml`에서 탭 하단 구분선 아래, 콘텐츠 `FrameLayout` 위에 배너 위치가 명시되어야 한다.
+- [x] 시리즈 메인 홈 화면의 완결 시리즈와 추천 시리즈 사이 배너 추가 계획을 수립한다.  
+  QA: `fragment_series_main_home.xml`에서 `ll_completed_series` 다음, `ll_recommend_series` 이전에 배너 위치가 명시되어야 한다.
+- [x] 시리즈 메인 요일별 화면의 요일 `RecyclerView`와 시리즈 `RecyclerView` 사이 배너 추가 계획을 수립한다.  
+  QA: `fragment_series_main_day_of_week.xml`에서 `rv_series_day_of_week_day` 다음, `rv_series_day_of_week` 이전에 배너 위치가 명시되어야 한다.
+- [x] 시리즈 메인 장르별 화면의 장르 `RecyclerView`와 시리즈 `RecyclerView` 사이 배너 추가 계획을 수립한다.  
+  QA: `fragment_series_main_by_genre.xml`에서 `rv_genre` 다음, `rv_series_by_genre` 이전에 배너 위치가 명시되어야 한다.
+- [x] 알림 리스트 화면의 카테고리와 알림 리스트 사이 배너 추가 계획을 수립한다.  
+  QA: `activity_push_notification_list.xml`에서 `rv_category` 아래, `rv_notification`를 감싸는 `FrameLayout` 위 또는 내부 상단에 배너 위치와 빈 상태(`ll_empty`) 영향이 정리되어야 한다.
+- [x] 알림 수신 설정 화면의 팔로잉 채널과 서비스 알림 사이 배너 추가 계획을 수립한다.  
+  QA: `activity_notification_receive_settings.xml`에서 서비스 알림 카드 영역 아래, 팔로잉 채널 섹션 제목 위에 배너 위치가 명시되어야 한다.
+- [x] 각 화면 생명주기에 맞는 배너 로드/정리 규칙과 검증 계획을 문서에 남긴다.  
+  QA: Activity/Fragment 종료 시 `BannerAdView.destroy()` 호출 위치, `assembleDebug`/`testDebugUnitTest` 기준, 수동 확인 포인트가 문서에 있어야 한다.
+
+## 범위 메모
+- 이번 요청 범위는 아래 6개 화면에 **Yandex adaptive inline banner**를 추가하기 위한 계획 문서 작성으로 한정한다.
+  - `CreatorCommunityAllActivity`
+  - `SeriesMainHomeFragment`
+  - `SeriesMainDayOfWeekFragment`
+  - `SeriesMainByGenreFragment`
+  - `PushNotificationListActivity`
+  - `NotificationReceiveSettingsActivity`
+- 광고 포맷은 모두 inline banner로 통일하고, 전면 광고·보상형 광고·배너 슬라이더 변경은 이번 범위에 포함하지 않는다.
+- 기존 Yandex SDK 의존성과 앱 초기화(`SodaLiveApp`)는 이미 존재하므로 이번 작업에서 SDK 추가나 초기화 구조 변경은 제외한다.
+- 기존 광고와 동일하게 ad unit id는 `app/build.gradle`의 `debug`/`release` `buildConfigField`를 우선 기준으로 사용한다.
+- **AD_UNIT_ID 생성 또는 재사용 원칙**
+  - 기존 광고와 동일한 운영 조건으로 판단한다.
+  - 동일 포맷(inline banner)이고 운영에서 같은 지면으로 취급해도 되는 경우에는 기존 AD_UNIT_ID 재사용을 우선 검토한다.
+  - 화면 목적, 노출 위치, 성과 분리, 운영 정책 분리가 필요한 경우에만 같은 방식의 신규 `buildConfigField`를 생성한다.
+  - 최종 재사용 여부는 서버/광고 운영 기준 확인 후 확정하되, 구현 구조는 재사용/신규 생성 모두 수용 가능하게 계획한다.
+  - 현재 구현은 **지면별 `buildConfigField`를 분리**했고, `app/build.gradle`에 각 지면별 ad unit 값을 별도 선언해 관리한다.
+- 기존 구현 관례상 inline banner는 `BannerAdView`를 XML에 배치하고, 코드에서 실제 측정 너비 기준으로 `BannerAdSize.inlineSize(...)`를 설정한 뒤 `loadAd(...)`를 호출한다.
+- 기존 구현 관례상 배너 높이 상한은 XML `android:maxHeight="90dp"`와 코드의 `maxAdHeightDp = 90` 조합을 기본값으로 둔다.
+
+## 조사 근거
+- 기존 inline banner 구현
+  - `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/LiveFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/room/detail/LiveRoomDetailFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+- 기존 ad unit id 주입
+  - `app/build.gradle`
+- 대상 화면
+  - `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/creator_community/all/CreatorCommunityAllActivity.kt`
+  - `app/src/main/res/layout/activity_creator_community_all.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/home/SeriesMainHomeFragment.kt`
+  - `app/src/main/res/layout/fragment_series_main_home.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/day_of_week/SeriesMainDayOfWeekFragment.kt`
+  - `app/src/main/res/layout/fragment_series_main_day_of_week.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/by_genre/SeriesMainByGenreFragment.kt`
+  - `app/src/main/res/layout/fragment_series_main_by_genre.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListActivity.kt`
+  - `app/src/main/res/layout/activity_push_notification_list.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/settings/notification/NotificationReceiveSettingsActivity.kt`
+  - `app/src/main/res/layout/activity_notification_receive_settings.xml`
+- 공식 문서
+  - `https://ads.yandex.com/helpcenter/ko/dev/android/adaptive-inline-banner`
+
+## 구현 계획
+
+### 1. AD_UNIT_ID 운영 기준 확정
+- 수정 후보: `app/build.gradle`
+- 계획:
+  - 기존 `YANDEX_INLINE_BANNER_*` `buildConfigField` 선언 구조를 그대로 따른다.
+  - 운영에서 이번 6개 지면을 기존 inline banner와 같은 지면으로 묶을 수 있으면, 기존 inline banner용 AD_UNIT_ID를 재사용한다.
+  - 지면별 리포트 분리나 운영 분리가 필요하면 화면 또는 위치 단위로 신규 `YANDEX_INLINE_BANNER_*` 필드를 추가한다.
+- 판단 기준:
+  - 재사용 가능: 같은 포맷, 같은 운영 정책, 같은 성과 집계 단위로 봐도 되는 경우
+  - 신규 생성 필요: 화면 성격이 다르거나 성과/노출 정책을 따로 봐야 하는 경우
+- 비고:
+  - 구현 코드는 `BuildConfig` 참조로 통일해 재사용/신규 생성 어느 쪽이든 코드 수정 범위를 최소화한다.
+
+### 2. 크리에이터 커뮤니티 전체보기 배너 계획
+- 수정 대상:
+  - `app/src/main/res/layout/activity_creator_community_all.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/creator_community/all/CreatorCommunityAllActivity.kt`
+- 위치:
+  - 탭 영역 및 1dp 구분선 아래, `FrameLayout` 위
+- 계획:
+  - 현재는 탭 영역 아래 바로 콘텐츠 `FrameLayout`이 시작되므로, 그 사이에 `BannerAdView`를 배치한다.
+  - list/grid 두 모드를 공통으로 덮는 구조이므로, 배너는 RecyclerView 내부 아이템이 아니라 상단 고정 섹션으로 넣는다.
+  - `Activity`에서 `binding.yandexInlineBannerView.post { ... }` 패턴으로 배너 너비 측정 후 광고를 로드한다.
+  - `onDestroy()`에서 `destroy()`를 호출해 리소스를 정리한다.
+
+### 3. 시리즈 메인 홈 배너 계획
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_series_main_home.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/home/SeriesMainHomeFragment.kt`
+- 위치:
+  - `ll_completed_series` 아래, `ll_recommend_series` 위
+- 계획:
+  - `NestedScrollView` 내부 세로 섹션 사이에 별도 배너 컨테이너를 추가한다.
+  - 완결 시리즈/추천 시리즈 visibility와 독립적으로 배너 노출 조건을 설계한다.
+  - 기존 `setupCompletedSeriesView()`/`setupRecommendSeriesView()`와 분리된 `setupInlineBanner()` 성격의 로직을 추가한다.
+  - `onDestroyView()`에서 `destroy()`를 호출한다.
+
+### 4. 시리즈 메인 요일별 배너 계획
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_series_main_day_of_week.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/day_of_week/SeriesMainDayOfWeekFragment.kt`
+- 위치:
+  - `rv_series_day_of_week_day` 아래, `rv_series_day_of_week` 위
+- 계획:
+  - 상단 요일 필터와 하단 시리즈 그리드 사이의 중간 섹션으로 `BannerAdView`를 배치한다.
+  - `match_parent` 높이로 쓰이는 하단 RecyclerView 영역을 깨지 않도록 배너 추가 후 레이아웃 weight/height 영향을 먼저 점검한다.
+  - Fragment에서 기존 inline banner 로드 패턴을 복사하되, 화면 너비와 90dp 상한을 동일하게 적용한다.
+  - `onDestroyView()`에서 배너 리소스를 해제한다.
+
+### 5. 시리즈 메인 장르별 배너 계획
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_series_main_by_genre.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/by_genre/SeriesMainByGenreFragment.kt`
+- 위치:
+  - `rv_genre` 아래, `rv_series_by_genre` 위
+- 계획:
+  - 요일별 화면과 같은 구조이므로, 동일한 배치/로드/해제 패턴을 우선 재사용한다.
+  - 장르 변경 시 시리즈 리스트만 다시 로드되도록 두고, 배너는 화면 생성 시 1회 로드 구조를 우선 검토한다.
+  - `onDestroyView()`에서 `destroy()`를 호출한다.
+
+### 6. 알림 리스트 배너 계획
+- 수정 대상:
+  - `app/src/main/res/layout/activity_push_notification_list.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListActivity.kt`
+- 위치:
+  - `rv_category` 아래, 알림 영역 시작 지점
+- 계획:
+  - 빈 상태(`ll_empty`)와 알림 리스트(`rv_notification`)가 같은 `FrameLayout`을 공유하므로, 배너를 `FrameLayout` 바깥 상단 섹션으로 두는 안을 우선 적용한다.
+  - 이렇게 하면 카테고리 아래에 항상 동일 위치로 배너를 유지하면서, 빈 상태/리스트 상태 전환에 영향을 덜 준다.
+  - Activity에서 기존 inline banner 로드 패턴을 추가하고, 종료 시 `destroy()`를 호출한다.
+
+### 7. 알림 수신 설정 배너 계획
+- 수정 대상:
+  - `app/src/main/res/layout/activity_notification_receive_settings.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/settings/notification/NotificationReceiveSettingsActivity.kt`
+- 위치:
+  - 서비스 알림 카드 영역 아래, 팔로잉 채널 섹션 제목 위
+- 계획:
+  - `NestedScrollView` 내부 세로 흐름을 유지하면서 두 섹션 사이에 `BannerAdView`를 넣는다.
+  - 서비스 알림 토글과 팔로잉 채널 리스트 스크롤/페이징 로직에 영향이 없도록, 배너는 독립 섹션으로 추가한다.
+  - Activity 종료 시 `destroy()`를 호출한다.
+
+### 8. 공통 배너 로드/정리 규칙
+- 공통 코드 방향:
+  - XML에 `BannerAdView`를 직접 선언한다.
+  - `post {}` 이후 `width` 기반 `adWidthDp`를 계산한다.
+  - `BannerAdSize.inlineSize(context, adWidthDp, 90)`를 사용한다.
+  - `setAdUnitId(BuildConfig.YANDEX_INLINE_BANNER_...)` 후 `loadAd(AdRequest.Builder().build())`를 호출한다.
+- 생명주기:
+  - Fragment는 `onDestroyView()`에서 `destroy()`
+  - Activity는 `onDestroy()`에서 `destroy()`
+- 문서상 확인 포인트:
+  - 배너가 섹션 사이에 위치하는지
+  - 기존 스크롤/무한 로드 동작을 깨지 않는지
+  - list/grid, empty/content, section visibility 변화와 충돌하지 않는지
+
+## 예상 수정 파일
+- `docs/20260424_커뮤니티시리즈알림Yandex배너광고추가계획.md`
+- `app/build.gradle` (AD_UNIT_ID 재사용 불가 시에만)
+- `app/src/main/res/layout/activity_creator_community_all.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/explorer/profile/creator_community/all/CreatorCommunityAllActivity.kt`
+- `app/src/main/res/layout/fragment_series_main_home.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/home/SeriesMainHomeFragment.kt`
+- `app/src/main/res/layout/fragment_series_main_day_of_week.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/day_of_week/SeriesMainDayOfWeekFragment.kt`
+- `app/src/main/res/layout/fragment_series_main_by_genre.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/audio_content/series/main/by_genre/SeriesMainByGenreFragment.kt`
+- `app/src/main/res/layout/activity_push_notification_list.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/home/pushnotification/PushNotificationListActivity.kt`
+- `app/src/main/res/layout/activity_notification_receive_settings.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/settings/notification/NotificationReceiveSettingsActivity.kt`
+
+## 검증 계획
+- 정적 확인
+  - 변경 대상 `.kt`, `.xml`에 대해 가능 범위에서 `lsp_diagnostics`를 시도한다.
+- 빌드/테스트
+  - `./gradlew :app:assembleDebug`
+  - `./gradlew :app:testDebugUnitTest`
+- 수동 확인
+  - 커뮤니티 전체보기에서 탭과 콘텐츠 리스트 사이에 배너가 노출되는지 확인한다.
+  - 시리즈 메인 홈에서 완결 시리즈와 추천 시리즈 사이에 배너가 노출되는지 확인한다.
+  - 시리즈 메인 요일별/장르별에서 필터 리스트와 시리즈 리스트 사이에 배너가 노출되는지 확인한다.
+  - 알림 리스트에서 카테고리 아래, 알림 영역 시작 위치에 배너가 노출되는지 확인한다.
+  - 알림 수신 설정에서 서비스 알림과 팔로잉 채널 사이에 배너가 노출되는지 확인한다.
+  - 각 화면 종료 후 재진입 시 크래시나 중복 로드 문제가 없는지 확인한다.
+
+## 검증 기록
+- 2026-04-24
+  - 무엇: 커뮤니티/시리즈/알림 화면의 Yandex inline banner 추가 계획 문서를 생성했다.
+  - 왜: 저장소 규칙에 따라 구현 전에 `docs` 아래 계획 문서를 먼저 만들고, 범위·삽입 위치·검증 기준을 문서로 고정해야 하기 때문이다.
+  - 어떻게:
+    - 생성 파일: `docs/20260424_커뮤니티시리즈알림Yandex배너광고추가계획.md`
+    - 근거 파일: `activity_creator_community_all.xml`, `fragment_series_main_home.xml`, `fragment_series_main_day_of_week.xml`, `fragment_series_main_by_genre.xml`, `activity_push_notification_list.xml`, `activity_notification_receive_settings.xml`, 각 대응 Activity/Fragment Kotlin 파일
+    - 재사용 근거: `MyPageFragment.kt`, `LiveFragment.kt`, `LiveRoomDetailFragment.kt`, `AudioContentDetailActivity.kt`, `app/build.gradle`
+    - 근거 문서: `https://ads.yandex.com/helpcenter/ko/dev/android/adaptive-inline-banner`
+    - 결과: 대상 6개 화면의 삽입 위치, 생명주기 정리 규칙, AD_UNIT_ID 재사용/신규 생성 기준, 예상 수정 파일, 검증 계획을 구현 전에 확정했다.
+- 2026-04-24
+  - 무엇: 계획 대상 6개 화면에 Yandex adaptive inline banner 배치, 로드, 생명주기 정리를 반영했다.
+  - 왜: 각 화면의 계획된 섹션 사이에 inline banner를 노출하고, 기존 구현과 동일하게 화면 종료 시 광고 리소스를 해제해야 하기 때문이다.
+  - 어떻게:
+    - 수정 파일: `activity_creator_community_all.xml`, `CreatorCommunityAllActivity.kt`, `fragment_series_main_home.xml`, `SeriesMainHomeFragment.kt`, `fragment_series_main_day_of_week.xml`, `SeriesMainDayOfWeekFragment.kt`, `fragment_series_main_by_genre.xml`, `SeriesMainByGenreFragment.kt`, `activity_push_notification_list.xml`, `PushNotificationListActivity.kt`, `activity_notification_receive_settings.xml`, `NotificationReceiveSettingsActivity.kt`
+    - AD_UNIT_ID: 신규 `buildConfigField`를 만들지 않고 기존 `BuildConfig.YANDEX_INLINE_BANNER_MYPAGE_AD_UNIT_ID`를 6개 지면에 일관 재사용했다.
+    - 근거: 신규 운영 ID가 별도로 제공되지 않았고, 이번 변경은 동일 포맷의 inline banner 추가이므로 문서의 재사용 우선 기준에 부합한다.
+    - 생명주기: Activity는 `onDestroy()`, Fragment는 `onDestroyView()`에서 `BannerAdView.destroy()`를 호출하도록 반영했다.
+- 2026-04-24
+  - 무엇: 구현 후 정적 확인, 빌드, 단위 테스트를 실행했다.
+  - 왜: XML `BannerAdView` 추가, ViewBinding 생성, Kotlin import/컴파일, Fragment/Activity 생명주기 코드가 기존 동작을 깨지 않는지 확인해야 하기 때문이다.
+  - 어떻게:
+    - `lsp_diagnostics`: 환경에 `.kt`/`.xml` LSP 서버가 구성되어 있지 않아 실행 불가(`No LSP server configured for extension`)를 확인했다.
+    - `./gradlew :app:assembleDebug`: 성공. XML 리소스, ViewBinding, Kotlin 컴파일이 통과했다.
+    - `./gradlew :app:testDebugUnitTest`: 성공. Debug 단위 테스트가 통과했다.
+    - `./gradlew :app:ktlintCheck`: 실패. 대상 파일의 미사용 import 1건은 제거했으며, 남은 실패는 기존 패키지 경로의 underscore 규칙(`audio_content/series/main/by_genre`) 위반이다.
+- 2026-04-24
+  - 무엇: 신규 6개 배너 지면의 ad unit 참조를 MyPage 공용 값 재사용에서 지면별 `BuildConfig` 필드 분리 구조로 변경했다.
+  - 왜: 동일 포맷이라도 운영상 화면별 리포팅과 교체 가능성을 유지하는 편이 더 안전하고, 기존 저장소도 지면별 Yandex 광고 필드를 분리해 관리하고 있기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/build.gradle`, `CreatorCommunityAllActivity.kt`, `SeriesMainHomeFragment.kt`, `SeriesMainDayOfWeekFragment.kt`, `SeriesMainByGenreFragment.kt`, `PushNotificationListActivity.kt`, `NotificationReceiveSettingsActivity.kt`
+    - `build.gradle`: release/debug 각각에 6개 신규 `YANDEX_INLINE_BANNER_*_AD_UNIT_ID` 필드를 추가했다.
+    - 값 분리: release는 `R-M-19140295-7`~`R-M-19140295-12`, debug는 `R-M-19140297-7`~`R-M-19140297-12`로 각 지면 ad unit 값을 분리했다.
+    - 코드 반영: 각 화면이 자신의 지면용 `BuildConfig` 필드를 참조하도록 변경해 이후 실제 값 교체 시 코드 수정이 필요 없게 정리했다.
+- 2026-04-24
+  - 무엇: ad unit 분리 구조 반영 후 빌드와 테스트를 다시 검증했다.
+  - 왜: `buildConfigField` 추가와 `BuildConfig` 참조 교체가 실제 컴파일과 단위 테스트를 깨지 않는지 새 결과로 확인해야 하기 때문이다.
+  - 어떻게:
+    - 실행 명령: `./gradlew :app:assembleDebug`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:ktlintCheck`
+    - 실행 결과: 실패
+    - 실패 원인: 이번 변경으로 추가된 스타일 오류가 아니라 기존 패키지 경로의 underscore 규칙 위반(`creator_community`, `audio_content/series/main/home`, `audio_content/series/main/day_of_week`, `audio_content/series/main/by_genre`)이 계속 보고되었다.

docs/plan-task/20260427_무료라이브_마이페이지_광고제거.md

@@ -0,0 +1,30 @@
+# 20260427 무료라이브 마이페이지 광고 제거
+
+- [x] 무료 라이브 입장 전면광고 노출 경로를 확인한다.
+- [x] 마이 페이지 하단 광고 노출 경로를 확인한다.
+- [x] `LiveRoomActivity`에서 무료 라이브 전면광고 관련 상태값, 로더, 호출부를 제거한다.
+- [x] `MyPageFragment`와 `fragment_my.xml`에서 마이 페이지 하단 배너를 제거한다.
+- [x] `app/build.gradle`에서 더 이상 쓰지 않는 광고 ad unit 필드를 제거한다.
+- [x] 관련 검증을 수행하고 결과를 문서 하단에 기록한다.
+
+## 검증 계획
+- `lsp_diagnostics`로 변경 파일의 오류 여부를 확인한다.
+- `./gradlew :app:compileDebugKotlin`로 컴파일 검증을 수행한다.
+- `./gradlew :app:assembleDebug`로 실제 빌드 결과를 확인한다.
+
+## 검증 기록
+
+- 2026-04-27 18:10 KST
+  - 무엇/왜: 변경 파일 기준 정적 진단 가능 여부를 먼저 확인해 기본 오류 검출 수단을 확보했다.
+  - 실행: `lsp_diagnostics` for `LiveRoomActivity.kt`, `MyPageFragment.kt`, `app/build.gradle`
+  - 결과: 현재 환경에는 Kotlin/Gradle LSP가 구성되어 있지 않아 진단을 제공하지 못했다. 대신 Gradle 컴파일과 빌드 검증으로 대체했다.
+
+- 2026-04-27 18:12 KST
+  - 무엇/왜: 광고 제거 후 남은 참조나 import 누락 때문에 컴파일이 깨지지 않는지 확인했다.
+  - 실행: `./gradlew :app:compileDebugKotlin`
+  - 결과: 첫 실행에서 `LiveRoomActivity.kt`의 `isLiveRoomJoinCompleted` 잔여 참조로 실패했고, 해당 참조 제거 후 재실행에서 성공했다.
+
+- 2026-04-27 18:13 KST
+  - 무엇/왜: 실제 디버그 APK 생성까지 완료되는지 확인해 변경의 수동 QA를 수행했다.
+  - 실행: `./gradlew :app:assembleDebug`
+  - 결과: `BUILD SUCCESSFUL`로 디버그 빌드가 완료됐다.

docs/plan-task/20260427_채팅탭Yandex배너광고추가.md

@@ -0,0 +1,195 @@
+# 20260427 채팅 탭 Yandex 배너 광고 추가
+
+## 작업 체크리스트
+- [x] 대상 화면 3곳의 구조와 기존 Yandex 광고 패턴을 조사한다.  
+  QA: `CharacterTabFragment`, `OriginalTabFragment`, `TalkTabFragment`, `LiveFragment`, `MyPageFragment`, 공식 Yandex adaptive inline banner 문서를 근거로 삽입 위치와 구현 패턴을 설명할 수 있어야 한다.
+- [x] 화면별 AD_UNIT_ID 분리 전략과 추가 대상 키를 확정한다.  
+  QA: `app/build.gradle`의 `debug`/`release`에 각 화면용 `BuildConfig` 필드가 필요하다는 판단 근거가 문서에 남아 있어야 한다.
+- [x] `app/build.gradle`에 Character/Original/Talk 탭용 Yandex inline banner ad unit id를 추가한다.  
+  QA: `debug`/`release` 모두에서 3개 화면용 `BuildConfig` 값이 생성되어야 한다.
+- [x] `fragment_character_tab.xml`과 `CharacterTabFragment.kt`에 최근 대화한 캐릭터와 인기 캐릭터 사이 배너를 추가한다.  
+  QA: `ll_latest_characters` 다음, `ll_popular_characters` 이전에 배너가 배치되고 기존 상단 콘텐츠 배너는 유지되어야 하며, 배너 최대 높이는 90dp를 넘지 않아야 한다.
+- [x] `fragment_original_tab.xml`과 `OriginalTabFragment.kt`에 최상단 배너를 추가한다.  
+  QA: 배너가 `rv_original` 위에 배치되고, 리스트가 배너 아래부터 시작해야 하며, 프래그먼트 종료 시 리소스가 정리되어야 한다.
+- [x] `fragment_talk_tab.xml`과 `TalkTabFragment.kt`에 최상단 배너를 추가한다.  
+  QA: 배너가 `rv_talk` 위에 배치되고, 빈 상태 문구가 배너와 겹치지 않아야 하며, 프래그먼트 종료 시 리소스가 정리되어야 한다.
+- [x] 변경 사항을 빌드/테스트/수동 확인 기준으로 검증한다.  
+  QA: 최소 `:app:assembleDebug`, `:app:testDebugUnitTest`, `:app:ktlintCheck` 결과와 수동 확인 가능 여부가 기록되어야 한다.
+- [x] 검증 기록과 체크리스트를 문서 하단에 누적 갱신한다.  
+  QA: 무엇/왜/어떻게, 실행 명령, 결과가 한국어로 누적되어야 한다.
+- [x] Original/Talk 탭 배너를 RecyclerView 헤더로 이동한다.  
+  QA: 배너가 고정 영역이 아니라 RecyclerView 첫 아이템으로 스크롤되어야 하며, Original 그리드에서는 전체 span을 차지해야 한다.
+- [x] Original/Talk 탭의 세로 여백을 Character 탭 기준 24dp 흐름에 맞춘다.  
+  QA: 스크롤 콘텐츠가 상단 24dp에서 시작하고, Talk/Original의 하단 여백이 24dp 기준으로 유지되어야 한다.
+- [x] 후속 변경 검증 상태를 재실행 가능 상태로 갱신한다.  
+  QA: 이번 요청의 도구 제한 때문에 Gradle 명령은 실행하지 않고, 재실행 대상 명령과 제한 사유를 문서에 남겨야 한다.
+
+## 범위 메모
+- 이번 요청 범위는 채팅 영역의 3개 화면에 Yandex adaptive inline banner를 추가하는 작업으로 한정한다.
+- `CharacterTabFragment`는 기존 상단 콘텐츠 캐러셀 배너를 제거하지 않고, 최근 대화한 캐릭터와 인기 캐릭터 사이에 Yandex 배너를 추가한다.
+- `OriginalTabFragment`, `TalkTabFragment`는 화면 최상단에 Yandex 배너를 추가하되, 후속 변경에서는 RecyclerView 헤더 아이템으로 이동해 리스트와 함께 스크롤되도록 한다.
+- AD_UNIT_ID는 사용자 요청대로 페이지별로 분리하며, 기존 저장소 관례에 맞춰 `app/build.gradle`의 `debug`/`release` `buildConfigField`로 관리한다.
+- Yandex SDK 의존성과 앱 초기화는 이미 존재하므로 이번 작업에서 SDK 추가나 `SodaLiveApp.kt` 수정은 제외한다.
+- 배너 로드 패턴은 현재 저장소의 `LiveFragment`, `MyPageFragment`에서 사용하는 `post { -> setAdUnitId -> setAdSize(BannerAdSize.inlineSize(...)) -> loadAd(...) }` 흐름을 우선 따른다.
+- 배너 정리는 프래그먼트 뷰 생명주기에 맞춰 `onDestroyView()`에서 `destroy()`를 호출하는 방향으로 맞춘다.
+
+## 조사 근거
+- 대상 화면
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/character/CharacterTabFragment.kt`
+  - `app/src/main/res/layout/fragment_character_tab.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/original/OriginalTabFragment.kt`
+  - `app/src/main/res/layout/fragment_original_tab.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/TalkTabFragment.kt`
+  - `app/src/main/res/layout/fragment_talk_tab.xml`
+- 기존 배너 구현 참고
+  - `app/src/main/java/kr/co/vividnext/sodalive/live/LiveFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`
+  - `app/src/main/res/layout/fragment_live.xml`
+- 설정 참고
+  - `app/build.gradle`
+- 공식 문서
+  - `https://ads.yandex.com/helpcenter/ko/dev/android/adaptive-inline-banner`
+
+## 구현 계획
+
+### 1. AD_UNIT_ID 추가
+- 수정 대상: `app/build.gradle`
+- 계획:
+  - `release`와 `debug` 각각에 아래 키를 추가한다.
+    - `YANDEX_INLINE_BANNER_CHARACTER_TAB_AD_UNIT_ID`
+    - `YANDEX_INLINE_BANNER_ORIGINAL_TAB_AD_UNIT_ID`
+    - `YANDEX_INLINE_BANNER_TALK_TAB_AD_UNIT_ID`
+  - 실제 값은 아직 제공되지 않았으므로 화면별·빌드타입별 placeholder 문자열을 서로 다르게 사용한다.
+- 이유:
+  - 기존 Yandex 광고가 모두 `BuildConfig` 기반으로 주입되고 있고, 사용자도 페이지별 분리를 명시했기 때문이다.
+
+### 2. Character 탭 중간 배너 추가
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_character_tab.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/character/CharacterTabFragment.kt`
+- 위치:
+  - `ll_latest_characters` 다음, `ll_popular_characters` 이전
+- 계획:
+  - 섹션 사이에 `BannerAdView`를 추가하고 기존 24dp 간격 흐름을 유지한다.
+  - `setupView()` 흐름에 배너 로드 메서드를 추가한다.
+  - 측정된 너비 기준으로 adaptive inline banner를 로드하고, 최대 높이는 90dp 상한을 유지한다.
+  - `onDestroyView()`에서 배너를 정리한다.
+
+### 3. Original 탭 최상단 배너 추가
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_original_tab.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/original/OriginalTabFragment.kt`
+- 위치:
+  - 루트 최상단, `rv_original` 위
+- 계획:
+  - `ConstraintLayout` 상단에 `BannerAdView`를 추가하고, `rv_original`의 top constraint를 배너 아래로 조정한다.
+  - 프래그먼트 로드 시 배너를 설정하고 종료 시 정리한다.
+
+### 4. Talk 탭 최상단 배너 추가
+- 수정 대상:
+  - `app/src/main/res/layout/fragment_talk_tab.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/TalkTabFragment.kt`
+- 위치:
+  - 루트 최상단, `rv_talk` 위
+- 계획:
+  - 최상단에 `BannerAdView`를 추가하고, `rv_talk` 및 `tv_empty`가 배너 아래 레이아웃 기준을 따르도록 constraint를 조정한다.
+  - 빈 상태 문구는 배너와 겹치지 않게 유지한다.
+  - 프래그먼트 종료 시 배너를 정리한다.
+
+## 예상 수정 파일
+- `docs/20260427_채팅탭Yandex배너광고추가.md`
+- `app/build.gradle`
+- `app/src/main/res/layout/fragment_character_tab.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/character/CharacterTabFragment.kt`
+- `app/src/main/res/layout/fragment_original_tab.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/original/OriginalTabFragment.kt`
+- `app/src/main/res/layout/fragment_talk_tab.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/TalkTabFragment.kt`
+
+## 검증 계획
+- `./gradlew :app:assembleDebug`
+- `./gradlew :app:testDebugUnitTest`
+- `./gradlew :app:ktlintCheck`
+- 수동 확인
+  - Character 탭에서 최근 대화한 캐릭터와 인기 캐릭터 사이에 배너가 보이는지 확인한다.
+  - Original 탭에서 배너가 최상단에 보이고 그 아래부터 그리드가 시작하는지 확인한다.
+  - Talk 탭에서 배너가 최상단에 보이고, 빈 상태 문구가 배너와 겹치지 않는지 확인한다.
+
+## 구현 반영 기록
+- 2026-04-27
+  - 무엇: Character/Original/Talk 탭에 Yandex adaptive inline banner 구현을 반영했다.
+  - 왜: 각 채팅 탭 화면에 별도 광고 단위 키를 사용하고, 지정 위치에 inline banner를 추가하며, 뷰 종료 시 광고 리소스를 정리해야 하기 때문이다.
+  - 어떻게:
+    - `app/build.gradle`의 `debug`/`release`에 화면별 placeholder `BuildConfig` 키 3개씩을 추가했다.
+    - `fragment_character_tab.xml`은 `ll_latest_characters`와 `ll_popular_characters` 사이에 `BannerAdView`를 추가했다.
+    - `fragment_original_tab.xml`과 `fragment_talk_tab.xml`은 최상단 `BannerAdView` 아래로 리스트가 시작되도록 조정했고, Talk 빈 상태 문구도 배너 아래 영역을 기준으로 배치했다.
+    - 각 Fragment는 `setAdUnitId(...)`, `BannerAdSize.inlineSize(...)`, `AdRequest.Builder().build()` 패턴으로 배너를 로드하고 `onDestroyView()`에서 `destroy()`를 호출하도록 연결했다.
+  - 결과: 구현 체크리스트 중 코드 반영 항목을 완료 상태로 갱신했다. 빌드/테스트/수동 확인 결과는 아직 기록하지 않았다.
+- 2026-04-27
+  - 무엇: Original/Talk 탭의 Yandex 배너를 고정 XML 자식에서 RecyclerView 헤더 아이템으로 이동하는 후속 변경을 반영했다.
+  - 왜: 배너가 리스트 바깥에 고정되어 있으면 Character 탭의 스크롤 콘텐츠 여백 흐름과 맞지 않고, 사용자가 요청한 “리스트와 함께 스크롤되는 배너” 조건을 만족하지 못하기 때문이다.
+  - 어떻게:
+    - `YandexInlineBannerHeaderAdapter`를 추가해 `BannerAdView`를 RecyclerView 첫 아이템으로 생성하고, 기존 Yandex SDK 7.18.5 방식인 `setAdUnitId(...)`, `BannerAdSize.inlineSize(...)`, `AdRequest.Builder().build()` 호출 흐름을 유지했다.
+    - `OriginalTabFragment`는 `ConcatAdapter`로 배너 헤더와 기존 그리드 어댑터를 연결하고, `GridLayoutManager.SpanSizeLookup` 및 `GridSpacingItemDecoration(headerCount = 1)`로 헤더가 전체 3열을 차지하게 했다.
+    - Original 그리드는 기존 16dp 아이템 하단 간격을 유지하면서 스크롤 콘텐츠 끝 여백이 24dp가 되도록 RecyclerView 하단 padding을 8dp로 보정했다.
+    - `TalkTabFragment`는 `ConcatAdapter`로 배너 헤더와 기존 Talk 어댑터를 연결하고, ItemDecoration이 헤더를 건너뛰도록 보정했다.
+    - `fragment_original_tab.xml`, `fragment_talk_tab.xml`에서는 고정 배너 뷰를 제거하고 RecyclerView를 부모 상단에 직접 연결했다.
+    - Talk 빈 상태 문구는 유지하되 RecyclerView는 배너 헤더를 표시할 수 있도록 빈 목록에서도 보이게 했다.
+  - 결과: 후속 변경의 코드 반영 항목을 완료 상태로 갱신했다.
+
+## 검증 기록
+- 2026-04-27
+  - 무엇: 채팅 탭 Yandex 배너 광고 추가 작업의 계획 문서를 생성했다.
+  - 왜: 저장소 규칙에 따라 구현 전에 `docs` 아래 계획 문서를 먼저 만들고, 범위·광고 위치·검증 기준을 먼저 고정해야 하기 때문이다.
+  - 어떻게:
+    - 생성 파일: `docs/20260427_채팅탭Yandex배너광고추가.md`
+    - 근거 파일: `app/build.gradle`, `CharacterTabFragment.kt`, `OriginalTabFragment.kt`, `TalkTabFragment.kt`, 각 대응 XML, `LiveFragment.kt`, `MyPageFragment.kt`
+    - 근거 문서: `https://ads.yandex.com/helpcenter/ko/dev/android/adaptive-inline-banner`
+    - 결과: 화면별 위치, AD_UNIT_ID 분리, 예상 수정 파일, 검증 계획을 구현 전에 확정했다.
+- 2026-04-27
+  - 무엇: 채팅 탭 3개 화면의 Yandex 배너 추가 구현에 대해 빌드, 테스트, 린트, 수동 확인 가능 여부를 검증했다.
+  - 왜: 이번 변경은 `BuildConfig`, Kotlin, XML을 함께 수정하므로 실제 Android 리소스 병합과 컴파일, 테스트, 스타일 검사를 통과해야 안전하게 반영됐다고 볼 수 있기 때문이다.
+  - 어떻게:
+    - 진단 도구: `lsp_diagnostics`
+    - 진단 결과: `.kt`, `.xml` LSP 서버가 현재 환경에 설정되어 있지 않아 정적 진단은 수행하지 못했다.
+    - 실행 명령: `./gradlew :app:assembleDebug`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:ktlintCheck`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `adb devices`
+    - 실행 결과: 연결 기기 없음
+    - 수동 확인 결과: ADB 연결 기기가 없어 앱 실행 기반 수동 QA는 수행하지 못했다.
+    - 비고: `app/build.gradle`의 Character/Original/Talk 탭 ad unit id는 현재 placeholder 값이므로, 실제 광고 응답 확인은 실 ad unit id 교체 후 추가 검증이 필요하다.
+- 2026-04-27
+  - 무엇: Original/Talk 탭 Yandex 배너 후속 변경의 정적 진단 가능 여부와 참조 정리를 확인했다.
+  - 왜: 이번 변경은 XML 바인딩 참조를 제거하고 RecyclerView 헤더 어댑터로 이동했으므로, 남은 고정 배너 참조와 문서 검증 상태를 확인해야 하기 때문이다.
+  - 어떻게:
+    - 진단 도구: `lsp_diagnostics`
+    - 진단 결과: Markdown 문서(`docs/20260427_채팅탭Yandex배너광고추가.md`)는 진단 없음.
+    - 진단 결과: `.kt`, `.xml` LSP 서버가 현재 환경에 설정되어 있지 않아 Kotlin/XML 정적 진단은 수행하지 못했다.
+    - 확인 도구: `grep`
+    - 확인 결과: `OriginalTabFragment`, `TalkTabFragment`, `fragment_original_tab.xml`, `fragment_talk_tab.xml`에는 기존 고정 배너 바인딩/ID 참조가 남아 있지 않다.
+    - 재실행 대기 명령: `./gradlew :app:assembleDebug`, `./gradlew :app:testDebugUnitTest`, `./gradlew :app:ktlintCheck`
+  - 결과: 이 시점에서는 Gradle 기반 빌드/테스트/린트를 아직 재실행하지 않았고, 기존 검증 명령은 재실행 준비 상태로 유지했다.
+- 2026-04-27
+  - 무엇: Original/Talk 탭 배너 헤더 후속 변경에 대해 빌드, 테스트, 린트, 기기 연결 상태를 다시 검증했다.
+  - 왜: 이번 후속 변경은 배너를 RecyclerView 헤더 어댑터로 옮기고 간격 계산을 변경했으므로, 실제 Android 컴파일과 테스트를 다시 통과해야 안전하게 반영됐다고 볼 수 있기 때문이다.
+  - 어떻게:
+    - 진단 도구: `lsp_diagnostics`
+    - 진단 결과: `.kt`, `.xml` LSP 서버가 현재 환경에 설정되어 있지 않아 Kotlin/XML 정적 진단은 수행하지 못했다.
+    - 실행 명령: `./gradlew :app:assembleDebug`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:testDebugUnitTest`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:ktlintCheck`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `adb devices`
+    - 실행 결과: 한때 `2cec640c34017ece` 기기가 표시되었으나, 이후 설치/실행 시점에는 연결이 끊어졌다.
+    - 실행 명령: `./gradlew :app:installDebug`
+    - 실행 결과: `No connected devices!`
+    - 실행 명령: `adb shell am start -n kr.co.vividnext.sodalive.debug/kr.co.vividnext.sodalive.splash.SplashActivity`
+    - 실행 결과: `adb: no devices/emulators found`
+    - Oracle 검토 결과: 후속 변경은 요청한 스크롤 배너 요구사항을 충족하며, 즉시 수정이 필요한 correctness/layout/pagination 결함은 확인되지 않았다.
+  - 결과: 빌드/테스트/린트는 모두 통과했고, 수동 QA는 기기 연결 해제 때문에 완료하지 못했다. 남은 검증 공백은 Original/Talk 화면에서 배너가 첫 아이템처럼 함께 스크롤되는지 실제 기기에서 확인하는 것이다.

docs/plan-task/20260429_AGENTS정리.md

@@ -0,0 +1,88 @@
+# 20260429 AGENTS 정리
+
+## 개요
+- `AGENTS.md`를 정비한 전체 작업 이력을 하나로 합친 문서다.
+- 작업 범위는 다음 3단계였다.
+  - `oh-my-openagent`, `superpowers`, `andrej-karpathy-skills` 통합
+  - 우선순위 기준 재배치 및 중복 정리
+  - 핵심 규칙 중심 경량화 및 세부 문서 분리
+- 현재 기준의 관련 세부 문서는 아래와 같다.
+  - `docs/agent-guides/build-test-style.md`
+  - `docs/agent-guides/workflow-docs-commits.md`
+  - `docs/agent-guides/safety-repo-rules.md`
+
+## 작업 체크리스트
+- [x] 기존 `AGENTS.md` 구조와 중복 규칙을 분석한다.
+- [x] 공식 `andrej-karpathy-skills` 원문 `CLAUDE.md`를 확인하고 통합한다.
+- [x] 우선순위/충돌 해결/실행 모드 정책을 추가한다.
+- [x] 우선순위 기준으로 섹션을 재배치하고 중복 표현을 줄인다.
+- [x] `AGENTS.md`에는 핵심 규칙만 남기고 세부 규칙은 참조 문서로 분리한다.
+- [x] 관련 작업 문서를 하나로 통합하고 중복 문서를 정리한다.
+
+## 결과 요약
+### 1) 통합
+- `AGENTS.md`에 `CORE EXECUTION PRINCIPLES (andrej-karpathy-skills)`를 공식 원문 그대로 포함했다.
+- `oh-my-openagent`, `superpowers`, 프로젝트 지침 사이의 우선순위와 충돌 해결 규칙을 추가했다.
+
+### 2) 재배치
+- 우선순위가 높은 정책을 상단으로 이동했다.
+- `충돌 해결 규칙`은 `실행 우선순위 및 통합 정책`에 통합했다.
+- 실행 모드/실행 계층/에이전트 동작 규칙은 하나의 묶음으로 정리했다.
+
+### 3) 경량화
+- `AGENTS.md`에는 핵심 원칙, 저장소 요약, 참조 문서 링크, 핵심 금지사항만 남겼다.
+- 빌드/테스트/스타일, 작업 절차/커밋, 보안/저장소 세부 규칙은 `docs/agent-guides/` 아래 별도 문서로 분리했다.
+
+## 검증 기록
+- 2026-04-29
+  - 무엇/왜/어떻게: 기존 `AGENTS.md`의 구조와 중복 규칙을 먼저 확인한 뒤, 공식 `andrej-karpathy-skills` 원문을 raw URL에서 검증하고, 기존 유용한 규칙은 유지한 채 상단에 우선순위/통합 정책 섹션을 추가했다.
+  - 실행 명령/도구:
+    - `read(AGENTS.md)`
+    - `grep("oh-my-openagent|openagent|superpowers|andrej|karpathy|plugin|workflow|우선순위|priority", include="AGENTS.md")`
+    - `webfetch("https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md")`
+    - `task(subagent_type="explore", run_in_background=true)`
+    - `task(subagent_type="librarian", run_in_background=true)`
+    - `apply_patch`
+  - 결과:
+    - 기존 `AGENTS.md`에는 `oh-my-openagent`, `superpowers`, `andrej-karpathy-skills` 관련 명시 섹션이 없음을 확인했다.
+    - 공식 raw `CLAUDE.md` 원문을 확인했고, 영문 본문은 변경 없이 `CORE EXECUTION PRINCIPLES (andrej-karpathy-skills)` 섹션에 삽입했다.
+    - 우선순위 체계, oh-my-openagent 정책, superpowers 정책, 충돌 해결 규칙, 실행 모드를 한국어로 추가했다.
+
+- 2026-04-29
+  - 무엇/왜/어떻게: `AGENTS.md`를 읽고 배경 탐색 결과를 합쳐, 우선순위가 높은 정책을 앞에 배치하고 중복되던 충돌 규칙/실행 계층/에이전트 동작 문장을 상위 섹션으로 흡수하는 방향으로 재배치를 수행했다.
+  - 실행 명령/도구:
+    - `read(AGENTS.md)`
+    - `grep("^## |^### |추측하지 말고|요청 범위를 우선|최소 변경|검증 가능한 결과|commit-policy|한국어|oh-my-openagent|superpowers|CORE EXECUTION PRINCIPLES", include="AGENTS.md")`
+    - `task(subagent_type="explore", run_in_background=true)` x2
+    - `apply_patch`
+    - `grep("^## |^### ", include="AGENTS.md")`
+  - 결과:
+    - `실행 우선순위 및 통합 정책`을 최상단으로 올리고 `충돌 해결 규칙`을 해당 섹션에 통합했다.
+    - `실행 모드`, `oh-my-openagent 사용 정책`, `superpowers 사용 정책`, `에이전트 동작 원칙`을 `실행 원칙 및 계층 사용 정책` 아래로 묶었다.
+    - 중복되던 문장을 줄이고 운영성 정보의 배치를 정리했다.
+
+- 2026-04-29
+  - 무엇/왜/어떻게: `AGENTS.md`는 핵심 정책만 남기고, 긴 운영 규칙은 별도 문서로 분리하기 위해 본문과 배경 탐색 결과를 합쳐 인라인 유지 항목과 분리 항목을 나눈 뒤, 3개 참조 문서와 링크 구조로 재구성했다.
+  - 실행 명령/도구:
+    - `read(AGENTS.md)`
+    - `grep("^## |^### ", include="AGENTS.md")`
+    - `glob("docs/*.md")`
+    - `task(subagent_type="explore", run_in_background=true)` x2
+    - `apply_patch`
+    - `read(수정된 AGENTS.md 및 분리 문서)`
+  - 결과:
+    - `AGENTS.md`에는 우선순위, 커뮤니케이션, `CORE EXECUTION PRINCIPLES`, 실행 계층 정책, 저장소 요약, 참조 문서 링크, 핵심 금지사항만 남겼다.
+    - 빌드/린트/테스트/스타일은 `docs/agent-guides/build-test-style.md`로 분리했다.
+    - 작업 절차/docs/커밋 규칙은 `docs/agent-guides/workflow-docs-commits.md`로 분리했다.
+    - 저장소 세부 규칙/보안/Git 안전 수칙은 `docs/agent-guides/safety-repo-rules.md`로 분리했다.
+
+- 2026-04-29
+  - 무엇/왜/어떻게: `AGENTS.md` 관련 작업 문서가 3개로 쪼개져 있어 관리 비용이 생겨, 같은 날의 연속 작업 이력을 하나의 문서로 합치고 중복 문서를 제거했다.
+  - 실행 명령/도구:
+    - `read(docs/20260429_AGENTS통합정리.md)`
+    - `read(docs/20260429_AGENTS재배치정리.md)`
+    - `read(docs/20260429_AGENTS경량화정리.md)`
+    - `apply_patch`
+  - 결과:
+    - 세 문서의 개요/체크리스트/검증 기록을 하나의 이력 문서로 통합했다.
+    - 중복되던 계획 생성 기록은 단일 문서 기준으로 정리했다.

docs/plan-task/20260429_채팅룸액티비티분석정리.md

@@ -0,0 +1,210 @@
+# 20260429 채팅룸 액티비티 분석 정리
+
+## 개요
+- `ChatRoomActivity` 화면의 UI 구성과 기능 흐름을 빠르게 파악할 수 있도록 분석 내용을 정리한 문서다.
+- 범위는 `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`를 중심으로, 실제 연결된 레이아웃/어댑터/보조 다이얼로그/리포지토리까지 포함한다.
+- 본 문서는 구현 계획 문서 형식을 따르며, 하단 `검증 기록`에 근거 확인 과정을 누적한다.
+
+## 완료 기준 (Acceptance Criteria)
+- [x] AC1: `ChatRoomActivity`의 화면 구성이 UI 영역 기준으로 구분되어 문서화되어야 한다.
+- [x] AC2: `ChatRoomActivity`의 주요 기능이 사용자 흐름 기준으로 구분되어 문서화되어야 한다.
+- [x] AC3: 각 분석 내용은 실제 확인한 파일 경로를 기준으로 정리되어야 한다.
+- [x] AC4: 문서 하단에 무엇을 어떻게 확인했는지 검증 기록이 남아야 한다.
+
+## 작업 체크리스트
+- [x] `docs` 폴더의 기존 문서 형식과 파일명 규칙을 확인한다.
+- [x] 오늘 날짜 기준 분석 문서를 생성한다.
+- [x] `ChatRoomActivity`의 UI 구성을 영역별로 정리한다.
+- [x] `ChatRoomActivity`의 기능 흐름을 사용자 액션 기준으로 정리한다.
+- [x] 관련 파일 경로와 검증 기록을 문서에 남긴다.
+
+## 분석 대상 파일
+### 핵심 파일
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+- `app/src/main/res/layout/activity_chat_room.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+
+### 보조 UI / 기능 파일
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomMoreDialogFragment.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatBackgroundPickerDialogFragment.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/character/detail/gallery/CharacterGalleryViewerDialogFragment.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/CharacterInfo.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomEnterResponse.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessage.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/MessageStatus.kt`
+
+### 메시지 아이템 레이아웃
+- `app/src/main/res/layout/item_chat_user_message.xml`
+- `app/src/main/res/layout/item_chat_ai_message.xml`
+- `app/src/main/res/layout/item_chat_typing_indicator.xml`
+- `app/src/main/res/layout/item_chat_quota_notice.xml`
+- `app/src/main/res/layout/fragment_chat_room_more_dialog.xml`
+
+## UI 구성 정리
+### 1) 헤더 영역
+- 뒤로가기 버튼, 캐릭터 프로필, 캐릭터 이름, 캐릭터 타입 배지, 현재 보유 캔 배지, 더보기 버튼으로 구성된다.
+- 캐릭터 정보가 아직 없으면 이름은 비워두고 플레이스홀더 이미지를 사용한다.
+- 캐릭터 타입은 `Clone` 또는 `Character`에 따라 배지 문구와 배경이 달라진다.
+- 관련 파일:
+  - `app/src/main/res/layout/activity_chat_room.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+
+### 2) 배경 표시 영역
+- 화면 전체 뒤에 캐릭터 배경 이미지가 깔리고, 그 위에 딤 오버레이가 덮이는 구조다.
+- 배경 표시 여부는 roomId 기준 preference로 관리된다.
+- 배경 이미지는 서버 응답의 `backgroundImageUrl`을 우선 사용하고, 없으면 프로필 이미지 fallback을 사용한다.
+- 관련 파일:
+  - `app/src/main/res/layout/activity_chat_room.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+
+### 3) 안내 배너 영역
+- 안내 아이콘, 안내 문구, 접기 버튼으로 구성된다.
+- 안내 문구는 캐릭터 타입에 따라 달라지며, 사용자가 접으면 숨김 상태가 저장된다.
+- 관련 파일:
+  - `app/src/main/res/layout/activity_chat_room.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+
+### 4) 채팅 메시지 리스트 영역
+- `RecyclerView` 하나에서 사용자 메시지, AI 메시지, 타이핑 인디케이터, 쿼터 안내 카드를 함께 렌더링한다.
+- 사용자 메시지는 오른쪽 정렬 말풍선이고, AI 메시지는 왼쪽 정렬 말풍선이다.
+- 같은 발신자의 연속 메시지는 그룹화되어 프로필, 이름, 시간 노출이 축소된다.
+- 메시지 유형별 UI는 다음과 같다.
+  - 사용자 메시지: 시간, 상태별 투명도, 실패 시 재전송 버튼
+  - AI 텍스트 메시지: 프로필, 이름, 말풍선, 시간
+  - AI 이미지 메시지: 4:5 비율 이미지, 잠금 오버레이, 구매 버튼
+  - 타이핑 인디케이터: AI 프로필 + 이름 + 점 3개 애니메이션
+  - 쿼터 안내 카드: 남은 시간, 안내 문구, 구매 CTA 버튼
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`
+  - `app/src/main/res/layout/item_chat_user_message.xml`
+  - `app/src/main/res/layout/item_chat_ai_message.xml`
+  - `app/src/main/res/layout/item_chat_typing_indicator.xml`
+  - `app/src/main/res/layout/item_chat_quota_notice.xml`
+
+### 5) 입력 영역
+- 메시지 입력창과 전송 버튼으로 구성된다.
+- 입력값이 비어 있으면 전송 버튼은 비활성화되고, 텍스트가 있으면 활성화된다.
+- IME `Send` 액션도 실제 전송 버튼 클릭으로 연결된다.
+- 쿼터가 없을 때는 입력 영역이 숨겨진다.
+- 관련 파일:
+  - `app/src/main/res/layout/activity_chat_room.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+
+### 6) 보조 다이얼로그 영역
+- 더보기 다이얼로그에서는 배경 표시 스위치, 배경 이미지 변경, 대화 초기화 진입을 제공한다.
+- 배경 선택 다이얼로그에서는 이미지 그리드와 현재 배경 표시 테두리를 제공한다.
+- 구매한 이미지는 전체화면 캐러셀 뷰어에서 확인한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomMoreDialogFragment.kt`
+  - `app/src/main/res/layout/fragment_chat_room_more_dialog.xml`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatBackgroundPickerDialogFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/character/detail/gallery/CharacterGalleryViewerDialogFragment.kt`
+
+## 기능 구성 정리
+### 1) 채팅방 진입 및 초기 동기화
+- `roomId`를 인텐트에서 받아 유효성을 확인한다.
+- 헤더, 공지, 리스트, 입력창을 초기화한 뒤 로컬 메시지를 먼저 표시한다.
+- 이후 `enterChatRoom()`을 호출해 캐릭터 정보, 배경 이미지, 서버 메시지, 쿼터 상태를 동기화한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomEnterResponse.kt`
+
+### 2) 헤더/멤버 정보 갱신
+- 서버에서 받은 `CharacterInfo`로 이름, 프로필, 타입 배지를 갱신한다.
+- 별도로 멤버 정보를 조회해 보유 캔 수를 최신값으로 갱신한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/CharacterInfo.kt`
+
+### 3) 메시지 전송
+- 사용자가 메시지를 입력하고 전송하면 입력창을 비우고 키보드를 내린다.
+- 사용자 메시지를 즉시 `SENDING` 상태로 화면과 로컬 DB에 반영한다.
+- 서버 전송 성공 시 `SENT` 상태로 바꾸고, 응답에 포함된 AI 메시지를 리스트에 추가한다.
+- 실패 시 `FAILED` 상태로 바꾸고 토스트를 노출한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessage.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/MessageStatus.kt`
+
+### 4) 전송 실패 재시도
+- 실패한 사용자 메시지는 재전송 버튼이 노출된다.
+- 재시도 시 상태를 다시 `SENDING`으로 바꾸고 후속 성공/실패 결과를 다시 반영한다.
+- 현재 구현은 실제 API 재호출이 아니라 데모성 성공 시뮬레이션과 AI 답변 추가 흐름을 사용한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`
+
+### 5) 메시지 리스트 관리 및 페이징
+- 새 메시지는 하단에 append되고, 사용자가 하단 근처에 있으면 자동 스크롤된다.
+- 리스트 상단에 도달하면 cursor 기반으로 이전 메시지를 서버에서 불러온다.
+- 과거 메시지를 prepend할 때는 기존 스크롤 위치를 유지하도록 오프셋을 보정한다.
+- 중복 메시지는 `messageId` 기준으로 제거한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+
+### 6) 쿼터 관리
+- `nextRechargeAtEpoch` 값이 있으면 입력창을 숨기고 쿼터 안내 카드를 표시한다.
+- 남은 시간은 카운트다운으로 갱신되며, 만료 시 서버에 다시 상태를 조회한다.
+- 쿼터 구매가 성공하면 카운트다운/입력 가능 상태와 캔 배지가 즉시 갱신된다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+  - `app/src/main/res/layout/item_chat_quota_notice.xml`
+
+### 7) 유료 메시지 구매
+- 잠긴 AI 이미지 메시지를 누르면 구매 확인 다이얼로그가 열린다.
+- 구매 성공 시 해당 메시지를 해금된 서버 응답 데이터로 교체한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+  - `app/src/main/res/layout/item_chat_ai_message.xml`
+
+### 8) 구매 이미지 보기
+- 접근 권한이 있는 이미지 메시지만 전체화면 갤러리로 열 수 있다.
+- 현재 리스트에서 구매 완료된 이미지 URL만 모아 캐러셀의 데이터 소스로 사용한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/character/detail/gallery/CharacterGalleryViewerDialogFragment.kt`
+
+### 9) 배경 설정
+- 더보기 다이얼로그에서 배경 표시 on/off를 전환할 수 있다.
+- 배경 선택 다이얼로그에서 이미지 선택 후 즉시 액티비티 배경에 적용한다.
+- 선택한 배경 이미지 ID와 표시 여부는 roomId 기준으로 저장된다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomMoreDialogFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatBackgroundPickerDialogFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+
+### 10) 대화 초기화
+- 더보기 다이얼로그에서 대화 초기화 액션을 누르면 확인 다이얼로그를 띄운다.
+- 서버 초기화 요청 성공 후 해당 방의 로컬 preference와 메시지 DB를 정리하고 새 채팅방으로 다시 진입한다.
+- 관련 파일:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomMoreDialogFragment.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+
+## 해석 메모
+- `ChatRoomActivity`는 단순 화면 렌더링만 하는 액티비티가 아니라, 채팅방 진입/동기화/입력/과금/설정/초기화까지 모두 오케스트레이션하는 중심 컨트롤러 역할을 한다.
+- UI는 헤더/안내/리스트/입력의 4개 주영역으로 단순하지만, 실제 기능은 로컬 DB와 서버 응답, preference, 다이얼로그 흐름이 복합적으로 얽혀 있다.
+- 특히 `ChatMessageAdapter`가 사용자 액션을 콜백으로 Activity에 위임하고, Activity가 다시 `ChatRepository`를 통해 데이터 상태를 바꾸는 구조가 핵심이다.
+
+## 검증 기록
+- 2026-04-29
+  - 무엇/왜/어떻게: `ChatRoomActivity`를 빠르게 이해할 수 있도록 UI 구성과 기능 흐름을 문서화하기 위해, 액티비티 본문뿐 아니라 연결된 레이아웃/어댑터/다이얼로그/리포지토리까지 함께 읽고 구조를 교차 확인했다.
+  - 실행 명령/도구:
+    - `read(ChatRoomActivity.kt)`
+    - `read(activity_chat_room.xml, ChatMessageAdapter.kt, ChatRoomMoreDialogFragment.kt, ChatMessage.kt, ChatRepository.kt)`
+    - `read(item_chat_user_message.xml, item_chat_ai_message.xml, item_chat_typing_indicator.xml, item_chat_quota_notice.xml, fragment_chat_room_more_dialog.xml)`
+    - `read(CharacterInfo.kt, ChatRoomEnterResponse.kt, MessageStatus.kt, ChatBackgroundPickerDialogFragment.kt, CharacterGalleryViewerDialogFragment.kt)`
+    - `task(subagent_type="explore", run_in_background=true)` x2
+    - `glob(docs/*.md)`
+    - `read(기존 docs 샘플 2건)`
+    - `apply_patch` (본 문서 생성)
+  - 결과:
+    - `ChatRoomActivity`의 UI를 헤더/배경/안내/메시지 리스트/입력/보조 다이얼로그로 구분할 수 있음을 확인했다.
+    - 기능 흐름을 초기 진입, 메시지 전송/재시도, 페이징, 쿼터, 유료 메시지 구매, 이미지 보기, 배경 설정, 대화 초기화로 정리했다.
+    - 기존 `docs` 폴더의 날짜 기반 체크리스트 문서 형식에 맞춰 분석 문서를 추가했다.

docs/plan-task/20260430_채팅쿼터충전확장계획.md

@@ -0,0 +1,178 @@
+# 20260430 채팅 쿼터 충전 확장 계획
+
+## 작업 체크리스트
+- [x] 기존 채팅 쿼터 UI, 응답 DTO, 구매 API, Yandex 광고 사용 패턴을 근거 파일 기준으로 조사한다.  
+  QA: `ChatRoomActivity`, `ChatMessageAdapter`, `ChatQuotaPurchaseRequest`, `TalkApi`, `ChatRepository`, `AudioContentDetailActivity`, `app/build.gradle`를 근거로 현재 구조를 설명할 수 있어야 한다.
+- [x] 쿼터 안내 노출 조건을 `nextRechargeAtEpoch != null`에서 `totalRemaining <= 0` 기준으로 전환한다.  
+  QA: 채팅방 입장, 메시지 전송 응답, 쿼터 상태 조회, 쿼터 구매 응답 모두에서 `updateQuotaUi`가 `totalRemaining` 기준으로만 노출 여부를 결정해야 한다.
+- [x] 무료 충전 제거에 맞춰 카운트다운 및 무료 대기 문구 관련 로직을 제거한다.  
+  QA: `CountDownTimer`, `tv_time`, `nextRechargeAtEpoch` 기반 갱신, `checkQuotaStatus()`의 무료 충전 재조회 목적 로직이 더 이상 남지 않아야 한다.
+- [x] `item_chat_quota_notice`를 2단 구성의 신규 구매 UI로 교체한다.  
+  QA: 상단에는 광고 버튼 1개, 하단에는 캔 구매 버튼 2개가 가로 배치되어야 하며, 기존 시간/무료 안내 문구 영역은 제거되어야 한다.
+- [x] 광고 버튼과 캔 구매 버튼의 텍스트/스타일을 요청 사양대로 반영한다.  
+  QA: 광고 버튼은 `광고 / 5채팅`, 하단 버튼은 `10 / 15채팅`, `20 / 40채팅` 구조를 가지며, 각 캔 숫자 앞에 `ic_can` 아이콘이 표시되고 캔 숫자는 bold, 채팅 개수는 medium이어야 한다.
+- [x] 쿼터 구매 요청 DTO를 광고/캔 구매 구분이 가능하도록 확장한다.  
+  QA: 요청 본문에 `container`, `chargeType`, `canOption`이 포함되고, 캔 구매 시 `CAN_10`, `CAN_20`, 광고 구매 시 `AD` 타입을 표현할 수 있어야 한다.
+- [x] Yandex 채팅 쿼터 전용 rewarded ad unit id를 buildType별 `BuildConfig`로 추가한다.  
+  QA: `debug`/`release`에서 채팅 쿼터 광고용 별도 `BuildConfig` 키가 생성되어야 하며, 기존 오디오 콘텐츠 전면 광고 id와 분리되어야 한다.
+- [x] `totalRemaining == 1`일 때 광고를 미리 준비하고, 광고 버튼 터치 시 rewarded 광고를 표시한 뒤 `onRewarded()` 시점에 쿼터 충전 API를 호출하도록 흐름을 추가한다.  
+  QA: 광고 미로드/표시 실패 시에는 API가 호출되지 않아야 하고, 사용자가 reward 조건을 충족했을 때만 `AD` 타입 구매 요청이 한 번만 전송되어야 한다.
+- [x] 캔 구매 버튼 2종이 각각 올바른 구매 옵션으로 API를 호출하고, 성공 시 헤더 캔 수와 쿼터 UI를 갱신하도록 정리한다.  
+  QA: 10캔 버튼은 15채팅, 20캔 버튼은 40채팅과 연결되고, 성공 후 `SharedPreferenceManager.can` 및 `tvCanBadge`가 실제 차감값에 맞게 갱신되어야 한다.
+- [x] 변경 결과를 문서 하단 검증 기록에 누적한다.  
+  QA: 최소 빌드, 테스트, 수동 확인 계획과 실제 실행 결과가 한국어로 누적되어야 한다.
+
+## 범위 메모
+- 이번 요청은 `ChatRoomActivity`의 채팅 쿼터 부족 안내와 구매 흐름을 광고/캔 3가지 선택지로 확장하는 작업으로 한정한다.
+- 무료 충전은 제거되므로, 기존 `nextRechargeAtEpoch` 기반 표시 판단과 카운트다운 UI/로직은 제거 대상으로 본다.
+- 안내 노출 여부는 `totalRemaining <= 0`일 때만 표시하는 방향으로 고정한다.
+- 광고 버튼은 Yandex **rewarded ad**를 사용하고, reward 지급 콜백인 `onRewarded()` 시점에 쿼터 충전 API를 호출한다.
+- reward 기준으로 처리하므로, 광고가 단순히 표시되거나 닫힌 것만으로는 보상을 지급하지 않는다.
+- 광고 unit id는 기존 `app/build.gradle`의 `buildConfigField` 패턴을 유지하되, 채팅 쿼터 지면은 별도 키로 분리한다.
+- 캔 구매 옵션은 요청에 맞춰 `10캔→15채팅`, `20캔→40채팅` 두 가지만 제공한다.
+- `AD` 타입 쿼터 지급은 서버가 광고 보상 완료를 검증할 수 있는 구조(예: SSV, 검증 토큰, nonce/idempotency)인지 별도 확인이 필요하다.
+- 요청 범위를 넘는 별도 결제 화면 추가, 무료 충전 대체 UX 확장, 다른 화면 공통화 리팩터링은 제외한다.
+
+## 조사 근거
+- 현재 채팅 쿼터 흐름
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`
+  - `app/src/main/res/layout/item_chat_quota_notice.xml`
+- 쿼터 응답/구매 DTO
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomEnterResponse.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/SendChatMessageResponse.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/quota/ChatQuotaStatusResponse.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/quota/ChatQuotaPurchaseRequest.kt`
+- API/Repository
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/TalkApi.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+- 기존 Yandex 광고/전면광고 패턴
+  - `app/src/main/java/kr/co/vividnext/sodalive/audio_content/detail/AudioContentDetailActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/app/SodaLiveApp.kt`
+  - `app/build.gradle`
+- 공식 문서
+  - `https://ads.yandex.com/helpcenter/en/dev/android/interstitial`
+  - `https://ads.yandex.com/helpcenter/en/dev/android/rewarded`
+
+## 구현 계획
+
+### 1. 쿼터 상태 판단 기준 전환
+- 수정 대상:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomEnterResponse.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/SendChatMessageResponse.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/quota/ChatQuotaStatusResponse.kt`
+- 계획:
+  - `updateQuotaUi` 시그니처와 호출부를 `nextRechargeAtEpoch` 대신 `totalRemaining` 중심으로 재구성한다.
+  - 입장 응답, 메시지 전송 응답, 쿼터 조회/구매 응답에서 모두 동일한 판단식을 사용한다.
+  - `inputContainer` 표시 여부도 `totalRemaining > 0` 기준으로 정리한다.
+
+### 2. 무료 충전/카운트다운 제거
+- 수정 대상:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`
+  - `app/src/main/res/layout/item_chat_quota_notice.xml`
+- 계획:
+  - `quotaTimer`, `startQuotaCountdown`, `stopQuotaCountdown`, `formatEpochToHms`, `formatMillisToHms`, `checkQuotaStatus`의 역할을 재평가하고, 무료 충전용 로직은 제거한다.
+  - `ChatListItem.QuotaNotice`가 시간 텍스트를 들고 다니는 구조를 단순화한다.
+  - `QuotaNoticeViewHolder`의 `tv_time` 의존성을 제거하고, 버튼 클릭만 처리하는 형태로 바꾼다.
+
+### 3. QuotaNotice 레이아웃 교체
+- 수정 대상:
+  - `app/src/main/res/layout/item_chat_quota_notice.xml`
+  - 필요 시 관련 drawable / string 리소스
+- 계획:
+  - 상단 시간/무료 안내 블록을 제거하고 광고 버튼 1개를 `match_parent`로 배치한다.
+  - 하단에는 좌우 2개 버튼을 동일 행에 둔다.
+  - 광고 버튼 배경색 `RGB(254, 248, 227)`, border `RGB(247, 203, 80)`를 기존 코드 스타일에 맞춰 hex로 정의한다.
+  - 버튼 텍스트는 국제화 리소스로 분리하되, 요청 문구를 그대로 반영한다.
+
+### 4. 캔 구매 DTO 및 API 호출 확장
+- 수정 대상:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/quota/ChatQuotaPurchaseRequest.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/TalkApi.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+- 계획:
+  - 기존 `ChatQuotaPurchaseRequest`를 요청 사양에 맞게 확장하고, 필요하면 내부 클래스명도 API 계약과 맞는 방향으로 정리한다.
+  - `ChatRoomQuotaChargeType`, `ChatRoomQuotaCanOption` enum을 추가한다.
+  - `purchaseChatQuota(...)`가 광고/캔 버튼별로 다른 요청 본문을 받을 수 있게 repository 시그니처를 확장한다.
+
+### 5. 채팅 쿼터 전용 Yandex rewarded 흐름 추가
+- 수정 대상:
+  - `app/build.gradle`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+- 계획:
+  - `debug`/`release` 각각에 채팅 쿼터 rewarded ad unit id `BuildConfig` 키를 추가한다.
+  - 기존 Yandex 광고 초기화 구조는 유지하고, rewarded ad의 loader / load listener / event listener / `show(activity)` 패턴을 채팅방에 맞게 적용한다.
+  - `totalRemaining == 1` 시점에 preload를 시도하고, 광고 버튼 터치 시 로드된 광고가 있으면 표시한다.
+  - `onRewarded()` 콜백에서 `AD` 타입 쿼터 구매 API를 호출한다.
+  - `onAdFailedToShow`, `onAdDismissed`, `onDestroy`에서 listener와 ad 참조를 정리한다.
+
+### 6. 버튼별 구매 액션과 로컬 상태 갱신 정리
+- 수정 대상:
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`
+  - `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+- 계획:
+  - 어댑터 콜백을 광고/10캔/20캔으로 구분 가능한 형태로 확장하거나, 단일 콜백에 옵션 인자를 전달하도록 바꾼다.
+  - 캔 구매 성공 시에는 선택한 `needCan`만큼 `SharedPreferenceManager.can`을 차감하고 `tvCanBadge`를 갱신한다.
+  - 광고 구매 성공 시에는 캔 차감 없이 쿼터 UI만 갱신한다.
+  - 응답의 `totalRemaining` 기준으로 입력창 복구 여부와 QuotaNotice 제거 여부를 결정한다.
+
+## 예상 수정 파일
+- `docs/20260430_채팅쿼터충전확장계획.md`
+- `app/build.gradle`
+- `app/src/main/res/layout/item_chat_quota_notice.xml`
+- `app/src/main/res/values/strings.xml`
+- `app/src/main/res/values-en/strings.xml`
+- `app/src/main/res/values-ja/strings.xml`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/quota/ChatQuotaPurchaseRequest.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/quota/ChatQuotaStatusResponse.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomEnterResponse.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/SendChatMessageResponse.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/TalkApi.kt`
+- `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`
+
+## 검증 계획
+- `./gradlew :app:assembleDebug`
+- `./gradlew :app:testDebugUnitTest`
+- 필요 시 `./gradlew :app:ktlintCheck`
+- 수동 확인:
+  - `totalRemaining > 0` 상태에서 입력창이 보이고 QuotaNotice가 사라지는지 확인한다.
+  - `totalRemaining <= 0` 상태에서 신규 QuotaNotice UI가 노출되는지 확인한다.
+  - `totalRemaining == 1`일 때 rewarded 광고 preload가 준비되는지 로그 또는 디버그 포인트로 확인한다.
+  - 광고 버튼 탭 시 rewarded 광고가 뜨고 `onRewarded()` 직후 `AD` 타입 구매 요청이 1회 호출되는지 확인한다.
+  - 10캔/20캔 버튼 각각이 15채팅/40채팅 구매와 연결되고, 성공 후 헤더 캔 수와 입력창 상태가 갱신되는지 확인한다.
+
+## 검증 기록
+- 2026-04-30
+  - 무엇: 채팅 쿼터 충전 확장 작업의 계획 문서를 생성했다.
+  - 왜: 저장소 규칙에 따라 구현 전에 `docs` 아래 계획 문서를 먼저 만들고, 그 문서를 기준으로 범위·근거·검증 기준을 고정해야 하기 때문이다.
+  - 어떻게:
+    - 생성 파일: `docs/20260430_채팅쿼터충전확장계획.md`
+    - 근거 파일: `ChatRoomActivity.kt`, `ChatMessageAdapter.kt`, `item_chat_quota_notice.xml`, `ChatQuotaPurchaseRequest.kt`, `ChatQuotaStatusResponse.kt`, `TalkApi.kt`, `ChatRepository.kt`, `ChatRoomEnterResponse.kt`, `SendChatMessageResponse.kt`, `AudioContentDetailActivity.kt`, `app/build.gradle`
+    - 근거 문서: `https://ads.yandex.com/helpcenter/en/dev/android/interstitial`, `https://ads.yandex.com/helpcenter/en/dev/android/rewarded`
+    - 결과: 무료 충전 제거, `totalRemaining` 기준 노출 전환, 광고/캔 3가지 구매 UI, DTO 확장, Yandex rewarded 연동 범위, 예상 수정 파일과 검증 계획을 구현 전에 먼저 확정했다.
+- 2026-04-30
+  - 무엇: 채팅 쿼터 충전 확장 구현과 검증을 완료했다.
+  - 왜: 무료 충전 제거 이후에도 채팅 쿼터 부족 상태에서 rewarded 광고와 2종의 캔 구매 옵션으로 다시 충전할 수 있어야 했기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/build.gradle`, `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`, `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapter.kt`, `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/quota/ChatQuotaPurchaseRequest.kt`, `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt`, `app/src/main/res/layout/item_chat_quota_notice.xml`, `app/src/main/res/drawable/bg_chat_quota_rewarded_ad_button.xml`, `app/src/main/res/values/strings.xml`, `app/src/main/res/values-en/strings.xml`, `app/src/main/res/values-ja/strings.xml`, `app/src/test/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapterTest.kt`
+    - 구현 내용: `totalRemaining` 기준 QuotaNotice 노출 전환, countdown/free-wait 로직 제거, rewarded 광고 preload/show/onRewarded 구매 호출, 10캔/20캔 구매 분기, 채팅 쿼터 전용 rewarded ad unit id 추가, QuotaNotice 3버튼 UI 적용
+    - 실행 명령: `./gradlew :app:testDebugUnitTest :app:assembleDebug`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 실행 명령: `./gradlew :app:ktlintCheck`
+    - 실행 결과: `BUILD SUCCESSFUL`
+    - 진단 도구: `lsp_diagnostics`
+    - 진단 결과: `.kt` LSP 서버 미설정으로 `No LSP server configured for extension: .kt`
+    - 수동 확인 시도: `adb devices`
+    - 수동 확인 결과: 연결된 Android 기기가 없어 앱 실행 기반의 광고 노출/버튼 동작 수동 검증은 이번 세션에서 진행하지 못했다.
+- 2026-04-30
+  - 무엇: 리뷰 피드백을 반영해 중복 요청 방지와 rewarded preload 조건을 보강하고, 서버 검증 리스크를 문서에 기록했다.
+  - 왜: 빠른 연속 탭으로 인한 중복 구매/중복 광고 시도와, 이미 quota가 소진된 상태에서 첫 광고 탭이 항상 실패하는 UX를 줄여야 했기 때문이다.
+  - 어떻게:
+    - 수정 파일: `app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRoomActivity.kt`, `docs/20260430_채팅쿼터충전확장계획.md`
+    - 로직 보강: `isQuotaPurchaseInFlight`, `isChatQuotaRewardedAdShowing` 가드 추가, rewarded preload 조건을 `totalRemaining <= 1`로 확장
+    - 문서 반영: `AD` 타입 쿼터 지급의 서버 검증/SSV/idempotency 확인 필요성을 범위 메모에 기록