Files

5.1 KiB

Yandex 광고 전체 제거 PRD

문서 정보

항목 내용
문서 상태 구현 완료 / 검증 제한 기록
작성일 / 최종 수정일 2026-10-13
대상 제품 SodaLive Android
결정권자 사용자
관련 구현 계획 plan-task.md
관련 review 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. 성공 기준

  • ADS-001~003 및 CAN-001 구현과 로컬 회귀 확인
  • debug 빌드와 runtime dependency 검사 완료
  • 검증 실패·환경 제약을 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 요청. 기존 범위·캔 구매 계약 유지