# PRD: 크리에이터 랭킹 페이지 ## 1. Overview `HomeMainFragment`의 Text Tab bar에서 `랭킹`을 선택했을 때 `GET /api/v2/home/rankings/creators` 응답을 기존 `kr.co.vividnext.sodalive.v2.widget.creatorranking` 위젯으로 표시하는 홈 랭킹 페이지를 구현한다. --- ## 2. Problem - 홈 추천 화면에는 `추천`, `랭킹`, `팔로잉` Text Tab bar가 이미 배치되어 있지만, `랭킹` 선택 시 표시할 실제 페이지가 없다. - Figma `24:5654`에는 홈 랭킹 화면과 크리에이터 랭킹 목록이 정의되어 있으나, 3번째 줄의 Capsule Tab bar는 이번 요구사항에서 제외해야 한다. - 기존 크리에이터 랭킹 위젯은 `previousRank`, `rankChangeType`, `rankChangeAmount`, `creatorName`, `imageUrl`, `isBlocked` 계약을 사용한다. - 신규 API 응답은 `showRankChange`, `items[].rankChange`, `items[].isNew`, `items[].nickname`, `items[].profileImageUrl` 형태이므로 기존 위젯 계약으로 변환하는 mapper가 필요하다. --- ## 3. Goals - `HomeMainFragment`에서 Text Tab bar의 `랭킹` 선택 시 크리에이터 랭킹 페이지를 표시한다. - API `GET /api/v2/home/rankings/creators`를 호출해 응답 item을 기존 `CreatorRankingAdapter`/`CreatorRankingItem` 기반 UI로 표시한다. - Figma `24:5654` 기준 상단 TitleBar와 Text Tab bar 아래에 랭킹 목록을 배치한다. - Figma에 존재하더라도 3번째 줄 Capsule Tab bar(`주간 인기`, `지금 뜨는 중`, `남성 인기`, `여성 인기`)는 배치하지 않는다. - 기존 `kr.co.vividnext.sodalive.v2.widget.creatorranking` 위젯을 우선 재사용하고, API 응답과 Figma 정합에 필요한 최소 변경만 수행한다. - 랭킹 item 터치 시 접근 가능한 크리에이터의 프로필 화면으로 이동할 수 있도록 한다. --- ## 4. Non-Goals - Capsule Tab bar 및 기간/성별/인기 유형 필터는 구현하지 않는다. - `팔로잉` 탭 페이지는 구현하지 않는다. - 크리에이터 랭킹 위젯의 순위별 카드 variant 정책 자체를 새로 설계하지 않는다. - Figma에 없는 skeleton, shimmer, pagination, pull-to-refresh, 추가 배너, 광고 영역은 구현하지 않는다. - 서버 API 스키마를 클라이언트에서 임의로 변경하지 않는다. - ViewPager2 기반 tab swipe 전환, tab별 신규 Fragment 대량 분리는 이번 범위에 포함하지 않는다. --- ## 5. Target Users - 홈에서 인기 크리에이터 순위를 확인하려는 앱 사용자. - `HomeMainFragment`와 v2 위젯 기반 홈 화면을 유지보수하는 Android 개발자. --- ## 6. User Stories - 사용자는 홈의 `랭킹` 탭을 눌러 크리에이터 순위를 바로 보고 싶다. - 사용자는 1위, 2~10위, 11위 이후 순위가 시각적으로 구분된 카드로 표시되길 기대한다. - 사용자는 신규 진입 또는 순위 변동 정보를 랭킹 카드에서 확인하고 싶다. - 사용자는 랭킹 item을 눌러 해당 크리에이터 프로필로 이동하고 싶다. - 개발자는 API 응답을 기존 랭킹 위젯 계약으로 명확히 변환해 재사용하고 싶다. --- ## 7. Core Features ### Home Ranking Tab Page `HomeMainFragment`의 Text Tab bar에서 `랭킹` 선택 상태일 때 크리에이터 랭킹 목록을 표시한다. #### Requirements - Text Tab bar 항목은 기존과 동일하게 `추천`, `랭킹`, `팔로잉` 순서를 유지한다. - `랭킹` 선택 시 Text Tab bar selected index가 `랭킹`으로 갱신되어야 한다. - TitleBar와 Text Tab bar는 기존 홈 추천 화면과 동일하게 상단에 유지한다. - Text Tab bar 아래 content 영역만 랭킹 페이지 content로 교체한다. - 랭킹 페이지 content는 세로 스크롤 가능한 목록으로 구성한다. - Figma `24:5654`의 3번째 줄 Capsule Tab bar는 배치하지 않으므로, 랭킹 목록은 Text Tab bar 아래에서 바로 시작한다. - 추천 탭으로 다시 전환하면 기존 추천 페이지 content가 표시되어야 한다. #### Edge Cases - API loading 중에는 기존 홈 추천 API loading 처리와 일관된 정책을 따른다. - API error 또는 empty 응답이면 랭킹 목록 영역을 비우거나 기존 홈 empty/error 정책에 맞춰 처리한다. - `items`가 빈 배열이면 `CreatorRankingAdapter`에는 빈 목록을 전달하고, 불필요한 placeholder UI는 추가하지 않는다. ### Creator Ranking API Integration 홈 랭킹 페이지에서 `GET /api/v2/home/rankings/creators`를 호출하고 응답을 UI model로 변환한다. #### API Endpoint - `GET /api/v2/home/rankings/creators` #### Response Contract ```json { "showRankChange": true, "items": [ { "rank": 1, "rankChange": 5, "isNew": false, "creatorId": 123, "nickname": "creator", "profileImageUrl": "https://cdn.example.com/profile.png" } ] } ``` #### Mapping Requirements | Response field | UI/widget field | Requirement | | --- | --- | --- | | `items[].creatorId` | `CreatorRankingItem.creatorId` | 그대로 전달한다. | | `items[].rank` | `CreatorRankingItem.rank` | `1` 이상인 item만 표시한다. | | `items[].nickname` | `CreatorRankingItem.creatorName` | 그대로 전달한다. | | `items[].profileImageUrl` | `CreatorRankingItem.imageUrl` | 그대로 전달한다. | | `items[].isNew` | `CreatorRankingItem.rankChangeType` | `true`이면 `RankingChangeType.New`로 매핑한다. | | `items[].rankChange` | `CreatorRankingItem.rankChangeType`, `CreatorRankingItem.rankChangeAmount` | `null` 또는 `0`이면 `Stay`, 양수이면 `Increase`, 음수이면 `Decrease`로 매핑하고 표시 숫자는 절대값을 사용한다. | | `showRankChange` | 순위 변동 표시 여부 | `false`이면 모든 item의 rank-num 영역을 완전히 숨긴다. | #### Rank Change Rules - `isNew=true`이면 `rankChange` 값과 무관하게 `RankingChangeType.New`로 표시한다. - `isNew=false && (rankChange=null || rankChange=0)`이면 `RankingChangeType.Stay`로 표시한다. - `isNew=false && rankChange > 0`이면 `RankingChangeType.Increase`로 표시한다. - `isNew=false && rankChange < 0`이면 `RankingChangeType.Decrease`로 표시한다. - `Increase`와 `Decrease`의 표시 숫자는 `abs(rankChange)`를 사용한다. - `showRankChange=false`이면 `isNew`, `rankChange` 값과 무관하게 rank-num 영역을 완전히 숨긴다. - API 응답 item은 서버에서 항상 `rank` 오름차순으로 내려오지만, 클라이언트에서도 한 번 더 `rank` 기준 오름차순 정렬 후 표시한다. #### Click Requirements - `creatorId > 0`인 item만 클릭 이벤트가 동작한다. - `creatorId > 0`인 item을 터치하면 `UserProfileActivity`로 이동하고 `Constants.EXTRA_USER_ID`에 `creatorId`를 전달한다. - `creatorId = 0`인 item은 차단 관계인 크리에이터로 간주하며 클릭 이벤트가 동작하지 않는다. - 랭킹 item 터치 시 크리에이터 프로필 이동 외 별도 analytics/logging은 추가하지 않는다. ### Creator Ranking Widget Reuse 기존 `kr.co.vividnext.sodalive.v2.widget.creatorranking` 컴포넌트를 랭킹 페이지 목록에 사용한다. #### Existing Widget Fit - Figma `24:5654`의 카드 구조는 기존 크리에이터 랭킹 위젯 PRD의 순위 구간과 일치한다. - 1위: `Large` - 2위~7위: 2열 `Compact` - 8위~10위: 3열 `Compact` - 11위 이후: `Horizontal` - 이미지 radius, dim gradient, Pattaya 순위 숫자, rank-num, New badge는 기존 위젯 계약을 따른다. - API 응답에서 차단 관계인 크리에이터는 `creatorId=0`으로 내려오므로 `creatorId=0` item은 `isBlocked=true`, `creatorId>0` item은 `isBlocked=false`로 매핑한다. #### Required Change Candidates - `showRankChange=false`일 때 rank-num 영역을 완전히 숨기는 옵션이 기존 위젯에 없으면 최소 확장이 필요하다. - 기존 `CreatorRankingItem.rankChangeAmount`는 non-null `Int`이므로 `rankChange=null` 응답을 `Stay`와 `0`으로 안전하게 변환해야 한다. - 기존 위젯은 `creatorName`/`imageUrl` 이름을 사용하므로 API DTO와 UI model mapper를 분리한다. - 기존 Adapter의 span size는 position 기반으로 계산하므로 서버 정렬 보장과 별개로 mapper 또는 UI state에서 `rank` 기준으로 한 번 더 정렬한다. - `creatorId=0` item은 기존 위젯의 차단 상태 UI를 적용하고, 클릭 listener가 동작하지 않도록 보장한다. #### Edge Cases - `rank < 1` item은 기존 `CreatorRankingItem` 생성 조건에 맞지 않으므로 표시하지 않는다. - `nickname`이 빈 값이면 빈 문자열 그대로 표시하되, 별도 대체 문구는 추가하지 않는다. - `profileImageUrl`이 빈 값이거나 이미지 로딩에 실패하면 기존 `loadUrl`/이미지 로딩 정책을 따른다. - `creatorId=0`인 차단 관계 item은 상세 이동을 막고, 기존 차단 상태 위젯 정책에 따라 이미지 블러와 이름 비노출/대체문구를 적용한다. - 동일 rank가 중복되면 서버 데이터 오류로 보고 클라이언트는 받은 순서 또는 `rank` 정렬 결과를 그대로 표시한다. 중복 보정 UI는 추가하지 않는다. ### Creator Ranking View Rewrite Follow-up 크리에이터 랭킹 view는 후속 구현에서 기존 view를 부분 보정하지 않고 새로 작성한다. 이 문서 갱신은 rewrite 요구사항과 구현 계획만 정리하며, mapper/API 동작 변경이나 production code 변경은 포함하지 않는다. #### Figma References - 1 per row: Figma `24:5659` - 2 per row: Figma `24:5660` - 3 per row: Figma `24:5668` - 11~20: Figma `24:5670` #### Rewrite Requirements - 신규 크리에이터 랭킹 view는 `ConstraintLayout`을 사용해 작성한다. - 신규 크리에이터 랭킹 view에는 `FrameLayout`을 사용하지 않는다. - adapter view type은 두 개만 둔다. - ranks `1~10` - ranks `11~20` - `rank > 20` 값은 이번 문서 갱신에서 mapper/API 동작을 바꾸지 않는다. 별도 요구가 있기 전까지 현재 구현의 lower-row 처리 방식은 유지할 수 있다. - rank change와 `NEW` 표시 로직은 `CreatorRankingDeltaPresentation`과 `HomeCreatorRankingMappers`의 기존 의미를 유지한다. - `isNew`, `rankChange`, `showRankChange`, `RankingChangeType` 매핑 의미는 변경하지 않는다. #### Text Size Policy | Rank group | Row basis | Rank | Name | Delta | | --- | --- | --- | --- | --- | | `1~10` | 1 item row | `96sp` | `32sp` | `16sp` | | `1~10` | 2 item row | `54sp` | `22sp` | `16sp` | | `1~10` | 3 item row | `36sp` | `14sp` | `14sp` | | `11~20` | lower-row Figma basis | `40sp` | `18sp` | 기존 lower-row 표시 정책 유지 | #### View Size Policy - XML/Kotlin에서 layout sizing 목적으로 고정 width/height를 새로 도입하지 않는다. - layout sizing은 `wrap_content`, `match_parent`, margins, padding, constraints, match-constraint, 측정된 available width, aspect handling을 필요에 따라 조합한다. - 텍스트 크기, rank/name/delta 배치 모델, image aspect 계산처럼 화면 표현을 결정하는 값은 순수 로직으로 분리해 테스트할 수 있게 한다. #### Testing Policy - 테스트는 placement, text-style model, mapper, delta presentation, item behavior 같은 logic contract에만 작성한다. - view size, margin, padding, constraints, `TextView` dimensions, inflated layout params, visibility attributes에 대한 UI layout/visual test는 작성하지 않는다. - `CreatorRankingDeltaPresentation`과 `HomeCreatorRankingMappers`의 기존 rank change 및 `NEW` 의미가 유지되는지는 로직 테스트로 확인한다. --- ## 8. UX / UI Expectations - 전체 배경은 기존 홈과 동일한 black 계열을 유지한다. - TitleBar와 Text Tab bar는 Figma `24:5654` 및 기존 홈 추천 구현과 동일한 위치/스타일을 유지한다. - Capsule Tab bar를 제거한 상태에서도 Text Tab bar 아래 여백이 과도하게 남지 않아야 한다. - 랭킹 목록 좌우 margin과 item gap은 기존 `CreatorRankingAdapter`와 Figma 목록 폭을 기준으로 맞춘다. - 순위 숫자 `TextView`의 XML 및 Kotlin layout width/height는 `wrap_content`를 유지하고, Kotlin은 variant별 텍스트 크기와 rank area의 spacing/margin만 조정한다. - 1위, 2~7위, 8~10위, 11위 이후 순위 영역은 rank 숫자와 rank-num을 하나의 세로 rank group으로 묶어 해당 영역 안에서 가운데 정렬한다. - `rank-num`은 순위 숫자 아래에서 같은 rank area의 중앙 정렬 흐름을 따르며, 11위 이후 Horizontal은 기존 `ll_creator_ranking_rank_group`의 vertical/center 배치를 유지한다. - 8~10위 Compact small은 두 자리 순위(`10`)가 잘리지 않도록 rank group도 고정 폭이 아닌 `wrap_content`로 유지하고, rank와 rank-num 사이 간격을 Kotlin margin으로 더 좁힌다. - 8~10위 Compact small 닉네임은 3열 카드 폭에서 답답하지 않도록 기존 14sp보다 작게 표시한다. - `랭킹` 탭 선택 상태가 흰색 텍스트로 명확히 드러나야 한다. - 1위~20위까지 응답이 내려오면 Figma 예시처럼 20위까지 자연스럽게 스크롤로 확인할 수 있어야 한다. - 긴 닉네임은 기존 위젯의 ellipsize/line 제한 정책을 따른다. --- ## 9. Technical Constraints - Android XML Views, ViewBinding, RecyclerView 기반 기존 구조를 유지한다. - 신규 API DTO, Repository, ViewModel, mapper, UI model은 기존 홈 추천 패턴을 확인해 `kr.co.vividnext.sodalive.v2.main.home` 하위에 둔다. - 신규 `Activity`, `Fragment`, `ViewModel` 및 연결 하위 코드는 `kr.co.vividnext.sodalive.v2` 패키지 하위에 작성한다. - 화면은 우선 `HomeMainFragment`와 `fragment_v2_main_home.xml`의 기존 상단 구조를 확장해 구현한다. - 기존 `CreatorRankingAdapter.createGridLayoutManager()`를 사용해 span 정책을 유지한다. - 크리에이터 프로필 이동은 `creatorId > 0`일 때만 기존 `UserProfileActivity`와 `Constants.EXTRA_USER_ID` 사용 패턴을 재사용한다. - 네트워크/API 등록은 기존 `AppDI.kt`의 홈 추천 API/Repository/ViewModel 등록 패턴을 따른다. - 구현 전 `docs/20260608_크리에이터_랭킹_페이지/plan-task.md`를 작성한 뒤 해당 계획에 따라 최소 구현한다. --- ## 10. Metrics - `랭킹` 탭 선택 시 `GET /api/v2/home/rankings/creators` 응답 item이 `CreatorRankingAdapter`에 전달된다. - Figma `24:5654`의 Capsule Tab bar는 화면에 존재하지 않는다. - 1위, 2~7위, 8~10위, 11위 이후 variant가 기존 위젯 정책과 일치한다. - 순위 숫자 `TextView`는 모든 variant에서 `wrap_content` width/height, `Gravity.CENTER`, `includeFontPadding=false`를 유지한다. - 1위, 2~7위, 8~10위, 11위 이후 rank group은 순위 숫자와 rank-num을 같은 rank area 중앙에 세로 정렬한다. - Kotlin은 Compact 2열 순위 `54sp`/닉네임 `22sp`/rank-num `16sp`, Compact 3열 순위 `36sp`/닉네임 `13sp`/rank-num `14sp` 텍스트 크기 계약을 유지한다. - Compact 3열 rank group은 `wrap_content` width를 유지하고, `rank=10`도 전체 숫자가 표시되어야 한다. - `isNew=true` item은 New badge로 표시된다. - `isNew=false && (rankChange=null || rankChange=0)` item은 유지 상태로 표시된다. - `rankChange > 0` item은 상승, `rankChange < 0` item은 하락으로 표시된다. - `showRankChange=false` 응답에서는 rank-num 영역이 완전히 숨겨진다. - `rank < 1` item은 표시되지 않는다. - `creatorId=0` item은 클릭되지 않고, `creatorId>0` item만 `UserProfileActivity`로 이동한다. - API 응답은 클라이언트에서 `rank` 기준 오름차순으로 한 번 더 정렬된다. - 빈 응답, API 실패, 이미지 실패가 crash 없이 처리된다. - 관련 mapper/unit test, `HomeMainFragment` layout test, `compileDebugKotlin`, `ktlintCheck`가 성공한다. - 후속 rewrite에서는 신규 크리에이터 랭킹 view가 `ConstraintLayout` 기반이고 `FrameLayout`을 사용하지 않는다. - 후속 rewrite에서는 adapter view type이 ranks `1~10`, ranks `11~20` 두 개뿐이다. - 후속 rewrite에서는 ranks `1~10` 텍스트 크기가 1 item row `96sp/32sp/16sp`, 2 item row `54sp/22sp/16sp`, 3 item row `36sp/14sp/14sp` rank/name/delta 정책을 따른다. - 후속 rewrite에서는 ranks `11~20`이 Figma `24:5670` lower-row 기준으로 rank `40sp`, name `18sp`를 사용한다. - 후속 rewrite 테스트는 logic contract 중심이며, UI layout/visual 속성 검증 테스트는 작성하지 않는다. --- ## 11. Open Questions - 없음. --- ## 12. References - Figma: https://www.figma.com/design/HmN1yNdJ3EIpqknFL0Hkab/-%EA%B3%B5%EC%9C%A0%EC%9A%A9-%EB%B3%B4%EC%9D%B4%EC%8A%A4%EC%98%A8-UI-UX-%EA%B8%B0%ED%9A%8D%EB%AC%B8%EC%84%9C?node-id=24-5654&m=dev - Figma 1 per row: `24:5659` - Figma 2 per row: `24:5660` - Figma 3 per row: `24:5668` - Figma 11~20 lower row: `24:5670` - 기존 크리에이터 랭킹 위젯 PRD: `docs/prd/20260520_크리에이터랭킹위젯컴포넌트_prd.md` - 기존 홈 추천 PRD: `docs/20260601_메인_홈_추천_UI와_API_연동/prd.md` - 기존 위젯 패키지: `app/src/main/java/kr/co/vividnext/sodalive/v2/widget/creatorranking` --- ## 13. Verification Log - 2026-06-29: 크리에이터 랭킹 view rewrite를 완료했다. `CreatorRankingAdapter`는 ranks `1~10` top-card와 ranks `11+` lower-row 두 view type만 사용하며, `CreatorRankingTopCardView`와 `CreatorRankingLowerRowView`는 `ConstraintLayout` 기반으로 작성했다. 기존 `FrameLayout` 기반 Large/Compact/Horizontal view와 layout calculator/card variant는 creator ranking 경로에서 제거했다. - 2026-06-29: rank change와 `NEW` 표시는 `CreatorRankingDeltaPresentation`, API mapper 의미는 `HomeCreatorRankingMappers`를 유지했다. 텍스트 크기는 `CreatorRankingTextStyle` 순수 로직으로 분리했고, 테스트는 placement/text-style/mapper/delta/item behavior 같은 logic contract 중심으로 정리했다. 최종 검증으로 creator ranking tests, main.home tests, mapper test, `mergeDebugResources`, `compileDebugKotlin`, `ktlintCheck`, `git diff --check`, obsolete reference/FrameLayout 검색이 통과했다. - 2026-06-29: 후속 요구사항으로 8~10위 Compact small에서 rank와 rank-num 간격이 넓고 `10` 표시가 답답해 보이는 문제를 확인했다. 원인은 rank `TextView`가 아니라 `CreatorRankingCompactCardView.positionSmall()`에서 parent `ll_creator_ranking_rank_group` 폭이 `52 * scale`로 고정되는 점으로 정리했다. PRD에 Compact small rank group `wrap_content`, `rank=10` 표시 보장, rank/rank-num 간격 축소, 닉네임 13sp 요구사항을 반영했다. - 2026-06-29: Compact small 보정으로 `ll_creator_ranking_rank_group` width를 `WRAP_CONTENT`로 변경하고, 닉네임을 `13sp`로 줄였으며, rank-num top margin을 `-4 * scale`로 조정했다. `CreatorRankingAdapterLayoutTest`, `mergeDebugResources`, `compileDebugKotlin`, `ktlintCheck`, `git diff --check`가 통과했다. - 2026-06-29: 후속 요구사항으로 크리에이터 랭킹 카드 rank-area 계약을 갱신했다. 모든 variant의 `tv_creator_ranking_rank` XML/Kotlin width/height는 `wrap_content`를 유지하고, Kotlin은 Compact medium `54sp/22sp/16sp`, Compact small `36sp/14sp/14sp` 텍스트 크기와 rank group/delta spacing만 조정하며, Large/Compact/Horizontal 모두 순위 숫자와 rank-num을 rank area 중앙에 세로 정렬해야 한다. - 2026-06-29: `CreatorRankingAdapterLayoutTest`를 새 계약으로 갱신한 뒤 production 수정 전 실행해 Large/Compact rank group 미구현 및 Horizontal rank `TextView` 고정 layoutParams 때문에 실패함을 확인했다. 이후 Large/Compact XML에 rank group을 추가하고 Kotlin의 rank `TextView` 고정 width/height 설정을 제거했으며, `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.creatorranking.CreatorRankingAdapterLayoutTest"`, `./gradlew :app:mergeDebugResources`, `./gradlew :app:compileDebugKotlin`이 모두 `BUILD SUCCESSFUL`로 통과했다. `rg`로 Kotlin 내 rank `TextView` 고정 sizing 잔여 없음과 XML `wrap_content` 유지도 확인했다. - 2026-06-29: Horizontal rank-num 간격도 XML 고정 margin 대신 Kotlin scale 기반 spacing으로 옮겼다. 재검증으로 `CreatorRankingAdapterLayoutTest`, `mergeDebugResources`, `compileDebugKotlin`이 모두 `BUILD SUCCESSFUL`로 통과했고, `rg`로 XML 고정 margin 및 Kotlin rank `TextView` 고정 sizing 잔여 없음도 확인했다. - 2026-06-29: 후속 요구사항으로 Figma `24:5668`, `24:5661`, `24:5670`을 확인했다. 메인 홈 랭킹 탭에서 item 간격은 `8dp`, 3열 Compact는 순위 `36sp`/닉네임 `14sp`/rank-num 숫자 `14sp`, 2열 Compact는 순위 `54sp`/닉네임 `22sp`/rank-num 숫자 `16sp`, 11위 이후 Horizontal은 순위와 New/순위 변동 표시가 rank group 내부에서 바로 이어지는 세로 배치를 유지해야 한다. - 2026-06-29: 위 기준에 따라 `CreatorRankingCompactCardView`, `CreatorRankingAdapter`, `HomeMainFragment`를 최소 수정했다. 3열 Compact 순위/변동 텍스트 크기, item 폭 계산 기준, 실제 RecyclerView item decoration 간격 `8dp`를 보정했고, 2열 Compact 및 11위 이후 Horizontal 배치는 회귀 테스트로 유지했다. 리뷰 게이트에서 지적된 실제 `GridLayoutManager` 간격 보장 문제는 전용 `CreatorRankingItemDecoration`과 Fragment 연결 테스트를 추가해 보완했다. - 2026-06-25: Figma `24:5659`의 rank component screenshot을 확인했다. rank 숫자와 rank-num은 좌표상 분리되어 있으나, 실제 구현에서는 `includeFontPadding=false`가 이미 적용된 상태에서도 Pattaya glyph가 고정 rank box 하단에 붙어 보여 rank-num과 시각적으로 붙는 문제가 발생할 수 있음을 확인했다. - 2026-06-25: 후속 요구사항으로 크리에이터 랭킹 카드의 기존 Figma 위치값(`rank-num` top: 1위 116, 2~7위 70, 8~10위 50, 11위 이후 rank group 내부 배치)은 유지하고, 순위 숫자 `TextView` 내부 하단 padding만 보정해 폰트별 glyph 하단 차이가 rank-num 간격을 침범하지 않도록 한다. - 2026-06-25: 크리에이터 랭킹 Large/Compact/Horizontal 카드에 scale 기반 하단 padding을 적용하고, `CreatorRankingAdapterLayoutTest`에서 `includeFontPadding=false`와 padding 값을 검증하도록 했다. `CreatorRankingAdapterLayoutTest`, `creatorranking.*`, `mergeDebugResources`, `compileDebugKotlin`은 통과했고, `ktlintCheck`는 기존 전역 위반으로 실패했다. - 2026-06-08: `docs/prd/sample-prd.md`, `docs/agent-guides/work-plan-docs.md`, 기존 크리에이터 랭킹 위젯 PRD, `CreatorRankingItem`, `CreatorRankingAdapter`, `CreatorRankingDeltaPresentation`, `RankingChangeType`, `HomeMainFragment`를 확인했다. - 2026-06-08: Figma `24:5654`의 design context와 screenshot을 확인했다. 화면에는 Capsule Tab bar가 포함되어 있으나 사용자 요구에 따라 PRD 범위에서 제외했다. - 2026-06-08: 이번 단계는 PRD 작성만 수행했으며 구현/빌드/테스트는 실행하지 않았다. - 2026-06-08: 사용자 추가 제공 정보에 따라 `rankChange`의 양수/음수/0 매핑, `showRankChange=false` 시 rank-num 완전 숨김, 클라이언트 `rank` 재정렬, `creatorId=0` 차단 관계 및 클릭 불가 정책을 반영했다. - 2026-06-08: 사용자 추가 제공 정보에 따라 랭킹 item 터치 시 `UserProfileActivity` 이동 외 별도 analytics/logging을 추가하지 않는 것으로 확정하고 Open Questions를 없음으로 정리했다. - 2026-06-08: 최종 검증으로 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.creatorranking.*"`, `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.home.HomeCreatorRankingMapperTest"`, `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.main.home.HomeMainFragmentLayoutTest"`, `./gradlew :app:mergeDebugResources`, `./gradlew :app:compileDebugKotlin`, `./gradlew :app:ktlintCheck`를 순차 실행했고 모두 `BUILD SUCCESSFUL`로 통과했다. Gradle deprecated feature warning은 기존 빌드 경고로 보고 수정하지 않았다. - 2026-06-09: 사용자 확인에 따라 Figma상 순위 숫자의 margin 값 자체를 추가하지 않고, 기존 고정 텍스트 박스 크기 안에서 텍스트 정렬을 맞추는 후속 보정 요구사항을 추가했다. - 2026-06-09: 순위 TextView 내부 중앙 정렬 보정 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.creatorranking.CreatorRankingAdapterLayoutTest"`, `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.creatorranking.*"`, `./gradlew :app:mergeDebugResources`가 모두 `BUILD SUCCESSFUL`로 통과했다. - 2026-06-09: Figma `24:5658` design context와 screenshot을 재확인해 순위 숫자 박스 및 rank-num 위치의 최신 기준값을 후속 보정 요구사항으로 반영했다. - 2026-06-09: 최신 Figma 수치 보정 후 `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.creatorranking.CreatorRankingAdapterLayoutTest"`, `./gradlew :app:testDebugUnitTest --tests "kr.co.vividnext.sodalive.v2.widget.creatorranking.*"`, `./gradlew :app:mergeDebugResources`, `./gradlew :app:ktlintCheck`가 모두 `BUILD SUCCESSFUL`로 통과했다. - 2026-06-29: 후속 rewrite 범위로 크리에이터 랭킹 view를 새로 작성하는 요구사항을 추가했다. 신규 view는 `ConstraintLayout`을 사용하고 `FrameLayout`을 사용하지 않으며, adapter view type은 ranks `1~10`과 ranks `11~20` 두 개만 둔다. `rank > 20`은 이번 문서 갱신에서 mapper/API 동작을 바꾸지 않고, 별도 요구 전까지 현재 lower-row 처리를 유지할 수 있다고 기록했다. - 2026-06-29: Figma `24:5659`, `24:5660`, `24:5668`, `24:5670` 기준과 ranks `1~10`, ranks `11~20` 텍스트 크기 정책을 추가했다. rank change와 `NEW` 로직은 `CreatorRankingDeltaPresentation` 및 `HomeCreatorRankingMappers` 의미를 유지하고, 테스트는 placement, text-style model, mapper, delta presentation, item behavior 같은 logic contract 중심으로 제한한다고 기록했다.