diff --git a/docs/20261028_마이_탭_공지사항_롤링/plan-task.md b/docs/20261028_마이_탭_공지사항_롤링/plan-task.md new file mode 100644 index 00000000..da7210ad --- /dev/null +++ b/docs/20261028_마이_탭_공지사항_롤링/plan-task.md @@ -0,0 +1,214 @@ +# 마이 탭 공지사항 롤링 구현 계획 + +| 항목 | 내용 | +|---|---| +| 상태 | 클라이언트 구현·범위 검증 완료, 전체 품질 Gate·운영 연동 차단 | +| 작성일 | 2026-10-28 | +| 요구사항·API 기준 | [prd.md](prd.md), 특히 §3~4 | +| 현재 Phase | Phase 1 공지 배열 조회·롤링 연결 | + +## 목표와 구조 + +마이 탭에서 최신 공지 최대 3개를 서버 순서대로 5초마다 상향 롤링하고 현재 항목의 기존 상세 화면을 연다. 기존 `NoticeApi → NoticeRepository → MyPageViewModel → MyPageFragment` 계층과 DI를 유지한다. 신규 DTO·롤링 보조 코드는 `v2/mypage/notice`에 두어 기존 공지 목록과 상세 Parcelable을 변경하지 않는다. + +## 현재 상태 + +| Phase | 상태 | 완료 Task | 다음 작업 | 차단 조건 | +|---|---|---|---|---| +| 1 | 클라이언트 구현·범위 검증 완료 | 5/5 | 없음 | 전체 테스트의 변경 밖 인증 실패·기존 lint 오류 및 운영 HTTP 401 | + +## 제약과 검토 초점 + +- 사용자 승인: 공지 관련 레거시 최소 수정, 5초 아래→위 롤링, 비활성 시 정지. +- 신규 라이브러리·공통 인증 변경·서버 쓰기·구 API fallback·홈 변경 없음. +- 기존 `NoticeItem(title, content, date)`를 상세 화면 payload로 유지하고 v2 DTO에 `id: Long`을 보존한다. +- 성공한 빈 배열, 최초 로딩, 오류를 구분한다. 오류는 기존 데이터를 유지하며 프로필 로딩·Toast에 영향을 주지 않는다. +- 탭 `hide/show`는 Lifecycle을 정지시키지 않으므로 `onHiddenChanged`와 `onStart/onStop`, `onDestroyView` 모두 연결한다. +- 현재 항목과 클릭 payload 일치, 마지막→첫 순환, 목록 교체, 중복 타이머 방지, 전환 중 정리를 검증한다. +- 테스트는 `app/src/test` local unit test만 작성한다. 레이아웃 속성·기기·에뮬레이터·계측·시각 QA는 제외한다. +- 실행은 한 구현 담당자가 순차적으로 수행한다. Gradle 검증을 동시에 실행하지 않는다. 커밋·게시하지 않는다. + +## Phase 1 + +**결과:** 배열 응답을 기존 공지 상세 흐름과 연결하고 0/1/2/3개 및 비활성 동작을 검증한다. + +#### Task 1.1 계약·기존 구조·실제 서버 확인 (P1-T1) + +- 시작 조건: 사용자 요구와 레거시 수정·5초 상향 롤링 승인. +- 완료 증거: PRD 및 파일 대조, 실제 GET 응답 검사, 변경 전 관련 회귀. +- 범위 밖: 서버 설정 변경, 실제 서버 데이터 생성·삭제. +- TDD 예외 사유: 읽기 전용 조사와 문서 작성. +- 대체 검증 방법: Retrofit 경로·공통 envelope·Parcelable·탭 전환 소스 대조, 인증 없는 GET과 JSON 타입·개수·정렬 검사. + +- [x] 호출부·DTO·클릭·로딩·오류와 탭 수명주기를 확인한다. +- [x] PRD에 승인된 결정과 외부 의존을 기록한다. +- [x] 실제 debug/release 대상에 인증 없는 GET을 실행한다. +- [x] 기존 마이 탭 연결 테스트와 Gradle 명령 존재를 확인한다. + +검증 기록: +- 테스트 서버: HTTP 200, success=true, id `[4,3,2]`, 공통 필드 message/errorProperty 명시적 null. Ruby JSON 검사로 배열·최대 3개·Long 대응 정수·문자열·날짜 형식·내림차순 통과. +- 운영 서버: HTTP 401. EXT-001로 서버 배포·비로그인 접근 설정 확인 필요. endpoint 미배포라고 단정하지 않는다. +- `./gradlew tasks --all --console=plain`: 성공. Gradle 9 비호환 deprecated 기능 경고는 기존 상태. +- `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.gift.GiftInboxEntryPolicyTest' --tests 'kr.co.vividnext.sodalive.v2.main.MainV2LoginGuardSourceTest' --console=plain`: 변경 전 7개 통과. + +#### Task 1.2 배열 계약과 상태 전달 (P1-T2) + +- 시작 조건: P1-T1 완료, PRD NOTICE-005~008. +- 완료 증거: 배열 계약·상태 focused test RED/GREEN와 원문 보존 검증. +- 범위 밖: 기존 공지 목록·상세 모델 변경, 사용자 정보 로딩 변경. + +Files (Kotlin 운영 경로는 `app/src/main/java/kr/co/vividnext/sodalive/` 기준): +- Create: `v2/mypage/notice/LatestNoticeResponse.kt`. +- Modify: `settings/notice/NoticeApi.kt`, `settings/notice/NoticeRepository.kt`, `mypage/MyPageViewModel.kt`. +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/mypage/notice/LatestNoticeApiTest.kt`, `MyPageNoticesViewModelTest.kt`. + +Interfaces: +- Consumes: 기존 `ApiResponse`, `NoticeItem`, 공유 Retrofit·RxJava3. +- Produces: `LatestNoticeResponse(id: Long, title: String, content: String, date: String)` 및 기존 `NoticeItem` 변환; `NoticeApi.getLatestNotices(): Single>>`; Repository 동일 반환형; `MyPageViewModel.latestNoticesLiveData: LiveData>`, `getLatestNotices()`. + +- [x] **RED:** 기존 GET 경로 불일치를 assertion으로 확인하는 계약 테스트와 0/1/2/3개·nullable envelope·원문 보존·성공 후 오류/빈 배열 상태 테스트를 작성한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests '*LatestNoticeApiTest' --tests '*MyPageNoticesViewModelTest' --console=plain`에서 요구 동작 부재로 인한 실패를 확인한다. 새 타입 추가 전에는 기존 API 리플렉션 테스트로 컴파일 가능한 RED를 만든다. +- [x] **GREEN:** v2 DTO와 배열 반환 경로를 연결하고 기존 오류·로딩 정책을 유지한다. 사용되지 않는 구 단건 메서드를 제거한다. +- [x] **GREEN 확인:** 같은 focused test를 재실행해 통과를 확인한다. +- [x] **REFACTOR:** 이번 변경에서 생긴 미사용 코드만 정리하고 결과를 이 Task 아래에 누적한다. + +검증 기록: +- 2026-10-28 최초 RED: 위 focused 명령에서 컴파일 성공 후 `LatestNoticeApiTest` 1개 실행·1개 실패. 기존 `/notice/latest`가 기대 `/api/v2/notices/latest`와 다른 `ComparisonFailure`를 확인했다. 이 시점에는 ViewModel 테스트를 아직 추가하지 않았다. 실행 14초, exit 1. +- 2026-10-28 상태 RED: 같은 명령에서 11개 실행·5개 실패(42초, exit 1). 새 DTO mapper는 빈 문자열, 새 ViewModel 메서드는 동작 없는 최소 골격으로 컴파일했다. 상세 원문 mapping 1개와 성공 배열 emit이 필요한 ViewModel 4개가 실제 assertion으로 실패했다. 실제 Retrofit·메모리 OkHttp interceptor로 0/1/2/3 JSON 배열 및 공통 nullable 필드 생략/명시 null 검사는 이미 통과했으며 외부 네트워크는 사용하지 않았다. +- 2026-10-28 GREEN: 동일 명령 성공(32초, exit 0). 결과 XML 기준 API 6개 + ViewModel 5개 = 11개, failures/errors/skipped 모두 0. 성공 후 `[]`, unsuccessful/null-data/exception 이전 배열 유지, 프로필 repository 미호출 및 로딩·Toast 미변경 검증. 구 단건 메서드와 변경으로 미사용이 된 NoticeItem import를 제거했고 목록 API·공통 envelope·상세 모델은 수정하지 않았다. Fragment는 새 목록 타입 컴파일에 필요한 관찰/호출 이름과 첫 항목 mapping만 우선 연결했으며 P1-T3에서 티커로 교체한다. + +#### Task 1.3 제목·롤링·상세 연결 (P1-T3) + +- 시작 조건: P1-T2 완료, PRD NOTICE-001~006. +- 완료 증거: 5초 시간 경계, 순서·클릭·중지·재개·정리 focused test와 Fragment 연결. +- 범위 밖: 마이 탭 다른 기능, 전역 배너, 상세 WebView 변경. + +Files: +- Create: `app/src/main/java/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTicker.kt`. +- Modify: `app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt`, `app/src/main/res/layout/fragment_my.xml`. +- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTickerTest.kt`. +- Modify: `docs/agent-guides/build-test-style.md` (focused test 실행 예시). + +Interfaces: +- Consumes: `List`, 플랫폼 `TextSwitcher`/Handler, 기존 상세 Intent. +- Produces: 목록 갱신·활성 상태 변경·정리 가능한 `MyNoticeTicker`; 현재 공지를 기준으로 상세 payload 전달. 표시와 클릭을 같은 항목으로 관리한다. +- 표시 방식: 초기 표시와 목록 교체는 애니메이션 없이 첫 항목, 2개 이상에서 5,000ms마다 상향 전환. 비활성 시 현재 항목을 유지하고 복귀 후 5초를 다시 센다. 전환 애니메이션은 250ms로 구현한다. + +- [x] **RED:** 0/1개 무롤링, 2/3개 서버 순환, 4,999/5,000ms 경계, 표시별 클릭, 중복 시작·비활성·재개·목록 교체·파괴 정리 테스트를 작성한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest' --console=plain`로 실패를 확인한다. 컴파일 가능한 최소 선언이 필요한 경우 동작 없는 골격만 허용하고 실제 assertion RED를 기록한다. +- [x] **GREEN:** `TextSwitcher`를 이용한 상향 롤링과 Fragment 수명주기·숨김 연결, 문구 제거·화살표 유지·제목 확장을 구현한다. +- [x] **GREEN 확인:** 같은 focused test와 P1-T2 테스트를 재실행한다. +- [x] **REFACTOR:** 이번 Task 중복만 정리하고 실행 예시와 검증 기록을 갱신한다. + +검증 기록: +- 2026-10-28 RED: 위 명령에서 동작 없는 `MyNoticeTicker` 최소 골격과 테스트 컴파일 성공 후 11개 실행·10개 실패(18초, exit 1). 첫 제목이 표시되지 않는 실제 `ComparisonFailure`이며 missing symbol/컴파일 오류가 아니다. 빈 목록 무동작 1개는 통과했다. Robolectric PAUSED main looper로 시간·목록·클릭·정리 동작을 검사하며 레이아웃 크기·간격·constraint·visibility는 assert하지 않는다. +- 2026-10-28 구현 중 검사: 첫 구현 실행은 11개 중 4개 실패(40초, exit 1), 생성자 인자 캡처 제거 후 동일 4개 실패(20초, exit 1). `javap` 및 테스트 진단에서 공지 인덱스는 2인데 보이는 자식은 0, 새 텍스트는 자식 1에 저장되는 것을 확인했다. 설치된 Robolectric 4.15.1 `ShadowViewAnimator`는 실제 `TextSwitcher.getNextView()`의 `mWhichChild`와 분리된 `currentChild`를 사용한다. 테스트 전용 `PlatformViewAnimatorShadow : ShadowViewGroup`으로 ViewAnimator의 실제 플랫폼 메서드를 실행하도록 해 정상 동작을 검사한다. 운영 우회 코드·의존성 변경은 없다. 해당 수정 후 티커 11개 통과(13초, exit 0). +- 2026-10-28 Fragment 연결 검사 추가: 실제 `MyPageFragment`와 XML을 local test에서 생성해 제목·화살표 touch→기존 상세 Intent의 원문 payload, STARTED 상태 hide/show, 숨김 중 지연 응답, Activity stop/start, View 제거를 검사했다. 최초 13개 중 2개 실패(24초, exit 1)는 touch click의 post 처리 및 commitNow 중 프레임 시간 전진 때문이었다. touch 후 main looper idle과 통합 검사 시간 여유를 적용해 13개 모두 통과(22초, exit 0). 정확한 4,999/5,000ms 경계는 독립 티커 검사에서 유지했다. 기기·계측·시각 QA가 아니며 레이아웃 속성은 assert하지 않는다. +- 2026-10-28 정리: 생성자 인자와 필드 이름을 분리해 Runnable이 View를 별도 캡처하지 않게 했다. `javap -p 'app/build/tmp/kotlin-classes/debug/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTicker$advance$1.class'` 결과 필드는 `this$0`뿐이다. destroy는 callback·애니메이션·row listener·View/클릭 참조를 정리한다. LSP 도구는 이 세션에 제공되지 않아 실행하지 못했다. +- 2026-10-28 최종 focused GREEN: `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest' --tests '*LatestNoticeApiTest' --tests '*MyPageNoticesViewModelTest' --console=plain` 성공(27초, exit 0). 결과 XML 기준 API 6개 + ViewModel 5개 + 티커/Fragment 13개 = 24개, failures/errors/skipped 모두 0. guide에는 공지 패키지 focused 실행 명령만 추가했다. 구 단건 호출·공지 목록·상세·홈·DI의 최종 diff 확인, assemble/lint/기존 회귀를 포함한 P1-GATE는 상위 담당자가 별도로 수행하며 여기서 완료 처리하지 않는다. + +#### Task 1.4 최초 전환 애니메이션 회귀 수정 (P1-R1) + +- 시작 조건: 독립 리뷰 `REV-P1-001` 확정. P1-T2/P1-T3의 기존 완료·검증 기록은 유지한다. +- 리뷰: [phase1-my-notice-ticker-review.md](reviews/phase1-my-notice-ticker-review.md). +- 대상 파일: `app/src/main/java/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTicker.kt`, `app/src/test/java/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTickerTest.kt`. +- 수정 범위: `setCurrentText` 최초 무애니메이션 표시를 유지하면서 첫 5초 tick부터 실제 자식 View의 상향 애니메이션이 시작되도록 최소 수정한다. `setAnimateFirstView(false)`와 플랫폼의 first-time 상태가 원인인지 실행 회귀로 확인한다. +- 회귀 테스트: 최초 표시에는 자식 애니메이션이 없고, 첫 5초 tick에서 새 currentView에 실제 inAnimation이 시작되는 것을 검사한다. 기존 duration·방향·순서·클릭·중지 검사는 유지한다. +- 완료 증거: 실제 assertion RED → 최소 수정 → GREEN, 공지 및 직접 영향 회귀, 리뷰 보고서 후속 기록. 레이아웃 속성 검사·shadow 성공 동작 조작·범위 밖 변경 없음. + +- [x] **RED:** 첫 tick의 실제 자식 애니메이션 시작을 검사하는 local regression test를 추가한다. +- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest' --console=plain`에서 현재 구현의 첫 전환 애니메이션 미시작 assertion 실패를 확인한다. +- [x] **GREEN:** 초기 표시는 그대로 유지하며 첫 실제 전환을 억제하는 설정만 최소 수정한다. +- [x] **GREEN 확인:** 같은 명령과 공지 패키지·선물함/인증 직접 영향 회귀 명령을 순차 재실행한다. +- [x] **REFACTOR:** 불필요한 변경 없이 결과를 이 Task와 리뷰 보고서 후속 기록에 누적한다. + +검증 기록: +- 2026-10-28 RED: `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest' --console=plain` 실행 1분 20초, exit 1. 컴파일 성공 후 14개 중 신규 회귀 1개만 실패했으며 기존 13개는 통과했다. `MyNoticeTickerTest.kt:219`의 `assertNotNull`에서 `첫 전환의 현재 자식에 진입 애니메이션이 있어야 한다`로 실패했다. 최초/4,999ms 무애니메이션 및 5,000ms의 둘째 제목 검사는 통과했지만 실제 `currentView.animation`은 null이었다. XML은 tests=14, failures=1, errors/skipped=0이며, shadow 변경이나 사전 전환 없이 재현했다. +- 2026-10-28 검사 시점 보정: `setAnimateFirstView(false)` 제거 후 첫 focused 실행도 14개 중 1개 실패(1분 13초, exit 1)했다. 신규 메서드 단독 진단 실행(37초, exit 1)에서 animateFirstView/firstTime=true이고 애니메이션 이력은 있으나 started/ended=true, 검사 시각 5,385ms·시작 5,130ms로 이미 250ms를 경과함을 관찰했다. `idleFor`가 Choreographer 프레임도 처리하므로 반환 뒤 검사는 첫 전환의 생략과 정상 종료를 구분하지 못했다. 진단 출력은 제거하고, 4,999ms에 1ms 뒤 관찰 콜백을 예약해 이미 예약된 첫 tick 바로 다음 실제 `currentView.animation`을 검사하도록 보정한다. 운영 설정을 원래 false로 복원하여 이 최종 회귀 테스트의 RED부터 다시 확인한다. shadow·애니메이션·first-time 상태를 수정하거나 사전 전환하지 않는다. +- 2026-10-28 최종 회귀 RED: 원래 운영 설정 false에서 같은 티커 focused 명령을 재실행해 59초, exit 1. XML tests=14, failures=1, errors/skipped=0. 기존 13개는 통과하고 새 테스트만 `MyNoticeTickerTest.kt:220`의 관찰 콜백 `assertNotNull`에서 같은 메시지로 실패했다. 5,000ms 첫 tick 직후 둘째 제목은 표시됐지만 자식 애니메이션은 null임을 직접 확인한 뒤 운영 설정 한 줄을 다시 제거했다. +- 2026-10-28 GREEN: `setAnimateFirstView(false)` 한 줄만 제거한 뒤 `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest' --console=plain` 성공(1분 2초, exit 0). XML tests=14, failures/errors/skipped=0. 최종 회귀 테스트는 초기/4,999ms 모든 자식 무애니메이션, 5,000ms 첫 tick 직후 둘째 제목 및 실제 `currentView.animation === inAnimation`을 검증했다. 기존 13개 테스트와 `PlatformViewAnimatorShadow`는 변경하지 않았으며 5,000ms 간격·250ms 방향/지속 시간도 유지했다. +- 2026-10-28 직접 영향 회귀: 위 GREEN 종료 후 `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain` 순차 실행 성공(44초, exit 0). XML 합계 API 6 + ViewModel 5 + 티커/Fragment 14 + 선물함 3 + 인증 가드 4 = 32개, failures/errors/skipped=0. 두 명령 모두 도구 timeout 600,000ms를 적용했다. 기존 Gradle 9 비호환 deprecated 기능 경고는 남아 있다. +- 2026-10-28 정리 및 인계: 운영 변경은 설정 한 줄 삭제뿐이고 신규 테스트 1개와 import 2개만 추가했다. 임시 진단 출력/리플렉션은 제거했다. 리뷰 보고서 §9에 수정 상태와 RED/GREEN 근거를 추가하고 최초 판정·이전 검증 기록은 보존했다. LSP 진단 도구는 제공되지 않아 실행하지 못했으며 Kotlin 운영/테스트 컴파일은 focused Gradle에서 성공했다. broad build/lint·전체 테스트·네트워크·기기·계측·시각 QA는 실행하지 않았다. P1-GATE 및 독립 재검토는 상위 담당자의 후속 작업이며 여기서 Gate를 완료 처리하지 않는다. + +#### Task 1.5 공지 Fragment 테스트의 저장된 로그인 상태 격리 (P1-R2) + +- 시작 조건: ULW 전체 회귀 1,641개 중 신규 Fragment 테스트 2개에서 `UserRepository.getMyPage` unstubbed null로 NPE 확인. `SharedPreferenceManager.resetForTest()`는 캐시만 초기화하며 저장된 토큰을 지우지 않아 `init()`에서 다른 테스트의 로그인 상태를 읽는다. +- 대상 파일: `app/src/test/java/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTickerTest.kt`만 수정. 운영 코드·공유 저장소·기존 인증 테스트는 변경하지 않는다. +- 수정 범위: 비로그인 공지 Fragment fixture가 저장된 토큰을 동기적으로 비운 뒤 초기화하도록 테스트 선행조건을 명시한다. `resetForTest()`가 디스크를 지운다고 가정하지 않는다. +- 회귀 테스트: 이전 테스트의 비어 있지 않은 토큰을 DataStore에 먼저 저장하고 동일 fixture가 비로그인으로 초기화되어 기존 공지 테스트 흐름을 실행하는지 검사한다. 단순 assertion 제거나 null 방어로 테스트를 약화하지 않는다. +- 완료 증거: 토큰 잔존 RED → fixture 최소 수정 → focused/영향 회귀 GREEN → 전체 local 재실행 결과 기록. + +- [x] **RED:** 저장된 이전 토큰을 주입한 공지 Fragment fixture 회귀 테스트를 추가한다. +- [x] **RED 확인:** 공지 테스트에서 같은 NPE 또는 비로그인 선행조건 assertion 실패를 확인한다. +- [x] **GREEN:** fixture에 기존 DataStore API를 통한 동기 토큰 초기화만 추가한다. +- [x] **GREEN 확인:** 공지·직접 영향 회귀와 전체 debug local 테스트를 순차 실행한다. +- [x] **REFACTOR:** 테스트 전용 최소 변경·검증을 기록한다. 기존 `V2AuthFlowTest` 실패는 별도로 기록하고 수정하지 않는다. + +검증 기록: +- RED: `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest.이전 테스트의 저장된 토큰과 무관하게 공지 fixture는 비로그인으로 시작한다' --console=plain --max-workers=2`, 1분 30초, exit 1. 컴파일 후 신규 1개가 동일 `UserRepository.getMyPage` NPE로 실패했다. 저장된 이전 토큰에 의해 비로그인 fixture가 로그인 분기로 들어가는 것을 재현했다. +- GREEN: fixture에서 `runBlocking { AppPreferencesDataStoreProvider.get(context).edit { token key = "" } }`가 끝난 뒤 `SharedPreferenceManager.init(context)`를 호출하도록 변경했다. 기존 assertion을 삭제/완화하지 않았다. +- `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain --max-workers=2`: 1분 3초, exit 0. 신규 토큰 회귀를 포함한 33개 모두 통과. +- 전체 재실행 1,642개 중 공지 26개·직접 영향 7개 모두 통과. 변경 밖 인증 실패 1개만 남았다. 전체 결과는 아래 Verification Log에 별도로 기록한다. +- 독립 P1-R2 한정 재검토는 승인·차단 결함 없음. 보고서의 §9 후속 기록을 참조한다. 수정 대상은 신규 테스트 fixture와 회귀 1개뿐이며 운영 코드 변경은 없다. + +### Phase 1 Gate (P1-GATE) + +- 시작 조건: P1-T2/P1-T3/P1-R1/P1-R2 구현·focused test 완료. +- 완료 증거: 아래 명령의 실제 결과와 최종 Verification Log. 코드 품질 검토 시 샘플 기반 리뷰 보고서를 남긴다. +- 범위 밖: unrelated lint/test 수정, 서버 인증 우회, UI 기기 검증. + +- [x] `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain`: 실행·범위 통과 확인. +- [x] debug build/lint 실행·판정: assembleDebug 성공, lintDebug 실패. 상세 명령·차단 오류는 아래 기록. +- [x] `./gradlew :app:ktlintCheck --console=plain`: 성공. 기존 deprecated 경고는 분리 기록. +- [x] `/notice/latest`와 단건 조회 코드의 미사용 제거, 홈·목록·상세 계약 미변경을 diff로 확인. +- [x] 통합 결과 및 운영 외부 의존·미실행 검증을 기록한다. +- [x] ULW 후속 전체 debug local 회귀를 실행하고 실패 이름을 기록했다. 관련 없는 코드·테스트는 수정하지 않았다. + +Gate 판정: 체크박스는 실행·판정 기록 완료를 뜻하며 전체 성공을 뜻하지 않는다. 공지 범위는 통과했다. **[blocked] 전체 품질 Gate**는 변경 밖 인증 테스트 실패와 기존 Android lint 오류로 통과하지 못했고, **[blocked] 운영 연동**은 EXT-001의 HTTP 401로 대기 중이다. + +## 실행 순서 + +`P1-T1 → P1-T2 → P1-T3 → P1-R1 → P1-R2 → P1-GATE`. 승인된 설계는 재질문하지 않는다. 변경 범위가 달라지면 구현 전에 이 문서를 갱신한다. 최초 계획은 국소 회귀로 제한했으나, ULW 후속 요청에 따라 전체 debug local 회귀도 실행했다. + +## Decision Log + +- 2026-10-28: 기존 계층·DI를 유지하고 API 반환 타입과 경로를 최소 수정한다. 별도 API·Repository·ViewModel·중복 네트워크 binder를 만들지 않는다. +- 2026-10-28: 기존 Parcelable에 기본값 id를 추가하지 않고 v2 DTO에서 id를 보존한다. 기존 공지 목록의 미확인 id 계약에 영향을 주지 않기 위함이다. +- 2026-10-28: 운영 401은 EXT-001로 남기며 클라이언트 fallback 없이 테스트 서버·목 응답 기준 검증을 진행한다. + +## Verification Log + +### 2026-10-28 독립 검증 1차 + +- 운영 코드·신규 DTO/티커·3개 테스트·화면 연결·가이드 변경을 직접 읽어 확인했다. 구 단건 메서드·`/notice/latest` 운영 참조는 0건이며 기존 목록·상세·홈·DI는 변경하지 않았다. Body3는 기존과 같은 regular 16sp다. +- 통합 회귀 명령 `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain`의 최초 실행은 도구 120초 제한으로 종료됐다. Android 실행 프로세스가 남지 않은 것을 확인하고 제한 600초로 같은 명령 재실행: 57초, exit 0. XML 합계 31개(API 6, ViewModel 5, ticker/Fragment 13, 기존 회귀 7), failures/errors/skipped 0. +- `./gradlew :app:assembleDebug :app:lintDebug --console=plain`: APK 생성·assembleDebug Task는 완료됐으나 lintAnalyzeDebug/AndroidTest/UnitTest 실행 중 도구 600초 제한으로 종료됐다. 전체 명령의 성공이나 lint 통과로 판정하지 않는다. 별도 명령으로 최종 상태를 확인한다. 린트의 AndroidTest 분석은 계측 테스트 실행이 아니다. +- 실제 API 재확인: 테스트 서버는 HTTP 200 및 동일 3개 배열/필드/정렬 검사 통과, 운영은 여전히 HTTP 401. 서버 배포·비로그인 접근 여부 EXT-001 미해결. +- 독립 리뷰에서 첫 tick 애니메이션 누락 REV-P1-001을 발견했다. 완료 Task를 되돌리지 않고 P1-R1을 추가했으며 수정·회귀 후 최종 Gate를 진행한다. +- LSP 진단 도구는 이 세션에 제공되지 않았다. 기기·계측·스크린샷·시각 QA는 요청 범위 밖으로 실행하지 않았다. + +### 2026-10-28 ULW 전체 회귀 1차 + +- `./gradlew :app:testDebugUnitTest --console=plain --max-workers=2`: 4분 48초, exit 1. 1,641개 중 3개 실패. +- 신규 실패 2개: `MyNoticeTickerTest`의 `Fragment는 STARTED 상태의 숨김과 지연 응답 배경 복귀 및 View 파괴를 처리한다`, `Fragment 제목과 화살표 클릭은 매번 현재 공지의 상세 Intent를 전달한다`. 기존 테스트의 저장된 token이 복원되어 프로필 요청 경로에 진입하고 mock UserRepository의 unstubbed 반환값으로 NPE. P1-R2로 테스트 선행조건을 수정한다. +- 변경 밖 실패 1개: `V2AuthFlowTest.정지 중 POST 실패는 재개에서 오류를 소비하고 같은 선택의 새 Sheet로 재제출한다`, `:528` contentPreference 기대 2·실제 0. 인증 파일은 수정하지 않았고 공지 테스트보다 앞서 실패했다. 별도 재실행으로 재현 여부만 확인하며 테스트를 완화하거나 관련 없는 로직을 수정하지 않는다. + +### 2026-10-28 최종 검증 + +- 독립 강제 재실행 `./gradlew :app:testDebugUnitTest --rerun --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain`: P1-R1 반영 후 1분 7초, exit 0, 32개 통과. P1-R2 추가 뒤에는 위 Task 기록대로 33개 통과. +- `./gradlew :app:assembleDebug :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain`: 9초, exit 0. debug APK 패키징 성공, 당시 동일 소스 테스트는 UP-TO-DATE였다. 이후 위 강제 실행으로 실제 재실행도 확인했다. +- `./gradlew :app:ktlintCheck --console=plain`: 14초, exit 0. 기존 `.editorconfig` disabled_rules deprecated 및 Gradle deprecated 경고가 남지만 스타일 오류는 없다. +- `./gradlew :app:lintDebug --console=plain --max-workers=2`: 6분 49초, exit 1. 오류 31개·경고 795개. 첫 오류 `AndroidManifest.xml:346` FacebookActivity MissingClass 외 NotSibling, InvalidSetHasFixedSize, UnsafeOptInUsageError, UseAppTint, StringFormatMatches는 변경하지 않은 코드에 있다. 변경된 마이 탭에는 기존 배경 Overdraw 및 최근 콘텐츠 count의 SetTextI18n 경고가 남아 있다. lint baseline 추가나 관련 없는 수정은 하지 않았다. +- ULW 전체 재실행 `./gradlew :app:testDebugUnitTest --console=plain --max-workers=2`: P1-R2 반영 후 4분 41초, exit 1. 1,642개 중 1,641개 통과·1개 실패. `V2AuthFlowTest.디버그 오디오는 POST 없이 실제 회원 조회를 재시도하고 서버 false와 설정 저장 뒤 한 번 완료한다`의 `:844` isAdultContentVisible=false assertion 실패. 앞선 전체 실행의 `:528` 실패와는 다른 메서드다. 변경하지 않은 인증 코드/테스트의 비결정적 실패를 이 작업에서 수정하지 않았으며 전체 통과로 보고하지 않는다. 이 실행에서도 공지 26개(6+5+15)·기존 직접 영향 7개는 failures/errors/skipped 0. +- P1-R2 이후 `./gradlew :app:assembleDebug :app:ktlintCheck --console=plain --quiet`: exit 0. 운영 소스는 P1-R1 이후 변하지 않았으며 최종 테스트 변경까지 스타일 검사 성공. +- 독립 리뷰와 P1-R1/P1-R2 한정 재검토 승인. `git diff --check` 성공. 기존 공지 목록/상세 Parcelable·WebView·홈·DI·인증 설정은 변경하지 않았고, worktree·브랜치·커밋·푸시는 만들지 않았다. +- 2026-10-28 18:51 KST 최종 무인증 실제 API: 테스트 HTTP 200·id `[4,3,2]`·원문 HTML·날짜·nullable envelope 유지, 운영 HTTP 401 유지. 활성 공지 필터와 서울 날짜 생성 규칙 및 다른 클라이언트의 구 API 사용 여부는 서버 담당 확인 범위다. Android의 구 latest 선언은 제거했지만 서버 endpoint는 삭제하지 않았다. +- Native 기기/에뮬레이터 시각 QA 및 LSP는 지원 도구 미제공으로 미검증이다. Robolectric 실제 Fragment local 검사를 기기 화면 QA로 표기하지 않는다. release 빌드·서버 설정 변경도 실행하지 않았다. +- 임시 자원 정리: 전용 `ulw-notice.OlTpXO` 루트의 열린 파일 없음(`lsof +D`, 출력 없음)을 확인하고 소유 노트 표식을 대조한 뒤 해당 루트만 제거했다. `test ! -e`와 `CLEANUP_CONFIRMED` 출력으로 제거를 재확인했다. 공유 cache·기존 worktree·프로세스는 정리 대상으로 삼지 않았다. + +### 2026-10-28 커밋 전 재검증 + +- 후속 `/commit-with-validation` 요청으로 이번 변경의 신규 커밋 생성을 승인받았다. 위의 커밋 미실행 기록은 구현 당시 이력으로 유지한다. +- `./gradlew :app:assembleDebug :app:ktlintCheck :app:testDebugUnitTest --rerun --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain --max-workers=2`: 3분 2초, exit 0. debug APK 생성 성공, ktlintCheck UP-TO-DATE, 테스트 Task 실제 재실행 성공. +- 결과 XML 기준 공지 26개(API 6, ViewModel 5, 티커/Fragment 15)와 직접 영향 회귀 7개, 총 33개 통과. failures/errors/skipped 모두 0이다. +- 전체 local 테스트·Android lint·운영 API·기기 QA는 이번 커밋 검증에서 재실행하지 않았다. 앞서 기록한 인증 테스트 실패·lint 오류·운영 HTTP 401 차단 상태는 해소된 것으로 판정하지 않는다. 기존 Agora namespace 중복 및 Gradle deprecated 경고가 남아 있다. diff --git a/docs/20261028_마이_탭_공지사항_롤링/prd.md b/docs/20261028_마이_탭_공지사항_롤링/prd.md new file mode 100644 index 00000000..662dfc28 --- /dev/null +++ b/docs/20261028_마이_탭_공지사항_롤링/prd.md @@ -0,0 +1,94 @@ +# 마이 탭 공지사항 롤링 PRD + +## 문서 정보 + +| 항목 | 내용 | +|---|---| +| 상태 | 클라이언트 구현·범위 회귀 완료, 운영 연동 확인 대기 | +| 작성일 / 수정일 | 2026-10-28 | +| 대상 | 메인 페이지 마이 탭 최상단 공지사항 | +| 결정권자 | 요청 사용자 | +| 구현 계획 | [plan-task.md](plan-task.md) | + +## 1. 목표와 범위 + +기존 단일 공지 영역에서 최신 공지를 최대 3개까지 순서대로 보여준다. 우측 `자세히` 문구는 제거하고 화살표만 유지하며, 확보한 너비를 제목에 사용한다. 기존 공지 상세 화면의 제목·HTML 본문·날짜 표시와 클릭 이동을 재사용한다. + +다른 마이 탭 기능, 공지 목록 API, 기존 홈의 `latestNotice`, 상세 WebView 처리, 공통 인증·오류 정책은 변경하지 않는다. 서버 배포·보안 설정 변경과 서버의 구 API 삭제는 Android 저장소 작업 범위가 아니다. + +## 2. 현재 구현과 변경 제약 + +- 호출 경로: `MyPageFragment → MyPageViewModel → NoticeRepository → NoticeApi`. +- 현재 `GET /notice/latest`는 단일 `NoticeItem`을 반환한다. Android 운영 소스 내 호출자는 마이 탭뿐이다. +- 기존 `NoticeItem`은 `title`, `content`, `date`만 가지고 있으며 `id`는 없다. 신규 응답에서는 `Long` 식별자를 보존하고 기존 상세 화면 계약을 유지해야 한다. +- 공지 조회에는 별도 로딩 UI가 없고, 실패는 기존 로그 처리 후 기존 데이터를 유지한다. 사용자 정보 조회의 로딩·Toast는 그대로 둔다. +- 사용자는 레거시 공지 관련 최소 수정과 5초 상향 롤링을 명시 승인했다. 신규 지원 코드는 `kr.co.vividnext.sodalive.v2` 아래에 작성한다. + +## 3. 확정 요구사항 + +| ID | 요구사항 | 수용 기준 | +|---|---|---| +| NOTICE-001 | `자세히` 제거, 화살표 유지, 제목 너비 확장 | 기존 색상·서체·주변 구조를 유지하고 문구가 차지하던 공간을 제목이 사용 | +| NOTICE-002 | 성공한 빈 배열은 공지 영역 미표시 | 로딩·실패와 성공한 `[]`를 혼동하지 않음 | +| NOTICE-003 | 1개는 고정, 2~3개는 5초마다 아래에서 위로 전환 | 서버 순서대로 표시하고 마지막 다음에는 첫 항목으로 순환 | +| NOTICE-004 | 다른 탭·백그라운드·화면 파괴 시 롤링 중지 | 중복 예약과 파괴된 View 참조가 없으며 재진입 시 정상 재개 | +| NOTICE-005 | 현재 표시 항목을 클릭하면 해당 공지 상세 이동 | 제목·본문 전체·날짜가 해당 항목과 일치하고 HTML 본문은 기존 처리 재사용 | +| NOTICE-006 | 서버 배열 순서·문자열 보존 | 로컬 정렬, 날짜 시간대 변환, 본문 가공을 추가하지 않음 | +| NOTICE-007 | v2 API 전환 후 미사용 구 latest 클라이언트 선언 제거 | `/notice` 목록과 기존 홈 계약은 유지하고 구 endpoint fallback은 추가하지 않음 | +| NOTICE-008 | 실제 배포·응답 확인과 목 응답 회귀 검증 | 비로그인 실제 GET 결과와 0/1/2/3개, 클릭 대상, 순서·내용 테스트 기록 | + +## 4. API 계약 + +- Method/path: `GET /api/v2/notices/latest`. +- 비로그인 접근 가능. 요청 body·query·개수 지정·페이지네이션 없음. +- 정상: HTTP 200, `success=true`, `data`는 0~3개 배열. 활성 공지를 `id` 내림차순으로 서버가 반환한다. +- 항목: `id: Long`, `title: String`, `content: String`(기존 본문 전체), `date: String`(`Asia/Seoul` 기준 `yyyy-MM-dd`). +- 공통 `message`, `errorProperty`는 nullable이며 포함·생략 모두 기존 `ApiResponse`로 처리한다. 예시만 보고 생략을 가정하지 않는다. +- 실패 응답의 HTTP status·오류 문구를 새로 추정하지 않으며 기존 공통 네트워크 처리와 공지 조회 오류 정책을 유지한다. + +## 5. 상태와 접근성 + +- 최초 로딩 중에는 빈 공지 컴포넌트를 보이지 않는다. 성공 시 받은 배열을 반영한다. +- 실패 시 성공한 이전 데이터가 있으면 유지하며, 임의 목 데이터나 구 API로 대체하지 않는다. +- 롤링 중 표시 제목과 클릭 대상이 일치해야 한다. 숨겨진 이전 항목이 접근성 탐색에 중복 노출되지 않도록 기본 플랫폼 동작을 활용한다. +- 기존 상세 진입을 재사용하며 공지 제목을 새 HTML 렌더링 경계에 전달하지 않는다. 키·토큰·BuildConfig 값을 로그나 문서에 노출하지 않는다. + +## 6. 검증 범위 + +- `app/src/test` local unit test로 실제 Gson 역직렬화, Rx/LiveData 전달, 롤링 순서·중지·재개, 클릭 payload를 검증한다. +- 0/1/2/3개 목 응답, `Long` 식별자, 원문 HTML/날짜 보존, nullable 공통 필드 포함·생략, 성공 후 빈 배열·실패를 포함한다. +- 레이아웃 크기·간격·constraint·visibility 속성 자체를 테스트하지 않는다. +- 기기·에뮬레이터 UI 조작, 계측 테스트, 스크린샷·시각 QA는 요청되지 않았으므로 실행하지 않는다. + +## 7. 실제 API 확인 및 외부 의존 + +2026-10-28 인증 header·body·query 없이 앱의 debug/release 대상에 GET을 실행했다. + +| 환경 | 관찰 결과 | 판정 | +|---|---|---| +| 테스트 서버 | HTTP 200, `success=true`, 3개, id `[4,3,2]`, 날짜 모두 `2026-10-28`, `message=null`, `errorProperty=null` | 현재 응답의 필드·타입·개수·정렬·날짜 형식 일치 | +| 운영 서버 | HTTP 401, Unauthorized | 비로그인 계약 충족·신규 controller 배포 여부 확인 필요 | + +테스트 서버 본문은 HTML 문자열을 포함한다. JSON 파싱 검사로 `data` 배열, 최대 3개, 각 필드 타입, 날짜 형식과 id 내림차순을 확인했다. 실제 활성 필터, 서울 날짜 생성 규칙, 0/1/2개 결과는 현재 3개 응답만으로 확정하지 않으며 목 검증과 서버 확인을 구분한다. + +외부 의존 `EXT-001`: 운영 서버 담당자가 신규 endpoint 배포 및 비로그인 보안 허용 설정을 확인해야 한다. 운영 인증 없는 HTTP 200을 재확인하기 전에는 운영 연동 완료로 표시하지 않는다. 클라이언트 구현·테스트는 승인된 계약과 정상인 테스트 서버 응답을 기준으로 진행한다. + +## 8. Decision Log + +| 날짜 | ID | 결정 | 근거 | +|---|---|---|---| +| 2026-10-28 | DEC-001 | 레거시 공지 관련 부분 최소 수정 허용 | 사용자 명시 승인 | +| 2026-10-28 | DEC-002 | 5초 간격 아래→위 순환, 비활성 시 중지 | 제안에 대한 사용자 승인 | +| 2026-10-28 | DEC-003 | 기존 상세 UI·본문 처리 재사용, 신규 의존성 미추가 | 사용자 요구 및 최소 변경 | +| 2026-10-28 | DEC-004 | 실제 서버는 읽기 전용 GET만 검사, 운영 401을 클라이언트 우회하지 않음 | 사용자 확인 요청 및 실제 응답 | +| 2026-10-28 | DEC-005 | 현재 저장소에서 worktree·브랜치 생성 및 커밋 없이 진행 | 사용자 명시 지시 | + +## 9. 구현 및 검증 결과 + +- NOTICE-001~007 클라이언트 변경을 구현했다. 공지·직접 영향 회귀 33개가 통과했고, 전체 debug local 실행에서도 같은 33개가 모두 통과했다. 첫 전환 애니메이션과 저장된 이전 토큰에 대한 회귀를 추가했다. +- `assembleDebug`, `ktlintCheck`, `git diff --check`는 성공했다. 독립 코드 리뷰와 두 수정의 한정 재검토에서 공지 범위의 미해결 차단 결함은 없다. +- 전체 debug local 테스트 최종 실행은 1,642개 중 1개 실패다. 변경하지 않은 `V2AuthFlowTest.디버그 오디오는 POST 없이 실제 회원 조회를 재시도하고 서버 false와 설정 저장 뒤 한 번 완료한다`의 `:844`에서 실패했다. 이전 전체 실행에서는 다른 인증 메서드 `:528`이 실패했으며 이 작업에서 인증 코드/테스트는 변경하지 않았다. 전체 통과로 표시하지 않는다. +- Android lint는 변경하지 않은 코드의 오류 31개·경고 795개로 실패했다. 첫 오류는 `AndroidManifest.xml:346`의 `com.facebook.FacebookActivity` MissingClass다. 요청 범위 밖 lint 수정이나 baseline 추가는 하지 않았다. +- 최종 무인증 GET 재확인(2026-10-28 18:51 KST): 테스트 서버 HTTP 200, id `[4,3,2]`, 원문 HTML·날짜·nullable envelope 계약 일치. 운영 서버는 여전히 HTTP 401로 EXT-001 미해결이다. +- 실제 Android 기기/에뮬레이터 시각 QA와 LSP는 실행하지 않았다. 이 세션에 native UI 제어·LSP 진단 도구가 없어 브라우저/소스 대조를 실제 화면 증거로 대체하지 않았다. +- 상세 증거는 [plan-task.md](plan-task.md) Verification Log와 [리뷰 보고서](reviews/phase1-my-notice-ticker-review.md)에 있다. diff --git a/docs/20261028_마이_탭_공지사항_롤링/reviews/phase1-my-notice-ticker-review.md b/docs/20261028_마이_탭_공지사항_롤링/reviews/phase1-my-notice-ticker-review.md new file mode 100644 index 00000000..5ae1738c --- /dev/null +++ b/docs/20261028_마이_탭_공지사항_롤링/reviews/phase1-my-notice-ticker-review.md @@ -0,0 +1,209 @@ +# Phase 1 마이 탭 공지사항 롤링 코드 리뷰 + +## 1. 리뷰 정보 + +| 항목 | 내용 | +|---|---| +| 리뷰 대상 | Phase 1 / P1-T2, P1-T3 및 직접 연결 코드 | +| 기준 commit 또는 working tree | 현재 main working tree의 이번 기능 변경분과 신규 파일 | +| 리뷰 일자 | 2026-10-28 | +| 리뷰어 | 독립 읽기 전용 코드 리뷰 담당 에이전트 | +| 기준 문서 | 같은 디렉터리의 `../prd.md`, `../plan-task.md`, `docs/sample/sample-review.md` | +| 리뷰 상태 | 최초 판정 완료, P1-R1 수정·회귀 검증 완료(독립 재검토 대기; §9) | + +## 2. 리뷰 목적과 범위 + +### 목적 + +- 승인된 NOTICE-001~008 및 P1-T2/P1-T3에 대한 구현 정합성과 기존 동작 회귀를 확인한다. +- 테스트 전용 shadow가 플랫폼 동작을 대체하는 방식과 테스트가 실제 결함을 놓치는지 확인한다. + +### 포함 범위 + +- 운영 코드: `MyPageFragment.kt`, `MyPageViewModel.kt`, `NoticeApi.kt`, `NoticeRepository.kt`, `LatestNoticeResponse.kt`, `MyNoticeTicker.kt`, `fragment_my.xml` 전체 변경분. +- 테스트: `v2/mypage/notice/LatestNoticeApiTest.kt`, `MyPageNoticesViewModelTest.kt`, `MyNoticeTickerTest.kt` 전체. +- 연결 코드: `MainActivity`, `MainV2Activity`, `BaseFragment`, 기존 `NoticeItem`/`NoticeDetailActivity`, `ApiResponse`, DI 참조, typography/color/spacing 리소스. +- 플랫폼 근거: 로컬 Android SDK 28의 `TextSwitcher`, `ViewSwitcher`, `ViewAnimator` 소스와 SDK 35의 `ViewAnimator` 동일 분기. + +### 제외 범위 + +- 운영/테스트/PRD/계획 수정, 새 의존성, 공통 인증·오류 정책 변경, 서버 수정 및 미확인 오류 계약 추정. +- Gradle·테스트·빌드·린트 실행, 네트워크 재호출, 하위 에이전트, 기기·브라우저·시각 QA 및 레이아웃 속성 assertion. + +## 3. 판정 기준 + +| 심각도 | 기준 | +|---|---| +| Blocker | 보안·데이터 손실 또는 핵심 흐름 불능 | +| High | 주요 요구사항 불충족 또는 주요 회귀 | +| Medium | 제한된 조건에서 발생하는 기능·복구·UX 문제 | +| Low | 비핵심 유지보수·문서 정합성 문제 | + +확정은 문서와 실제 코드 또는 플랫폼 구현으로 동작이 결정되는 경우로 제한한다. 실행하지 않은 테스트 통과나 기기 재현을 주장하지 않는다. + +## 4. 검토한 근거 + +### 요구사항·구현 대조 + +| 검토 항목 | 확인 결과와 근거 | +|---|---| +| v2 계약과 구 단건 선언 제거 | `NoticeApi.kt:19`의 파라미터 없는 `GET /api/v2/notices/latest`, `NoticeRepository.kt:16`의 직접 전달. 운영 소스 검색에서 구 `getLatestNotice()`·`latestNoticeLiveData`·`/notice/latest` 호출 없음. `/notice` 목록 메서드는 그대로 유지됨. | +| 0/1/2/3개, 순서·문자열·id 보존 | `LatestNoticeResponse.kt:9`는 `Long`, `:14`는 제목·HTML 전체·날짜를 그대로 기존 payload로 매핑. `MyNoticeTicker.kt:42`는 정렬 없이 첫 항목을 표시하고 `:26`은 모듈로 순환. 성공한 빈 배열은 row를 숨기고 예약/클릭 대상을 비움. 1개는 예약하지 않음. | +| 기존 상세 계약 | 기존 `GetNoticeResponse.kt:16`의 `NoticeItem`은 의도대로 id 없이 유지됨. `MyPageFragment.kt:82`에서 기존 상세 Intent를 사용하고 `NoticeDetailActivity.kt:35`부터 기존 제목·날짜·HTML 처리를 재사용함. id가 상세 Parcelable에 없는 것은 결함이 아님. | +| 로딩·오류 유지 | `MyPageViewModel.kt:78`에서 성공 및 non-null data만 전달. unsuccessful/null-data/예외 시 기존 값 유지. 기존 로그·stack trace 문구와 프로필 로딩/Toast 경로는 diff상 변경 없음. 새 오류 계약이나 fallback 없음. | +| 표시와 클릭 일치 | `MyNoticeTicker.kt:26`에서 선택 index와 다음 제목을 같은 main-thread Runnable에서 변경. `:37`은 그 index의 원문 payload를 사용. 전환 완료 후뿐 아니라 전환 시작 시에도 플랫폼 currentView와 새 선택 index가 일치함. | +| 주기·전환 | `MyNoticeTicker.kt:75`의 5,000ms 예약과 `:85`의 아래→위 250ms TranslateAnimation은 확인됨. 단, 최초 전환에는 애니메이션이 실행되지 않는 REV-P1-001이 있음. | +| 탭 hide/show | `MainActivity.kt:756`, `:770`, `MainV2Activity.kt:386`, `:400`은 hide/show를 사용하며 lifecycle을 낮추지 않음. `MyPageFragment.kt:95`가 숨김을 별도로 반영하고 `:177`과 `:100`이 start/stop을 연결함. | +| 숨김·늦은 응답·재개 | `MyNoticeTicker.kt:53`은 중복 활성화로 타이머를 늘리지 않고 비활성 시 예약/애니메이션을 해제. 숨김 중 submitList는 목록만 반영하고 active가 false라 예약하지 않음. 복귀 후 새 5초를 셈. | +| 목록 교체·파괴 | `MyNoticeTicker.kt:42`에서 기존 예약/애니메이션을 지우고 첫 항목으로 교체. `:60`은 예약·자식 애니메이션·row listener·View 및 클릭 참조를 해제. 이후 submitList/setActive는 titles가 null이면 무시. Fragment observer는 viewLifecycleOwner에 연결됨. | +| 서체·화살표·의존성 | `typography.xml:40`의 Body3는 기존과 같은 `@font/regular`, 16sp이며 별도 parent 속성 추가 없음. XML은 `자세히` text만 제거하고 기존 우측 TextView의 `ic_arrow_right`, 여백·서체·색상 속성을 유지. 제목이 weight=1 영역을 사용. 빌드/의존성 파일 변경 없음. | + +### 테스트와 shadow 평가 + +- API 6개 테스트는 실제 Retrofit/Gson과 메모리 interceptor로 0/1/2/3개, nullable envelope 포함/생략, Long id, 비정렬 입력 순서, 원문과 요청 경로·파라미터를 검사한다. 외부 서버의 특정 실패 계약을 가정하지 않는다. +- ViewModel 5개 테스트는 성공 후 빈 배열 및 unsuccessful/null-data/예외에서 이전 데이터 유지, 최초 실패와 프로필 로딩/Toast 분리를 검사한다. +- 티커/Fragment 13개 테스트는 4,999/5,000ms, 서버 순환, 표시별 클릭 원문, 중복 시작, 비활성/재개, 숨김 중 응답, 목록 교체 및 파괴를 검사한다. Fragment 통합 테스트도 STARTED 이상에서 hide/show를 직접 사용하므로 lifecycle stop만으로 숨김을 대체하지 않는다. +- `MyNoticeTickerTest.kt:381`의 `PlatformViewAnimatorShadow : ShadowViewGroup()`에는 ViewAnimator 메서드를 새로 구현하거나 별도 currentChild를 두는 코드가 없다. 테스트 클래스에 국한해 기본 ShadowViewAnimator 대신 실제 ViewAnimator의 구현을 통과시키는 방향은 타당하다. 실제 `ViewSwitcher.getNextView()`와 `ViewAnimator.getCurrentView()/showNext()`가 동일한 `mWhichChild`를 사용해야 하므로 제품을 shadow의 분리된 index에 맞추지 않은 점도 타당하다. 설치된 기본 shadow의 내부 구현을 이번 리뷰에서 별도로 디컴파일하거나 실행한 것은 아니다. +- 하지만 `MyNoticeTickerTest.kt:207`의 애니메이션 검사는 설정된 `inAnimation/outAnimation`의 duration과 transformation만 계산한다. 자식 View에 해당 애니메이션이 실제 시작됐는지는 검사하지 않으므로 REV-P1-001이 통과할 수 있다. shadow 선언 자체가 결함을 만든 것이 아니라 assertion의 범위가 첫 전환 실행 여부를 놓친 것이다. + +### 실행 환경과 수행한 검증 + +| 명령 또는 검증 | 결과 | 핵심 증거 | +|---|---|---| +| `GIT_MASTER=1 git diff --stat` 및 대상 파일별 `GIT_MASTER=1 git diff -- ...` | 확인 | 기존 코드의 국소 변경, 공지 외 동작 및 의존성 변경 여부 대조 | +| `rg --files ...`, `rg -n ... app/src/main ...` | 확인 | 변경/신규 코드 위치, 호출자, 구 단건 참조 제거, hide/show, 토큰과 테스트 의존성 추적 | +| 로컬 SDK 소스 읽기 및 SDK 35 `ViewAnimator`의 `mFirstTime/showOnly` 검색 | 확인 | 첫 전환의 animate=false 분기가 SDK 28 및 35에서 동일함 | +| Gradle·테스트·assemble·lint | 미실행 | 상위 담당자가 검증 중이므로 명시 요청대로 중복 실행하지 않음 | +| 네트워크·기기·브라우저·시각 QA | 미실행 | 이번 읽기 전용 리뷰의 명시적 제외 범위 | + +구현 담당자가 보고한 focused 24개 통과는 `plan-task.md:108`의 기존 기록이며 이 리뷰의 독립 실행 결과가 아니다. 상위 담당자의 focused/기존 회귀 및 assemble/lint 결과도 여기서 선행 확정하지 않는다. + +## 5. 발견 사항 요약 + +| ID | 심각도 | 상태 | 제목 | 소유 Task | 후속 goal | +|---|---|---|---|---|---| +| REV-P1-001 | Medium | 확정 | 최초 5초 전환은 상향 애니메이션 없이 즉시 교체됨 | P1-T3, 신규 P1-R1 필요 | 첫 전환 실행 회귀 검사 후 최소 수정 | + +그 외 검토 범위에서 확정된 제품 결함은 없다. 운영 401은 아래 EXT-001의 외부 조건이며 클라이언트 코드 결함으로 분류하지 않는다. + +## 6. 발견 사항 상세 + +### REV-P1-001: 최초 5초 전환에서 상향 애니메이션이 생략됨 + +- **심각도:** Medium +- **상태:** 확정, 코드 및 플랫폼 구현으로 판정. 이번 리뷰에서 테스트·기기 실행은 하지 않음. +- **대상:** `app/src/main/java/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTicker.kt:33` +- **관련 요구사항:** NOTICE-003, P1-T3의 최초 무애니메이션 표시와 이후 5초마다 250ms 상향 전환. +- **소유 Task:** P1-T3. 수정 전 상위 담당자가 별도 회귀 Task P1-R1을 추가해야 함. + +**관찰 내용과 근거** + +`setAnimateFirstView(false)`는 최초 제목 설정만 제어하는 옵션이 아니다. 플랫폼 ViewAnimator의 첫 `showOnly`를 비애니메이션으로 실행하게 한다. 현재 초기/목록 표시는 `MyNoticeTicker.kt:48`의 `setCurrentText`를 쓰므로 `showOnly`를 전혀 호출하지 않아 `mFirstTime=true`가 남는다. 따라서 `:27`의 첫 `setText`가 5초 후 실행될 때 처음으로 `showNext → setDisplayedChild → showOnly`에 도달하고 animate=false가 된다. 두 번째 tick부터는 mFirstTime=false여서 정상 애니메이션을 시작한다. + +- 로컬 SDK 28 `android/widget/TextSwitcher.java:88`: `setCurrentText`는 current TextView의 text만 설정한다. +- 로컬 SDK 28 `android/widget/ViewAnimator.java:40`, `:176`: 초기 `mFirstTime=true`, animate는 `!mFirstTime || mAnimateFirstTime`으로 결정한다. +- 같은 파일 `:182`: 일반 child 추가는 첫 자식을 보이게 할 뿐 mFirstTime을 해제하지 않는다. 현재 XML의 일반 추가 및 테스트의 setFactory 경로 모두 해당한다. +- SDK 35 `android/widget/ViewAnimator.java:187`에서도 동일한 분기를 확인했다. +- `app/src/test/java/kr/co/vividnext/sodalive/v2/mypage/notice/MyNoticeTickerTest.kt:213`은 설정 객체만 읽어 검사하므로 실제 자식에 애니메이션이 시작되지 않아도 실패하지 않는다. + +**재현 또는 검증 절차** + +1. 실제 플랫폼 메서드를 사용하는 기존 local test 환경에서 새 TextSwitcher와 티커를 만들고 2개 이상 목록을 제출한 뒤 활성화한다. +2. 기존대로 최초 표시에 자식 애니메이션이 없음을 확인한다. +3. main looper를 정확히 5,000ms 전진시킨 직후 새 currentView에 incoming animation이 시작됐는지 검사한다. 현재 구현은 null이며, 제목만 두 번째 항목으로 바뀐다. +4. 기대 결과는 첫 tick부터 새 currentView에 설정한 250ms incoming animation이 시작되는 것이다. 이는 View 크기·간격·constraint·visibility assertion이 아닌 전환 실행 계약 검사로 작성한다. + +**영향** + +새 View로 마이 탭에 처음 진입하면 첫 공지 교체가 상향 롤링이 아닌 즉시 교체로 나타난다. 한 개에서 여러 개로 바뀌어 처음으로 전환하는 경우도 해당한다. 순서·payload·주기·이후 전환은 유지되므로 제한적인 UX 결함으로 Medium으로 판정한다. + +**권장 조치** + +우선 최초 tick에서 실제 자식 애니메이션의 시작을 검사하는 실패 회귀 테스트를 추가한다. 초기 표시는 이미 `setCurrentText`로 무애니메이션이므로 `setAnimateFirstView(false)` 제거 등 첫 실제 전환만 억제하지 않는 최소 수정이 적절하다. shadow에 성공 동작을 별도 구현하거나 테스트에서 숨은 첫 전환을 미리 소비하여 우회하지 않는다. + +**판정 기록** + +- 2026-10-28: 신규 티커와 SDK 28/35 플랫폼 분기 대조로 확정. 보고서만 작성했으며 제품/테스트 수정 및 재실행은 하지 않았다. + +## 7. 확정 항목의 plan·goal 전환 + +이번 리뷰는 보고서 외 파일 변경이 금지되어 있으므로 아래는 상위 담당자를 위한 초안이다. 기존 완료 Task는 다시 열지 않고 수정 전에 Phase 1에 별도 추가해야 한다. + +### 신규 회귀 수정 Task 초안 + +```markdown +### Task R1.1 최초 공지 전환의 상향 애니메이션 실행 보장 (P1-R1) + +- 시작 조건: REV-P1-001 확정, P1-T3 완료 기록 유지. +- 대상 파일: MyNoticeTicker.kt, MyNoticeTickerTest.kt. +- 수정 범위: 최초 무애니메이션 표시는 유지하고 첫 5초 tick부터 실제 상향 전환 실행. +- 완료 증거: 첫 tick의 실제 자식 애니메이션 시작 assertion RED, 최소 수정 후 GREEN, focused/직접 영향 회귀 통과 및 검증 기록. +- 범위 밖: 레이아웃 assertion, shadow 성공 동작 조작, 기존 상세/인증/서버 변경. + +- [ ] 첫 tick에서 incoming animation의 실제 시작을 검사하는 회귀 테스트를 추가하고 assertion 실패를 확인한다. +- [ ] 최초 실제 전환만 생략되는 원인을 최소 수정한다. +- [ ] 공지 focused test와 Phase Gate의 관련 회귀를 순차 실행하고 결과를 누적한다. +``` + +### goal objective 초안 + +```text +[P1-R1] REV-P1-001을 수정하여 최초 표시의 무애니메이션과 첫 5초 tick의 실제 상향 애니메이션 실행을 함께 보장한다. +먼저 plan-task.md에 별도 회귀 Task를 추가하고 기존 완료 기록을 보존한다. +실패 재현, 최소 수정, focused/직접 영향 회귀 및 검증 기록을 완료 증거로 남긴다. +``` + +## 8. 리뷰 종료 판정 + +| 판정 항목 | 결과 | 근거 | +|---|---|---| +| 리뷰 범위 전체 확인 | 충족 | 지정된 운영/테스트 파일과 직접 연결 및 플랫폼 소스 확인 | +| 후보 항목 판정 완료 | 충족 | REV-P1-001 확정, 그 외 확정 결함 없음 | +| 확정 항목 plan 반영 | 미충족 | 보고서 외 변경 금지. 상위 담당자가 수정 전에 P1-R1 추가 필요 | +| 보류 항목 담당·재개 조건 기록 | 충족 | EXT-001은 서버 담당자의 운영 배포/비로그인 허용 확인 후 운영 무인증 HTTP 200 재확인 필요 | +| 검증 명령과 결과 기록 | 충족 | 실제 수행한 읽기 전용 검사와 미실행 범위를 구분 | + +**최종 결론:** 수정 goal 필요. REV-P1-001 수정·회귀 검증 전에는 상향 롤링 전체 요구사항 충족으로 판정하지 않는다. + +**외부 조건 EXT-001:** 상위 담당자가 관찰한 테스트 서버 HTTP 200과 id `[4,3,2]`는 정상 계약의 관찰 근거다. 운영 HTTP 401은 운영 비로그인 연동 완료를 막는 별도 서버 확인 항목이며, endpoint 미배포로 단정하거나 클라이언트 인증 우회/fallback을 권고하지 않는다. 이번 리뷰에서는 네트워크를 재실행하지 않았다. + +**남은 항목:** 상위 담당자의 P1-R1 추가 및 수정·회귀 검증, 원래 Phase Gate 실행 결과, 운영 EXT-001 확인. + +## 9. 수정 후 검증 기록 + +아직 수정하지 않았다. 후속 검증은 기존 판정 기록을 보존하여 누적한다. + +### 1차 수정 검증: P1-R1 / REV-P1-001 (2026-10-28) + +위의 미수정 문장과 §1~8의 판정·줄 번호는 최초 읽기 전용 리뷰 시점 기록이다. 아래는 P1-R1 수정 담당자의 실행 근거이며 독립 재리뷰나 Phase Gate 완료 판정이 아니다. + +| 항목 | 최신 상태와 근거 | +|---|---| +| REV-P1-001 | 수정 완료. `MyNoticeTicker.kt` init의 `setAnimateFirstView(false)` 한 줄 삭제. 최초/목록 교체는 기존 `setCurrentText`로 무애니메이션을 유지하고 첫 실제 `setText`부터 플랫폼 기본 상향 전환을 허용한다. | +| 소유 Task | 기존 완료 Task를 다시 열지 않고 추가된 `plan-task.md` P1-R1의 RED/GREEN/직접 영향 회귀·기록 체크리스트 완료. | +| 새 실행 회귀 | `MyNoticeTickerTest.kt:209`의 `첫 5초 전환부터 현재 자식에 진입 애니메이션을 시작한다`. 초기와 4,999ms에는 자식 애니메이션 없음, 5,000ms 첫 tick 직후 둘째 제목과 실제 자식 `animation === inAnimation` 검사. 기존 13개 테스트·방향/250ms 검사·플랫폼 shadow 유지. | +| 남은 판정 | 상위 담당자의 scoped 독립 재검토와 P1-GATE build/lint. EXT-001은 기존 외부 조건으로 유지하고 이번 수정에서 네트워크를 재호출하지 않음. | + +**실행 증거** + +- 최초 RED: `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest' --console=plain`, 1분 20초·exit 1·14개 중 새 회귀 1개 실패. 최초/4,999ms 무애니메이션 및 둘째 제목 검사는 통과했지만 `currentView.animation` null로 `assertNotNull` 실패. +- 검사 시점 정정: 한 줄 제거 후에도 `idleFor` 반환 뒤 검사는 1분 13초 실행에서 14개 중 1개 실패했다. 새 메서드 단독 진단 명령 `./gradlew :app:testDebugUnitTest --tests '*MyNoticeTickerTest.첫 5초 전환부터 현재 자식에 진입 애니메이션을 시작한다' --console=plain`도 37초·exit 1. 읽기 진단으로 animateFirstView/firstTime=true, 애니메이션 이력 존재, started/ended=true 및 검사 5,385ms·시작 5,130ms를 관찰했다. Choreographer 프레임 처리로 250ms 전환이 끝난 뒤 검사한 것이므로 4,999ms에 1ms 뒤 관찰 콜백을 추가하여 이미 예약된 첫 tick 바로 뒤의 실제 자식 애니메이션을 검사하도록 보정했다. shadow/first-time 상태·애니메이션을 조작하거나 숨은 사전 전환으로 우회하지 않았다. 임시 진단 출력과 리플렉션은 제거했다. +- 최종 테스트 RED 재확인: 운영 설정을 원래 false로 복원하고 같은 티커 클래스 명령을 재실행했다. 59초·exit 1, XML tests=14·failures=1·errors/skipped=0. 첫 tick 직후 둘째 제목은 표시됐지만 `MyNoticeTickerTest.kt:220`의 관찰 콜백 `assertNotNull`이 `첫 전환의 현재 자식에 진입 애니메이션이 있어야 한다`로 실패했다. 기존 13개는 통과했다. +- GREEN: 설정 한 줄을 다시 제거한 뒤 같은 티커 클래스 명령 성공, 1분 2초·exit 0. XML tests=14·failures/errors/skipped=0. 이후 `./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.mypage.notice.*' --tests '*GiftInboxEntryPolicyTest' --tests '*MainV2LoginGuardSourceTest' --console=plain` 순차 실행 성공, 44초·exit 0. XML API 6 + ViewModel 5 + 티커/Fragment 14 + 선물함 3 + 인증 가드 4 = 32개, failures/errors/skipped=0. 각 Gradle 실행의 도구 timeout은 600,000ms였다. +- 검증 한계: LSP 도구 미제공. focused Gradle의 Kotlin 운영/테스트 컴파일 성공을 확인했다. broad build/lint·전체 테스트·네트워크·기기·계측·브라우저·시각 QA는 실행하지 않았다. 기존 Gradle deprecated 기능 경고 외 추가 실패는 없으며 Gate 체크박스와 최초 검증 기록은 변경하지 않았다. + +### 독립 재검토: REV-P1-001 한정 (2026-10-28) + +- **판정: 조치됨(Addressed).** `MyNoticeTicker.kt:32`의 초기화에는 `setAnimateFirstView(false)`가 없고 진입/퇴장 애니메이션 설정만 유지된다. §6에서 확인한 플랫폼 기본 first-view 허용 분기에 따라 `:27`의 첫 실제 `setText`부터 애니메이션 시작 경로가 실행된다. 초기/목록 교체는 `:44`의 정리와 `:47`의 `setCurrentText`를 유지하므로 무애니메이션 표시와 양립한다. +- **회귀 검사의 유효성:** `MyNoticeTickerTest.kt:209`는 초기와 4,999ms의 무애니메이션을 확인한다. `:217`의 관찰 콜백은 이미 예약된 advance와 같은 5,000ms에 나중에 등록되므로 첫 advance 다음, 후속 애니메이션 프레임 처리 전에 둘째 제목과 실제 `currentView.animation`의 non-null 및 `inAnimation` 객체 동일성을 검사한다. `idleFor` 반환 후 정상 종료된 애니메이션을 검사하는 오류를 피하며, 사전 전환·워밍업·운영 상태/애니메이션 조작은 없다. `:401`의 shadow는 여전히 메서드 재구현 없는 `ShadowViewGroup` 상속이다. +- **최소 수정·회귀 범위:** P1-R1(`plan-task.md:110`) 및 §9의 한 줄 설정 삭제·테스트 1개/import 2개 추가 기록과 현재 소스가 일치한다. 예약 5,000ms(`MyNoticeTicker.kt:74`), 250ms 상향 전환(`:84`), 목록 교체·비활성·파괴 정리 경로는 유지된다. 이 두 파일의 수정 범위에서 새로운 결함은 확인하지 못했다. +- **실행 증거의 구분:** §9와 P1-R1에 기록된 최종 RED(원래 false 설정, 14개 중 새 검사만 1개 실패·59초), GREEN(한 줄 제거 후 14개 통과·62초), 직접 영향 회귀 32개 통과·44초는 수정 담당자의 보고이며 이번 독립 실행 결과가 아니다. 이번 재검토는 지정된 소스와 기록만 읽었고 테스트·빌드·네트워크·시각 QA를 실행하지 않았다. 최종 P1-GATE와 EXT-001 판정은 상위 담당자의 별도 확인 대상으로 유지한다. + +### 독립 재검토: P1-R2 테스트 fixture 격리 한정 (2026-10-28) + +- **판정: 승인(Approve), 이 변경의 차단 결함 없음.** `plan-task.md:133~145`의 저장된 로그인 토큰 격리만 검토했으며 운영 기능·전체 Phase 판정은 재검토하지 않았다. +- **원인 확인:** `SharedPreferenceManager.kt:85~92`는 observer·메모리 상태·초기화 플래그만 초기화한다. `:63~68`은 DataStore의 첫 값을 다시 읽는다. `AppPreferencesDataStoreProvider.kt:18~26`은 같은 저장소 인스턴스를 반환하므로 캐시 reset만으로 저장된 토큰을 제거할 수 없다. +- **수정의 충분성:** `MyNoticeTickerTest.kt:389~395`는 캐시 reset 후 `runBlocking` 안에서 동일 provider의 `edit`로 `Constants.PREF_TOKEN`만 빈 문자열로 저장하고, 완료 후 `init(context)`를 호출한다. 전체 preferences 삭제·비동기 setter 경쟁·운영 fallback 없이 재수화 전 선행조건을 확정한다. +- **회귀의 유효성:** `MyNoticeTickerTest.kt:334~343`은 같은 저장소에 `previous-test-token`을 동기 저장한 뒤 실제 공통 fixture를 호출해 `SharedPreferenceManager.token == ""`를 assert한다. 단순 메모리 초기값 검사나 fixture를 우회하는 검사가 아니다. +- **기존 경로·assert 유지 확인:** `MyNoticeTickerTest.kt:405~412`는 실제 `MyPageFragment`를 Activity에 추가한 후 테스트 본문을 실행한다. `:280~301`의 현재 제목·상세 Intent·원문 payload 검사와 `:303~332`의 숨김·지연 응답·재개·파괴 검사가 남아 있고 예외 무시·null 방어·프로필 성공 stub으로 우회하지 않는다. +- **검증 한계:** 소스 읽기만 수행하고 보고서에만 추가했다. 부모가 보고한 수정 전 1개 NPE·90초 RED는 독립 재실행하지 않았으며 focused/전체 GREEN은 부모 담당자의 실행 결과로 확인해야 한다. 기존 `V2AuthFlowTest:528` 실패는 이번 범위 밖이다.