Files
sodalive-android/docs/20261001_선물함_리스트_페이지/plan-task.md
T

75 KiB

선물함 리스트 페이지 구현 계획/TASK

For agentic workers: REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development 또는 superpowers:executing-plans to implement this plan task-by-task. 각 단계는 체크박스(- [ ])로 추적하고, 완료 즉시 - [x]로 갱신한다. 구현 범위 변경이 생기면 이 문서를 먼저 수정한 뒤 코드에 반영한다.

Goal: 로그인 사용자가 마이 탭에서 조건에 맞을 때 선물함으로 진입하고, 보낸 선물과 받은 선물 목록 및 각 item의 현재 상태를 확인할 수 있게 한다.

Architecture: 기존 kr.co.vividnext.sodalive.v2.gift 패키지의 GiftApi/GiftRepository/BaseViewModel/BaseActivity 패턴을 확장한다. API DTO와 repository는 데이터 계층에 두고, direction/status/date/empty/banner 및 마이 탭 진입점 노출 결정은 순수 Kotlin 정책으로 분리해 local unit test로 검증한다. 레거시 MyPageFragment는 사용자 승인 범위의 아이콘 추가와 Activity 연결만 최소 수정한다.

Tech Stack: Kotlin, Android XML Views, ViewBinding, RecyclerView, RxJava3 Single, Retrofit, Koin, JUnit4 local unit test.


전제와 성공 기준

  • PRD: docs/20261001_선물함_리스트_페이지/prd.md
  • Figma:
    • 보낸 선물 있음: 2481:19382
    • 보낸 선물 없음: 2520:35587
    • 받은 선물 없음: 2531:36283
    • 받은 선물 있음: 2531:36194
    • 받은 선물 상태별 카드: 2531:36237
  • 이번 범위:
    • 선물함 리스트 API GET /api/v2/gifts?type=ALL&page={page}&size=20.
    • direction 기반 보낸/받은 카드 UI 모델.
    • status 표시 문구, 날짜 라벨, empty/banner 정책.
    • 신규 선물함 Activity, adapter, layout, string/drawable resource.
    • pagination, refresh, error/retry 상태.
    • 한국 접속·한국어 유효 언어 조건의 마이 탭 첫 번째 선물함 진입점.
  • 제외 범위:
    • 선물 상세 화면 신규 구현.
    • API 미제공 필드 추정 표시.
    • SENT, RECEIVED 별도 호출.
    • app/src/androidTest, connectedDebugAndroidTest, 기기·에뮬레이터 UI 조작, 스크린샷·시각 QA.
  • 구현 완료 후 최소 다음 명령을 실행한다.
    • ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"
    • ./gradlew :app:mergeDebugResources
    • ./gradlew :app:compileDebugKotlin
    • ./gradlew :app:ktlintCheck
    • git diff --check

현재 상태

Phase 상태 완료 Task 활성/다음 Goal 차단 또는 남은 조건
1 완료 2/2 P1-GATE 통과 없음
2 완료 4/4 P2-GATE 통과 없음
3 완료 5/5 P3-GATE 통과 기기 시각 QA는 제외
4 완료 1/1 P4-GATE 통과 API 미제공 필드/시각 QA는 기존 제외 범위
5 완료 2/2 P5-GATE 통과 기기 시각 QA는 기존 제외 범위
6 완료 3/3 P6-GATE 통과 기기·스크린샷 QA는 기존 제외 범위

범위

포함

  • 선물함 리스트 API client/repository/ViewModel 연결.
  • page 0 최초 조회, 다음 page append, refresh, error/retry.
  • 보낸 선물/받은 선물 카드 UI 모델과 adapter view type 분기.
  • 고정 상단 내비게이션과 nav 아래 스크롤 콘텐츠 layout.
  • 진입 관점별 empty UI와 안내 배너.
  • 국가 코드 KR·유효 언어 ko 조건의 마이 탭 선물함 진입점.
  • 두 방향 카드의 상대방 이미지·닉네임 표시와 null/blank 이미지 placeholder 처리.

제외

  • 선물 상세 화면 신규 구현. 현재 상세 화면이 없으므로 item 터치 시 상태 표시 문구 toast만 제공한다.
  • API 미제공 필드인 canceledAt, recipientAddressDeadlineAt, sortAt의 추정 구현. 상대방 필드 3개는 계약이 제공되어 Phase 6에 포함한다.
  • 사용자 승인 범위인 MyPageFragment 선물함 진입점 최소 연결 외 레거시 파일 직접 수정.
  • UI/계측 테스트와 스크린샷 기반 visual QA.

기술적 제약

  • 기술 스택: Kotlin, XML View, ViewBinding, RxJava3, Retrofit, Koin.
  • 패키지: 신규 파일은 app/src/main/java/kr/co/vividnext/sodalive/v2/gift 하위에 작성한다.
  • API 패턴: 기존 GiftApi, GiftRepository, GiftSendRequestViewModel의 ApiResponse<T>와 Authorization header 패턴을 따른다.
  • 테스트 범위: app/src/test의 local unit test만 작성한다. layout 크기·간격·constraint 자체는 직접 테스트하지 않는다.
  • 정렬: 서버 응답 순서를 유지하고 클라이언트 재정렬을 넣지 않는다.
  • 날짜: 현재 API만 사용할 때 createdAt 기준 라벨을 표시한다. CANCELED 취소일 라벨은 canceledAt 제공 전까지 createdAt 기반 정책만 구현한다.
  • 민감정보: token, 내부 URL, 실제 사용자 닉네임을 log/fixture에 기록하지 않는다.

파일 구조

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftApi.kt
    • getGiftInbox(type, page, size, authHeader) endpoint를 추가한다.
  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepository.kt
    • 선물함 목록 조회 메서드를 추가한다.
  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt
    • 선물함 목록 response/item DTO를 추가한다.
  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxModels.kt
    • GiftInboxViewMode, GiftInboxDirection, GiftInboxStatus, card/banner/empty UI model을 정의한다.
  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt
    • DTO를 UI model로 변환하고 status/date/banner/empty 정책을 계산한다.
  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt
    • 최초 조회, append, refresh, retry, 상태 toast event, 문의 이동 event 상태를 관리한다.
  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxActivity.kt
    • header, RecyclerView, refresh, loading/error/navigation binding을 담당한다.
  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt
    • 안내 배너, 파란 배송지 배너, 보낸 카드, 받은 카드, empty/footer item view type을 표시한다.
  • Create: app/src/main/res/layout/activity_gift_inbox.xml
  • Create: app/src/main/res/layout/item_gift_inbox_sent.xml
  • Create: app/src/main/res/layout/item_gift_inbox_received.xml
  • Create: app/src/main/res/layout/item_gift_inbox_notice_banner.xml
  • Create: app/src/main/res/layout/item_gift_inbox_address_banner.xml
  • Create: app/src/main/res/layout/item_gift_inbox_empty_received.xml
  • Create 가능: app/src/main/res/drawable/bg_gift_inbox_*.xml
  • Modify: app/src/main/res/values/strings.xml, app/src/main/res/values-en/strings.xml, app/src/main/res/values-ja/strings.xml
  • Modify: app/src/main/AndroidManifest.xml
  • Modify: app/src/main/java/kr/co/vividnext/sodalive/di/AppDI.kt
    • GiftInboxViewModel Koin 등록을 추가한다.
  • Test: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenterTest.kt
  • Test: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModelTest.kt
  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxEntryPolicy.kt
    • 국가 코드와 유효 언어로 마이 탭 선물함 항목 노출 여부를 결정한다.
  • Test: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxEntryPolicyTest.kt
    • 국가·언어 조합과 마이 탭 아이콘·순서·라우팅 연결을 검증한다.
  • Modify: app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt
    • 승인된 레거시 최소 변경으로 기존 기능 아이콘 목록 첫 번째에 선물함을 조건부 추가한다.

Task TDD 작성 규칙

  • RED: 가장 작은 실패 test를 작성한다.
  • RED 확인: focused test를 실행해 요구 동작이 없어서 발생한 의도한 실패를 확인한다.
  • GREEN: RED를 통과시키는 최소 구현을 작성한다.
  • GREEN 확인: 같은 focused test를 다시 실행해 성공을 확인한다.
  • REFACTOR: 이번 Task가 만든 중복만 정리하고 focused test·직접 영향 회귀·lint 결과를 Progress에 기록한다.

Phase 1: API 계약과 순수 표시 정책

Phase 결과: API DTO/repository 계약과 선물함 카드 표시 정책을 local unit test로 검증할 수 있다.

선행조건: PRD GIFT-INBOX-API-*, GIFT-INBOX-STATUS-* 확정.

Phase 완료 조건: P1-T1, P1-T2, P1-GATE 완료, 검증 기록 누적.

구현 항목

Task 1.1 목록 API 계약 추가

Goal 실행 P1-T1: GiftApi와 GiftRepository에 type=ALL 선물함 목록 조회 계약을 추가한다.

  • 시작 조건: 기존 GiftApi, GiftRepository, GiftModels.kt 패턴 확인 완료.
  • 완료 증거: repository 테스트 double에서 type=ALL, page, size, auth header 전달이 검증된다.
  • 범위 밖: ViewModel 상태 관리와 실제 UI 렌더링.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftApi.kt
  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftRepository.kt
  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt
  • Test: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModelTest.kt

Interfaces:

  • Produces: GiftInboxResponse(totalCount, items, page, size, hasNext)

  • Produces: GiftInboxItemResponse(applicationNo, direction, status, statusName, priceCan, categoryName, sizeName, createdAt)

  • Produces: GiftRepository.getGiftInbox(type: String = "ALL", page: Int, size: Int, token: String)

  • RED: fake API가 받은 type, page, size, authHeader를 기록하고, 첫 조회가 ALL/0/20이 아니면 실패하는 테스트를 작성한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest"를 실행해 신규 DTO/repository method 부재로 실패를 확인한다.

  • GREEN: GiftApi.getGiftInbox(@Query("type"), @Query("page"), @Query("size"), @Header("Authorization")), DTO, repository method를 최소 구현한다.

  • GREEN 확인: 같은 focused test를 다시 실행해 PASS를 확인한다.

  • REFACTOR: 기존 gift API naming과 import 스타일만 맞추고 focused test 결과를 Progress에 기록한다.

검증 기록 (2026-10-01): 위 focused 명령 RED compileDebugUnitTestKotlin FAILED(4초, GiftInboxResponse/getGiftInbox 부재), GREEN BUILD SUCCESSFUL(16초). repository는 호출자가 다른 type/size를 전달하지 못하도록 page/token만 받고 ALL/20을 고정한다. 기존 전송 테스트 fake에 신규 API 미사용 구현만 추가했다.

Task 1.2 카드 표시 정책 presenter 추가

Goal 실행 P1-T2: direction/status/date/empty/banner를 화면 UI 모델로 변환하는 순수 정책을 만든다.

  • 시작 조건: P1-T1 DTO contract 완료.
  • 완료 증거: 보낸/받은 카드 status mapping, 날짜 라벨, section title 미노출 정책 테스트 PASS.
  • 범위 밖: RecyclerView adapter와 Android resource binding.

Files:

  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxModels.kt
  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt
  • Test: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenterTest.kt

Interfaces:

  • Produces: GiftInboxCardUiModel.Sent

  • Produces: GiftInboxCardUiModel.Received

  • Produces: GiftInboxPresenter.toUiModels(items, viewMode)

  • Produces: GiftInboxPresenter.hasAddressRequiredGift(cards)

  • RED: direction=SENT와 status=RECEIVED item이 운송장 등록 필요 보낸 카드로 변환되는 테스트를 작성한다.

  • RED: direction=RECEIVED와 status=TRACKING_REGISTERED item이 배송지 입력 필요/전달 예정 받은 카드로 변환되는 테스트를 작성한다.

  • RED: 변환 결과 어디에도 신청 내역, 선물 내역 section title이 포함되지 않는 테스트를 작성한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"를 실행해 신규 presenter 부재로 실패를 확인한다.

  • GREEN: enum parsing 없이 문자열 status를 요구사항 표대로 매핑하는 최소 presenter를 구현한다.

  • GREEN 확인: 같은 focused test를 다시 실행해 PASS를 확인한다.

  • REFACTOR: 중복 status map만 private helper로 정리하고 focused test 결과를 Progress에 기록한다.

검증 기록 (2026-10-01): presenter RED compileDebugUnitTestKotlin FAILED(4초, presenter/리소스 부재), 두 focused 클래스 GREEN BUILD SUCCESSFUL(45초). 보낸 7개/받은 5개 상태, 미지 상태 서버명, createdAt 신청일, 서버 순서, 배너/empty 정책을 7개 테스트로 확인했다. 단순 when 매핑으로 별도 중복 helper는 불필요했다.

완료 조건

  • P1-T1, P1-T2 체크박스와 완료 증거가 모두 충족됐다.
  • API 미제공 필드가 production 추정 구현으로 들어가지 않았다.

검증 방법

Phase 1 Gate

Goal 실행 P1-GATE: API 계약과 표시 정책을 최종 판정한다.

./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest"

Expected: 두 테스트 클래스가 BUILD SUCCESSFUL로 통과하고, type=ALL, direction 분기, status mapping, section title 미노출이 검증된다.


Phase 2: ViewModel 목록 상태와 pagination

Phase 결과: 선물함 화면 상태가 최초 조회, append, refresh, error/retry를 안정적으로 제공한다.

선행조건: P1-GATE 완료.

Phase 완료 조건: P2-T1~P2-T4, P2-GATE 완료, 검증 기록 누적.

구현 항목

Task 2.1 ViewModel 최초 조회 상태 구현

Goal 실행 P2-T1: 화면 진입 시 page 0을 조회하고 loading/content/empty/error 상태를 노출한다.

  • 시작 조건: P1-GATE 완료.
  • 완료 증거: 최초 조회 테스트 PASS.
  • 범위 밖: append와 refresh.

Files:

  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt
  • Modify: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModelTest.kt

Interfaces:

  • Produces: GiftInboxUiState.Loading, Content, Empty, Error

  • Produces: GiftInboxViewModel.loadFirstPage(viewMode)

  • RED: loadFirstPage()가 page 0/size 20/type ALL을 요청하고 content 상태를 내보내는 테스트를 작성한다.

  • RED 확인: focused test를 실행해 ViewModel 부재 또는 state mismatch 실패를 확인한다.

  • GREEN: 기존 BaseViewModel과 Rx scheduler 패턴을 따라 최소 상태를 구현한다.

  • GREEN 확인: 같은 focused test PASS를 확인한다.

  • REFACTOR: 상태 class 이름과 기존 gift 테스트 스타일을 정리하고 Progress에 기록한다.

검증 기록 (2026-10-01): GiftInboxViewModelTest에서 Phase 2와 클릭 event 계약을 함께 먼저 작성했다. RED GiftInboxViewModel/GiftInboxUiState 부재로 3초 실패, GREEN 18초 성공. 로딩, content, empty, 재진입 중복 방지를 검증했다.

Task 2.2 다음 page append 구현

Goal 실행 P2-T2: hasNext=true일 때 하단 도달 이벤트로 다음 page를 추가 조회한다.

  • 시작 조건: P2-T1 완료.
  • 완료 증거: page 1 append와 중복 요청 방지 테스트 PASS.
  • 범위 밖: RecyclerView scroll listener wiring.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt

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

  • RED: hasNext=true content 후 loadNextPage() 호출 시 page 1이 요청되고 기존 item 뒤에 append되는 테스트를 작성한다.

  • RED: append loading 중 loadNextPage()를 다시 호출해도 중복 요청하지 않는 테스트를 작성한다.

  • RED 확인: focused test 실패를 확인한다.

  • GREEN: currentPage, hasNext, isAppending 상태를 최소 구현한다.

  • GREEN 확인: focused test PASS를 확인한다.

  • REFACTOR: append 실패와 최초 실패가 섞이지 않도록 상태 이름을 정리하고 Progress에 기록한다.

검증 기록 (2026-10-01): P2-T1과 같은 RED/GREEN 실행에서 page 1, 기존 순서 append, pending Single 중복 방지, hasNext=false 종료를 검증했다.

Task 2.3 pull-to-refresh 정책 구현

Goal 실행 P2-T3: refresh가 가능한 UI에서 page 0을 다시 조회하고 기존 목록을 교체한다.

  • 시작 조건: P2-T1 완료.
  • 완료 증거: refresh reset 테스트 PASS.
  • 범위 밖: SwipeRefreshLayout layout wiring.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt

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

  • RED: 기존 page 1까지 append된 상태에서 refresh()가 page 0을 요청하고 목록을 새 응답으로 교체하는 테스트를 작성한다.

  • RED 확인: focused test 실패를 확인한다.

  • GREEN: refresh()를 page 0 재조회와 state reset으로 최소 구현한다.

  • GREEN 확인: focused test PASS를 확인한다.

  • REFACTOR: 최초 로딩과 refresh 로딩 flag를 구분하고 Progress에 기록한다.

검증 기록 (2026-10-01): P2-T1 RED/GREEN에서 page 0 교체, 기존 콘텐츠 유지, refresh flag, SerialDisposable로 취소된 append의 늦은 응답 무시를 검증했다. 기존 SwipeRefreshLayout 1.1.0 의존성을 재사용한다.

Task 2.4 오류와 재시도 정책 구현

Goal 실행 P2-T4: 첫 페이지 실패와 append 실패를 구분하고 재시도를 제공한다.

  • 시작 조건: P2-T1, P2-T2 완료.
  • 완료 증거: 첫 페이지 실패, append 실패, retry 테스트 PASS.
  • 범위 밖: Toast resource와 layout 표시.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt

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

  • RED: 첫 페이지 API 실패 시 Error 상태와 retry 가능 상태가 되는 테스트를 작성한다.

  • RED: append 실패 시 기존 content를 유지하고 toast event만 발생하는 테스트를 작성한다.

  • RED 확인: focused test 실패를 확인한다.

  • GREEN: 첫 페이지 retry와 append retry를 최소 구현한다.

  • GREEN 확인: focused test PASS를 확인한다.

  • REFACTOR: toast event consume 정책을 기존 ToastMessage 패턴에 맞추고 Progress에 기록한다.

검증 기록 (2026-10-01): P2-T1 RED/GREEN에서 첫 실패 retry=0, append 실패 retry=1, refresh 실패 retry=0, 콘텐츠 보존, 실패 후 자동 중복 retry 차단, 토스트 1회 소비를 검증했다.

검증 방법

Phase 2 Gate

Goal 실행 P2-GATE: ViewModel 목록 상태와 pagination을 최종 판정한다.

./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest"

Expected: 최초 조회, append, refresh, error/retry 테스트가 BUILD SUCCESSFUL로 통과한다.


Phase 3: Activity, adapter, resource UI 연결

Phase 결과: 고정 상단 내비게이션 아래에서 선물함 콘텐츠가 스크롤되고, 카드/배너/빈 상태/문의 버튼이 Figma 기준 구조로 표시된다.

선행조건: P2-GATE 완료.

Phase 완료 조건: P3-T1~P3-T5, P3-GATE 완료, 검증 기록 누적.

구현 항목

Task 3.1 RecyclerView adapter와 view type 구현

Goal 실행 P3-T1: 보낸 카드, 받은 카드, 안내 배너, empty/footer item을 표시하는 adapter를 만든다.

  • 시작 조건: P1-T2 UI model 완료.
  • 완료 증거: adapter view type 분기 테스트 또는 presenter item type 테스트 PASS.
  • 범위 밖: Activity wiring.

Files:

  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt

  • Create: app/src/main/res/layout/item_gift_inbox_sent.xml

  • Create: app/src/main/res/layout/item_gift_inbox_received.xml

  • Create: app/src/main/res/layout/item_gift_inbox_notice_banner.xml

  • Create: app/src/main/res/layout/item_gift_inbox_address_banner.xml

  • Create: app/src/main/res/layout/item_gift_inbox_empty_received.xml

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

  • RED: presenter가 SENT_CARD, RECEIVED_CARD, NOTICE_BANNER, ADDRESS_BANNER, EMPTY_RECEIVED item type을 필요한 순서로 만드는 테스트를 작성한다.

  • RED 확인: focused test 실패를 확인한다.

  • GREEN: adapter와 item layout을 최소 구현하고 presenter item type 생성을 통과시킨다.

  • GREEN 확인: focused test PASS와 ./gradlew :app:mergeDebugResources PASS를 확인한다.

  • REFACTOR: view holder 중복 bind helper만 정리하고 Progress에 기록한다.

검증 기록 (2026-10-01): item 순서 RED/GREEN은 P1-T2에 포함했다. 추가 footer RED는 isAppending/canRetry/LOADING/RETRY 부재로 3초 실패했다. Activity 연결 후 두 focused 클래스+merge+compile 명령이 49초 성공했다. ViewBinding holder와 ListAdapter DiffUtil을 사용한다.

Task 3.2 Activity layout과 고정 header 구현

Goal 실행 P3-T2: 상단 선물함 뒤로가기 header를 고정하고, 아래 콘텐츠만 스크롤되게 만든다.

  • 시작 조건: P2-GATE, P3-T1 완료.
  • 완료 증거: resource merge/compile PASS, read-only layout 대조 완료.
  • 범위 밖: 기기 UI 조작과 screenshot 검증.

Files:

  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxActivity.kt

  • Create: app/src/main/res/layout/activity_gift_inbox.xml

  • Modify: app/src/main/AndroidManifest.xml

  • Modify: app/src/main/res/values/strings.xml

  • Modify: app/src/main/res/values-en/strings.xml

  • Modify: app/src/main/res/values-ja/strings.xml

  • TDD 예외 사유: header 고정과 scroll 영역 분리는 Android layout 구조이며 local unit test가 동작을 직접 검증하지 못한다.

  • 대체 검증 방법: layout root에서 header와 refresh/recycler content가 sibling인지 read-only 대조하고 resource merge/compile로 binding을 검증한다.

  • GREEN: BaseActivity<ActivityGiftInboxBinding>, title 선물함, back click finish(), RecyclerView, optional SwipeRefreshLayout을 연결한다.

  • GREEN 확인: ./gradlew :app:mergeDebugResources와 ./gradlew :app:compileDebugKotlin PASS를 확인한다.

  • REFACTOR: Activity method를 setup/bind/observe 단위로만 정리하고 Progress에 기록한다.

검증 기록 (2026-10-01): 49초 통합 focused 실행에서 merge/compile 성공. XML 최상위 LinearLayout의 header와 content FrameLayout이 sibling이며 RecyclerView가 별도 스크롤 소유자임을 대조했다. 초기 오류는 content 영역, append/refresh 오류 버튼과 문의는 스크롤 행이다. manifest와 Koin 등록을 추가했다.

Task 3.3 빈 상태와 배너 정책 연결

Goal 실행 P3-T3: 진입 관점과 사용자 유형별 empty UI, 안내/배송지 입력 배너를 화면에 연결한다.

  • 시작 조건: P3-T1, P3-T2 완료.
  • 완료 증거: presenter empty/banner 테스트 PASS, resource compile PASS.
  • 범위 밖: API 미제공 deadline 계산.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxActivity.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt

  • Modify: app/src/main/res/values/strings.xml

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

  • RED: SENT 관점 빈 목록은 안전 배송 안내 배너만 만드는 테스트를 작성한다.

  • RED: RECEIVED 관점 빈 목록은 받은 선물 empty title/body/button item을 만드는 테스트를 작성한다.

  • RED: ALL 관점 전체 빈 목록에서 사용자 유형이 creator이면 받은 선물 empty, 일반 회원이면 보낸 선물 empty를 만드는 테스트를 작성한다.

  • RED: TRACKING_REGISTERED 받은 선물이 있으면 배송지 입력 안내 배너가 첫 대상 상태 문구를 들고 생성되는 테스트를 작성한다.

  • RED 확인: focused test 실패를 확인한다.

  • GREEN: empty/banner item 생성을 최소 구현하고 Activity click event를 ViewModel 상태 toast event로 전달한다.

  • GREEN 확인: focused test와 resource compile PASS를 확인한다.

  • REFACTOR: deadline 미제공 정책을 주석이 아닌 모델 이름으로 표현하고 Progress에 기록한다.

검증 기록 (2026-10-01): P1-T2의 empty/banner RED/GREEN 및 49초 UI 통합 focused 검증에 포함했다. Activity는 SharedPreferenceManager.role == MemberRole.CREATOR.name을 사용한다. 모델에는 마감일/남은 일수 필드가 없고 숫자 없는 안내만 표시한다.

Task 3.4 item 터치 상태 toast 연결

Goal 실행 P3-T4: 카드와 배송지 입력 배너 탭 시 상세 이동 대신 item 상태 표시 문구 toast event를 발생시킨다.

  • 시작 조건: P2-GATE, P3-T1 완료.
  • 완료 증거: 상태 toast event 테스트 PASS.
  • 범위 밖: 상세 화면 신규 구현.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxActivity.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt

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

  • RED: 카드 클릭 시 item 상태 표시 문구가 포함된 toast event가 한 번 소비되는 테스트를 작성한다.

  • RED: 배송지 입력 배너 클릭 시 첫 배송지 입력 필요 선물의 상태 표시 문구 toast event가 한 번 소비되는 테스트를 작성한다.

  • RED 확인: focused test 실패를 확인한다.

  • GREEN: toastLiveData 또는 기존 ToastMessage event와 consume method를 최소 구현한다.

  • GREEN 확인: focused test PASS를 확인한다.

  • REFACTOR: 상세 화면이 생기면 교체할 수 있도록 click handling을 한 함수 경계에만 격리하고 Progress에 남긴다.

검증 기록 (2026-10-01): P2-T1 RED/GREEN에 클릭 event 계약 포함. 카드/배송지 배너 모두 onCardClick으로 연결하고 상태 resource를 ToastMessage로 1회 소비한다. 상세 화면 이동은 없다.

Task 3.5 카카오 문의하기 이동 연결

Goal 실행 P3-T5: 받은 선물 empty 또는 리스트 하단의 의견 남기기/문의하기 버튼을 설정 페이지의 카카오 문의하기와 동일한 페이지로 연결한다.

  • 시작 조건: 설정 페이지의 카카오 문의하기 이동 패턴 확인 완료.
  • 완료 증거: routing 함수 또는 event 테스트 PASS, compile PASS.
  • 범위 밖: 신규 문의 화면 구현.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxViewModel.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxActivity.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt

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

  • RED: 의견/문의 버튼 클릭 시 카카오 문의하기 이동 event가 한 번 소비되는 테스트를 작성한다.

  • RED 확인: focused test 실패를 확인한다.

  • GREEN: 설정 페이지의 카카오 문의하기와 동일한 intent/URL 패턴을 재사용한다.

  • GREEN 확인: focused test와 compile PASS를 확인한다.

  • REFACTOR: 버튼 위치는 Figma와 기존 앱 정책을 따르되 이동 대상은 설정 페이지 카카오 문의하기와 동일함을 Progress에 기록한다.

검증 기록 (2026-10-01): ServiceCenterActivity 43~49행을 읽고 그대로 ACTION_VIEW와 공개 카카오 문의 URL을 재사용했다. P2-T1 RED/GREEN의 Robolectric local test에서 Intent action/data 및 1회 소비를 검증했다. 레거시 파일은 수정하지 않았다.

검증 방법

Phase 3 Gate

Goal 실행 P3-GATE: Activity/resource/UI 연결을 최종 판정한다.

./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest"
./gradlew :app:mergeDebugResources
./gradlew :app:compileDebugKotlin

Expected: 테스트와 resource/compile이 성공하고, read-only 대조에서 header/content가 분리되어 있으며 신청 내역, 선물 내역 노출용 문자열이 없다.


Phase 4: 통합 검증과 문서 갱신

회귀 수정 Task P4-FIX-1: 신규 코드 포맷 검증

  • P4-FIX-1: AppDI.kt 신규 인접 등록 들여쓰기, GiftInboxPresenter.kt else 블록, GiftInboxAdapter.kt 긴 리소스 분기 줄을 수정한다.
  • 발견: 최초 전체 gift+merge+compile+ktlint 실행(11초)에서 ktlint 9개 위반. 대상 모두 이번 구현 줄이며 기존 소스 전체 포맷은 변경하지 않는다.
  • 회귀 검증/완료 증거: 동일 gift 테스트 및 merge/compile/ktlintCheck 재실행, git diff --check exit 0.

완료 증거 (2026-10-01): 전체 gift+merge+compile+ktlint 재실행 BUILD SUCCESSFUL in 17s, 46 tasks(8 executed/38 up-to-date). git diff --check 출력 없음, exit 0. 기존 파일의 무관한 포맷은 변경하지 않았다.

Phase 결과: 선물함 리스트 구현 범위가 PRD 요구사항과 검증 명령으로 추적된다.

선행조건: P1-GATE, P2-GATE, P3-GATE 완료.

검증 방법

Phase 4 Gate

Goal 실행 P4-GATE: 전체 gift package와 Android resource/compile/lint를 최종 판정한다.

  • 전체 gift local unit test 49개 통과(실패/오류/skip 0).
  • mergeDebugResources, compileDebugKotlin, ktlintCheck 통과.
  • git diff --check 통과 및 실행 문서 갱신.
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"
./gradlew :app:mergeDebugResources
./gradlew :app:compileDebugKotlin
./gradlew :app:ktlintCheck
git diff --check

Expected: 모든 명령이 exit code 0으로 종료된다. 실패가 있으면 실패 소유 Task 아래에 회귀 수정 Task를 추가한 뒤 수정한다.


Phase 5: 마이 탭 선물함 진입점

Phase 결과: 한국에서 접속하고 앱의 유효 언어가 한국어인 로그인 사용자는 마이 탭 첫 번째 기능 아이콘으로 기본 ALL 선물함에 진입한다.

선행조건: PRD GIFT-INBOX-ENTRY-001~003, DEC-008, DEC-009 확정 및 레거시 최소 수정 승인.

Phase 완료 조건: P5-T1, P5-T2, P5-GATE 완료, 검증 기록 누적.

구현 항목

Task 5.1 국가·언어 노출 정책 추가

Goal 실행 P5-T1: 국가 코드 KR과 유효 언어 ko를 모두 충족할 때만 선물함 진입점을 표시하는 순수 정책을 만든다.

  • 시작 조건: SharedPreferenceManager.countryCode와 LanguageManager.getEffectiveLanguage(context) 기존 계약 확인 완료.
  • 완료 증거: 네 가지 국가·언어 조합과 빈 국가 코드 기본값 local unit test PASS.
  • 범위 밖: 마이 탭 UI 연결과 Activity 실행.

Files:

  • Create: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxEntryPolicy.kt
  • Create: app/src/test/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxEntryPolicyTest.kt

Interface:

object GiftInboxEntryPolicy {
    fun shouldShow(countryCode: String, languageCode: String): Boolean
}
  • RED: KR/ko만 true이고 KR/en, JP/ko, JP/ja는 false이며 빈 국가 코드와 ko는 true인 테스트를 작성한다.
class GiftInboxEntryPolicyTest {
    @Test
    fun `한국 접속이고 유효 언어가 한국어일 때만 표시한다`() {
        assertTrue(GiftInboxEntryPolicy.shouldShow("KR", "ko"))
        assertFalse(GiftInboxEntryPolicy.shouldShow("KR", "en"))
        assertFalse(GiftInboxEntryPolicy.shouldShow("JP", "ko"))
        assertFalse(GiftInboxEntryPolicy.shouldShow("JP", "ja"))
    }

    @Test
    fun `빈 국가 코드는 기존 정책대로 한국으로 처리한다`() {
        assertTrue(GiftInboxEntryPolicy.shouldShow("", "ko"))
        assertFalse(GiftInboxEntryPolicy.shouldShow("", "en"))
    }
}
  • RED 준비: 테스트가 컴파일되도록 GiftInboxEntryPolicy.shouldShow가 항상 false를 반환하는 최소 placeholder를 만든다.
  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxEntryPolicyTest"를 실행해 KR/ko와 빈 국가 코드/ko assertion이 의도대로 실패하는지 확인한다.
  • GREEN: 다음 최소 정책을 구현한다.
package kr.co.vividnext.sodalive.v2.gift

import kr.co.vividnext.sodalive.settings.language.LanguageManager

object GiftInboxEntryPolicy {
    fun shouldShow(countryCode: String, languageCode: String): Boolean =
        countryCode.ifBlank { "KR" } == "KR" && languageCode == LanguageManager.LANG_KO
}
  • GREEN 확인: 같은 focused test를 다시 실행해 PASS를 확인한다.
  • REFACTOR: 조건을 다른 화면이나 공통 계층으로 확장하지 않고 focused test 결과를 Progress에 기록한다.

검증 기록 (2026-10-01): false placeholder에서 focused test 2개가 지정 assertion으로 RED(BUILD FAILED in 1m 22s)를 확인했다. countryCode.ifBlank { "KR" } == "KR" && languageCode == LanguageManager.LANG_KO만 구현한 뒤 동일 명령이 GREEN(BUILD SUCCESSFUL in 13s)으로 통과했다.

Task 5.2 마이 탭 첫 번째 아이콘과 라우팅 연결

Goal 실행 P5-T2: 기존 기능 아이콘 목록의 첫 번째에 선물함 항목을 조건부 추가하고 기본 ALL 선물함으로 이동한다.

  • 시작 조건: P5-T1 완료 및 MyPageFragment 최소 직접 수정 사용자 승인.
  • 완료 증거: source contract test, focused policy test, resource merge, Kotlin compile PASS.
  • 범위 밖: 기능 아이콘 layout·adapter 변경, 비로그인 마이 탭 정책 변경, 별도 SENT/RECEIVED 진입점.

Files:

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

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt

  • Reuse: app/src/main/res/drawable-xxhdpi/ic_my_present.png

  • Reuse: app/src/main/res/values/strings.xml의 gift_inbox_title

  • RED: MyPageFragment source에서 ic_my_present가 ic_my_storage보다 앞에 있고, gift_inbox_title, LanguageManager.getEffectiveLanguage(requireContext()), GiftInboxActivity.newIntent(requireContext()) 연결이 존재하는 contract test를 작성한다.

@Test
fun `마이 탭은 조건부 선물함을 첫 번째 아이콘으로 연결한다`() {
    val source = projectFile(
        "app/src/main/java/kr/co/vividnext/sodalive/mypage/MyPageFragment.kt"
    ).readText()
    val function = source
        .substringAfter("private fun buildFunctionButtonItems")
        .substringBefore("private fun showAuthDialog")

    val presentIndex = function.indexOf("R.drawable.ic_my_present")
    val storageIndex = function.indexOf("R.drawable.ic_my_storage")
    assertTrue(presentIndex >= 0)
    assertTrue(storageIndex >= 0)
    assertTrue(presentIndex < storageIndex)
    val giftBlock = function.substringBefore("R.drawable.ic_my_storage")
    assertTrue(giftBlock.contains("GiftInboxEntryPolicy.shouldShow("))
    assertTrue(giftBlock.contains("SharedPreferenceManager.countryCode"))
    assertTrue(giftBlock.contains("LanguageManager.getEffectiveLanguage(requireContext())"))
    assertTrue(giftBlock.contains("R.string.gift_inbox_title"))
    assertTrue(giftBlock.contains("GiftInboxActivity.newIntent(requireContext())"))
}

private fun projectFile(path: String): File =
    if (File("app").isDirectory) File(path) else File("../$path")
  • RED 확인: focused test를 실행해 신규 마이 탭 연결 부재로 실패를 확인한다.
  • GREEN: buildFunctionButtonItems의 items를 빈 mutable list로 시작하고 다음 조건부 항목을 먼저 추가한 뒤 기존 storage/block 목록을 그대로 append한다.
if (
    GiftInboxEntryPolicy.shouldShow(
        countryCode = SharedPreferenceManager.countryCode,
        languageCode = LanguageManager.getEffectiveLanguage(requireContext())
    )
) {
    items += FunctionButtonItem(
        iconRes = R.drawable.ic_my_present,
        title = getString(R.string.gift_inbox_title)
    ) {
        startActivity(GiftInboxActivity.newIntent(requireContext()))
    }
}
  • GREEN 확인: focused test와 :app:mergeDebugResources, :app:compileDebugKotlin을 실행해 PASS를 확인한다.
  • REFACTOR: MyPageFragment에서 이번 항목 외 기존 아이콘 순서·조건·클릭 코드는 변경하지 않고 diff를 확인한다.

검증 기록 (2026-10-01): source contract 추가 후 focused test 3개 중 마이 탭 연결 1개가 ic_my_present 부재 assertion으로 RED(BUILD FAILED in 5s)를 확인했다. 승인된 import 3개와 조건부 첫 항목만 추가한 뒤 focused test GREEN(BUILD SUCCESSFUL in 15s), resource merge·Kotlin compile GREEN(BUILD SUCCESSFUL in 1s)을 확인했다. codegraph 재대조에서 선물함 항목 뒤에 기존 storage/block 순서와 callback이 유지됨을 확인했다.

검증 방법

Phase 5 Gate

Goal 실행 P5-GATE: 진입점 정책·연결과 기존 gift 회귀를 최종 판정한다.

  • GiftInboxEntryPolicyTest 3개와 전체 gift local unit test 53개 통과.
  • mergeDebugResources, compileDebugKotlin, ktlintCheck 통과.
  • git diff --check HEAD 통과 및 Phase 5 검증 기록 갱신.
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxEntryPolicyTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*"
./gradlew :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck
git diff --check HEAD

Expected: 모든 명령이 exit code 0이고, 정책 테스트에서 한국/한국어만 표시되며 source contract에서 ic_my_present·선물함·첫 번째 순서·GiftInboxActivity 기본 진입이 확인된다.

완료 증거 (2026-10-01): 전체 gift test·resource merge·Kotlin compile·ktlint를 함께 실행해 exit 0, BUILD SUCCESSFUL in 12s를 확인했다. XML 보고서 기준 GiftInboxEntryPolicyTest 3개와 기존 gift 50개, 총 53개가 failures/errors/skipped=0이다. git diff --check HEAD도 exit 0, 출력 없음이다.


Phase 6: 상대방 프로필 표시

Phase 결과: SENT는 수신 크리에이터, RECEIVED는 발신 팬의 이미지·닉네임을 표시한다.

선행조건: P5-GATE 완료, PRD GIFT-INBOX-PROFILE-001~003, DEC-010 확정. EXT-001은 API 계약 제공으로 해결됐으며 앱 구현은 아직 미완료다.

Phase 완료 조건: P6-T1, P6-T2, P6-T3, P6-GATE 완료 및 각 검증 증거 누적.

구현 경로: GiftInboxItemResponse → GiftInboxPresenter → GiftInboxCardUiModel → GiftInboxAdapter. 기존 Coil과 ic_placeholder_profile을 재사용하며 공통 abstraction·dependency·상세 Activity·deeplink는 추가하지 않는다.

구현 항목

Task 6.1 프로필 매핑 회귀 테스트

Goal 실행 P6-T1: 두 방향의 프로필 매핑과 이미지 URL 정규화 요구를 실패 테스트로 고정한다.

Files:

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

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

  • RED: SENT 수신 크리에이터와 RECEIVED 발신 팬 fixture에 서로 다른 가상 ID·닉네임·유효 URL을 넣고 각 카드 UI 모델의 세 값이 응답과 같은지 검증한다.

  • RED: 두 방향 모두 이미지 URL null, "", " "을 null로 정규화하고 유효 URL은 그대로 유지하는 테스트를 작성한다.

  • 기존 ViewModel의 ALL/0/20, pagination, 카드 클릭 상태 toast 테스트를 유지하고 필수 상대방 필드가 추가되는 fixture만 보완한다.

  • RED 확인: 아래 focused 명령으로 신규 프로필 계약 부재에 따른 실패를 확인하고 원인을 이 Task 아래 기록한다.

P6-T1 RED 검증 기록 (2026-10-01): ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" 실행 결과 GiftInboxCardUiModel의 counterpartMemberId, counterpartNickname, counterpartProfileImageUrl unresolved reference 및 GiftInboxItemResponse 추가 생성자 인자 오류로 :app:compileDebugUnitTestKotlin이 실패했다. 생산 코드는 수정하지 않았다.

./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest"

Task 6.2 DTO·카드 모델·presenter 구현

Goal 실행 P6-T2: P6-T1의 실패를 통과시키는 최소 프로필 매핑을 구현한다.

Files:

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/data/GiftModels.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxModels.kt

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt

  • GREEN: GiftInboxItemResponse와 두 방향 GiftInboxCardUiModel에 counterpartMemberId: Long, counterpartNickname: String, counterpartProfileImageUrl: String?를 반영한다.

  • GREEN: presenter에서 ID·닉네임은 그대로 전달하고 이미지 URL은 counterpartProfileImageUrl?.takeIf { it.isNotBlank() }로 정규화한다. 역할 라벨 대신 API 닉네임을 사용하며 상태·날짜·direction 정책은 유지한다.

  • GREEN 확인: P6-T1 focused 명령이 BUILD SUCCESSFUL인지 확인하고 결과를 이 Task 아래 기록한다.

P6-T2 GREEN 검증 기록 (2026-10-01): ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" 실행 결과 BUILD SUCCESSFUL로 완료됐다. ID·닉네임 직접 전달, null/blank 이미지 URL 정규화, 기존 status/date/direction/addressRequired 동작을 focused 테스트에서 확인했다.

Task 6.3 XML·adapter 프로필 바인딩

Goal 실행 P6-T3: 기존 카드 구조와 클릭 동작을 보존하며 이미지·닉네임을 바인딩한다.

Files:

  • Modify: app/src/main/res/layout/item_gift_inbox_sent.xml

  • Modify: app/src/main/res/layout/item_gift_inbox_received.xml

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/ui/GiftInboxAdapter.kt

  • 두 카드 프로필 행을 이미지·닉네임으로 연결한다. SENT는 프로필 아래 sizeName · categoryName, RECEIVED는 상단 프로필·날짜와 본문 상태를 유지한다.

  • 기존 Coil로 정규화된 URL을 매 bind마다 로드하고 ic_placeholder_profile을 placeholder/fallback/error에 사용한다. null/blank도 바인딩해 재활용된 이전 이미지를 남기지 않는다.

  • 카드 클릭은 기존 상태 toast callback을 유지한다. 사용자 선택에 따라 상세 화면·프로필 화면·deeplink를 만들지 않는다.

  • TDD 예외 및 대체 검증: XML 배치·이미지 binding은 크기·간격·constraint·visibility 테스트 없이 read-only 대조와 resource merge·Kotlin compile로 확인하고 이 Task 아래 기록한다. 기기·스크린샷 QA는 수행하지 않는다.

P6-T3 검증 기록 (2026-10-01): ./gradlew :app:mergeDebugResources :app:compileDebugKotlin 실행 결과 exit 0, BUILD SUCCESSFUL in 24s(24 tasks: 10 executed, 14 up-to-date)를 확인했다. 기존 ImageView/TextView에 counterpart_profile_image·counterpart_nickname ID를 추가하고 고정 역할 문구만 제거했다. 양쪽 bind에서 API 닉네임과 counterpartProfileImageUrl ?: R.drawable.ic_placeholder_profile을 연결하고 placeholder/fallback/error를 같은 drawable로 지정했다. 소스 대조에서 기존 크기·간격·Typography·계층·접근성·chevron, 보낸 카드 status/date/details, 받은 카드 date/status/subtitle 및 root의 onCardClick(card)를 그대로 유지했다. LSP 도구가 없어 Kotlin 컴파일로 바인딩을 검증했으며 기기·스크린샷 QA는 실행하지 않았다. 기존 무관한 파일의 MediaRecorder deprecated 및 annotation target 경고는 수정하지 않았다.

P6-T3 공백 검증: 수정한 XML 2개·adapter·본 계획 문서를 대상으로 git diff --check -- <4개 대상 경로>를 실행해 exit 0, 출력 없음을 확인했다.

검증 방법

Phase 6 Gate

Goal 실행 P6-GATE: 프로필 요구와 기존 목록 동작의 회귀를 최종 판정한다.

  • P6-T1~P6-T3 완료 증거와 focused presenter/ViewModel 테스트 PASS를 확인한다.
  • 전체 gift local unit test를 실행하고 기존 53개 기준 회귀와 신규 프로필 테스트의 실제 총수·실패 수를 기록한다.
  • resource merge, Kotlin compile, ktlintCheck, git diff --check HEAD가 모두 exit 0인지 확인한다.
  • GET /api/v2/gifts?type=ALL&page=0&size=20, direction 렌더링, pagination, 상태 toast 보존을 대조하고 PRD 14.5와 검증 기록을 갱신한다.
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck
git diff --check HEAD

Expected: 모든 명령이 exit 0으로 종료되고 두 방향 프로필 매핑·null/blank 정규화·기존 조회/클릭 회귀가 통과한다. 이 단계는 구현 계획이며 아직 실행 결과가 없다.

P6-GATE 완료 증거 (2026-10-01): 위 미실행 문구는 계획 작성 당시 기록으로 보존한다. 이번 게이트에서 위 focused 명령을 새로 실행해 exit 0, BUILD SUCCESSFUL in 22s(39 tasks: 8 executed, 31 up-to-date)를 확인했다. 이어 전체 gift·resource merge·Kotlin compile·ktlint 명령을 새로 실행해 exit 0, BUILD SUCCESSFUL in 10s(46 tasks: 5 executed, 41 up-to-date)를 확인했다. 전체 실행의 testDebugUnitTest와 main/test ktlint 검사는 실행됐으며 resource merge·Kotlin compile은 UP-TO-DATE였다. git diff --check HEAD는 exit 0, 출력 없음이다.

  • XML 집계: app/build/test-results/testDebugUnitTest/TEST-kr.co.vividnext.sodalive.v2.gift.*.xml을 파싱하고 gift 테스트 소스 클래스 목록 및 각 XML의 testcase 수와 대조했다. GiftInboxEntryPolicyTest 3개, GiftInboxPresenterTest 11개, GiftInboxViewModelTest 11개, GiftSendEntryPolicyTest 3개, GiftSendRequestPresenterTest 21개, GiftSendRequestViewModelTest 6개로 총 6개 클래스·55개이며 failures/errors/skipped는 모두 0이다. 기존 53개에 프로필 테스트 2개가 추가됐고 focused 두 클래스는 합계 22개다.
  • 요구사항 연결: GiftInboxItemResponse의 상대방 3개 필드 → presenter의 ID·닉네임 직접 전달 및 null/blank URL 정규화 → 카드 모델 → adapter의 두 방향 nickname/Coil binding → 두 XML의 counterpart_profile_image·counterpart_nickname을 읽기 전용 대조했다. placeholder/fallback/error는 모두 ic_placeholder_profile이며 매 bind마다 이미지 요청을 설정한다. 보낸 카드의 닉네임 아래 details와 받은 카드의 상단 프로필·날짜 및 본문 status/subtitle 연결을 확인했다.
  • 회귀 근거: GiftInboxViewModelTest의 ALL/0/20, 다음 page append·중복 방지, 상태 toast 1회 소비 테스트와 presenter의 방향별 상태·혼합 목록 순서 테스트를 확인했다. API/repository의 ALL/20 고정, Activity의 page 0 진입·pagination 및 adapter → ViewModel → Activity 상태 toast 연결도 유지된다. 카드 클릭에 상세 화면·프로필 화면·deeplink 이동은 없다.
  • 판정 범위: PRD 14.5는 local unit test·코드/XML 대조·resource/Kotlin 검증 근거로 완료 처리했다. 실제 네트워크 이미지 로딩, 기기·에뮬레이터 화면 표시, 스크린샷·시각 QA는 실행하지 않았으며 시각적 완성도를 검증했다고 주장하지 않는다. 이번 게이트에서는 production/test/XML을 수정하지 않았다.

Phase 7: 배송지 미입력 아이템 중복 제거

Phase 결과: 받은 선물 상단의 배송지 입력 기간 안내는 유지하고, 배송지 미입력 선물마다 기존 3문구 Address 아이템만 하나씩 표시한다.

선행조건: PRD GIFT-INBOX-UI-002, GIFT-INBOX-STATUS-002~003, GIFT-INBOX-BANNER-003, DEC-013 확정.

Phase 완료 조건: P7-R1, P7-GATE 완료 및 PRD 14.7·Verification Log 갱신.

Task 7.R1 배송지 미입력 행 중복 회귀 수정

Goal 실행 P7-R1: 기존 첫 대상 전용 Address 배너와 같은 선물의 일반 카드를 동시에 생성하는 presenter 행 조합을 수정한다.

Files:

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

  • Modify: app/src/main/java/kr/co/vividnext/sodalive/v2/gift/GiftInboxPresenter.kt

  • RED: 배송지 미입력 선물 한 건은 Notice(true), 해당 Address, Inquiry만 만들고 같은 신청번호의 Card를 만들지 않는 테스트를 작성한다.

  • RED: 배송지 미입력 선물 두 건은 서버 순서대로 Address 두 건을 만들며 각 신청번호를 보존하고 일반 Card를 만들지 않는 테스트를 작성한다.

  • RED: 배송지 입력 필요/완료 선물이 섞이면 서버 순서를 유지해 각각 Address/Card로 한 번씩만 변환하는 테스트를 작성한다.

  • RED 확인: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"가 기존 firstOrNull Address 추가와 전체 Card 추가 때문에 실패하는지 확인한다.

  • GREEN: cards.firstOrNull { it.addressRequired } 별도 추가를 제거하고 cards.map에서 addressRequired이면 GiftInboxRow.Address, 아니면 GiftInboxRow.Card로 최소 분기한다.

  • GREEN 확인: 같은 focused test를 실행해 통과를 확인한다.

  • REFACTOR: 기존 GiftInboxRow.Address(card)와 item_gift_inbox_address_banner.xml을 그대로 재사용하고 신규 row type·layout·API field를 추가하지 않는다.

향후 계약: 현재 목록 DTO에는 recipientAddressDeadlineAt이 없다. API와 timezone 정책이 제공되면 각 Address가 보존한 개별 card/applicationNo에 마감일 또는 계산된 경고 문구를 추가한다. 이번 Task에서는 임의 날짜나 남은 일수를 계산하지 않고 기존 고정 제목·본문·경고를 유지한다.

P7-R1 검증 기록 (2026-10-06): 단건·다건·혼합 행 계약을 production 변경 전에 추가했다. 기존 구현에서 focused test 13개 중 4개가 행 타입·중복 assertion으로 실패해 RED를 확인했다. firstOrNull 별도 Address 추가와 전체 Card 추가를 아이템별 Address/Card 변환 한 줄로 교체한 뒤 같은 13개 test가 BUILD SUCCESSFUL in 12s로 통과했다. 기존 Address XML의 제목·본문·경고와 각 card/applicationNo를 그대로 재사용했으며 API field·layout·row type은 추가하지 않았다.

Phase 7 Gate

Goal 실행 P7-GATE: 배송지 미입력 단건·다건·혼합 목록과 기존 선물함 회귀를 검증한다.

  • GiftInboxPresenterTest의 단건·다건·혼합 행 계약을 통과한다.
  • 전체 gift local unit test, resource merge, Kotlin compile을 통과한다.
  • 변경 파일 ktlint와 GIT_MASTER=1 git diff --check HEAD를 통과한다.
  • PRD 14.7과 Verification Log를 실제 증거로 갱신한다.
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"
./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin
./gradlew :app:ktlintCheck
GIT_MASTER=1 git diff --check HEAD

Expected: 상단 기간 안내는 유지되고 각 배송지 미입력 선물은 Address 행 한 건으로만 표시되며, 다건의 신청번호·서버 순서가 보존된다.

P7-GATE 검증 기록 (2026-10-06): focused GiftInboxPresenterTest 13개가 BUILD SUCCESSFUL in 12s로 통과했다. 전체 gift local unit test와 resource merge·Kotlin compile을 --rerun-tasks로 실행해 BUILD SUCCESSFUL in 1m 56s를 확인했다. :app:ktlintCheck --rerun-tasks는 변경하지 않은 CreatorChannelFanTalkFragmentLayoutTest.kt의 기존 줄바꿈·최대 길이 20건 때문에 실패했으며 보고서에는 이번 변경 파일 위반이 없다. GIT_MASTER=1 git diff --check HEAD와 staging 확인은 무출력으로 통과했다. 기존 Address XML의 제목·본문·경고 3문구와 클릭 binding을 재사용했고 기기·에뮬레이터·androidTest·스크린샷 QA는 실행하지 않았다.


실행 순서와 의존성

순서 Goal 선행조건 병행 가능 차단 시 다음 행동
1 P1-T1 없음 아니요 API 계약 재확인
2 P1-T2 P1-T1 아니요 PRD status mapping 재확인
3 P1-GATE Phase 1 Task 전체 아니요 실패 Task에 회귀 수정 추가
4 P2-T1 P1-GATE 아니요 ViewModel state contract 재확인
5 P2-T2 P2-T1 아니요 pagination 조건 재확인
6 P2-T3 P2-T1 P2-T2 이후 권장 refresh 정책 재확인
7 P2-T4 P2-T1, P2-T2 아니요 오류 상태 분기 재확인
8 P2-GATE Phase 2 Task 전체 아니요 실패 Task에 회귀 수정 추가
9 P3-T1 P1-T2 P2 이후 권장 item type contract 재확인
10 P3-T2 P2-GATE, P3-T1 아니요 layout binding 재확인
11 P3-T3 P3-T1, P3-T2 아니요 empty/banner 정책 재확인
12 P3-T4 P2-GATE, P3-T1 P3-T5와 일부 병행 가능 상태 toast 정책 확인
13 P3-T5 설정 페이지 카카오 문의하기 패턴 확인 P3-T4와 일부 병행 가능 카카오 문의하기 진입점 확인
14 P3-GATE Phase 3 Task 전체 아니요 실패 Task에 회귀 수정 추가
15 P4-GATE Phase 1~3 Gate 전체 아니요 실패 소유 Task로 되돌림
16 P5-T1 P4-GATE, PRD 진입점 요구 확정 아니요 국가·언어 판정 계약 재확인
17 P5-T2 P5-T1, 레거시 최소 수정 승인 아니요 아이콘 목록·라우팅 계약 재확인
18 P5-GATE Phase 5 Task 전체 아니요 실패 Task에 회귀 수정 추가
19 P6-T1 P5-GATE, 상대방 API 계약 확정 아니요 PRD 프로필 계약 재확인
20 P6-T2 P6-T1 RED 확인 아니요 DTO·카드 모델·매핑 대조
21 P6-T3 P6-T2 GREEN 확인 아니요 XML·Coil binding 대조
22 P6-GATE Phase 6 Task 전체 아니요 실패 Task에 회귀 수정 추가
23 P7-R1 PRD DEC-013 아니요 단건·다건·혼합 행 계약 재확인
24 P7-GATE P7-R1 아니요 실패 소유 Task 수정
P1-T1 → P1-T2 → P1-GATE → P2-T1 → P2-T2 → P2-T3 → P2-T4 → P2-GATE → P3-T1 → P3-T2 → P3-T3 → P3-T4/P3-T5 → P3-GATE → P4-GATE → P5-T1 → P5-T2 → P5-GATE → P6-T1 → P6-T2 → P6-T3 → P6-GATE → P7-R1 → P7-GATE

변경 금지 항목

  • type=SENT, type=RECEIVED 목록 호출을 추가하지 않는다.
  • 서버 응답을 클라이언트에서 임의 재정렬하지 않는다.
  • API 미제공 필드 값을 하드코딩하거나 추정하지 않는다.
  • 신청 내역, 선물 내역 section title을 노출하지 않는다.
  • 선물 상세 화면이 생기기 전에는 item 터치에서 상세 이동을 추정 구현하지 않는다.
  • 승인된 MyPageFragment 진입점 최소 연결 외 레거시 코드 수정, dependency 추가, 공통 abstraction 확장을 하지 않는다.
  • test를 삭제·skip·완화하거나 타입 오류를 우회해 Gate를 통과시키지 않는다.
  • token, 실제 사용자 정보, 신청번호 fixture를 log나 문서에 기록하지 않는다.

의사결정 및 중단 규칙

  • PRD와 API 응답이 충돌하면 PRD Decision Log를 먼저 갱신하고, 구현은 안전한 최소 기본값으로 제한한다.
  • canceledAt, recipientAddressDeadlineAt, sortAt이 제공되기 전에는 해당 표시를 정확히 구현했다고 완료 처리하지 않는다. EXT-002, EXT-003은 유지한다.
  • EXT-001은 상대방 필드 3개의 계약 제공으로 해결됐다. 앱 프로필 표시는 P6-GATE 통과 전까지 완료 처리하지 않으며, 과거 닉네임 미제공 기록은 당시 이력으로 보존한다.
  • 구현 범위가 바뀌면 이 문서 체크박스를 먼저 갱신한 뒤 코드를 수정한다.
  • 완료된 Task와 검증 기록은 삭제하거나 덮어쓰지 않고 후속 수정 Task를 추가한다.

Progress

구현 시작 및 디자인 기준 — 2026-10-01

  • 사용자 승인에 따라 현재 브랜치에서 구현하며 worktree/commit 없이 진행한다. 기존 문서 기록은 유지한다.
  • Figma 5개 노드 screenshot을 확인했다. 기존 Typography.Heading1/Heading4/Body4/Caption3, spacing_4/6/8/12/14/16/20/24/32/48, radius_14, black/white/gray_900/gray_500/soda_900/soda_200 리소스를 기준으로 재사용한다.
  • 고정 header, 14dp 좌우 여백, 14dp 카드 내부 여백, 8dp 카드 간격, 회색 카드와 파란 배송지 배너를 적용한다. 닉네임 대신 일반 상대 역할 라벨, 모든 날짜는 createdAt 신청일, deadline은 숫자 없는 안내를 사용한다.
  • P1-T1 완료: ALL/0/20/인증 전달 테스트 RED 및 GREEN 확인. LSP 도구가 없어 Kotlin Gradle 컴파일로 검증한다.

기존 기록을 삭제하거나 덮어쓰지 않고 실제 실행 결과를 차수별로 누적한다.

문서 작성 — 2026-10-01

  • 상태: 완료
  • 무엇을: PRD와 구현 계획/TASK 초안을 생성했다.
  • 왜: 사용자 요청이 구현 전 문서 생성으로 제한되어 있다.
  • 어떻게:
    • docs/sample/sample-prd.md와 docs/sample/sample-plan-task.md 구조를 반영했다.
    • 기존 GiftApi, GiftRepository, GiftSendRequestViewModel 패턴을 기준 파일로 삼았다.
  • 남은 항목: API 미제공 필드 제공 전까지 닉네임, 취소일, 배송지 마감일은 정확 표시로 완료 처리하지 않는다.
  • 다음 행동: 사용자가 구현을 승인하면 P1-T1부터 실행한다.

문서 보완 — 2026-10-01

  • 상태: 완료
  • 무엇을: 전체 빈 목록, item 터치, 문의 이동 정책을 사용자 확정 내용으로 갱신했다.
  • 왜: 이전 문서의 OQ-001~OQ-003이 사용자 답변으로 확정됐다.
  • 어떻게:
    • 전체 목록 empty는 크리에이터/일반 회원 유형으로 분기하도록 PRD와 P3-T3 테스트 계획을 수정했다.
    • 상세 화면 부재 시 item 터치는 상태 toast로 처리하도록 P3-T4를 수정했다.
    • 받은 선물 문의 버튼은 설정 페이지 카카오 문의하기와 동일 페이지로 연결하도록 P3-T5를 수정했다.
  • 남은 항목: 설정 페이지 카카오 문의하기의 실제 intent/URL 패턴은 구현 시작 시 코드에서 재확인한다.
  • 다음 행동: 사용자가 구현을 승인하면 P1-T1부터 실행한다.

구현 완료 — 2026-10-01

  • 상태: Phase 1~4 완료. API 계약 테스트, presenter 정책 테스트, ViewModel 상태/클릭 event 테스트를 먼저 작성하고 각 묶음의 부재 실패를 확인한 뒤 구현했다.
  • 결과: 고정 헤더, 방향별 카드, 안내/배송지 배너, creator/member 빈 화면, pagination/refresh/retry, 상태 toast, 카카오 문의 Intent, manifest/Koin 및 한·영·일 리소스를 연결했다.
  • 검증: 선물함 신규 테스트 20개(presenter 9, ViewModel 11), 기존 gift 테스트 30개를 포함해 총 50개 PASS. 리소스 병합, Kotlin 컴파일, ktlint, debug APK 빌드, diff-check PASS.
  • 최소 구현 결정: 기존 DTO 파일을 확장하고 repository에서 ALL/20을 고정했다. 신규 status enum/추정 API 필드는 추가하지 않았다. 화면마다 쓰이는 신규 추상화/의존성도 추가하지 않았다.
  • 외부 의존: 실제 닉네임, 취소일, 마감일은 API가 제공하지 않아 정확 표시 대상에서 제외한다. createdAt의 날짜 부분을 yyyy.MM.dd 신청일로 표시하며 시간대 변환/남은 일수 추정은 하지 않는다.
  • 제한: 기기·에뮬레이터/UI 계측/시각 QA는 사용자 지시에 따라 실행하지 않았다. Figma 원본 screenshot 5개 확인과 XML/리소스 읽기 대조만 수행했다. LSP 도구는 제공되지 않아 Kotlin compiler로 검증했다.

마이 탭 진입점 완료 — 2026-10-01

  • 상태: Phase 5 완료. 사용자 승인에 따라 레거시 MyPageFragment의 아이콘 목록 생성부와 import만 최소 수정했다.
  • 결과: 국가 코드가 KR이고 앱의 유효 언어가 ko인 로그인 사용자에게만 ic_my_present·선물함 항목을 기능 아이콘 목록 첫 번째에 표시하며, 클릭 시 기본 ALL 관점의 GiftInboxActivity를 연다.
  • 검증: 정책·source contract 신규 테스트 3개와 전체 gift 테스트 53개 PASS. resource merge, Kotlin compile, ktlint, diff-check PASS.
  • 범위 보존: 기존 기능 아이콘 layout·adapter·다른 항목 순서/조건/callback, 비로그인 정책, 선물함 API는 변경하지 않았다. 신규 dependency·string·drawable·공통 abstraction을 추가하지 않았다.
  • 제한: 저장소 규칙에 따라 기기·에뮬레이터 UI 조작, screenshot, androidTest는 실행하지 않았다.

상대방 프로필 계획 추가: 2026-10-01

  • 상태: Phase 6 계획 반영 완료, 구현·테스트는 미실행.
  • 결정: 사용자 제공 상대방 필드 3개를 두 방향 카드에 반영한다. 상세 이동과 toast 충돌은 상세 화면 부재로 기존 상태 toast 유지로 확정했다.
  • 다음 행동: P6-T1에서 프로필 매핑과 null/blank URL 정규화 RED를 확인한다. 기존 53개 테스트 통과 기록은 Phase 5 당시 증거이며 Phase 6 완료 증거로 사용하지 않는다.

배송지 미입력 아이템 요구사항 정정: 2026-10-06

  • 상태: Phase 7 계획 등록, 구현 전.
  • 결정: 상단 배송지 입력 기간 안내는 유지한다. 배송지 미입력 선물은 별도 첫 대상 배너와 일반 카드로 중복 표시하지 않고 각 선물마다 기존 3문구 Address 아이템 하나로 표시한다.
  • 향후 계약: 현재 목록 API에는 recipientAddressDeadlineAt이 없으므로 고정 경고를 유지한다. API 필드 제공 후 각 Address 아이템의 경고를 개별 남은 일수 문구로 바인딩한다.
  • 실행 위치: 사용자 요청에 따라 현재 main 작업 트리에서 worktree와 commit 없이 진행한다.

Decision Log

날짜 ID 상태 결정 근거 영향 Goal/문서
2026-10-01 DEC-001 확정 선물함 목록은 type=ALL만 호출한다. 사용자 요구사항 P1-T1
2026-10-01 DEC-002 확정 서버 응답 순서를 유지하고 클라이언트 재정렬하지 않는다. 현재 API에는 취소일/sortAt 없음 P1-T2, P2-*
2026-10-01 DEC-003 확정 이번 요청에서는 PRD와 구현 계획 문서만 생성하고 production 코드는 변경하지 않는다. 사용자 요청 전체
2026-10-01 DEC-004 확정 전체 빈 목록은 크리에이터이면 받은 선물 없음, 일반 회원이면 보낸 선물 신청 내역 없음으로 표시한다. 사용자 보완 요청 P3-T3
2026-10-01 DEC-005 확정 현재 상세 페이지가 없으므로 item 터치 시 상태 표시 문구 toast를 보여준다. 사용자 보완 요청 P3-T4
2026-10-01 DEC-006 확정 받은 선물 문의 버튼은 설정 페이지의 카카오 문의하기와 동일한 페이지로 연결한다. 사용자 보완 요청 P3-T5
2026-10-01 DEC-010 확정 상대방 ID·닉네임·이미지 계약을 반영하고 null/blank 이미지는 기존 placeholder를 사용한다. 상세 화면이 없으므로 사용자가 선택한 기존 상태 toast를 유지하며 ALL 조회·direction·pagination을 변경하지 않는다. 사용자 제공 API 계약과 Phase 6 승인, PRD DEC-010 EXT-001 해결, P6-T1~P6-GATE
2026-10-06 DEC-011 정정 받은 선물 상단 기간 안내는 유지하고, 배송지 미입력 선물은 각자 기존 3문구 Address 아이템으로 표시한다. 첫 대상 별도 배너와 같은 선물의 일반 카드 중복은 제거한다. 현재 고정 경고는 유지하고 향후 목록 API의 아이템별 마감일로 개별 경고를 계산한다. 사용자 요구사항 정정 및 PRD DEC-013 P7-R1, P7-GATE

발견된 문제

ID 심각도 상태 발견 내용 영향 Goal 처리 계획
ISSUE-001 Medium 해결 ALL 관점에서 전체 목록이 비었을 때 적용할 empty UI 기준이 필요했다. P3-T3 크리에이터이면 받은 선물 없음, 일반 회원이면 보낸 선물 신청 내역 없음으로 확정됨
ISSUE-002 Medium 해결 상세 화면이 아직 없으면 카드 탭의 실제 목적지가 없다. P3-T4 item 터치 시 상태 표시 문구 toast로 확정됨

Verification Log

  • 2026-10-01: 문서 생성 단계에서는 production 코드 변경이 없어 Gradle build/test를 실행하지 않았다. 문서 경로와 샘플 구조는 docs/sample/ 및 docs/agent-guides/work-plan-docs.md 기준으로 확인했다.
  • 2026-10-01: 문서 보완 단계에서는 production 코드 변경이 없어 Gradle build/test를 실행하지 않았다. 보완 내용은 PRD Open Questions, Decision Log, P3-T3~P3-T5 Task에 반영한다.
  • 2026-10-01 API RED: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" → exit 1, compileDebugUnitTestKotlin FAILED in 4s, GiftInboxResponse/getGiftInbox 부재. 동일 명령 GREEN → exit 0, BUILD SUCCESSFUL in 16s.
  • 2026-10-01 presenter RED: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest" → exit 1, compileDebugUnitTestKotlin FAILED in 4s, 신규 presenter와 string resource 부재. 두 focused 클래스 동시 GREEN → exit 0, BUILD SUCCESSFUL in 45s.
  • 2026-10-01 ViewModel RED: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" → exit 1, compileDebugUnitTestKotlin FAILED in 3s, 신규 ViewModel/상태 부재. 동일 명령 GREEN → exit 0, BUILD SUCCESSFUL in 18s.
  • 2026-10-01 footer RED: presenter focused 명령 → exit 1, FAILED in 3s, isAppending/canRetry/LOADING/RETRY 부재. UI 연결 후 ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest" --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest" :app:mergeDebugResources :app:compileDebugKotlin → exit 0, BUILD SUCCESSFUL in 49s.
  • 2026-10-01 전체 회귀 1차: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck → exit 1, BUILD FAILED in 11s. 테스트/merge/compile은 통과하고 신규 줄의 ktlint 9건만 실패했다. P4-FIX-1로 수정했다.
  • 2026-10-01 전체 회귀 최종: 위와 동일 명령 → exit 0, BUILD SUCCESSFUL in 17s. XML 보고서 기준 GiftInboxPresenterTest 8개, GiftInboxViewModelTest 11개, GiftSendEntryPolicyTest 3개, GiftSendRequestPresenterTest 21개, GiftSendRequestViewModelTest 6개, 총 49개 모두 failures/errors/skipped=0.
  • 2026-10-01 변경 검증: git diff --check → exit 0, 출력 없음. section title은 선물함 layout에 없고, header/content sibling 구조와 API-missing 데이터 비추정 정책을 읽기 전용 대조했다. 한국어·영어·일본어에 동일 29개 선물함 string key를 추가했다.
  • 2026-10-01 기존 경고: Gradle 9 deprecated features, .editorconfig disabled_rules deprecation, Agora namespace 중복, 기존 코드 deprecated API/annotation 경고가 출력되었다. 기존 실패는 관찰되지 않았으며 무관한 기존 코드를 수정하지 않았다.
  • 2026-10-01 범위 보존: 이번 작업에서 PRD, SettingsActivity, ServiceCenterActivity를 수정하지 않았다. 기존 staged/dirty 문서는 유지했다. worktree, commit, push, UI/계측 테스트, 기기 실행은 하지 않았다.
  • 2026-10-01 nullable 날짜 회귀: createdAt=null fixture를 추가한 presenter focused test가 DTO의 non-null 타입 오류로 RED를 확인했다. GiftInboxItemResponse.createdAt을 nullable로 맞추고 날짜가 없으면 빈 표시값으로 매핑하며 adapter가 날짜 라벨을 숨기도록 최소 수정한 뒤 focused presenter/ViewModel test가 BUILD SUCCESSFUL in 14s로 통과했다.
  • 2026-10-01 문구 대조: 받은 선물 상단 안내의 확정 정책인 알림을 받은 날부터 7일 이내가 누락된 것을 확인해 한국어·영어·일본어 리소스에 동일 의미로 반영했다. API가 제공하지 않는 가변 n일 값은 추정하지 않았다.
  • 2026-10-01 전체 회귀 2차: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck → exit 0, BUILD SUCCESSFUL in 13s. XML 보고서 기준 presenter 9개, ViewModel 11개, 기존 gift 30개로 총 50개가 failures/errors/skipped=0이다.
  • 2026-10-01 APK 검증: 최초 ./gradlew :app:assembleDebug는 120초 실행 제한으로 중단됐고, 동일 명령을 300초 제한으로 재실행해 exit 0, BUILD SUCCESSFUL in 14s를 확인했다. git diff --check HEAD도 exit 0, 출력 없음으로 통과했다.
  • 2026-10-01 독립 QA: gift test·resource merge·Kotlin compile·APK assemble을 --rerun으로 실행해 exit 0, BUILD SUCCESSFUL in 11s를 확인했다. resource·compile·package·assemble 강제 재실행도 exit 0, BUILD SUCCESSFUL in 1m 34s, APK unzip -tq exit 0으로 통과했다.
  • 2026-10-01 리뷰: 요구사항, 비기기 QA, 코드 품질, 보안, 저장소·Git 문맥 5개 독립 검토가 모두 PASS했다. 차단 이슈는 없으며 비차단 권고와 판정 근거는 reviews/phase4-gift-inbox-integration-review.md에 기록했다.
  • 2026-10-01 P5-T1 RED/GREEN: false placeholder에서 GiftInboxEntryPolicyTest 2개가 지정 assertion으로 실패했고, KR·ko AND 조건 최소 구현 후 동일 focused 명령이 BUILD SUCCESSFUL in 13s로 통과했다.
  • 2026-10-01 P5-T2 RED/GREEN: 마이 탭 source contract가 ic_my_present 부재로 1개 실패했고, 조건부 첫 항목과 GiftInboxActivity.newIntent를 연결한 뒤 focused test 3개가 BUILD SUCCESSFUL in 15s로 통과했다. resource merge·Kotlin compile도 BUILD SUCCESSFUL in 1s였다.
  • 2026-10-01 P5-GATE: ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck → exit 0, BUILD SUCCESSFUL in 12s. XML 기준 gift 테스트 53개가 failures/errors/skipped=0이며 git diff --check HEAD도 exit 0이다.
  • 2026-10-01 Phase 5 리뷰: 요구사항·순서·조건·라우팅·레거시 최소 변경을 독립 대조해 PASS했다. Critical/Important는 없고 source contract의 실행 검증 한계 1건을 Low/보류로 reviews/phase5-my-gift-inbox-entry-review.md에 기록했다.
  • 2026-10-01 체크박스 감사: PRD 성공 기준 17개를 완료된 Phase 1~5 Task, 53개 gift local unit test, resource merge, Kotlin compile, ktlint, diff-check 및 독립 리뷰 증거와 대조해 모두 완료 처리했다. counterpartNickname은 목록 API 응답과 GiftInboxItemResponse에 없어 역할 라벨(크리에이터/팬)을 표시하는 EXT-001 외부 의존 상태를 유지하며 값을 추정 구현하지 않았다.
  • 2026-10-01 Phase 6 문서 갱신: 사용자 제공 상대방 필드 3개로 EXT-001 계약 의존을 해결하고 GIFT-INBOX-PROFILE-001~003, DEC-010, 미완료 수용 기준과 P6-T1~P6-GATE를 추가했다. 위 닉네임 미제공 기록은 당시 이력으로 유지한다. 문서만 변경했으며 Gradle·git 명령, production/test 코드 수정, 기기·스크린샷 QA는 수행하지 않았다.
  • 2026-10-01 P6-GATE 신규 검증: focused presenter/ViewModel 명령 exit 0, BUILD SUCCESSFUL in 22s; ./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.*" :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck exit 0, BUILD SUCCESSFUL in 10s. XML 직접 집계는 6개 클래스·55개 테스트(focused 대상 22개 포함), failures/errors/skipped=0이며 테스트 소스 클래스 목록과 일치했다. resource merge·Kotlin compile은 UP-TO-DATE, 전체 테스트와 main/test ktlint는 실행됐다. git diff --check HEAD exit 0, 출력 없음. Phase 6을 3/3 및 게이트 통과로 갱신하고 PRD 14.5를 완료 처리했다. 기존 로그는 보존했다.
  • 2026-10-01 P6-GATE 제한 및 경고: DTO부터 양방향 XML까지의 연결과 ALL/0/20·direction·pagination·상태 toast를 코드/테스트로 확인했다. 기기·에뮬레이터·androidTest·스크린샷 QA 및 실제 이미지 다운로드는 실행하지 않았다. LSP 도구는 제공되지 않는다. 기존 테스트 deprecated API, Gradle 9 호환성 및 .editorconfig disabled_rules deprecation 경고만 관찰됐으며 범위 밖 코드는 수정하지 않았다.
  • 2026-10-01 Phase 6 최종 리뷰: Oracle PASS, Critical/Important/Minor 각 0, 확정 발견 사항 없음. 기존 P6-GATE의 6개 클래스·55개 테스트(failures/errors/skipped=0), 전체 gift·mergeDebugResources·compileDebugKotlin·ktlint 및 git diff --check HEAD exit 0 증거를 reviews/phase6-gift-inbox-counterpart-profile-review.md에 기록했다. 회귀 수정 Task 전환과 검증 재실행은 없다.
  • 2026-10-06 Phase 7 완료: 배송지 미입력 단건·다건·혼합 목록의 중복 회귀 test를 추가해 기존 구현에서 13개 중 4개 실패를 확인했다. presenter의 행 조합을 아이템별 Address/Card 단일 변환으로 수정한 뒤 focused 13개와 전체 gift 회귀·resource merge·Kotlin compile이 통과했다. 전역 ktlint는 변경하지 않은 fan-talk 테스트의 기존 20건에 차단됐고 이번 변경 파일 위반은 없었다. 상단 배송지 입력 기간 안내와 고정 3문구는 유지하며, 아이템별 남은 일수는 목록 API의 recipientAddressDeadlineAt 제공 전까지 계산하지 않는다.