docs(ads): 광고 제거 계획과 검증 결과를 기록한다

This commit is contained in:
2026-10-13 15:51:40 +09:00
parent 739f57e5df
commit f419b12da0
4 changed files with 298 additions and 0 deletions
@@ -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` 요청. 기존 범위·캔 구매 계약 유지 |