one-pipe-system/openspec/changes/update-asset-wallet-empty-state-stability/proposal.md

Change: 优化资产信息钱包流水的默认加载与展示稳定性

Why

当前资产信息页的钱包流水区域存在三个连续问题：默认进入资产详情时没有稳定触发钱包流水查询；前端按 list/page_size 解析响应，但后端实际返回 items/size，导致接口成功返回后表格仍然不显示；当结果为空时，重复查询还会出现“暂无钱包流水数据”先消失再出现的闪烁。

这些问题叠加后，会让用户误以为钱包流水没有被加载、接口无返回，或页面发生异常刷新。需要将默认加载、数据展示和空态刷新体验统一规范。

What Changes

• 为资产信息页的钱包流水区域新增默认加载规范：
  • 资产详情加载完成后应自动请求钱包流水
  • 默认请求参数为 page=1、page_size=20
• 明确钱包流水区域需兼容后端当前返回结构：
  • 使用 items 作为流水列表
  • 使用 page、size、total 作为分页信息
• 明确有数据时必须展示钱包流水表格，不能因为前端字段映射不一致而落入空态
• 为空结果场景新增稳定性展示规范：
  • 当当前已是空态且新结果仍为空时，空态区域应保持连续可见
  • 加载反馈不应通过“先移除空态再重新渲染”的方式呈现
• 覆盖以下触发路径：
  • 资产信息页首次进入或首次加载当前资产
  • 资产信息页顶部再次搜索资产
  • 钱包流水区域内的查询、重置、分页切换、分页尺寸重置等再次拉取

Impact

• Affected specs:
  • asset-wallet-transaction-display
• Affected code:
  • src/views/asset-management/asset-information/components/WalletTransactionCard.vue
  • src/views/asset-management/asset-information/index.vue
  • src/types/api/asset.ts
• Dependencies:
  • GET /api/admin/assets/:asset_type/:id/wallet/transactions
  • 钱包流水分页响应以接口返回 items、page、size、total 为准