From 6cc7aa0d1bce7da46af0d2d9d7ad21496209d2aa Mon Sep 17 00:00:00 2001 From: klaus Date: Fri, 30 Oct 2026 12:32:21 +0900 Subject: [PATCH] =?UTF-8?q?docs(subbanner):=20=EB=A6=AC=EB=B7=B0=20?= =?UTF-8?q?=EA=B2=B0=EA=B3=BC=EC=99=80=20=ED=9A=8C=EA=B7=80=20=ED=85=8C?= =?UTF-8?q?=EC=8A=A4=ED=8A=B8=20=EC=95=88=EB=82=B4=EB=A5=BC=20=EA=B8=B0?= =?UTF-8?q?=EB=A1=9D=ED=95=9C=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../reviews/phase3-sub-banner-review.md | 52 +++++++++++++++++++ docs/agent-guides/build-test-style.md | 6 +++ 2 files changed, 58 insertions(+) create mode 100644 docs/20261029_추천_서브_배너/reviews/phase3-sub-banner-review.md diff --git a/docs/20261029_추천_서브_배너/reviews/phase3-sub-banner-review.md b/docs/20261029_추천_서브_배너/reviews/phase3-sub-banner-review.md new file mode 100644 index 00000000..2338d455 --- /dev/null +++ b/docs/20261029_추천_서브_배너/reviews/phase3-sub-banner-review.md @@ -0,0 +1,52 @@ +# 추천 서브 배너 통합 리뷰 + +## 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 범위 | Phase 1 데이터·링크 및 Phase 2 캐러셀·화면 연결 | +| 기준 | 현재 working tree, [PRD](../prd.md), [계획](../plan-task.md) | +| 리뷰 일자 | 2026-10-30 | +| 리뷰어 | Oracle, 부모 에이전트의 변경 파일·검증 증거 확인 | +| 상태 | 수정 검증 완료, 코드 APPROVE, 전체 회귀·시각 QA 제한 별도 | + +## 검토 근거 + +- `v2/widget/subbanner` 공통 DTO/필터/링크/View/State/Adapter 및 대응 로컬 테스트. +- 홈·콘텐츠 추천 API/Repository/ViewModel/Mapper/UiState와 Fragment/XML 연결. +- Phase 1: 실제 Retrofit interceptor, Gson 정밀도, Android Context ACTION_VIEW와 예외 fallback, 51 tests 성공. +- Phase 2: 실제 Coil callback·RecyclerView 로컬 driver의 bootstrap/자동·수동 순환/실패·취소/클릭, 259 focused tests 및 debug build 성공. +- 통합: 224 suite/1,814 tests 모두 성공, debug build 성공. `lintDebug`는 기존 오류 32건으로 실패. + +## 판정 기록 + +- Phase 1 독립 리뷰: **APPROVE**, 확정 발견 사항 없음. 단일 GET·익명 헤더 생략·follow 인증 유지, 필터/순서/정수 정밀도, URI 원문/금지 scheme/한 번 fallback, 오류와 정상 빈 응답 구분을 승인했다. +- Phase 1 검증 제한: interceptor fixture는 운영 TokenAuthenticator의 기존 로그인 이동 부작용을 실행한 증거가 아니다. 이번 변경의 회귀로 판단하지 않았다. +- 최종 UI 통합 리뷰: 진행 중. 이전 reviewer session 복구 불가로 대체 reviewer 한 명이 증거를 이어받았다. +- 최종 통합 리뷰: **REQUEST_CHANGES**, `REV-P3-001` 1건. 실제 전환 중 목록 교체의 callback 재진입이 새 선택을 덮어쓸 수 있는 경로를 정적으로 확인했다. 실행 재현 후 최소 수정 대상으로 등록했다. +- 후속 delta 리뷰: **APPROVE**. 기존 스크롤 callback 차단, 동일 정상 목록 no-op 유지, 실제 SETTLING 교체의 선택·Coil URL·adapter 위치·클릭 일치 테스트와 RED/GREEN 증거를 확인했다. 추가 코드 차단 사항 없음. + +## REV-P3-001: 목록 교체 중 이전 스크롤 callback 재진입 + +- **심각도:** High. +- **관련 요구사항:** SB-03/06/07 및 Task 2.1 rebind 정리. +- **근거:** SubBannerView.setItems에서 state.setItems 뒤 recycler.stopScroll을 호출한다. IDLE callback은 아직 이전 adapter의 snap 위치로 새 state.select를 실행할 수 있고, 이후 currentPosition만 첫 번째로 변경되어 이미지와 위치가 불일치한다. +- **재현 조건:** 기존 세 항목의 두 번째→세 번째 전환 초반에 다른 세 항목을 전달한다. +- **검증:** 실제 RecyclerView SETTLING 중 교체 테스트로 선택·요청·adapter 위치·클릭을 검증한다. 리뷰 자체는 Gradle을 실행하지 않았다. +- **후속 Task:** plan-task.md Task 3.2. 기존 완료 Task는 다시 열지 않는다. +- **최종 상태:** 수정 완료. 실제 재현 RED expected id=4/actual id=5 후 GREEN 10/10. `replacingItems` guard로 이전 callback의 새 선택 덮어쓰기를 막고 dragging을 초기화한다. 관련 237 tests 및 build 성공 후 부모가 더 넓은 관련 260 tests/build를 재실행해 성공했다. + +## 검증 제한 + +- 테스트 서버 두 익명 추천 GET은 HTTP 200/success:true지만 subBanners 키가 없어 실제 다중 배너 응답은 검증하지 못했다. +- 소유 AVD가 앱 설치 전 System UI ANR로 부팅 실패하여 실제 기기 화면·시각 QA는 **미검증**이다. 기존 사용자 기기는 변경하지 않았다. +- LSP 도구가 없어 Kotlin 컴파일·Android lint를 대체 진단으로 사용했다. 전체 lint 통과를 주장하지 않는다. +- 신규 lint 경고 9건(테스트 반환값, KTX 제안, 코드에서 설정한 이미지 설명)은 최종 판정에서 분류한다. +- 위 신규 경고 9건은 후속 수정으로 제거됐다. 변경 파일의 ktlint/Android lint 진단은 0건이며 전체 기존 오류는 남아 있다. +- 최종 전체 suite 재실행은 Test Executor exit 1로 두 차례 중단됐다. 두 번째 실행에서는 미수정 `V2AuthFlowTest.kt:844` assertion 실패도 확인됐다. 원인 미확정이며 전체 최종 통과로 주장하지 않는다. 수정 전 1,814개 성공과 최종 관련 260개 성공을 구분한다. + +## 후속 Task + +REV-P3-001을 Task 3.2로 등록했다. 별도 정적 검증에서 발견한 신규 테스트 형식과 신규 lint 경고 정리는 Task 3.3으로 등록했다. 관련 없는 기존 lint 오류는 범위 밖이다. + +Task 3.2/3.3 완료. 코드 리뷰 후 추가 수정 항목 없음. 실제 기기 QA와 전체 suite 중단 원인 확인은 검증 제한으로 남겼다. diff --git a/docs/agent-guides/build-test-style.md b/docs/agent-guides/build-test-style.md index 00995b94..7b04069b 100644 --- a/docs/agent-guides/build-test-style.md +++ b/docs/agent-guides/build-test-style.md @@ -205,6 +205,12 @@ fake API와 Robolectric local unit test로 조회 상태·호환 bridge·재시 ``` 실제 request source·변환, 실패 시 빈 결과, null/blank 입력과 이전 요청 해제를 검증하는 Robolectric local unit test다. 기기 UI/계측 테스트가 아니며 레이아웃 크기·간격을 검증하지 않는다. +추천 서브 배너 계약·링크·익명 조회 및 추천 상태 회귀: +```bash +./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.widget.subbanner.*' --tests '*HomeRecommendationViewModelTest' --tests '*ContentMainViewModelTest' --tests '*AudioRecommendationsMapperTest' --console=plain +``` +기존 추천 GET의 헤더·envelope·placement·ID 정밀도, URI 원문과 Android 우선/web fallback, 캐러셀 상태 로직을 검증한다. 테스트 fixture는 로컬 테스트에만 사용하며 운영 요청을 대체하지 않는다. Gradle 실행은 다른 테스트 실행과 직렬로 수행한다. + ### 2) UI/계측 테스트 예외 - UI/계측 테스트가 반드시 필요한 경우에도 사용자의 명시 요청을 먼저 확인한다.