From f419b12da0ef6e024f75ab79edcfc683150ee518 Mon Sep 17 00:00:00 2001 From: klaus Date: Tue, 13 Oct 2026 15:51:40 +0900 Subject: [PATCH] =?UTF-8?q?docs(ads):=20=EA=B4=91=EA=B3=A0=20=EC=A0=9C?= =?UTF-8?q?=EA=B1=B0=20=EA=B3=84=ED=9A=8D=EA=B3=BC=20=EA=B2=80=EC=A6=9D=20?= =?UTF-8?q?=EA=B2=B0=EA=B3=BC=EB=A5=BC=20=EA=B8=B0=EB=A1=9D=ED=95=9C?= =?UTF-8?q?=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../plan-task.md | 156 ++++++++++++++++++ docs/20261013_Yandex_광고_전체_제거/prd.md | 74 +++++++++ .../reviews/phase1-yandex-removal-review.md | 62 +++++++ docs/agent-guides/build-test-style.md | 6 + 4 files changed, 298 insertions(+) create mode 100644 docs/20261013_Yandex_광고_전체_제거/plan-task.md create mode 100644 docs/20261013_Yandex_광고_전체_제거/prd.md create mode 100644 docs/20261013_Yandex_광고_전체_제거/reviews/phase1-yandex-removal-review.md diff --git a/docs/20261013_Yandex_광고_전체_제거/plan-task.md b/docs/20261013_Yandex_광고_전체_제거/plan-task.md new file mode 100644 index 00000000..8c3b6c58 --- /dev/null +++ b/docs/20261013_Yandex_광고_전체_제거/plan-task.md @@ -0,0 +1,156 @@ +# Yandex 광고 전체 제거 구현 계획 + +| 항목 | 내용 | +|---|---| +| 상태 | 구현 완료 / lint 및 release 검증 제한 기록 | +| 작성일 | 2026-10-13 | +| 요구사항 기준 | [prd.md](prd.md) | +| API 기준 | 기존 ChatQuotaPurchaseRequest 및 TalkApi 계약 유지 | +| 현재 Phase / Goal | Phase 1 완료 / 활성 Goal 없음 | + +## 목표와 범위 + +사용자의 `문서대로 진행` 요청으로 아래 Task와 검증을 재개한다. 기존 중단 및 원복 기록은 유지한다. + +Yandex SDK와 광고 소비 경로를 모두 없애면서 기존 캔 구매·채팅·목록 기능을 보존한다. PRD의 ADS-001~003, CAN-001, SAFE-001을 하나의 빌드 가능한 변경으로 처리한다. 과거 문서, 서버, 다른 광고/일반 콘텐츠 배너, 사용자 선행 변경은 수정하지 않는다. + +## 기술적 제약 + +- 선행 변경: `app/build.gradle` 26줄 삭제. Yandex BuildConfig 선언은 이미 삭제되어 초기 Gradle 테스트가 컴파일 단계에서 차단될 수 있다. 이를 복구하거나 RED 성공으로 보고하지 않는다. +- `app/src/test` 로직/local unit test만 작성한다. 레이아웃 속성 테스트, 기기/계측 테스트, 실제 서버 구매는 제외한다. +- 캔 요청은 `container=aos`, `chargeType=CAN`, `canOption=CAN_10/CAN_20`; 10캔/15회 및 20캔/40회 유지. +- 미사용 정리는 이번 삭제로 생긴 항목만 수행한다. API 메서드·인증·구매 잠금·성공/실패 처리를 변경하지 않는다. +- 커밋·푸시는 하지 않는다. 검증 실패를 숨기거나 기존 테스트를 삭제·완화하지 않는다. + +## Phase 1 + +**결과:** 광고 없는 앱을 빌드하고 캔 구매 계약을 유지한다. + +#### Task 1.1 광고 제거 및 캔 구매 회귀 보호 + +**Goal P1-T1:** 모든 광고 소비 코드와 라이브러리를 일괄 제거한다. + +- 시작 조건: 사용자의 별도 구현 요청, PRD 범위 확정 및 선행 변경 재확인. +- 완료 증거: 제거 diff, focused 테스트, production 잔존 참조 검사. +- 범위 밖: 서버의 AD 지원 제거, 일반 콘텐츠 배너 삭제, UI 재설계. + +**Files (Java/Kotlin 경로 기준: `app/src/main/java/kr/co/vividnext/sodalive/`):** + +- Modify: `app/build.gradle`, `app/SodaLiveApp.kt`. +- Delete: `common/YandexInlineBannerHeaderAdapter.kt`. +- Modify: `chat/original/OriginalTabFragment.kt`, `chat/talk/TalkTabFragment.kt`, `chat/character/CharacterTabFragment.kt`. +- Modify: `live/LiveFragment.kt`, `live/room/detail/LiveRoomDetailFragment.kt`. +- Modify: `audio_content/series/main/home/SeriesMainHomeFragment.kt`, `audio_content/series/main/day_of_week/SeriesMainDayOfWeekFragment.kt`, `audio_content/series/main/by_genre/SeriesMainByGenreFragment.kt`. +- Modify: `explorer/profile/creator_community/all/CreatorCommunityAllActivity.kt`, `home/pushnotification/PushNotificationListActivity.kt`, `settings/notification/NotificationReceiveSettingsActivity.kt`. +- Modify: `chat/talk/room/ChatRoomActivity.kt`, `chat/talk/room/ChatMessageAdapter.kt`, `chat/talk/room/quota/ChatQuotaPurchaseRequest.kt`. +- Modify (app/src/main/res/layout): `fragment_live.xml`, `fragment_live_room_detail.xml`, `fragment_character_tab.xml`, `fragment_series_main_home.xml`, `fragment_series_main_day_of_week.xml`, `fragment_series_main_by_genre.xml`, `activity_creator_community_all.xml`, `activity_push_notification_list.xml`, `activity_notification_receive_settings.xml`. +- Modify: `app/src/main/res/values/strings.xml`, `values-en/strings.xml`, `values-ja/strings.xml` 내 광고 전용 3개 문구. +- Test: `app/src/test/java/kr/co/vividnext/sodalive/chat/talk/room/ChatMessageAdapterTest.kt`, `ChatRepositoryTest.kt`. +- Modify: `docs/agent-guides/build-test-style.md`에 캔 구매 회귀 명령 예시 추가. + +**Interfaces:** `ChatQuotaNoticeAction`은 PURCHASE_10_CAN/PURCHASE_20_CAN만 제공한다. `Callback.onQuotaNoticeAction(action)`은 유지하고 광고로 이어지는 `onPurchaseQuota()`와 fallback을 삭제한다. CAN 요청 serializer와 repository 계약은 유지한다. Original/Talk은 콘텐츠 adapter를 직접 연결하며 기존 광고 헤더 offset·span 처리를 제거한다. + +- [x] **RED:** 액션 enum에 캔 구매 2개만 존재하는 실패 테스트와 두 캔 옵션의 요청·응답·오류 보존 테스트를 추가한다. +- [x] **RED 확인:** 아래 focused 테스트를 실행한다. 예상 assertion 실패 또는 선행 BuildConfig 누락에 따른 컴파일 차단을 실제 결과로 구분 기록한다. +- [x] **GREEN:** SDK·초기화·배너·헤더·광고 사전 로딩/표시/보상·AD enum·광고 문구를 삭제한다. 캔 구매는 그대로 둔다. +- [x] **GREEN 확인:** 동일 focused 테스트를 실행해 통과를 확인한다. +- [x] **REFACTOR:** 이번 삭제로 미사용이 된 import/상태만 정리하고 관련 회귀 및 lint 결과를 기록한다. + +```bash +./gradlew :app:testDebugUnitTest --tests '*ChatMessageAdapterTest' --tests '*ChatRepositoryTest' +``` + +**검증 기록:** 구현 시 실제 실행 결과를 누적한다. + +- 2026-10-13 중단 전 시도: 캔 구매 보호 테스트를 추가하고 focused 테스트를 실행했으나 기존 Yandex BuildConfig 선언 누락으로 Kotlin 컴파일 단계에서 차단되어 assertion까지 도달하지 못했다. 사용자 요청에 따라 실행 작업을 중단하고 이번에 추가한 테스트 변경은 원복했다. 구현 및 RED/GREEN 완료로 판정하지 않는다. +- 2026-10-13 재개 RED: 테스트 5개를 먼저 복원·추가한 뒤 `./gradlew :app:testDebugUnitTest --tests '*ChatMessageAdapterTest' --tests '*ChatRepositoryTest'` 실행. exit 1, `:app:compileDebugKotlin`에서 기존 Yandex BuildConfig 필드 12개 미해결 참조로 차단됐다. assertion 실패를 관찰한 RED가 아니며 선언을 복구하지 않았다. +- 2026-10-13 GREEN 구현: SDK 의존성·초기화, 배너 소비 Kotlin 9곳과 XML 9개, 전용 헤더 adapter, Original/Talk의 ConcatAdapter와 헤더 offset/span, 광고 사전 로딩·표시·보상·정리·상태, REWARDED_AD·onPurchaseQuota fallback·AD 요청 enum 및 3개 locale의 광고 문구를 삭제했다. `ChatRoomActivity.purchaseChatQuota`의 구매 잠금·인증·성공 잔액 차감·실패 안내 함수는 수정하지 않았으며 CAN_10(10,15), CAN_20(20,40), repository와 API도 유지했다. +- 2026-10-13 GREEN 실행: 동일 focused 명령의 첫 실행은 Kotlin 컴파일 중 도구 제한 120초로 종료됐다. timeout을 600초로 늘려 동일 명령을 다시 실행하여 exit 0, `BUILD SUCCESSFUL in 1m 50s`를 확인했다. 결과 XML 기준 ChatMessageAdapterTest 4개, ChatRepositoryTest 6개, wildcard에 포함된 기존 DmChatRepositoryTest 10개로 총 20개 통과, 실패·오류·skip 각각 0개다. 새 회귀 테스트는 구매 액션 2개, CAN 충전 타입, 두 옵션의 실제 Gson payload·충전 수량·서버 잔여 응답, 서버 및 통신 실패 전달을 검증한다. +- 2026-10-13 제거 확인: `rg -n -i 'yandex|rewarded|onPurchaseQuota' app/src/main app/build.gradle app/proguard-rules.pro` 결과 0건(exit 1). `GIT_MASTER=1 git diff --check` exit 0. `GIT_MASTER=1 git diff --numstat -- app/build.gradle app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ChatRepository.kt app/src/main/java/kr/co/vividnext/sodalive/chat/talk/TalkApi.kt app/src/main/res/layout/item_chat_quota_notice.xml`에서 Gradle만 추가 0/삭제 30으로 확인했다. 선행 26줄 삭제에 SDK 의존성·주석·빈 줄 및 고아 ad unit 주석 4줄 삭제만 추가했으며 다른 3개 파일은 변경 없다. 기존 일반 콘텐츠 배너는 유지했다. +- 2026-10-13 REFACTOR 부분 확인: 이번 삭제로 미사용이 된 import·광고 전용 상태·생명주기만 정리했고 build-test-style.md에 focused 명령 예시를 추가했다. LSP 도구가 제공되지 않아 diagnostics는 실행하지 않았다. focused 명령의 debug Kotlin/Java 및 테스트 컴파일은 통과했으나 기존 deprecated/unchecked cast·Gradle 경고가 남는다. lint·별도 빌드·전체 suite·의존성 검사·독립 리뷰는 상위 작업자의 P1-GATE 검증으로 남겨 REFACTOR와 Gate 체크박스를 완료로 표시하지 않는다. 기기/UI·실제 결제는 실행하지 않았고 staging 및 PRD는 수정하지 않았다. +- 2026-10-13 REFACTOR 최종 기록: 전체 로컬 테스트·debug 빌드 성공 및 lint 실패 내역 확인을 완료했다. lint 오류는 수정하지 않은 파일에서 보고되며 이번 제거 범위 밖으로 남긴다. 독립 리뷰에서 캔 구매 함수·원래 콘텐츠 adapter·일반 배너 보존을 확인하고 APPROVE를 받았다. lint 통과나 release 컴파일 완료를 의미하지 않는다. + +#### Task 1.2 광고 버튼 전용 잔존 리소스 제거 + +**Goal P1-T2:** APK 검사에서 확인한 미사용 광고 버튼 배경까지 제거한다. + +- 시작 조건: P1-T1 구현 후 APK DEX 목록에 `R.drawable.bg_chat_quota_rewarded_ad_button` 잔존 확인. +- 대상 파일: `app/src/main/res/drawable/bg_chat_quota_rewarded_ad_button.xml` 삭제. +- 완료 증거: 파일명·참조 검색 결과, 재빌드한 APK에서 해당 resource ID 미포함, 관련 로컬 테스트 유지. +- 범위 밖: 포인트 정산의 reward 기능, AppsFlyer SDK의 일반 광고 네트워크 enum 상수. +- TDD 예외 사유: 호출자 없는 drawable 삭제이며 문서 규칙상 레이아웃/시각 속성 테스트를 추가하지 않는다. 대체 검증으로 APK resource ID 전후 검사와 빌드를 사용한다. +- [x] 삭제 전 증거: APK DEX 목록에 해당 ID가 있고 source 참조는 0건임을 확인했다. +- [x] 광고 버튼 전용 drawable을 삭제한다. +- [x] debug 재빌드와 APK 검사 및 로컬 회귀 결과를 기록한다. + +**검증 기록:** 2026-10-13 `./gradlew :app:testDebugUnitTest :app:assembleDebug --console=plain` 재실행 결과 BUILD SUCCESSFUL in 3m 47s, 196 suites/1,549 tests, 실패·오류·skip 0. 최종 APK의 DEX/manifest 검색에서 `com.yandex`, `io.appmetrica`, `YandexInlineBannerHeaderAdapter`, `bg_chat_quota_rewarded_ad_button`, `chat_quota_rewarded_ad` 모두 0건 확인. + +#### Phase 1 Gate + +**Goal P1-GATE:** 광고 제거와 캔 구매 보존의 통합 결과를 확인한다. + +- 시작 조건: P1-T1 구현 및 focused 검증 종료. +- 완료 증거: 아래 명령 결과, 사용자 선행 변경 보존, Verification Log. +- 범위 밖: 기존 무관한 lint/test 실패 수정 및 기기 UI 검증. +- TDD 예외 사유: read-only 통합 검증 Task. 대체 검증은 빌드·로컬 테스트·의존성 및 참조 검사다. + +- [x] 채팅·라우팅 local 회귀를 실행한다. +- [x] 전체 debug local unit test를 실행하고 기존 실패와 변경 관련 실패를 구분한다. +- [x] debug 빌드·lint 및 release Kotlin 컴파일을 실행한다. debug 빌드 성공, lint 실패·release configuration 차단은 아래 제한으로 기록한다. +- [x] debug/release runtime에 Yandex SDK가 없는지 확인한다. +- [x] 소스·리소스·설정 잔존 참조와 사용자 선행 변경 보존을 확인한다. +- [x] 문서 체크박스와 검증 기록을 갱신한다. + +**Gate 판정:** 광고 제거·캔 구매 보존 구현 승인. 전체 local test 및 debug 빌드 통과. 전체 lint/release 컴파일까지 통과한 상태는 아니다. 독립 리뷰: [phase1-yandex-removal-review.md](reviews/phase1-yandex-removal-review.md). + +**[blocked] 검증 제한:** release 컴파일은 로컬 서명 설정 제공 후 재검증 필요. lint는 변경하지 않은 파일의 오류 30개를 별도 작업으로 해결해야 전체 통과 가능. LSP 도구 미제공으로 diagnostics 실행 불가. 기기·실제 결제 검증은 승인 범위 밖이다. + +```bash +./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.chat.talk.room.*' --tests 'kr.co.vividnext.sodalive.v2.chat.action.*' +./gradlew :app:assembleDebug :app:compileReleaseKotlin :app:lintDebug +./gradlew :app:dependencyInsight --dependency yandex --configuration debugRuntimeClasspath +./gradlew :app:dependencyInsight --dependency yandex --configuration releaseRuntimeClasspath +./gradlew tasks --all +rg -n -i 'yandex|rewarded|onPurchaseQuota' app/src/main app/build.gradle app/proguard-rules.pro +``` + +**Expected:** 테스트·빌드 exit 0, dependency 일치 없음, production 참조 검색 0건(rg exit 1). 무관한 실패는 완료로 위장하지 않고 별도 기록한다. + +## 실행 순서 + +P1-T1 → P1-T2 → P1-GATE. Gradle 명령은 테스트 산출물 충돌을 피하기 위해 직렬 실행한다. + +## 재개 시나리오 계약 + +- S1 광고 제거: production 참조 검색 0건, debug/release dependencyInsight Yandex 일치 없음, debug APK 생성 성공. 실제 표면은 Gradle 의존성 그래프와 생성 APK의 DEX/manifest 검사다. +- S2 캔 구매 정상·실패: CAN_10/CAN_20 요청 직렬화, 서버 잔여 횟수 반환, 오류 전달을 ChatRepositoryTest에서 검증하고 구매 함수 diff로 잔액 처리 보존을 확인한다. 실제 결제는 하지 않는다. +- S3 잔여 횟수 경계·인접 기능: 광고 사전 로딩 제거, 캔 액션 2개만 유지, 채팅 라우팅 회귀 테스트 통과, Original/Talk 목록의 헤더 offset 제거를 확인한다. +- 종료 기준: 광고 제거 구현, 위 시나리오 증거, 테스트/빌드/의존성 결과와 리뷰 판정 기록을 갖추면 즉시 종료한다. 기존 무관한 실패·LSP 미제공 등 확인 불가능한 항목은 명시하며 통과로 보고하지 않는다. +- 검증 제약: 문서가 정한 기기·계측·시각 QA 금지는 유지한다. 실제 표면 검증은 빌드 산출물 검사로 수행하며 LSP 도구가 없으면 Kotlin 컴파일·Android lint 결과를 사용한다. + +## Progress + +- 2026-10-13: 기존 사용 경로와 문서 샘플 확인. 광고 버튼은 이미 없으며 사전 로딩/보상 코드와 배너 소비 코드가 남은 상태임을 확인했다. PRD와 제거·보존 범위 작성 완료. +- 2026-10-13 후속 요청: 사용자가 문서 작성까지만 요청하여 백그라운드 구현 작업을 취소했다. 실제 광고 삭제는 수행되지 않았으며, 추가했던 테스트 2개 파일의 변경도 원복했다. 기존 사용자 Gradle 변경은 유지한다. +- 2026-10-13 재개 완료: 사용자 승인 후 P1-T1/P1-T2 구현 및 P1-GATE 검증 기록 완료. 최종 테스트 1,549개 통과, debug APK에서 SDK·광고 전용 리소스 제거 확인, 독립 리뷰 APPROVE. 사용자 선행 변경과 staging 상태는 보존하고 커밋하지 않았다. + +## Decision Log + +- DEC-001~004: PRD와 동일. 현재 차단되는 제품 결정 없음. +- DEC-005: 구현 승인 상태를 정정한다. 현재는 문서만 전달하고 구현을 보류하며, 사용자 재요청 전까지 코드 변경을 재개하지 않는다. +- DEC-006: 사용자 재요청으로 구현을 재개한다. ULW 검증 요청에 따라 전체 debug local unit test와 독립 리뷰를 추가하되 커밋·푸시 및 실제 결제·기기 UI 검증은 하지 않는다. +- DEC-007: 사용자 `/commit-with-validation` 요청으로 현재 변경의 신규 커밋과 메시지 검증을 진행한다. 공용 원본 절차와 저장소 커밋 규칙을 따른다. + +## Verification Log + +- 작업 시작: `git status --short`에서 `app/build.gradle`만 수정 상태, `git diff --numstat -- app/build.gradle`에서 추가 0/삭제 26 확인. 기존 변경은 보존한다. +- 사용자 중단 요청 이후 추가 빌드·테스트는 실행하지 않는다. 최종 diff/status로 테스트 원복과 문서만 추가된 상태를 확인한다. +- 재개 통합 검증: `:app:testDebugUnitTest` 결과 196 suites / 1,549 tests / failure·error·skip 0. 채팅/라우팅 23개 테스트도 포함된다. `:app:assembleDebug` 성공 및 APK 생성 확인. `:app:lintDebug`는 변경하지 않은 파일의 오류 30개·경고 794개로 실패했으며 첫 오류는 AndroidManifest.xml의 FacebookActivity MissingClass다. 로그: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/yandex-debug-gate.log`. +- release 컴파일: `:app:compileReleaseKotlin` 포함 실행은 RELEASE_STORE_FILE, RELEASE_STORE_PASSWORD, RELEASE_KEY_ALIAS, RELEASE_KEY_PASSWORD 미설정으로 configuration 단계에서 차단됐다. 실제 값은 출력·생성하지 않고 release 컴파일은 미검증으로 남긴다. +- debug/release 각각 `:app:dependencyInsight --dependency yandex --configuration debugRuntimeClasspath` 및 `releaseRuntimeClasspath` 실행 성공, 일치 의존성 없음. `:app:assembleDebug tasks --all` 재실행은 BUILD SUCCESSFUL in 4s. +- APK `apkanalyzer dex packages --defined-only` 및 `manifest print` 검사에서 com.yandex/io.appmetrica 패키지 0건. 앱 소유 광고 버튼 drawable ID가 남아 P1-T2를 추가했다. AppsFlyer의 YANDEX/REWARDED enum 상수는 광고 SDK 포함 증거가 아니며 삭제하지 않는다. +- 최종 재검증: `/var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/yandex-final-gate.log`의 BUILD SUCCESSFUL, 결과 XML 196 suites/1,549 tests/실패·오류·skip 0 확인. 전체 실행에 ChatMessageAdapterTest 4개, ChatRepositoryTest 6개, TimeUtilsTest 1개, ChatActionTest 12개가 포함된다. +- 최종 실제 산출물: `app/build/outputs/apk/debug/app-debug.apk`. `/Users/klaus/Library/Android/sdk/cmdline-tools/latest/bin/apkanalyzer dex packages --defined-only app/build/outputs/apk/debug/app-debug.apk`와 `manifest print`로 검사했다. 증거 로그는 같은 임시 폴더의 `yandex-final-apk-packages.log`, `yandex-final-apk-manifest.xml`이며 SDK 패키지 및 광고 전용 resource ID 부재를 확인했다. +- 독립 리뷰: Oracle 경로는 두 번 중단되고 결과를 회수하지 못해 승인 근거로 사용하지 않았다. 별도 general reviewer가 실제 diff·구매 함수·목록 offset·테스트 로그를 확인하여 APPROVE, 차단 발견 사항 없음으로 판정했다. 상세는 reviews/phase1-yandex-removal-review.md에 기록했다. +- 정리: 기기·브라우저·서버·포트·QA 임시 실행 프로세스를 만들지 않았다. Gradle 및 apkanalyzer 명령은 종료됐으며 증거 로그만 보존한다. `git diff --check` 통과. 별도 코드 수정이나 커밋·푸시 없음. +- 2026-10-13 커밋 전 검증: `./gradlew :app:testDebugUnitTest :app:assembleDebug --console=plain` exit 0, `BUILD SUCCESSFUL in 1m 47s`. 테스트 태스크는 `UP-TO-DATE`로 기존 결과를 재사용했고 debug APK는 재생성했다. `git diff HEAD --check` 통과. lint와 release 컴파일은 재실행하지 않았으며 기존 제한 기록을 유지한다. diff --git a/docs/20261013_Yandex_광고_전체_제거/prd.md b/docs/20261013_Yandex_광고_전체_제거/prd.md new file mode 100644 index 00000000..0b8c90f8 --- /dev/null +++ b/docs/20261013_Yandex_광고_전체_제거/prd.md @@ -0,0 +1,74 @@ +# Yandex 광고 전체 제거 PRD + +## 문서 정보 + +| 항목 | 내용 | +|---|---| +| 문서 상태 | 구현 완료 / 검증 제한 기록 | +| 작성일 / 최종 수정일 | 2026-10-13 | +| 대상 제품 | SodaLive Android | +| 결정권자 | 사용자 | +| 관련 구현 계획 | [plan-task.md](plan-task.md) | +| 관련 review | [phase1-yandex-removal-review.md](reviews/phase1-yandex-removal-review.md) | +| 관련 API Contract | 신규 계약 없음. 기존 캔 구매 요청 유지 | + +## 1. Overview / Problem Statement + +Yandex SDK와 앱 초기화, 화면 배너, 전용 어댑터, 채팅 보상형 광고를 제거한다. 광고 충전 버튼은 현재 레이아웃에 없지만 광고 액션과 사전 로딩 경로가 남아 있다. SDK만 제거하면 Kotlin 및 XML 참조가 깨지므로 소비 코드를 함께 삭제한다. + +## 2. Goals / Non-Goals + +사용자의 후속 요청 `문서대로 진행`에 따라 구현 보류를 해제하고 아래 요구사항을 구현한다. 이전 중단 기록은 Decision Log에 보존한다. + +- 광고 SDK 없이 빌드하고 Yandex 광고를 초기화·요청·표시하지 않는다. +- 채팅 10캔/20캔 구매와 기존 일반 콘텐츠 배너·라우팅·목록 동작은 유지한다. +- 새 광고 SDK, 무료 충전 대체 기능, 서버 API 변경, 관련 없는 리팩터링은 하지 않는다. +- 과거 광고 도입 문서와 사용자 선행 변경은 보존한다. SDK 캐시나 과거 빌드 산출물의 강제 삭제는 범위 밖이다. + +## 3. 사용자 흐름 및 보존 계약 + +1. 기존 경로로 AI 채팅방에 입장한다. +2. 잔여 채팅 횟수가 없으면 기존 10캔/20캔 구매 옵션을 제공한다. +3. 구매 요청은 기존 인증·roomId와 `container=aos`, `chargeType=CAN`, `canOption=CAN_10` 또는 `CAN_20`을 보낸다. +4. 성공 시 서버 `totalRemaining`을 반영하고 기존 방식으로 캔 잔액을 차감한다. 실패 시 차감하지 않고 기존 오류 안내를 유지한다. +5. 10캔/15채팅, 20캔/40채팅 설정과 중복 구매 방지 처리를 유지한다. + +## 4. 기능 요구사항 + +| ID | 상태 | 요구사항 | 수용 기준 | Goal | +|---|---|---|---|---| +| ADS-001 | 확정 | SDK·초기화·전용 어댑터 제거 | production 코드/리소스에 Yandex 참조 없음, runtime dependency 미포함 | P1-T1 | +| ADS-002 | 확정 | 모든 Yandex 배너 및 헤더 제거 | 9개 XML 배너 제거, Original/Talk 목록의 광고 헤더 인덱스 보정 제거 | P1-T1 | +| ADS-003 | 확정 | 채팅 광고 로딩·표시·보상·액션·문구 제거 | 광고 요청/보상 경로 및 AD 요청 enum 제거, 광고 버튼 추가 없음 | P1-T1 | +| CAN-001 | 확정 | 캔 구매 동작 보존 | CAN_10/CAN_20 요청 직렬화·전달·성공·실패 회귀 테스트 통과 | P1-T1 | +| SAFE-001 | 확정 | 사용자 변경 및 비광고 동작 보존 | 선행 Gradle 26줄 삭제 유지, 일반 콘텐츠 배너와 서버 API 유지 | P1-GATE | + +## 5. 기술·보안·검증 기준 + +- Kotlin/XML/Gradle 기존 구조에서 삭제 위주로 변경한다. 신규 라이브러리나 wrapper를 만들지 않는다. +- `app/build.gradle`은 작업 시작 시 이미 26줄 삭제 상태다. Yandex BuildConfig 선언은 없는 상태이며 복구하지 않는다. +- 잔여 횟수 1회 이하에서 광고 사전 로딩 함수를 호출하는 경로도 제거한다. +- 광고 전용 import·상태·생명주기 처리와 삭제로 새로 미사용이 되는 코드만 정리한다. +- `app/src/test` 로컬 테스트, debug 빌드·lint, debug/release runtime dependency 검사로 검증한다. 기기·에뮬레이터 UI 조작, 계측 테스트, 시각 QA, 실제 구매 요청은 실행하지 않는다. +- 키·토큰·URL 등 BuildConfig 민감값은 보고서·로그에 출력하지 않는다. + +## 6. Open Questions + +차단되는 미결 사항 없음. 사용자는 앞서 설명한 SDK·어댑터·광고 코드 전체 제거와 캔 구매 보존을 확정했다. 레거시 광고 수정은 이 요청을 수행하는 데 필요한 범위로 한정한다. + +## 7. 성공 기준 + +- [x] ADS-001~003 및 CAN-001 구현과 로컬 회귀 확인 +- [x] debug 빌드와 runtime dependency 검사 완료 +- [x] 검증 실패·환경 제약을 plan-task.md에 구분 기록 + +## 8. Decision Log + +| 날짜 | ID | 결정 | 근거 | +|---|---|---|---| +| 2026-10-13 | DEC-001 | 전체 Yandex 제거, 캔 구매 유지 | 사용자 최종 요청 | +| 2026-10-13 | DEC-002 | 레거시 광고 소비 코드만 직접 수정 | 이전 확인 질문 후 사용자가 동일 제거 범위를 확정 | +| 2026-10-13 | DEC-003 | 광고 충전 버튼은 이미 없으므로 잔존 액션·문구·로직 제거 | item_chat_quota_notice.xml과 ChatMessageAdapter 확인 | +| 2026-10-13 | DEC-004 | 기존 API endpoint와 CAN 계약 유지, 앱에서 AD 요청 타입 제거 | 보상형 광고 제거 후 AD의 소비자 없음 | +| 2026-10-13 | DEC-005 | 현재 작업은 문서 작성까지만 수행, 구현 보류 | 사용자 후속 요청. 실행 작업 중단 및 이번에 추가한 테스트 원복 | +| 2026-10-13 | DEC-006 | 구현 보류 해제, 문서대로 광고 제거 재개 | 사용자 `문서대로 진행` 및 `ulw` 요청. 기존 범위·캔 구매 계약 유지 | diff --git a/docs/20261013_Yandex_광고_전체_제거/reviews/phase1-yandex-removal-review.md b/docs/20261013_Yandex_광고_전체_제거/reviews/phase1-yandex-removal-review.md new file mode 100644 index 00000000..b3dc1499 --- /dev/null +++ b/docs/20261013_Yandex_광고_전체_제거/reviews/phase1-yandex-removal-review.md @@ -0,0 +1,62 @@ +# Phase 1 Yandex 광고 제거 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | P1-T1 광고 제거, P1-T2 잔존 리소스 제거 | +| 기준 | 현재 working tree, 사용자 선행 Gradle 변경 제외 | +| 일자 | 2026-10-13 | +| 리뷰어 | 독립 general agent, 세션 ses_ecc0ca1e1ffeyV0WuWgI3kKO3T | +| 기록자 | Sisyphus | +| 기준 문서 | ../prd.md, ../plan-task.md | +| 상태 | 판정 완료: APPROVE | + +## 2. 목적과 범위 + +- SDK·초기화·배너·헤더·보상형 광고 제거의 누락과 회귀를 확인한다. +- 캔 구매 인증·잠금·성공 후 잔액 반영·실패 안내·수량을 보존했는지 확인한다. +- Original/Talk의 헤더 offset 제거와 일반 콘텐츠 배너 보존을 확인한다. +- 실제 결제·기기 UI·서버 변경·무관한 lint 수정은 제외한다. + +## 3. 검토 근거 + +- `ChatRoomActivity.kt:465`: 캔 구매 액션 2개만 처리한다. +- `ChatRoomActivity.kt:474`: 구매 함수는 기존 잠금, Bearer 인증, 서버 잔여 횟수 반영, 성공 후 캔 차감과 실패 toast를 유지한다. +- `ChatQuotaPurchaseRequest.kt:13`: CAN 타입 및 CAN_10(10,15)/CAN_20(20,40) 유지. +- `ChatRepository.kt:77`, `TalkApi.kt:85`: 기존 요청·endpoint 보존, 두 파일의 변경 없음. +- `OriginalTabFragment.kt:61`, `TalkTabFragment.kt:59`: 광고 header 제거 후 원래 콘텐츠 adapter 위치 기준으로 복귀. +- `SodaLiveApp.kt` 광고 초기화 제거, 9개 XML·소비자 제거, 전용 adapter·drawable 삭제. +- 기존 사용자 변경은 Gradle 26줄 삭제이며 이번 작업은 그 위에 광고 관련 4줄 삭제만 추가했다. 비밀값은 기록하지 않는다. + +## 4. 실행 증거 + +| 검증 | 결과 | 근거 | +|---|---|---| +| 전체 local test + assembleDebug | 성공 | yandex-final-gate.log, BUILD SUCCESSFUL in 3m 47s | +| 전체 테스트 XML | 성공 | 196 suites / 1,549 tests, failure/error/skip 0 | +| 캔 구매 테스트 | 성공 | ChatMessageAdapterTest 4개, ChatRepositoryTest 6개 | +| 채팅 라우팅 테스트 | 성공 | ChatActionTest 12개 | +| debug/release dependencyInsight | 성공 | 두 configuration 모두 Yandex 일치 의존성 없음 | +| production 참조/파일명 검색 | 성공 | Yandex/rewarded 광고 관련 참조·전용 파일명 0건 | +| 최종 APK DEX/manifest | 성공 | com.yandex/io.appmetrica, 전용 adapter, 광고 버튼 resource ID 없음 | +| lintDebug | 실패, 범위 밖 오류 기록 | 변경하지 않은 파일에서 30 errors/794 warnings. 첫 오류 FacebookActivity MissingClass | +| release Kotlin 컴파일 | 환경 차단 | release signing properties 미설정으로 configuration 중단 | +| LSP diagnostics | 실행 불가 | 도구 미제공; debug Kotlin/Java 컴파일 증거 사용 | + +실제 명령과 로그 위치는 plan-task.md의 Verification Log를 따른다. 리뷰어는 새로운 빌드나 네트워크 요청을 실행하지 않고 diff·호출 코드·기존 실행 로그를 독립 확인했다. 최종 APK 재검사는 기록자가 수행했다. + +## 5. 발견 사항 + +**확정 발견 사항 없음. 차단 이슈 없음. APPROVE.** + +APK 확인에서 발견한 미사용 광고 버튼 배경은 리뷰 판정 전에 P1-T2로 등록·삭제됐다. AppsFlyer SDK의 YANDEX/REWARDED enum 상수는 제거 대상 SDK나 앱 광고 기능이 아니므로 유지한다. + +lint 오류는 이번 수정 파일 밖에 있으며 해당 코드를 변경하지 않았다. 다만 별도 원본 checkout에서 lint baseline을 재실행한 것은 아니므로 전체 lint 통과나 모든 기존 오류의 실행 전후 동등성을 주장하지 않는다. + +## 6. 계획 전환과 종료 + +- 리뷰에서 신규 회귀 수정 Task로 전환할 항목 없음. +- 광고 제거·캔 구매 보존 기준 승인. release 컴파일은 서명 환경 제공 후 재검증해야 한다. +- 실제 결제 및 기기 UI는 승인 범위 밖으로 미실행. +- Oracle 경로 결과는 회수 실패/중단되어 판정 근거로 사용하지 않았다. 별도 독립 검토자의 실제 APPROVE 응답을 기록했다. diff --git a/docs/agent-guides/build-test-style.md b/docs/agent-guides/build-test-style.md index 778f4589..ccd13818 100644 --- a/docs/agent-guides/build-test-style.md +++ b/docs/agent-guides/build-test-style.md @@ -74,6 +74,12 @@ ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.*" ``` +Yandex 광고 제거 후 캔 구매 회귀 테스트 예시: +```bash +./gradlew :app:testDebugUnitTest --tests '*ChatMessageAdapterTest' --tests '*ChatRepositoryTest' +``` +쿼터 구매 액션, 두 캔 옵션의 요청 직렬화와 성공·실패 전달을 검증한다. 실제 결제와 기기 UI는 실행하지 않는다. + DM 채팅 테스트 예시: ```bash ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.chat.dm.*"