refactor: 收口排行配置模型

docs/technical/【前端架构】RankingViewModel收口计划-2026-06-03.md

@@ -0,0 +1,32 @@
+# 【前端架构】Ranking ViewModel 收口计划
+
+## 背景
+
+平台发现页排行频道以 `PlatformRankingTab` 决定 tab 文案、空态文案、排序字段和指标展示。原先排序与指标取值在 `rpgEntryPublicGalleryViewModel.ts`，而 tab label、metric label 与 empty text 留在 `RpgEntryHomeView.tsx`，页面还用类型断言寻找 active config，导致同一个排行语义的 **Interface** 分散。
+
+## 决策
+
+在 `src/components/rpg-entry/rpgEntryPublicGalleryViewModel.ts` 收口排行 **Interface**：
+
+- `DEFAULT_PLATFORM_RANKING_TAB` 与 `PLATFORM_RANKING_TABS`：统一 tab 顺序、tab label、metric label 与空态文案。
+- `getPlatformRankingTabConfig(tab)`：统一 active tab 配置兜底。
+- `getPlatformRankingMetric(entry, tab)`：统一 metric label 与 value，避免 label/value 漂移。
+- `buildPlatformRankingEntries(entries, tab)` 继续承载排序规则。
+
+`RpgEntryHomeView.tsx` 只保留 active tab 状态、点击与渲染，不再理解“热门榜=游玩值”“新品榜=近 7 日值”等映射。排行规则的 **Locality** 收口到 PublicGallery ViewModel。
+
+## 约定
+
+- 默认排行 tab 保持 `hot`。
+- tab 顺序保持“热门榜 / 改造榜 / 新品榜 / 点赞榜”。
+- 排序口径保持：`hot=playCount`、`remix=remixCount`、`new=recentPlayCount7d`、`like=likeCount`。
+- “新品榜”仍按近 7 日游玩数排序，不改为发布时间排序。
+- 页面层继续保留最多显示 30 条的展示限制。
+
+## 验证
+
+- `npm run test -- src/components/rpg-entry/rpgEntryPublicGalleryViewModel.test.ts`
+- `npm run test -- src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx -t "bottom category tab becomes ranking and switches ranking metrics|ranking"`
+- 针对变更文件执行 ESLint
+- `npm run typecheck`
+- `npm run check:encoding`