docs(subbanner): 리뷰 결과와 회귀 테스트 안내를 기록한다
This commit is contained in:
@@ -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 중단 원인 확인은 검증 제한으로 남겼다.
|
||||||
@@ -205,6 +205,12 @@ fake API와 Robolectric local unit test로 조회 상태·호환 bridge·재시
|
|||||||
```
|
```
|
||||||
실제 request source·변환, 실패 시 빈 결과, null/blank 입력과 이전 요청 해제를 검증하는 Robolectric local unit test다. 기기 UI/계측 테스트가 아니며 레이아웃 크기·간격을 검증하지 않는다.
|
실제 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/계측 테스트 예외
|
### 2) UI/계측 테스트 예외
|
||||||
|
|
||||||
- UI/계측 테스트가 반드시 필요한 경우에도 사용자의 명시 요청을 먼저 확인한다.
|
- UI/계측 테스트가 반드시 필요한 경우에도 사용자의 명시 요청을 먼저 확인한다.
|
||||||
|
|||||||
Reference in New Issue
Block a user