fix(following): empty 안내 문구를 정리한다

This commit is contained in:
2026-08-19 17:57:53 +09:00
parent 3d217197e7
commit 0ec6c6c29b
6 changed files with 165 additions and 4 deletions
@@ -1544,7 +1544,78 @@
---
### Phase 15: 팔로잉 empty 안내 문구 변경
**Phase 결과:** 팔로잉 탭의 5개 섹션이 모두 비면 기존 중앙 empty UI에 확정된 한국어·일본어 안내 문구가 표시되고, 안내 상태에서도 당겨서 새로고침할 수 있다.
**선행조건:** Phase 12의 `HomeFollowingUiState.Empty` 중앙 표시와 홈 탭 `SwipeRefreshLayout` 새로고침 경로가 유지되어야 한다.
**Phase 완료 조건:** `P15-T1``P15-GATE` 완료, 한국어·일본어 문구 변경 및 영어·empty 판정·중앙 표시·새로고침 회귀 검증 기록 누적.
#### Task 15.1 한국어·일본어 empty 안내 문구 교체
**Goal 실행 `P15-T1`:** 기존 empty UI와 string key를 재사용해 한국어·일본어 문구의 첫 문장만 확정 문구로 교체한다.
- **시작 조건:** PRD의 `2026-08-19 팔로잉 empty 안내 문구 변경 Requirements``DEC-20260819-001` 확정.
- **완료 증거:** 기존 source test의 한국어·일본어 기대값 RED → 두 locale string resource 최소 변경 → focused test GREEN.
- **범위 밖:** 영어 문구, API/DTO/mapper, `HomeFollowingUiState`, `HomeMainFragment`, `fragment_v2_main_home.xml`, 다른 화면의 empty 문구 변경.
**Files:**
- Modify: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/home/HomeFollowingFragmentSourceTest.kt`
- Modify: `app/src/main/res/values/strings.xml`
- Modify: `app/src/main/res/values-ja/strings.xml`
- Confirm unchanged: `app/src/main/res/values-en/strings.xml`
**Interfaces:**
- Consumes: `HomeFollowingUiState.Empty`, `R.string.screen_home_following_empty`, `tv_home_following_empty`의 기존 표시 경로.
- Produces: 한국어 `아직 팔로우한 크리에이터가 없어요.\n관심 있는 크리에이터를 팔로우해 보세요.`, 일본어 `まだフォローしているクリエイターがいません。\n気になるクリエイターをフォローしてみましょう。` resource 값.
- [x] **RED:** `HomeFollowingFragmentSourceTest`의 한국어·일본어 `screen_home_following_empty` 기대값을 확정 문구로 변경하고 영어 기대값은 유지한다.
- [x] **RED 확인:** `./gradlew --no-daemon :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.home.HomeFollowingFragmentSourceTest"`를 실행해 기존 한국어 첫 문장 불일치로 focused test가 실패하는지 확인한다.
- [x] **GREEN:** `values/strings.xml``values-ja/strings.xml`의 기존 `screen_home_following_empty` 첫 문장만 확정 문구로 교체한다.
- [x] **GREEN 확인:** 같은 focused test를 다시 실행해 한국어·일본어 새 문구와 기존 영어 문구 검증이 통과하는지 확인한다.
- [x] **REFACTOR:** 추가 abstraction이나 새 resource key를 만들지 않고 이번 변경이 만든 불필요한 수정만 정리한 뒤 focused test와 `git diff --check`를 다시 실행한다.
검증 기록:
- 2026-08-19 RED: `HomeFollowingFragmentSourceTest`의 한국어·일본어 기대값만 확정 문구로 변경하고 영어 기대값은 유지한 뒤 focused test를 실행했다. 기존 한국어 resource 값 불일치로 `HomeFollowingFragmentSourceTest.kt:120` assertion 실패를 확인했다.
- 2026-08-19 GREEN: `values/strings.xml`, `values-ja/strings.xml`의 기존 `screen_home_following_empty` 첫 문장만 교체했다. 같은 focused test가 `BUILD SUCCESSFUL`로 통과했고 `git diff --check`도 PASS했다. 새 resource key나 abstraction은 추가하지 않았다.
#### Task 15.2 empty 표시와 당겨서 새로고침 회귀 검증
**Goal 실행 `P15-GATE`:** 문구 변경 후에도 기존 5개 섹션 전체 empty 판정, 중앙 empty UI 연결, 팔로잉 당겨서 새로고침 경로가 유지되는지 판정한다.
- **시작 조건:** `P15-T1` 완료.
- **완료 증거:** 아래 local unit/source test, resource merge, Kotlin compile, ktlint와 diff 검증 결과 기록.
- **범위 밖:** `app/src/androidTest` 작성·실행, 기기·에뮬레이터 UI 조작, 스크린샷·시각 QA, layout 속성 직접 테스트.
- **TDD 예외 사유:** 신규 production 로직이 없는 회귀 검증 Gate이므로 별도 RED/GREEN 구현 단계를 만들지 않는다.
- **대체 검증 방법:** 기존 mapper test로 5개 섹션 전체 empty 판정을, source test로 empty string 연결·상태 분기와 홈 탭 refresh routing을 검증하고, Phase 12에서 확정된 layout 파일이 이번 Phase에서 변경되지 않았는지 diff로 확인한다.
**Files:**
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/home/HomeFollowingMapperTest.kt`
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/home/HomeFollowingFragmentSourceTest.kt`
- Test: `app/src/test/java/kr/co/vividnext/sodalive/v2/main/home/HomeMainFragmentSourceTest.kt`
- Confirm unchanged: `app/src/main/res/layout/fragment_v2_main_home.xml`
- Confirm unchanged: `app/src/main/java/kr/co/vividnext/sodalive/v2/main/home/HomeMainFragment.kt`
- [x] `./gradlew --no-daemon :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.home.HomeFollowingMapperTest" --tests "kr.co.vividnext.sodalive.v2.main.home.HomeFollowingFragmentSourceTest" --tests "kr.co.vividnext.sodalive.v2.main.home.HomeMainFragmentSourceTest"` PASS.
- [x] `./gradlew --no-daemon :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` PASS.
- [x] `git diff --check` PASS.
- [x] 이번 Phase의 production 변경이 `values/strings.xml`, `values-ja/strings.xml``screen_home_following_empty` 값으로 한정되고 영어 resource, layout, Kotlin production 파일이 변경되지 않았음을 확인한다.
- [x] Task별 검증 결과와 실행 중 확인된 기존 경고를 이 Phase의 검증 기록에 한국어로 누적한다.
검증 기록:
- 2026-08-19: mapper·Fragment·홈 refresh routing focused test가 `BUILD SUCCESSFUL`로 통과해 기존 5개 섹션 전체 empty 판정, 중앙 empty string 연결·상태 분기, 팔로잉 당겨서 새로고침 경로를 확인했다. `:app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck``git diff --check`도 PASS했다. ktlint에서는 기존 `.editorconfig disabled_rules` deprecation warning만 출력됐다. 영어 resource, layout, Kotlin production 파일은 변경하지 않았고, 계획에 따라 androidTest·기기 조작·스크린샷·시각 QA는 실행하지 않았다. 명세 및 코드 품질 리뷰는 blocking finding 없이 승인됐다.
---
## Verification Log
- 2026-08-19 Phase 15 구현 완료: `screen_home_following_empty`의 한국어·일본어 첫 문장만 확정 문구로 변경하고 영어 문구와 기존 empty 판정·중앙 표시·당겨서 새로고침 경로를 유지했다. focused RED는 기존 한국어 resource 불일치로 확인했고 최소 resource 수정 후 GREEN으로 전환했다. mapper·Fragment·refresh routing 회귀, resource merge, Kotlin compile, ktlint, `git diff --check`가 PASS했으며 명세·품질 리뷰에서 확정 발견 사항은 없었다.
- 2026-08-19 문서 전용 계획 추가: 사용자 인터뷰를 통해 기존 5개 섹션 전체 empty 판정과 영어 문구를 유지하고, 한국어·일본어 `screen_home_following_empty` 첫 문장만 변경하는 요구사항을 확정했다. 기존 중앙 empty UI와 당겨서 새로고침 경로를 재사용하는 최소 범위로 Phase 15를 추가했으며, 코드·resource·test 구현은 진행하지 않았다. 문서 검증에서 요구사항·Decision·Goal 추적, `git diff --check`, production/test 경로 변경 0건을 확인했다. `./gradlew --no-daemon tasks --all`은 sandbox의 Gradle lock 접근 제한으로 첫 실행이 실패했으나 승인된 동일 명령 재실행은 `BUILD SUCCESSFUL`로 통과했다.
- 2026-08-18 Phase 14 구현 완료: 팔로잉 크리에이터 `전체`를 RecyclerView 마지막 item에서 추천 탭 라이브 섹션과 같은 우측 고정 TextView로 변경했다. adapter는 creator item만 표시하고, 기존 로그인 가드와 `FollowingCreatorActivity` 이동을 고정 TextView 클릭에 연결했다. TDD RED/GREEN, 팔로잉 회귀, resource merge, Kotlin compile, ktlint, `git diff --check`, debug APK assemble가 PASS했다. visual QA와 기기 조작은 사용자 요청으로 실행하지 않았고, 사용자가 `app/build/outputs/apk/debug/app-debug.apk`로 팔로잉 크리에이터 목록 스크롤 중 `전체` 고정과 클릭 이동을 수동 확인했다. Phase 14 리뷰에서 Critical/Important finding은 없었다.
- 2026-08-18 문서 전용 계획 추가: 팔로잉 크리에이터 `전체` 버튼을 RecyclerView 마지막 item에서 추천 탭 라이브 섹션과 같은 우측 고정 TextView 구조로 변경하는 요구사항을 PRD에 추가하고, 구현은 진행하지 않은 상태로 Phase 14 계획/TASK만 작성했다.
- 2026-07-31 이번 Phase 1~13 리뷰 재검증: 현재 working tree의 PRD·계획·production/test 코드와 Phase별 리뷰 보고서 13개를 대조했다. 새 확정 발견 사항은 없고 기존 확정 항목은 모두 각 회귀 수정 Task에서 수정 완료 상태다. Phase 9 보고서 범위를 Task 9.7까지 확장해 production/test `FeedAdapter|FeedImageViews` 호출자 0건과 현재 Feed view/model 직접 재사용을 기록했다. `./gradlew --no-daemon :app:testDebugUnitTest ... :app:mergeDebugResources :app:compileDebugKotlin :app:ktlintCheck` PASS(`BUILD SUCCESSFUL`, 16 suites·120 tests, failures/errors/skipped 0, 46 actionable tasks), `./gradlew --no-daemon tasks --all`, staged/unstaged `git diff --check` PASS. `adb devices`에서 기기 `2cec640c34017ece` 연결은 확인했지만 테스트 계정·API 데이터 기반 팔로잉 화면 조작과 Figma 대조는 수행하지 않아 `REV-P5-001` / Task 5.3 보류를 유지한다. 이번 리뷰에서는 production/test/resource 코드를 수정하지 않았다.