docs(gift): 선물함 구현 계획을 기록한다
This commit is contained in:
@@ -0,0 +1,936 @@
|
||||
# 선물함 리스트 페이지 구현 계획/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 작성 규칙
|
||||
|
||||
- [x] **RED:** 가장 작은 실패 test를 작성한다.
|
||||
- [x] **RED 확인:** focused test를 실행해 요구 동작이 없어서 발생한 의도한 실패를 확인한다.
|
||||
- [x] **GREEN:** RED를 통과시키는 최소 구현을 작성한다.
|
||||
- [x] **GREEN 확인:** 같은 focused test를 다시 실행해 성공을 확인한다.
|
||||
- [x] **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)`
|
||||
|
||||
- [x] **RED:** fake API가 받은 `type`, `page`, `size`, `authHeader`를 기록하고, 첫 조회가 `ALL/0/20`이 아니면 실패하는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxViewModelTest"`를 실행해 신규 DTO/repository method 부재로 실패를 확인한다.
|
||||
- [x] **GREEN:** `GiftApi.getGiftInbox(@Query("type"), @Query("page"), @Query("size"), @Header("Authorization"))`, DTO, repository method를 최소 구현한다.
|
||||
- [x] **GREEN 확인:** 같은 focused test를 다시 실행해 PASS를 확인한다.
|
||||
- [x] **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)`
|
||||
|
||||
- [x] **RED:** `direction=SENT`와 `status=RECEIVED` item이 `운송장 등록 필요` 보낸 카드로 변환되는 테스트를 작성한다.
|
||||
- [x] **RED:** `direction=RECEIVED`와 `status=TRACKING_REGISTERED` item이 `배송지 입력 필요`/`전달 예정` 받은 카드로 변환되는 테스트를 작성한다.
|
||||
- [x] **RED:** 변환 결과 어디에도 `신청 내역`, `선물 내역` section title이 포함되지 않는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxPresenterTest"`를 실행해 신규 presenter 부재로 실패를 확인한다.
|
||||
- [x] **GREEN:** enum parsing 없이 문자열 status를 요구사항 표대로 매핑하는 최소 presenter를 구현한다.
|
||||
- [x] **GREEN 확인:** 같은 focused test를 다시 실행해 PASS를 확인한다.
|
||||
- [x] **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는 불필요했다.
|
||||
|
||||
### 완료 조건
|
||||
|
||||
- [x] `P1-T1`, `P1-T2` 체크박스와 완료 증거가 모두 충족됐다.
|
||||
- [x] API 미제공 필드가 production 추정 구현으로 들어가지 않았다.
|
||||
|
||||
### 검증 방법
|
||||
|
||||
#### Phase 1 Gate
|
||||
|
||||
**Goal 실행 `P1-GATE`:** API 계약과 표시 정책을 최종 판정한다.
|
||||
|
||||
```bash
|
||||
./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)`
|
||||
|
||||
- [x] **RED:** `loadFirstPage()`가 page 0/size 20/type ALL을 요청하고 content 상태를 내보내는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test를 실행해 ViewModel 부재 또는 state mismatch 실패를 확인한다.
|
||||
- [x] **GREEN:** 기존 `BaseViewModel`과 Rx scheduler 패턴을 따라 최소 상태를 구현한다.
|
||||
- [x] **GREEN 확인:** 같은 focused test PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **RED:** `hasNext=true` content 후 `loadNextPage()` 호출 시 page 1이 요청되고 기존 item 뒤에 append되는 테스트를 작성한다.
|
||||
- [x] **RED:** append loading 중 `loadNextPage()`를 다시 호출해도 중복 요청하지 않는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test 실패를 확인한다.
|
||||
- [x] **GREEN:** `currentPage`, `hasNext`, `isAppending` 상태를 최소 구현한다.
|
||||
- [x] **GREEN 확인:** focused test PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **RED:** 기존 page 1까지 append된 상태에서 `refresh()`가 page 0을 요청하고 목록을 새 응답으로 교체하는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test 실패를 확인한다.
|
||||
- [x] **GREEN:** `refresh()`를 page 0 재조회와 state reset으로 최소 구현한다.
|
||||
- [x] **GREEN 확인:** focused test PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **RED:** 첫 페이지 API 실패 시 `Error` 상태와 retry 가능 상태가 되는 테스트를 작성한다.
|
||||
- [x] **RED:** append 실패 시 기존 content를 유지하고 toast event만 발생하는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test 실패를 확인한다.
|
||||
- [x] **GREEN:** 첫 페이지 retry와 append retry를 최소 구현한다.
|
||||
- [x] **GREEN 확인:** focused test PASS를 확인한다.
|
||||
- [x] **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을 최종 판정한다.
|
||||
|
||||
```bash
|
||||
./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`
|
||||
|
||||
- [x] **RED:** presenter가 `SENT_CARD`, `RECEIVED_CARD`, `NOTICE_BANNER`, `ADDRESS_BANNER`, `EMPTY_RECEIVED` item type을 필요한 순서로 만드는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test 실패를 확인한다.
|
||||
- [x] **GREEN:** adapter와 item layout을 최소 구현하고 presenter item type 생성을 통과시킨다.
|
||||
- [x] **GREEN 확인:** focused test PASS와 `./gradlew :app:mergeDebugResources` PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **TDD 예외 사유:** header 고정과 scroll 영역 분리는 Android layout 구조이며 local unit test가 동작을 직접 검증하지 못한다.
|
||||
- [x] **대체 검증 방법:** layout root에서 header와 refresh/recycler content가 sibling인지 read-only 대조하고 resource merge/compile로 binding을 검증한다.
|
||||
- [x] **GREEN:** `BaseActivity<ActivityGiftInboxBinding>`, title `선물함`, back click `finish()`, RecyclerView, optional SwipeRefreshLayout을 연결한다.
|
||||
- [x] **GREEN 확인:** `./gradlew :app:mergeDebugResources`와 `./gradlew :app:compileDebugKotlin` PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **RED:** `SENT` 관점 빈 목록은 안전 배송 안내 배너만 만드는 테스트를 작성한다.
|
||||
- [x] **RED:** `RECEIVED` 관점 빈 목록은 받은 선물 empty title/body/button item을 만드는 테스트를 작성한다.
|
||||
- [x] **RED:** `ALL` 관점 전체 빈 목록에서 사용자 유형이 creator이면 받은 선물 empty, 일반 회원이면 보낸 선물 empty를 만드는 테스트를 작성한다.
|
||||
- [x] **RED:** `TRACKING_REGISTERED` 받은 선물이 있으면 배송지 입력 안내 배너가 첫 대상 상태 문구를 들고 생성되는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test 실패를 확인한다.
|
||||
- [x] **GREEN:** empty/banner item 생성을 최소 구현하고 Activity click event를 ViewModel 상태 toast event로 전달한다.
|
||||
- [x] **GREEN 확인:** focused test와 resource compile PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **RED:** 카드 클릭 시 item 상태 표시 문구가 포함된 toast event가 한 번 소비되는 테스트를 작성한다.
|
||||
- [x] **RED:** 배송지 입력 배너 클릭 시 첫 배송지 입력 필요 선물의 상태 표시 문구 toast event가 한 번 소비되는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test 실패를 확인한다.
|
||||
- [x] **GREEN:** `toastLiveData` 또는 기존 `ToastMessage` event와 consume method를 최소 구현한다.
|
||||
- [x] **GREEN 확인:** focused test PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **RED:** 의견/문의 버튼 클릭 시 카카오 문의하기 이동 event가 한 번 소비되는 테스트를 작성한다.
|
||||
- [x] **RED 확인:** focused test 실패를 확인한다.
|
||||
- [x] **GREEN:** 설정 페이지의 카카오 문의하기와 동일한 intent/URL 패턴을 재사용한다.
|
||||
- [x] **GREEN 확인:** focused test와 compile PASS를 확인한다.
|
||||
- [x] **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 연결을 최종 판정한다.
|
||||
|
||||
```bash
|
||||
./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: 신규 코드 포맷 검증
|
||||
|
||||
- [x] `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를 최종 판정한다.
|
||||
|
||||
- [x] 전체 gift local unit test 49개 통과(실패/오류/skip 0).
|
||||
- [x] mergeDebugResources, compileDebugKotlin, ktlintCheck 통과.
|
||||
- [x] git diff --check 통과 및 실행 문서 갱신.
|
||||
|
||||
```bash
|
||||
./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:**
|
||||
|
||||
```kotlin
|
||||
object GiftInboxEntryPolicy {
|
||||
fun shouldShow(countryCode: String, languageCode: String): Boolean
|
||||
}
|
||||
```
|
||||
|
||||
- [x] **RED:** `KR/ko`만 true이고 `KR/en`, `JP/ko`, `JP/ja`는 false이며 빈 국가 코드와 `ko`는 true인 테스트를 작성한다.
|
||||
|
||||
```kotlin
|
||||
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"))
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- [x] **RED 준비:** 테스트가 컴파일되도록 `GiftInboxEntryPolicy.shouldShow`가 항상 `false`를 반환하는 최소 placeholder를 만든다.
|
||||
- [x] **RED 확인:** `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.gift.GiftInboxEntryPolicyTest"`를 실행해 `KR/ko`와 빈 국가 코드/`ko` assertion이 의도대로 실패하는지 확인한다.
|
||||
- [x] **GREEN:** 다음 최소 정책을 구현한다.
|
||||
|
||||
```kotlin
|
||||
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
|
||||
}
|
||||
```
|
||||
|
||||
- [x] **GREEN 확인:** 같은 focused test를 다시 실행해 PASS를 확인한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] **RED:** `MyPageFragment` source에서 `ic_my_present`가 `ic_my_storage`보다 앞에 있고, `gift_inbox_title`, `LanguageManager.getEffectiveLanguage(requireContext())`, `GiftInboxActivity.newIntent(requireContext())` 연결이 존재하는 contract test를 작성한다.
|
||||
|
||||
```kotlin
|
||||
@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")
|
||||
```
|
||||
|
||||
- [x] **RED 확인:** focused test를 실행해 신규 마이 탭 연결 부재로 실패를 확인한다.
|
||||
- [x] **GREEN:** `buildFunctionButtonItems`의 `items`를 빈 mutable list로 시작하고 다음 조건부 항목을 먼저 추가한 뒤 기존 storage/block 목록을 그대로 append한다.
|
||||
|
||||
```kotlin
|
||||
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()))
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
- [x] **GREEN 확인:** focused test와 `:app:mergeDebugResources`, `:app:compileDebugKotlin`을 실행해 PASS를 확인한다.
|
||||
- [x] **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 회귀를 최종 판정한다.
|
||||
|
||||
- [x] `GiftInboxEntryPolicyTest` 3개와 전체 gift local unit test 53개 통과.
|
||||
- [x] mergeDebugResources, compileDebugKotlin, ktlintCheck 통과.
|
||||
- [x] `git diff --check HEAD` 통과 및 Phase 5 검증 기록 갱신.
|
||||
|
||||
```bash
|
||||
./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`
|
||||
|
||||
- [x] **RED:** `SENT` 수신 크리에이터와 `RECEIVED` 발신 팬 fixture에 서로 다른 가상 ID·닉네임·유효 URL을 넣고 각 카드 UI 모델의 세 값이 응답과 같은지 검증한다.
|
||||
- [x] **RED:** 두 방향 모두 이미지 URL `null`, `""`, `" "`을 null로 정규화하고 유효 URL은 그대로 유지하는 테스트를 작성한다.
|
||||
- [x] 기존 ViewModel의 `ALL/0/20`, pagination, 카드 클릭 상태 toast 테스트를 유지하고 필수 상대방 필드가 추가되는 fixture만 보완한다.
|
||||
- [x] **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`이 실패했다. 생산 코드는 수정하지 않았다.
|
||||
|
||||
```bash
|
||||
./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`
|
||||
|
||||
- [x] **GREEN:** `GiftInboxItemResponse`와 두 방향 `GiftInboxCardUiModel`에 `counterpartMemberId: Long`, `counterpartNickname: String`, `counterpartProfileImageUrl: String?`를 반영한다.
|
||||
- [x] **GREEN:** presenter에서 ID·닉네임은 그대로 전달하고 이미지 URL은 `counterpartProfileImageUrl?.takeIf { it.isNotBlank() }`로 정규화한다. 역할 라벨 대신 API 닉네임을 사용하며 상태·날짜·direction 정책은 유지한다.
|
||||
- [x] **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`
|
||||
|
||||
- [x] 두 카드 프로필 행을 이미지·닉네임으로 연결한다. `SENT`는 프로필 아래 `sizeName · categoryName`, `RECEIVED`는 상단 프로필·날짜와 본문 상태를 유지한다.
|
||||
- [x] 기존 Coil로 정규화된 URL을 매 bind마다 로드하고 `ic_placeholder_profile`을 placeholder/fallback/error에 사용한다. null/blank도 바인딩해 재활용된 이전 이미지를 남기지 않는다.
|
||||
- [x] 카드 클릭은 기존 상태 toast callback을 유지한다. 사용자 선택에 따라 상세 화면·프로필 화면·deeplink를 만들지 않는다.
|
||||
- [x] **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`:** 프로필 요구와 기존 목록 동작의 회귀를 최종 판정한다.
|
||||
|
||||
- [x] `P6-T1`~`P6-T3` 완료 증거와 focused presenter/ViewModel 테스트 PASS를 확인한다.
|
||||
- [x] 전체 gift local unit test를 실행하고 기존 53개 기준 회귀와 신규 프로필 테스트의 실제 총수·실패 수를 기록한다.
|
||||
- [x] resource merge, Kotlin compile, ktlintCheck, `git diff --check HEAD`가 모두 exit 0인지 확인한다.
|
||||
- [x] `GET /api/v2/gifts?type=ALL&page=0&size=20`, direction 렌더링, pagination, 상태 toast 보존을 대조하고 PRD 14.5와 검증 기록을 갱신한다.
|
||||
|
||||
```bash
|
||||
./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을 수정하지 않았다.
|
||||
|
||||
---
|
||||
|
||||
## 실행 순서와 의존성
|
||||
|
||||
| 순서 | 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에 회귀 수정 추가 |
|
||||
|
||||
```text
|
||||
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
|
||||
```
|
||||
|
||||
## 변경 금지 항목
|
||||
|
||||
- `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 완료 증거로 사용하지 않는다.
|
||||
|
||||
## 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` |
|
||||
|
||||
## 발견된 문제
|
||||
|
||||
| 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 전환과 검증 재실행은 없다.
|
||||
Reference in New Issue
Block a user