修复泥点余额自动刷新

顶部泥点总余额优先展示实时钱包余额，避免缓存明细覆盖刷新结果。补充缓存明细场景的余额变更回归测试。同步主站与图片画布的泥点余额数据口径文档。
2026-07-15 22:01:25 +08:00
parent cfdba640ee
commit ea8d0ef064
4 changed files with 30 additions and 5 deletions
@@ -9,7 +9,7 @@
 - 主站新增 `/editor/canvas` 路由，进入独立图片画布编辑器阶段。
 - 主站新增 `/project` 项目页，从“我的”页项目入口进入，展示当前用户所有图片画布工程；点击项目进入 `/editor/canvas?projectid=<projectId>`。
 - 创作 Tab 顶部提供编辑器入口，入口只负责跳转，不参与玩法创作链路。
- 编辑器顶部栏采用紧凑高度，项目标题和重命名入口贴近返回项目按钮；右侧复用与主站相同的公共泥点资产入口，并以充值中心 `mudPointBalance` 为余额真相源。余额区只展开不限时、每日免费及重置信息，会员周期限时泥点保留在后端 read model 中用于存量兼容和结算但不展示；独立“充值”按钮进入“购买更多泥点”弹窗，“使用详情”进入泥点账单。
+- 编辑器顶部栏采用紧凑高度，项目标题和重命名入口贴近返回项目按钮；右侧复用与主站相同的公共泥点资产入口。顶部总余额优先展示画板按扣费、退回、到账和页面恢复链路刷新的 `profileDashboard.walletBalance`，充值中心 `mudPointBalance` 仅用于展开面板的账户明细，不覆盖已刷新的总余额。余额区只展开不限时、每日免费及重置信息，会员周期限时泥点保留在后端 read model 中用于存量兼容和结算但不展示；独立“充值”按钮进入“购买更多泥点”弹窗，“使用详情”进入泥点账单。
 - 编辑器左侧为图片素材栏，可展开 / 收起；移动端优先保持素材栏可折叠。
 - 中央画布支持背景拖拽平移、滚轮缩放、缩放百分比菜单、显示所有元素和固定比例缩放。
 - 画布左下角提供 Lovart 式状态控件：背景色圆点、素材 / 图层入口、小地图开关；小地图显示图层缩略分布和当前视口框，点击小地图执行显示所有元素。
@@ -12,7 +12,7 @@

 旧库或旧迁移包没有 `event_banners_json` 时，后端读取层必须把 `eventBanners` 归一到 `module-runtime` 默认公告数组，不能把旧结构化 `eventBanner` 当成前端优先数组下发。默认公告引用的背景图必须指向 `public/` 下真实存在的站内静态资源，当前默认使用 `/creation-type-references/puzzle.webp`，避免创作入口顶部 banner 出现失效图片。

-创作页和草稿页顶栏右上角统一复用公共泥点资产入口，不再把余额区本身作为直接充值按钮。余额区展开后只展示不限时泥点、每日免费泥点及重置口径；会员周期限时泥点仅由后端保留用于存量兼容和结算，当前版本不在前台展示。独立“充值”按钮进入“购买更多泥点”弹窗，“使用详情”进入泥点账单。主站各位置必须保持同一组件、数据口径和交互语义，头像 / 设置等账号入口继续保留各自语义。
+创作页和草稿页顶栏右上角统一复用公共泥点资产入口，不再把余额区本身作为直接充值按钮。顶部总余额优先展示会随扣费、退回和到账刷新的 `profileDashboard.walletBalance`，充值中心的 `mudPointBalance` 只承接展开面板中的不限时 / 每日免费泥点明细，不得用已缓存的明细总数覆盖已刷新的顶部余额。余额区展开后只展示不限时泥点、每日免费泥点及重置口径；会员周期限时泥点仅由后端保留用于存量兼容和结算，当前版本不在前台展示。独立“充值”按钮进入“购买更多泥点”弹窗，“使用详情”进入泥点账单。主站各位置必须保持同一组件、数据口径和交互语义，头像 / 设置等账号入口继续保留各自语义。

 创作恢复参数只保留 `sessionId`、`profileId`、`draftId`、`workId` 这四个私有 query。它们只允许在同一条创作链路的结果页、生成页、工作台之间保留；切到首页、公开作品详情、runtime 或另一条玩法链路时必须清掉。平台入口刷新直达时，路径到玩法恢复目标、四个 query 归一化、生成页标记、大鱼吃小鱼 workId 兜底、作品 / 草稿身份匹配和跳一跳 / 敲木鱼恢复阶段落点统一由 `platformCreationUrlStateModel.ts` 解析，壳层只执行读取作品、恢复草稿和切换阶段等副作用。生成页等待时间统一以生成状态里的 `startedAtMs` 为准；创建该状态时优先使用后端 session 下发的时间戳，作品摘要里的 `updatedAt` 仍只用于排序与摘要展示，不作为前端自行推导业务状态的真相。

@@ -1,6 +1,12 @@
 /* @vitest-environment jsdom */

-import { act, fireEvent, render, screen, within } from '@testing-library/react';
+import {
+  act,
+  fireEvent,
+  render,
+  screen,
+  within,
+} from '@testing-library/react';
 import userEvent from '@testing-library/user-event';
 import { expect, test, vi } from 'vitest';

@@ -30,7 +36,7 @@ test('shows only permanent and daily free points in the shared wallet panel', as

  render(
    <PlatformMudPointWalletEntry
-      balance={999}
+      balance={207}
      breakdown={breakdown}
      onRequestDetails={onRequestDetails}
      onRecharge={onRecharge}
@@ -60,6 +66,25 @@ test('shows only permanent and daily free points in the shared wallet panel', as
  expect(onRecharge).toHaveBeenCalledTimes(1);
 });

+test('keeps the chip on the live balance when cached details are stale', () => {
+  const props = {
+    breakdown,
+    onRequestDetails: vi.fn(),
+    onRecharge: vi.fn(),
+    onOpenLedger: vi.fn(),
+  };
+  const { rerender } = render(
+    <PlatformMudPointWalletEntry balance={207} {...props} />,
+  );
+
+  expect(screen.getByRole('button', { name: '泥点 207' })).toBeTruthy();
+
+  rerender(<PlatformMudPointWalletEntry balance={195} {...props} />);
+
+  expect(screen.getByRole('button', { name: '泥点 195' })).toBeTruthy();
+  expect(screen.queryByRole('button', { name: '泥点 207' })).toBeNull();
+});
+
 test('keeps the desktop panel open while moving across the gap without click pinning', () => {
  vi.useFakeTimers();

@@ -67,7 +67,7 @@ export function PlatformMudPointWalletEntry({
  const closeTimerRef = useRef<number | null>(null);
  const [isOpen, setIsOpen] = useState(false);
  const isCompact = variant === 'mobile';
-  const displayedBalance = breakdown?.totalPoints ?? balance;
+  const displayedBalance = balance ?? breakdown?.totalPoints ?? null;
  const balanceLabel =
    displayedBalance === null
      ? '--'