Files

18 KiB

Yandex 광고 전체 제거 구현 계획

항목 내용
상태 구현 완료 / lint 및 release 검증 제한 기록
작성일 2026-10-13
요구사항 기준 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 처리를 제거한다.

  • RED: 액션 enum에 캔 구매 2개만 존재하는 실패 테스트와 두 캔 옵션의 요청·응답·오류 보존 테스트를 추가한다.
  • RED 확인: 아래 focused 테스트를 실행한다. 예상 assertion 실패 또는 선행 BuildConfig 누락에 따른 컴파일 차단을 실제 결과로 구분 기록한다.
  • GREEN: SDK·초기화·배너·헤더·광고 사전 로딩/표시/보상·AD enum·광고 문구를 삭제한다. 캔 구매는 그대로 둔다.
  • GREEN 확인: 동일 focused 테스트를 실행해 통과를 확인한다.
  • REFACTOR: 이번 삭제로 미사용이 된 import/상태만 정리하고 관련 회귀 및 lint 결과를 기록한다.
./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 전후 검사와 빌드를 사용한다.
  • 삭제 전 증거: APK DEX 목록에 해당 ID가 있고 source 참조는 0건임을 확인했다.
  • 광고 버튼 전용 drawable을 삭제한다.
  • 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. 대체 검증은 빌드·로컬 테스트·의존성 및 참조 검사다.

  • 채팅·라우팅 local 회귀를 실행한다.

  • 전체 debug local unit test를 실행하고 기존 실패와 변경 관련 실패를 구분한다.

  • debug 빌드·lint 및 release Kotlin 컴파일을 실행한다. debug 빌드 성공, lint 실패·release configuration 차단은 아래 제한으로 기록한다.

  • debug/release runtime에 Yandex SDK가 없는지 확인한다.

  • 소스·리소스·설정 잔존 참조와 사용자 선행 변경 보존을 확인한다.

  • 문서 체크박스와 검증 기록을 갱신한다.

Gate 판정: 광고 제거·캔 구매 보존 구현 승인. 전체 local test 및 debug 빌드 통과. 전체 lint/release 컴파일까지 통과한 상태는 아니다. 독립 리뷰: phase1-yandex-removal-review.md.

[blocked] 검증 제한: release 컴파일은 로컬 서명 설정 제공 후 재검증 필요. lint는 변경하지 않은 파일의 오류 30개를 별도 작업으로 해결해야 전체 통과 가능. LSP 도구 미제공으로 diagnostics 실행 불가. 기기·실제 결제 검증은 승인 범위 밖이다.

./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 컴파일은 재실행하지 않았으며 기존 제한 기록을 유지한다.