refactor: 收口个人资金展示模型

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

@@ -0,0 +1,31 @@
+# 【前端架构】Profile Funds ViewModel 收口计划
+
+## 背景
+
+`RpgEntryHomeView.tsx` 原先直接维护钱包账单来源文案、金额正负号、账单余额兜底、充值价格、充值商品主值和会员摘要文案。这些规则散在页面 **Implementation** 内，且已与 `ProfileWalletLedgerEntry.sourceType` 契约产生漂移：后端可返回 `puzzle_author_incentive_claim`，页面没有对应中文 label，会把原始枚举值外显给用户。
+
+## 决策
+
+新增 `src/components/rpg-entry/rpgEntryProfileFundsViewModel.ts` 作为个人资金展示 **Module**。该 **Module** 的 **Interface** 收口为：
+
+- `getWalletLedgerSourceLabel(sourceType)`：统一账单来源中文文案，补齐 `puzzle_author_incentive_claim`。
+- `formatWalletLedgerAmount(amountDelta)`：统一账单金额正负号。
+- `buildWalletLedgerPresentation(ledger, fallbackBalance)`：统一余额兜底与账单行 presentation。
+- `formatRechargePrice(priceCents)` 与 `buildRechargeProductValueLabel(product)`：统一充值商品价格与主值文案。
+- `buildMembershipLabel(membership, formatTime)`：统一会员摘要文案，并保留页面现有时间格式 Adapter。
+
+`RpgEntryHomeView.tsx` 只消费该 **Module** 输出，保留弹窗布局、支付流程、微信渠道和轮询副作用。资金展示规则的 **Locality** 收口到纯函数测试，后续新增账单来源或调整价格 / 会员文案时不再穿透页面 JSX。
+
+## 约定
+
+- 未知账单来源仍保留原始 sourceType 兜底，避免新后端枚举被空白吞掉。
+- 账单余额继续沿用既有口径：有账单时取第一条 `balanceAfter`，无账单时使用外部 fallback balance。
+- 本次只收展示 **Interface**，不迁移支付确认、微信跳转、订单轮询或弹窗状态。
+
+## 验证
+
+- `npm run test -- src/components/rpg-entry/rpgEntryProfileFundsViewModel.test.ts`
+- `npm run test -- src/components/rpg-entry/RpgEntryHomeView.recharge.test.tsx -t "wallet ledger|profile recharge modal shows native qr code"`
+- 针对变更文件执行 ESLint
+- `npm run typecheck`
+- `npm run check:encoding`