fix(donation): 빈 상태와 캔 표시를 수정한다

docs/20260704_크리에이터_채널_후원_탭/prd.md

@@ -16,11 +16,13 @@ Figma 참조:
 - 후원 후 홈 탭 후원 섹션은 갱신되지만, 후원 탭이 구현되면 후원 탭 목록도 함께 갱신되어야 한다.
 - 후원 탭 empty 문구와 `후원하기` 버튼이 한국어로 하드코딩되어 앱 언어 설정에 맞게 표시되지 않는다.
 - 후원 랭킹 title·전체보기 action과 공용 후원 카드의 can 표기·빈 메시지 fallback이 한국어로 하드코딩되어 영어·일본어 설정에서도 한국어가 노출된다.
+- `rankings.isEmpty && donationCount == 0`인 empty 상태에서도 count bar가 `전체 0`으로 표시된다.
+- 후원 item 우측 상단 can badge가 icon과 숫자 뒤에 언어별 단위까지 중복 표시한다.
 
 ## 3. Goals
 - `CreatorChannelTab.donation` 선택 시 후원 탭 API를 호출하고 응답 데이터로 화면을 구성한다.
 - 기본 query는 `page=0`, `size=20`이다.
-- `donationCount`는 sort-bar 좌측에 `전체 {donationCount}` 형식으로 표시한다.
+- `rankings.isEmpty && donationCount == 0`인 empty 상태에서는 count bar를 숨기고, 그 외에는 sort-bar 좌측에 `전체 {donationCount}`를 표시한다.
 - sort-bar에는 정렬 UI를 표시하지 않는다.
 - `rankings`는 Figma 후원 랭킹 섹션(`290:9097`)처럼 `후원 랭킹` 카드 안에 프로필 그리드로 표시한다.
 - 후원 랭킹 섹션의 `전체보기`를 터치하면 기존 `UserProfileDonationAllView`로 이동한다.
@@ -32,6 +34,7 @@ Figma 참조:
 - `donationCount != 0 || !rankings.isEmpty`이면 홈 탭 plus button 위치에 icon-only 후원하기 버튼을 표시한다.
 - 후원 성공 후 후원 탭 데이터와 홈 탭 데이터가 갱신되어야 한다.
 - 후원 랭킹과 공용 후원 카드의 고정 UI 문구는 기존 I18n을 우선 재사용하고, 재사용할 수 없는 빈 메시지 fallback만 `I18n.CreatorChannelDonation`에 추가한다.
+- 홈·후원 탭 공용 item의 can badge는 기존 can icon과 숫자만 표시하고 숫자 뒤 ko/en/ja 단위 문자열은 제거한다.
 
 ## 4. Non-Goals
 - 크리에이터 채널 공통 shell, header, sticky tab-bar 동작을 다시 설계하지 않는다.
@@ -85,7 +88,8 @@ data class CreatorChannelDonationResponse(
 
 ### 5.2 Sort-bar
 - 후원 탭 sort-bar는 정렬이 없고 전체 개수만 포함한다.
-- 좌측에 `전체`과 `donationCount`를 표시한다.
+- `rankings.isEmpty && donationCount == 0`이 아닐 때만 좌측에 `전체`와 `donationCount`를 표시한다.
+- `rankings.isEmpty && donationCount == 0`인 empty 상태에서는 `CreatorChannelDonationCountBar` 전체를 표시하지 않는다.
 - 우측 정렬 버튼, 정렬 아이콘, 정렬 context popup, BottomSheet는 표시하지 않는다.
 - 기존 `CreatorChannelSortBar`가 정렬 버튼을 필수로 노출하므로, 후원 탭에서는 별도 `CreatorChannelDonationCountBar`를 만들거나 `CreatorChannelSortBar`를 선택적으로 정렬 숨김 처리할 수 있다.
 
@@ -111,7 +115,8 @@ data class CreatorChannelDonationResponse(
   - `createdAtUtc` 상대 시간
   - `can`
   - `message`
-- 후원 금액 pill은 기존 can icon과 `I18n.LiveChat.canWithUnit(_:)`을 재사용해 ko/en/ja 단위 표기를 적용한다.
+- 홈·후원 탭 공용 item의 후원 금액 pill은 기존 can icon과 숫자만 표시하고 `I18n.LiveChat.canWithUnit(_:)`의 ko/en/ja 단위 문자열은 표시하지 않는다.
+- `CreatorChannelDonationCard`의 기존 공용 구조를 유지해 두 탭에 동일하게 적용한다.
 - 카드 상단 배경색은 홈 탭 후원 카드의 `can` 구간 색상을 재사용한다.
   - `1...50`: `#E2E2E2`
   - `51...100`: `#73EE01`
@@ -163,14 +168,15 @@ data class CreatorChannelDonationResponse(
 
 ## 6. Success Criteria
 - 후원 탭 진입 시 `GET /api/v2/creator-channels/{creatorId}/donations?page=0&size=20`가 호출된다.
-- sort-bar에는 `전체 {donationCount}`만 표시되고 정렬 버튼/아이콘/popup은 표시되지 않는다.
+- empty 상태가 아니면 sort-bar에 `전체 {donationCount}`만 표시되고 정렬 버튼/아이콘/popup은 표시되지 않는다.
 - `rankings`가 있으면 `후원 랭킹` 카드에 프로필 그리드와 rank number가 표시된다.
 - `후원 랭킹` 카드의 `전체보기`를 터치하면 `UserProfileDonationAllView`로 이동한다.
-- `donations` 목록은 기존 홈 탭 후원 카드와 같은 후원 금액별 상단 컬러, can pill, 상대 시간, 메시지 표시 규칙을 따른다.
-- 앱 언어가 ko/en/ja일 때 후원 랭킹 title·전체보기 action·can pill·빈 메시지 fallback이 해당 언어로 표시된다.
-- 공용 `CreatorChannelDonationCard`를 사용하는 홈 탭과 후원 탭에서 동일한 다국어 결과가 표시된다.
+- `donations` 목록은 기존 홈 탭 후원 카드와 같은 후원 금액별 상단 컬러, 상대 시간, 메시지 표시 규칙을 따르되, 후원 탭 can pill은 icon과 숫자만 표시한다.
+- 앱 언어가 ko/en/ja일 때 후원 랭킹 title·전체보기 action·빈 메시지 fallback이 해당 언어로 표시된다.
+- 후원 탭 can pill은 앱 언어와 관계없이 can icon과 숫자만 표시되고 숫자 뒤 단위 문자열은 표시되지 않는다.
+- 홈 탭의 공용 후원 카드도 can icon과 숫자만 표시되고 숫자 뒤 단위 문자열은 표시되지 않는다.
 - 목록 하단 도달 시 `hasNext == true`이면 다음 페이지가 append된다.
-- `rankings.isEmpty && donationCount == 0`이면 Figma `290:9009` empty view가 표시되고, 하단 고정 후원하기 버튼은 숨겨진다.
+- `rankings.isEmpty && donationCount == 0`이면 count bar 없이 Figma `290:9009` empty view가 표시되고, 하단 고정 후원하기 버튼은 숨겨진다.
 - Empty 문구가 지정된 ko/en/ja 값과 줄바꿈으로 표시되고, 버튼 문구는 기존 `I18n.ContentDetail.DonationDialog.title`을 사용한다.
 - 내 채널인 경우 Empty view의 후원하기 버튼과 우측하단 icon-only 후원하기 버튼이 모두 표시되지 않는다.
 - Empty view의 후원하기 버튼을 누르면 홈 탭과 동일한 후원 dialog가 열린다.
@@ -186,7 +192,8 @@ data class CreatorChannelDonationResponse(
 - 후원 item UI는 기존 홈 탭 구현과 중복을 줄이기 위해 공용 컴포넌트로 추출하거나, 홈/후원 탭 양쪽에서 같은 하위 컴포넌트를 사용하도록 최소 범위로 조정한다.
 - 신규 문구가 필요하면 `SodaLive/Sources/I18n/I18n.swift`에 ko/en/ja를 추가한다.
 - Empty 문구는 `pick(ko:en:ja:)`로 관리하고, 후원 버튼은 기존 `I18n.ContentDetail.DonationDialog.title`을 재사용한다. 신규 후원 버튼 문구, route, API, dependency는 추가하지 않는다.
-- 랭킹 title은 `I18n.Explorer.donationRankingTitle`, 전체보기는 `I18n.CreatorChannelHome.viewAll`, can pill은 `I18n.LiveChat.canWithUnit(_:)`을 재사용한다.
+- 랭킹 title은 `I18n.Explorer.donationRankingTitle`, 전체보기는 `I18n.CreatorChannelHome.viewAll`을 재사용한다.
+- 홈·후원 탭 공용 can pill은 단위 formatter나 신규 I18n을 추가하지 않고 서버의 `can` 숫자를 그대로 표시한다.
 - 빈 후원 메시지 fallback만 `I18n.CreatorChannelDonation.defaultMessage(_:)`로 추가하며 신규 dependency나 공용 formatter abstraction은 만들지 않는다.
 - 프로젝트 설정 변경은 신규 Swift 파일 target 등록이 필요한 경우에만 수행한다.
 
@@ -202,6 +209,9 @@ data class CreatorChannelDonationResponse(
 - 2026-08-26: `CreatorChannelDonationRankingSection`, 공용 `CreatorChannelDonationCard`, 두 컴포넌트의 호출 경로를 정적 점검해 런타임 하드코딩 4곳을 확정했다. Preview fixture의 샘플 문구는 런타임 제품 문구가 아니므로 제외했다.
 - 2026-08-26: 사용자 인터뷰로 랭킹 title은 기존 `I18n.Explorer.donationRankingTitle`을 재사용하고, 빈 후원 메시지는 카드 전용 ko/en/ja 문구를 추가하기로 결정했다. 이번 작업에서는 문서만 갱신하고 Swift·I18n 구현과 빌드는 수행하지 않는다.
 - 2026-08-26: Phase 7의 다국어 요구사항을 구현했다. `§5.3`, `§5.4`, `§6`, `§7`의 랭킹 title·전체보기·can pill·빈 메시지 fallback과 홈·후원 탭 공용 적용을 정적 계약, Debug 빌드, 독립 리뷰로 확인했다. 이 PRD에는 체크박스 항목이 없으며, 구현 체크 상태는 `plan-task.md` Phase 7에 기록했다. 사용자 요청에 따라 visual QA는 실행하지 않았다.
+- 2026-08-26: `CreatorChannelDonationTabView`, `CreatorChannelDonationCountBar`, 공용 `CreatorChannelDonationCard`와 홈 탭 호출부를 정적 확인했다. empty 상태의 count bar 숨김과 후원 탭 can 단위 제거 요구사항을 문서에 반영했으며, 공용 카드의 홈 탭 영향 범위는 미결로 남겼다. Swift 구현과 빌드는 수행하지 않았다.
+- 2026-08-26: 사용자 인터뷰에서 A안을 선택해 can badge 단위 제거를 공용 `CreatorChannelDonationCard`를 사용하는 홈·후원 탭에 함께 적용하기로 확정했다. `OQ-DONATION-BUG-001`을 종료했으며 Swift 구현과 빌드는 수행하지 않았다.
+- 2026-08-26: Phase 8을 구현해 후원 empty count bar를 숨기고 홈·후원 공용 카드의 can badge를 숫자만 표시하도록 수정했다. 정적 계약, `git diff --check`, `SodaLive-dev` Debug 빌드와 독립 사양·품질 리뷰가 통과했다. PRD에는 체크박스가 없으며 `§3`, `§5.2`, `§5.4`, `§5.7`, `§6`, `§7`, `DEC-DONATION-BUG-001`의 구현 누락이 없음을 대조했다. 사용자 요청에 따라 visual QA와 실제 화면 수동 검증은 수행하지 않았다.
 
 ## 10. Decision Log
 
@@ -209,3 +219,4 @@ data class CreatorChannelDonationResponse(
 |---|---|---|---|---|---|
 | 2026-08-26 | DEC-DONATION-I18N-001 | 확정 | 랭킹 title은 기존 `I18n.Explorer.donationRankingTitle`을 재사용한다. | 사용자 인터뷰에서 기존 `후원랭킹` 표기를 선택했다. | Ranking section |
 | 2026-08-26 | DEC-DONATION-I18N-002 | 확정 | 빈 후원 메시지는 `I18n.CreatorChannelDonation.defaultMessage(_:)` 전용 문구로 관리한다. | 공개 카드에서 `You donated`가 작성자를 오인하게 하므로 사용자 인터뷰에서 전용 문구를 선택했다. | Home·Donation 공용 card |
+| 2026-08-26 | DEC-DONATION-BUG-001 | 확정 | 공용 후원 카드의 can badge는 홈·후원 탭 모두 icon과 숫자만 표시하고 단위 문자열은 제거한다. | 사용자 인터뷰 A안 선택 | `§3`, `§5.4`, `§6`, Phase 8 |