Files

34 KiB

전체 이미지 로딩 placeholder 제거 구현 계획

후속 사용자 승인으로 구현을 진행한다. 이미지 관련 레거시 수정 허용, error/fallback 모두 빈 표시, worktree 없이 현재 main에서 직접 작업한다. 같은 파일에 대한 구현은 순차 실행한다. 커밋·게시·브랜치 이동은 하지 않는다.

항목 내용
상태 구현 완료, 기존 린트 위반 및 비결정적 인증 테스트 관찰 기록
작성일 2026-10-28
요구사항 기준 prd.md
API 기준 변경 없음, 별도 계약 문서 불필요
기준 샘플 sample-plan-task.md
현재 활성 구현 Goal 없음

목표와 접근

모든 이미지 로딩의 placeholder와 초기 기본 이미지를 제거하고 실제 요청 이미지·아이콘은 정상 표시한다. 기존 Coil/Glide 호출과 바인딩 경계를 유지하며, 전역 wrapper·새 의존성·레이어 재설계 없이 지정 옵션과 기본 source만 최소 변경한다.

현재 상태

Phase 상태 완료 구현 Task 다음 조건
1. 승인 및 기준선 완료 1/1 사용자 승인 기록 완료
2. 요청 옵션과 source 없음 완료 2/2 없음
3. 초기값·XML·배너 완료 3/3 없음
4. 통합 검증 완료, 기존 문제 보고 1/1 전체 lint는 기존 위반으로 실패, 신규 변경 줄 진단 0

범위와 제약

  • 전체 변경 파일·라인은 PRD 부록 A와 §5에 단일 목록으로 관리한다. 117파일/170호출 = URL 160 + local URI/file 6 + no-source resource 분기 4다. 구현 시 이동한 줄은 먼저 재조사한다.
  • 초기 Kotlin 할당 10건, 기본 resource load 4건, GiftInbox Elvis 2건, XML 초기 source 18파일/19곳(음성 메시지 포함), 배너 배경 1파일/2곳 및 runtime preview를 포함한다. 이 수치는 호출 목록과 중첩되므로 단순 합산하지 않는다.
  • 이미지 관련 레거시 100파일/146호출 및 관련 기본·오류 표시 수정은 승인됐다. ImageLoader.kt의 placeholder 인자는 error 제거 후 전체 호출자를 확인하여 이번 변경으로 불필요해진 경우에만 정리한다.
  • error와 null-source fallback은 원인이 다르지만 표시 결과는 모두 빈 이미지다. 이전 error 보존 권고는 폐기됐다. 모든 이미지 request error/fallback 옵션과 직접 실패 콜백의 대체 이미지도 조사하고 제거한다. 일반 Kotlin error() 및 이미지와 무관한 오류 처리는 보존한다.
  • 실제 요청 resource, 서비스센터 로고, 입력 hint, 미구현 탭, tools: preview, 장식 배경, 변환·캐시·crossfade·입력·권한·API는 보존한다. 리소스 파일을 일괄 삭제하지 않는다.
  • HomeCreatorProfileImageLoader.kt, ImageExtensions.kt, ImageLoaderProvider.kt에는 새 동작이나 wrapper를 추가하지 않는다.
  • 신규 테스트는 app/src/test의 request·source 선택·바인딩 로직만 검증한다. View 크기·간격·constraint·visibility 또는 XML 속성 자체의 assertion, androidTest, 기기 조작, 스크린샷·시각 QA는 제외한다.
  • 아래 신규 테스트 3개는 구현되어 실제 request 경계로 검증했다. production wrapper는 추가하지 않았으며 Glide 내부 필드 관찰은 테스트 코드에만 한정했다.

검증 시나리오

시나리오 이진 판정 조건 소유 Task
원격/로컬 요청 실제 요청의 placeholder 미설정, 기존 model/transform 유지, 성공 이미지 전달 P2-T1
로딩 실패 원격·로컬 요청 실패에서 error/fallback 리소스가 표시되지 않고 이전 이미지도 남지 않음 P2-T1, P2-T2, P3-T1
null/빈 값/공백 기본 drawable 요청 없음, 이전 요청 해제 및 빈 drawable, 지연된 이전 완료의 재등장 없음 P2-T2, P3-T1
초기 화면 초기 기본 이미지는 없고 실제 이미지 요청/아이콘 계약 유지 P3-T1, P3-T2
배너 runtime preview 사전 할당 없음, 실제 배너 바인딩 및 editor preview 유지 P3-T3
인접 기능 회귀 기존 local unit suite 통과, debug compile 및 lint 결과 기록 P4-GATE

Phase 1. 승인 및 기준선

Task 1.1 구현 재개 조건 확정

Goal P1-T1: 확정된 제품 정책과 수정 권한으로만 구현을 시작한다.

  • 시작 조건: 후속 구현 요청 및 현재 브랜치 직접 실행 승인 확보.

  • Files: 이 문서와 prd.md만 갱신.

  • 완료 증거: OQ-001/002 결정, 승인 범위, 최신 호출 inventory를 Decision Log에 기록.

  • 범위 밖: 앱·테스트 수정, 커밋, 실행 방식 확대.

  • TDD 예외 사유: 문서·승인 확인 작업. 대체 검증은 사용자 결정과 PRD/계획 대조 및 rg 전수 검색이다.

  • 샘플·코드·기존 테스트를 확인하고 문서 기준선을 작성했다.

  • Gradle task 목록에서 후속 검증 명령을 확인했다.

  • OQ-001: 실패 error 및 null-source fallback 모두 빈 이미지로 확정했다.

  • OQ-002: 이미지 관련 레거시 직접 수정 승인을 기록했다.

  • 후속 구현 요청과 main 직접 작업 승인을 확인하고 PRD와 계획을 동기화했다.

추가 검증 기록: 사용자 명시 승인으로 기능상 미결 항목 없음. git rev-parse에서 원본 main임을 확인했다. 기존 문서 2개 외 작업 변경 없음. 구현은 이 승인 이후 시작한다.

검증 기록: 문서 작성 시 ./gradlew tasks --all exit 0, BUILD SUCCESSFUL (1m 3s). 이는 task 조회이며 앱 build/test/lint 통과 증거가 아니다. 코드 구현은 미착수다.

Phase 2. 이미지 요청과 source 없음 처리

Task 2.1 URL·local URI/file 요청의 placeholder 제거

Goal P2-T1: URL 160곳과 local URI/file 6곳의 요청 옵션만 제거한다.

승인 반영 추가 범위: 같은 request 경로의 이미지 error(...) 및 fallback(...)도 제거한다. ImageLoader와 CharacterDetail의 no-source 분기 내부 error는 P2-T2가 담당한다. GiftInbox fallback 및 Elvis source는 P3-T1이 담당한다. 기존 CreatorChannelFanTalkFragmentLayoutTest.kt:159는 placeholder와 error 모두 제거하면 바뀌므로 P2-T1에서 URL·변환·빈 오류 결과 계약으로 갱신한다.

  • 시작 조건: P1-T1 완료.

  • Files Modify: PRD 부록 전체 중 local/no-source 분류를 기준으로 no-source 4곳을 제외한 166곳. ImageLoader.kt:30,60의 공통 URL 요청도 포함한다.

  • Test Modify: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt.

  • Test Create: app/src/test/java/kr/co/vividnext/sodalive/live/room/update/LiveRoomImageRequestTest.kt.

  • Interfaces: 기존 Coil builder와 Glide request, LiveRoomInfoEditDialog.setCoverImageUri(File) 유지. 실제 source·transform을 관찰하며 별도 생산 코드 abstraction은 만들지 않는다.

  • 완료 증거: 아래 focused test와 166곳 source/옵션 전후 대조. 대표 테스트 하나로 모든 호출이 검증됐다고 주장하지 않는다.

  • 범위 밖: 기본 resource 분기 4곳, 초기 source/XML, 이미지와 무관한 오류 처리.

  • RED 추가: request의 error/fallback 미설정 및 실제 원격 실패 시 빈 drawable을 검증한다. source 미지정과 실패는 별도 case이며 성공 source/transform assertion은 보존한다.

  • GREEN 추가: 직접 실패 콜백을 포함한 이미지 error/fallback 리소스 참조를 재검색하여 승인 범위만 제거한다. 실패 시 이전 요청 이미지가 재등장하지 않음을 검증한다.

  • RED: GiftNavigationTest의 기존 request collector로 URL 존재 요청의 data == URL, placeholder 미설정, CircleCrop 유지 assertion을 추가한다. LiveRoomImageRequestTest는 Robolectric에서 실제 setCoverImageUri(File) 호출의 Glide request model/placeholder/transform을 test double로 관찰한다. URL 없음의 기존 XML 초기값 기대는 아직 변경하지 않는다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest' --tests 'kr.co.vividnext.sodalive.live.room.update.LiveRoomImageRequestTest'에서 현재 placeholder 설정 때문에 assertion이 실패함을 확인한다. 정상 이미지 성공만 검증하여 이미 통과하는 테스트는 RED 증거가 아니다.

  • GREEN: 166곳의 placeholder와 위 추가 범위의 error/fallback 이미지를 제거한다. local 6곳은 PRD의 정확한 URI/file 목록을 따르며 모든 source·crop·rounding·blur·cache·crossfade·권한 callback은 보존한다.

  • GREEN 확인: 동일 focused test 통과와 실제 요청 이미지 전달을 확인한다. 나머지 호출은 원본 source와 옵션을 전수 대조한다.

  • REFACTOR: 이번 변경으로만 생긴 불필요한 import 등을 정리하고 같은 focused test 및 ./gradlew :app:ktlintCheck 결과를 기록한다. 기존 unrelated 실패는 별도 기록한다.

실행 판정 및 RED 기록 (2026-10-28): DEC-005에 따라 P2-T1은 error/fallback의 빈 결과를 포함한다. Glide 5.0.5 sources에서 실제 target의 SingleRequest model/requestOptions를 확인했으므로 제안된 mock seam 대신 실제 요청 관찰을 사용한다. 생산 wrapper는 추가하지 않는다. 기존 5개 클래스 기준선은 baseline-retry.log exit 0. 최초 200초 제한 실행은 완료 증거가 아니다. p2-t1-red.log exit 1(55개 중 6실패)에서 GiftNavigation은 placeholder drawable, LiveRoom은 placeholder ID, FanTalk은 기존 source로 실패했다. detached ImageView로 시작하지 않은 Coil 3건은 RED 증거에서 제외하고 Activity에 붙인 후 재실행했다. p2-t1-red-request.log exit 1(3개 중 3실패), 모두 실제 placeholder/오류 VectorDrawable 잔존으로 expected null 실패를 확인했다. 로그는 승인된 임시 루트 image-placeholder-impl.X3myNy에 보관한다.

P2-T1 GREEN 기록 (2026-10-28): p2-t1-green.log exit 0, BUILD SUCCESSFUL in 1m 45s. ImageLoaderTest·LiveRoomImageRequestTest·GiftNavigationTest·CreatorChannelFanTalkFragmentLayoutTest 통과. Coil 실제 fetch 성공/실패, URL/변환 및 Glide File model/변환을 확인했다. placeholder는 170→4, 117파일의 166개 삭제이며 남은 4개는 이 Task 대상이다. 불필요해진 R import 32개를 제거했다. p2-t1-lint.log exit 1, 기존 대량 test-source 위반과 신규 ImageLoaderTest의 4개 문법 스타일 지적을 확인했다. 신규 4개만 수정했으며 최종 lint에서 재확인한다. callback 감사에서 Glide onLoadFailed는 false 반환으로 SDK의 빈 오류 처리에 위임하며 대체 이미지를 직접 지정하지 않는다.

Task 2.2 URL 없는 기본 resource 로딩 제거

P2-T2 실행 판정: ImageLoader 호출자 4곳 모두 기본 placeholder 인자를 전달하지 않으므로 기본 source 제거 후 불필요해진 인자·annotation/import만 제거한다. CharacterDetail의 댓글 source 없음 분기는 기존 코드가 다른 ivMyProfile에 기본 그림을 요청했다. 재사용된 댓글 그림 잔존을 막기 위해 같은 분기의 실제 URL target인 ivCommentProfile을 dispose/clear한다. 레이아웃 분기와 visibility는 보존한다.

Goal P2-T2: URL이 없는 4개 분기에서 기본 resource를 load하지 않는다.

  • 시작 조건: P2-T1 완료, OQ-001 결정 반영.

  • Files Modify: app/src/main/java/kr/co/vividnext/sodalive/chat/talk/room/ImageLoader.kt:36,66, app/src/main/java/kr/co/vividnext/sodalive/chat/character/detail/detail/CharacterDetailFragment.kt:265,290.

  • Test Create: app/src/test/java/kr/co/vividnext/sodalive/chat/talk/room/ImageLoaderTest.kt.

  • Interfaces: 기존 loadProfileImage(ImageView, String?, Int) 및 loadRoundedImage(ImageView, String?, Float, Int) 직접 호출. HomeCreatorProfileImageLoaderTest의 dispose/빈 drawable 검증을 참고한다.

  • 완료 증거: null/빈 문자열/공백에서 resource request 없음과 이전 요청 해제, 유효 URL source·변환 유지. CharacterDetail 두 분기의 동일 정책 소스 대조.

  • 범위 밖: GiftInbox Elvis, 임의 함수 시그니처 삭제, 실제 요청한 resource 이미지 제거.

  • RED: ImageLoaderTest에서 두 함수의 null/빈 문자열/공백 입력은 기본 drawable request 없이 빈 상태가 되고 이전 요청이 해제됨을 검증한다. 유효 URL의 요청·변환과 clear 이후 지연된 이전 완료가 재등장하지 않는 case도 포함한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.chat.talk.room.ImageLoaderTest'에서 기본 resource 요청 또는 이전 drawable 잔존 때문에 실패함을 확인한다.

  • GREEN: 위 4개 source load와 그 안의 placeholder 4곳을 제거하고, source 없음 분기에서 필요한 기존 loader 취소·drawable clear를 수행한다. 새 요청의 완료 이미지를 뒤늦게 지우지 않는다.

  • GREEN 확인: 같은 focused test 통과, 두 CharacterDetail 분기에서 기본 source 미사용 및 유효 URL 로딩 보존을 확인한다.

  • REFACTOR: 이 변경에서 생긴 중복만 정리하고 focused test 및 ./gradlew :app:ktlintCheck를 재실행한다.

P2-T2 검증 기록: p2-t2-red.log exit 1, 5개 중 신규 2개가 expected null, CrossfadeDrawable로 실패. p2-t2-green.log exit 0, 5개 모두 통과(27s). 두 helper의 null/빈 문자열/공백, 이전 Disposable 해제, 기본 resource 요청 0건, 지연 fetch 완료 후 성공 재등장 없음 및 유효 URL 성공/변환을 확인했다. 기본 인자를 사용하던 호출자 4곳은 모두 그대로 컴파일됐다. 마지막 lint 재실행은 통합 검증에서 수행한다.

Phase 3. 초기값·XML·배너

Task 3.1 Kotlin 기본 이미지 할당과 GiftInbox 기본 source 제거

Goal P3-T1: 초기 setImageResource 10곳과 GiftInbox Elvis 2곳에서 기본 이미지가 표시되지 않는다.

  • 시작 조건: P2-T2 완료.

  • Files Modify: PRD §5.1 중 setImageResource 10곳과 GiftInbox 2곳. OriginalWorkDetailActivity.kt:145 포함. load 4개 source는 P2-T2 전담이며 중복 수정하지 않는다.

  • Test Create: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapterTest.kt.

  • Test Modify: app/src/test/java/kr/co/vividnext/sodalive/v2/creator/channel/CreatorChannelActivitySourceTest.kt:2195.

  • Interfaces: 기존 adapter의 sent/received 데이터 바인딩 및 팬톡 있음/없음 분기. GiftNavigationTest는 GiftSendRequest 화면 테스트이므로 GiftInbox의 증거로 사용하지 않는다.

  • 완료 증거: null/blank source 바인딩은 기본 resource 미요청 및 이전 요청 해제, 유효 URL·실제 resource·아이콘은 보존.

  • 범위 밖: source가 있는 실제 이미지 제거, 정상 배지·버튼 제거, 레이아웃 변경.

  • RED: GiftInboxAdapterTest의 sent/received 각각에 source 없음·URL 있음·이전 항목 재사용 case를 추가한다. 실제 request source 및 이전 요청 해제를 검증한다. CreatorChannelActivitySourceTest의 기본 프로필 할당 기대는 팬톡 없음의 clear 동작을 검증하도록 변경하고 기존 다른 assertion을 보존한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.gift.ui.GiftInboxAdapterTest' --tests 'kr.co.vividnext.sodalive.v2.creator.channel.CreatorChannelActivitySourceTest'에서 기존 기본 source 때문에 실패함을 확인한다.

  • GREEN: 기본 source 할당만 제거한다. 재바인딩 경로는 기존 loader 요청 해제 후 clear하고, 최초 빈 View 초기화는 불필요한 요청을 추가하지 않는다. error/fallback은 승인 정책대로 반영한다.

  • GREEN 확인: 같은 focused test 통과와 10개 직접 할당 전후 대조를 기록한다. 초기 API 응답 대기 상태에서도 기본 이미지를 새로 할당하지 않는다.

  • REFACTOR: 이번 수정의 중복·unused import만 정리하고 focused test 및 ./gradlew :app:ktlintCheck 결과를 기록한다.

P3-T1 검증 기록: p3-t1-red.log exit 1, 104개 중 5실패. sent/received URL은 error/fallback VectorDrawable 설정으로, 빈 source 재사용은 기본 BitmapDrawable로 실패했고 팬톡 source 기대도 실패했다. p3-t1-green.log exit 0, 104개 모두 통과(42s). sent/received의 null/빈 문자열/공백은 새 요청 없이 이전 Disposable과 drawable을 비우고 지연 fetch 완료 뒤에도 빈 결과다. URL은 원본 source와 실제 성공 이미지를 유지한다. Kotlin 직접 할당 10건은 초기 4건 삭제와 재사용 6건 dispose/clear로 대체했다. lint 재실행은 통합 검증에서 수행한다.

Task 3.2 XML 초기 이미지 제거

Goal P3-T2: XML 초기 source 18파일/19곳에서 기본 이미지가 나타나지 않는다.

  • 시작 조건: P3-T1 완료.

  • Files Modify: PRD §5.2의 17파일/18곳 및 app/src/main/res/layout/fragment_voice_message_write.xml:54.

  • Test Modify: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftNavigationTest.kt:1197의 기존 URL 없음 동작 기대.

  • Interfaces: 기존 XML inflate 및 GiftSendRequest URL 유무별 request 분기 유지.

  • 완료 증거: 기존 GiftNavigationTest의 새 URL 없음 계약 통과, 지정 source 검색 0건 및 Android resource compile 성공.

  • 범위 밖: View 크기·간격·visibility 변경, XML attribute assertion 신규 작성, tools preview 및 장식 배경.

  • TDD 예외: 나머지 순수 XML 속성 삭제는 새 layout assertion을 만들지 않고 검색·resource compile로 검증한다. 이미 존재하는 GiftNavigationTest의 source 유무별 동작은 아래 TDD를 적용한다.

  • RED: GiftNavigationTest의 URL 없음 case를 request 미발생 및 drawable 없음으로 변경한다. URL 존재의 요청·변환 검증은 유지한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.gift.GiftNavigationTest'에서 XML 초기 drawable 때문에 실패함을 확인한다.

  • GREEN: 지정 XML의 초기 android:src만 제거한다. View 영역을 숨기거나 없애지 않는다.

  • GREEN 확인: 같은 focused test 통과, rg -n 'android:src="@drawable/(ic_placeholder_profile|bg_placeholder|img_thumb_default)"' app/src/main/res/layout 결과 0건(exit 1), ./gradlew :app:assembleDebug 성공을 확인한다.

  • REFACTOR: unrelated XML 포맷은 건드리지 않고 동일 focused test와 resource compilation 결과를 기록한다.

P3-T2 검증 기록: p3-t2-red.log exit 1, GiftNavigation 44개 중 새 초기 빈 결과 1개가 XML drawable 때문에 실패. 지정 초기 source 18파일/19곳만 제거했다. p3-t2-green.log exit 0, GiftNavigation 44개와 GiftInboxAdapter 4개 통과(56s). 지정 src 검색은 0건(exit 1), p3-t2-build.log exit 0, BUILD SUCCESSFUL in 1m 2s. 새 XML attribute/레이아웃 assertion은 작성하지 않았다.

Task 3.3 배너 runtime placeholder 제거

Goal P3-T3: 배너의 runtime 기본 배경·preview 이미지는 제거하고 실제 이미지 바인딩과 editor preview는 유지한다.

  • 시작 조건: P3-T2 완료, PRD DEC-001 기술 경계 확인.
  • Files Modify: app/src/main/res/layout/item_banner.xml:5,11, app/src/main/java/kr/co/vividnext/sodalive/v2/widget/banner/BannerAdapter.kt:94, app/src/main/java/kr/co/vividnext/sodalive/v2/widget/banner/BannerView.kt:145,146.
  • Files Read only: app/src/main/res/layout/view_banner.xml:5, app/src/main/java/kr/co/vividnext/sodalive/v2/main/home/ui/HomeBannerBinder.kt.
  • Test Modify: app/src/test/java/kr/co/vividnext/sodalive/v2/widget/banner/BannerViewTest.kt:211.
  • Interfaces: setOnBindBannerImage callback 및 preview resource 설정 API 유지. runtime에서만 사전 할당을 차단하고 editor 경계는 기존 Android isInEditMode를 사용한다.
  • 완료 증거: runtime preview resource 비표시, 실제 이미지 callback 유지, tools preview 보존, banner focused tests 통과.
  • 범위 밖: autoplay·크기·간격·counter 변경, 다른 카드 배경 제거.

P3-T3 실행 판정: 기존 HomeBannerBinder는 빈 URL에서 drawable만 비우므로 재사용 이전 Coil 요청이 늦게 덮을 수 있다. binder를 변경하지 않고 소유 BannerAdapter의 bind 시작에서 기존 Coil dispose/clear를 수행한 뒤 editor preview 또는 실제 callback을 실행한다. 생산 seam 없이 editor root의 isInEditMode를 override한 로컬 테스트로 editor 바인딩을 관찰한다. preview count/current-index 처리와 editor tools 배경은 변경하지 않는다.

  • RED: 기존 preview image 테스트를 runtime에서는 preview resource가 표시되지 않는 바인딩 결과로 갱신한다. 실제 이미지 callback은 정상 호출되며 editor 전용 분기에서는 preview가 허용됨을 검증한다. layout property assertion은 추가하지 않는다.
  • RED 확인: ./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.widget.banner.BannerViewTest'에서 runtime 사전 할당 때문에 실패함을 확인한다.
  • GREEN: 두 runtime placeholder 배경을 제거하고 preview 이미지 할당은 editor 모드에 한정한다. tools:background는 유지한다.
  • GREEN 확인: 동일 focused test 통과와 runtime XML의 bannerPreviewImage 지정 0건, 기존 배너 callback 보존을 확인한다.
  • REFACTOR: 이번 변경 중복만 정리하고 ./gradlew :app:testDebugUnitTest --tests 'kr.co.vividnext.sodalive.v2.widget.banner.*', ./gradlew :app:assembleDebug, ./gradlew :app:ktlintCheck 결과를 기록한다.

P3-T3 검증 기록: p3-t3-red.log exit 1, BannerViewTest 33개 중 runtime preview 표시 2개 실패. editor preview 테스트는 기존 동작을 유지했다. p3-t3-green.log exit 0, 배너 전체 45개 통과(40s). runtime callback 호출 전 빈 이미지, 실제 callback 이미지 전달, callback 제거 재바인딩 시 이전 Disposable 해제와 빈 drawable, editor preview 표시를 확인했다. preview count/current-index 기존 테스트도 통과했다. runtime XML preview 속성 0건, view_banner.xml의 tools 배경은 보존했다. 최종 build/lint는 다음 통합 검증에서 직렬 실행한다.

Phase 4. 통합 검증

Task 4.1 완료 Gate

Goal P4-GATE: 전체 제거 범위와 정상 이미지 표시의 회귀 증거를 확보한다.

  • 시작 조건: P2-T1~P3-T3 완료, OQ 미결 없음.

  • Files: PRD inventory와 변경한 앱·테스트 파일을 읽기 전용 확인. 결과는 본 문서에 기록.

  • 완료 증거: 아래 명령·대조 결과와 승인 범위 일치. 테스트를 통과시키기 위한 코드·테스트 수정은 Gate에서 하지 않고 별도 회귀 Task로 먼저 등록한다.

  • 범위 밖: device/UI tests, 새로운 기능, 자동 commit/push, unrelated lint 정리.

  • TDD 예외 사유: 검증 전용 작업. 대체 검증은 전수 검색 및 실제 Gradle 결과다.

  • rg -n 'placeholder\s*\(' app/src/main/java --glob '*.kt' --glob '*.java' 결과 0건(exit 1)을 확인한다. onLoadCleared(placeholder)는 설정 호출이 아니므로 제거하지 않는다.

  • 기본 source 10+4+2, XML 초기 source 19곳, 배너 배경 2곳 및 preview 경로를 대조한다. error/fallback 잔존은 승인된 정책과 연결해 설명한다.

  • ./gradlew :app:testDebugUnitTest를 실행한다. 여러 domain이 변경되므로 전체 local unit 회귀를 수행한다. 기존 HomeCreatorProfileImageLoaderTest, CreatorChannelFanTalkFragmentLayoutTest도 포함한다. error 제거로 바뀐 계약은 소유 TDD 단계에서 먼저 갱신하며 Gate에서 테스트를 약화하지 않는다.

  • ./gradlew :app:assembleDebug와 ./gradlew :app:ktlintCheck를 직렬 실행하고 실제 결과를 기록한다. 기존 실패와 신규 실패를 구분하며 성공을 추정하지 않는다.

  • 요구사항 추적표와 승인 범위를 대조하고 최종 리뷰 승인을 확인했다. 전체 unit/build는 통과했으며 전체 lint의 기존 위반은 아래 기록으로 별도 보고한다.

P4-GATE 최종 판정: Oracle 읽기 전용 리뷰 APPROVE, 차단 발견 사항 없음. 전체 unit 강제 재실행 1,616/1,616 통과, debug assemble 성공, 잔여 이미지 placeholder/error/fallback 및 기본 source 검색 0건. 전체 ktlint는 기존 줄 위반 222건으로 실패했으며 변경 줄 진단 0건이다. 상세 기록: phase4-image-placeholder-removal-review.md.

실행 순서와 중단 규칙

P1-T1 → P2-T1 → P2-T2 → P3-T1 → P3-T2 → P3-T3 → P4-GATE 순서로 실행한다. 같은 파일을 여러 Task가 수정하므로 병렬 구현하지 않는다. 승인되지 않은 정책, 재현하지 못한 RED, 지원되지 않는 SDK test seam은 해당 Task에서 중단·기록하고 계획을 먼저 보완한다. 완료 Task는 다시 열지 않고 회귀 수정 Task를 추가한다.

Decision Log

날짜 ID 상태 결정 근거
2026-10-28 DEC-001 기술 경계 runtime preview 미표시, editor preview 보존 PRD §5.3
2026-10-28 DEC-002 권고, 미승인 실제 실패 error 보존 권고, null-source fallback은 별도 결정 OQ-001
2026-10-28 DEC-003 제약 레거시 직접 수정은 후속 명시 승인 필요 AGENTS.md, OQ-002
2026-10-28 DEC-004 범위 확정 현재 문서 2개만 작성, 앱·테스트 미수정 사용자 요청
2026-10-28 DEC-005 확정, DEC-002 정정 error/fallback 모두 빈 이미지 사용자 명시 결정
2026-10-28 DEC-006 승인 확보 이미지 관련 legacy 수정 허용 사용자 명시 승인
2026-10-28 DEC-007 실행 승인, DEC-004 후속 문서 반영 후 구현. worktree 없이 현재 main 직접 작업 사용자 명시 지시

Verification Log

  • 2026-10-28: 샘플·코드·기존 테스트를 확인했다. 초안의 16곳/11파일 누락과 local/no-source 분류를 보완했으며 OriginalWorkDetailActivity.kt:145를 추가해 직접 기본 이미지 할당을 10곳으로 정정했다.
  • 2026-10-28: ./gradlew tasks --all exit 0, BUILD SUCCESSFUL (1m 3s). Gradle 9 비호환 deprecated feature 경고가 있었으며 task 조회는 성공했다. 앱 build/test/lint와 기기 QA는 미실행이다.
  • 문서 완료는 구현 완료가 아니다. 후속 Task별 실행 증거는 각 Task 아래에 누적하고 통합 결과는 이 절에 추가한다.
  • 2026-10-28 최종 문서 대조: rg --json 결과와 PRD의 전체 호출 블록을 비교해 117파일/170곳 완전 일치(누락 0, 초과 0)를 확인했다. local 6곳과 no-source 4곳은 중복 없는 부분집합이며 나머지 URL 경로는 160곳이다. 초기 할당 10곳, XML 초기 source 18파일/19곳, banner 배경 2곳도 직접 검색과 일치한다.
  • 2026-10-28 문서 구조 검증: 두 문서의 상대 링크 존재, 미치환 템플릿 없음, Verification Log 최하단 배치 통과. 문서 보정 후 ./gradlew tasks --all을 다시 실행해 exit 0, BUILD SUCCESSFUL (6s)을 확인했다. Markdown LSP 진단 도구는 세션에 제공되지 않아 실행하지 못했으며 파일 직접 읽기·링크·목록 대조로 검증했다.
  • 2026-10-28 읽기 전용 문서 정합성 게이트: 두 문서 전체를 별도로 읽은 검증에서 APPROVE, 문서 전달 차단 항목 없음. 이는 코드 리뷰나 구현 승인이 아니다. 신규 SDK request 관찰용 test seam은 구현 시 확인하며 지원되지 않으면 해당 Task에서 계획을 먼저 보완한다.
  • 2026-10-28 통합 실행: ./gradlew :app:testDebugUnitTest exit 0, BUILD SUCCESSFUL in 1m 45s, JUnit XML 기준 204클래스/1,616테스트/실패 0/오류 0 (full-tests.log). 이어서 ./gradlew :app:assembleDebug exit 0, 5s (final-build.log). 기기·브라우저·계측·시각 QA는 승인 범위에서 제외하여 실행하지 않았다. LSP 도구가 제공되지 않아 Kotlin 컴파일·로컬 테스트로 대체했으며 LSP clean을 주장하지 않는다.
  • 2026-10-28 lint 판정: ./gradlew :app:ktlintCheck는 exit 0, 7s (final-lint.log)였으나 incremental 결과만으로 전체 통과를 주장하지 않고 ./gradlew :app:ktlintCheck --rerun-tasks를 실행했다. 강제 실행은 exit 1, 32s, :app:ktlintTestSourceSetCheck 실패 (final-lint-full.log). 기존 ChatRepositoryTest.kt:39,42 6건과 CreatorChannelFanTalkFragmentLayoutTest.kt:85,88,89,225 20건의 wrapping/길이 위반, 총 26건이다. git HEAD와 SequenceMatcher의 동일 줄 mapping으로 26건 모두 원래 존재한 줄임을 확인했다 (lint-classification.log). 새 코드·변경 줄의 위반은 0건이며 무관한 기존 포맷은 수정하지 않았다. 최초 P2-T1의 신규 4건은 수정되어 재실행에 남지 않았다.
  • 2026-10-28 전수 감사: audit.py 실행 exit 0, final-audit.log의 AUDIT PASS. 원본 117파일/170 placeholder → 0, 이미지 error 27→0, fallback 2→0, bg_black placeholder 5→0, 직접 기본 source 10→0. 기본 load 4개 제거, GiftInbox Elvis 2개 제거. 나머지 116개 변경 Kotlin 파일의 실제 load source는 원본과 동일하며 default builder 4개 외 transform/crossfade/cache/scale 설정도 동일하다. XML parser 대조에서 18파일/19 src 및 배너 배경 2개 외 node/attribute 차이 0, tools preview와 레이아웃 속성 유지. helper/provider/HomeBannerBinder 보호 파일은 미수정이다.
  • 2026-10-28 callback 감사: final-callback-audit.txt와 실제 callback body를 확인했다. Glide onLoadFailed 4곳은 false로 빈 SDK 오류 처리를 사용하며 직접 오류 이미지를 넣지 않는다. 이미지 picker의 onError는 Toast/업로드 상태 처리로 보존했다. 기존 CustomTarget onLoadCleared의 placeholder 매개변수와 구현은 이 제거 대상에 포함하지 않았다. 사용자 요청대로 자산·의존성·AGENTS·설정·API·인증 코드는 변경하지 않았다.
  • 2026-10-28 전달 상태: 수정 파일 정확한 전체 목록은 승인된 임시 루트 /var/folders/yh/8xsbvpsj5wg2qnxzxdp11_gm0000gn/T/opencode/image-placeholder-impl.X3myNy/changed-files.txt, 실행 판정은 같은 루트의 progress.md, 로그도 같은 루트에 있다. git diff --check exit 0. P2/P3의 구현 및 실행 증거만 완료 표시했으며 P4의 최종 완료 체크와 별도 최종 리뷰는 상위 실행자의 검토 전까지 미완료로 둔다. 커밋·브랜치 변경·worktree·cache wipe는 실행하지 않았다.
  • 2026-10-28 최종 수치: count-audit.log에서 PRD roster와 원본 117파일/170호출 완전 일치 및 Kotlin/Java placeholder·이미지 error/fallback·지정 XML src·runtime banner preview 검색 모두 0건(exit 1)을 확인했다. 전체 변경은 Kotlin 앱 119파일, XML 19파일, 테스트 7파일(신규 3), 기존 작업 문서 2파일, 합계 147파일이다. 소유 Task 검증 기록을 각 해당 Task 아래에 배치했다.
  • 2026-10-28 공유 검증 산출물 주의: 위 204클래스/1,616개는 해당 full test 명령 완료 직후 XML을 직접 집계한 값이다. 마지막 문서 확인 시 다른 실행자의 :app:testDebugUnitTest --rerun :app:assembleDebug 프로세스가 공유 XML을 갱신 중임을 확인했다. 그 프로세스는 중단하지 않고 추가 Gradle도 실행하지 않았으며 부분 XML을 새 완료/실패 증거로 사용하지 않았다. 상위 실행자의 최종 검증과 완료 판정을 기다린다.
  • 2026-10-28 독립 재검증 정정: ./gradlew :app:testDebugUnitTest :app:assembleDebug :app:ktlintCheck에서 test/build는 UP-TO-DATE, ktlint는 main/test source set의 기존 위반으로 실패했다. 로그 직접 집계 222개 진단/188파일이며 git diff의 추가·수정 줄과 교집합은 0건이다. 앞의 incremental lint 성공과 test-source 26건 기록을 전체 lint 통과로 해석하지 않는다. 주요 기존 위반은 underscore 패키지명, 기존 공백 및 줄바꿈, ChatRepositoryTest와 FanTalk 기존 테스트의 길이 등이다.
  • 2026-10-28 독립 전체 재실행: ./gradlew :app:testDebugUnitTest --rerun :app:assembleDebug 첫 실행에서 1,616개 중 V2AuthFlowTest.디버그 오디오는 POST 없이 실제 회원 조회를 재시도하고 서버 false와 설정 저장 뒤 한 번 완료한다의 844행 isAdultContentVisible assertion 1건 실패(3m 52s). 해당 인증 코드·테스트는 변경하지 않았다. 같은 클래스 단독 --tests 'kr.co.vividnext.sodalive.v2.auth.V2AuthFlowTest' --rerun은 33s 성공, 이어 전체 동일 명령 재실행은 2m 33s 성공했다. 최신 JUnit XML은 204클래스/1,616테스트/실패 0/오류 0/skipped 0이다. 원인은 확정하지 않았으며 비결정적 기존 영역 관찰로 남긴다.
  • 2026-10-28 최종 리뷰: Oracle이 전체 앱 diff·신규 테스트·호출자를 읽고 APPROVE했다. 리뷰 중 build/test를 다시 실행하지 않았으며 위 독립 실행 결과는 상위 실행자가 검증했다. 기기·계측·시각 QA 및 LSP는 실행하지 않았다. 문서만 수정한 단계에는 추가 테스트·Gradle task 조회를 수행하지 않는다.
  • 2026-10-28 단일 테스트 가이드에 신규 3개 클래스 명령을 추가했다. 이 가이드 외 앱 Kotlin 119파일, XML 19파일, 테스트 7파일(신규 3), 작업 문서 2파일, 리뷰 1파일로 총 변경 149파일이다. temporary log는 이 문서와 리뷰에 핵심 증거를 옮긴 뒤 소유 임시 경로만 정리한다. 앱 산출물과 기존 공유 cache는 유지한다.
  • 2026-10-28 정리 완료: 완료된 하위 작업을 확인하고 위 소유 임시 루트의 28개 임시 파일과 빈 디렉터리만 삭제했다. test ! -e로 경로 부재 확인. 앞의 임시 로그 경로는 실행 당시 기록이며 최종 증거 요약은 이 문서와 리뷰에 보존한다. 공유 Gradle cache, 앱 build/test 산출물 및 기존 worktree는 변경하지 않았다.
  • 2026-10-28 후속 커밋 요청 검증: /commit-with-validation 요청으로 커밋 승인을 확인했다. git diff --check exit 0, ./gradlew :app:testDebugUnitTest :app:assembleDebug exit 0, BUILD SUCCESSFUL in 1m 32s. 테스트 Task는 UP-TO-DATE로 기존 결과를 재사용했고 debug APK 빌드는 실행됐다. 전체 테스트 강제 재실행·린트·기기 QA는 추가 실행하지 않았으며 기존 린트 및 인증 테스트 관찰 기록은 유지한다.