docs(mypage): 공지 롤링 요구사항과 검증을 기록한다

This commit is contained in:
2026-10-28 19:16:33 +09:00
parent fe28b0ce59
commit 33904eea3e
3 changed files with 517 additions and 0 deletions
@@ -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<T>`, `NoticeItem`, 공유 Retrofit·RxJava3.
- Produces: `LatestNoticeResponse(id: Long, title: String, content: String, date: String)` 및 기존 `NoticeItem` 변환; `NoticeApi.getLatestNotices(): Single<ApiResponse<List<LatestNoticeResponse>>>`; Repository 동일 반환형; `MyPageViewModel.latestNoticesLiveData: LiveData<List<LatestNoticeResponse>>`, `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<LatestNoticeResponse>`, 플랫폼 `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 경고가 남아 있다.