bindbox-game/docs/玩家管理Bug修复/ALIGNMENT_玩家管理Bug修复.md

玩家管理Bug修复 - 需求对齐

项目上下文

• 前端: Vue 3 + TypeScript + Element Plus
• 后端: Go (Gin框架)
• 关键文件:
  • 玩家列表: web/admin/src/views/player-manage/index.vue
  • 分页Hook: web/admin/src/hooks/core/useTable.ts
  • 用户详情抽屉: web/admin/src/views/player-manage/modules/player-detail-drawer.vue
  • 用户盈亏图表: web/admin/src/views/player-manage/modules/player-profit-loss-chart.vue
  • 活动分析抽屉: web/admin/src/views/activity/manage/components/ActivityAnalysisDrawer.vue

---

Bug列表

Bug 1: 玩家列表分页失效

现象: 点击下一页后会自动跳回第1页

初步分析:

• 玩家列表使用 useTable hook 管理分页
• handleCurrentChange 函数会修改 pagination.current 并调用 getData
• 可能原因:
  1. handleSearch 函数在搜索时重置了页码但没有正确更新
  2. getDataDebounced 使用的参数可能覆盖了新的页码值
  3. 搜索参数和分页参数同步问题

需要确认: 具体是在什么场景下触发？是否有搜索条件？

---

Bug 2: 活动的游戏盈亏仪表盘

现象描述不清，需要澄清

可能的理解:

1. 需要在仪表盘（Dashboard）添加活动的游戏盈亏分析组件？
2. 现有的 ActivityAnalysisDrawer 有问题需要修复？
3. 需要一个全局的活动盈亏汇总仪表盘？

当前现有功能:

• ActivityAnalysisDrawer.vue: 单个活动的数据分析抽屉，包含总营收、总成本、毛利润、参与人数等

需要澄清: 具体需要什么功能？是新增组件还是修复现有问题？

---

Bug 3: 用户盈亏分析需要明细

需求理解:

• 当前 player-profit-loss-chart.vue 显示用户盈亏趋势图表和汇总数据
• 需要增加订单明细列表，可以点击查看每笔订单的盈亏
• 明细需包含: 道具卡、优惠券等使用情况

当前支持:

• 有资产分项概览: 商品产出、积分收益、道具卡价值、优惠券价值
• 有趋势图表展示投入、产出、净盈亏

待实现:

• 盈亏明细列表（可分页、可搜索）
• 每条记录显示: 订单信息、支付金额、获得奖品价值、使用的优惠券/道具卡及其价值

---

Bug 4: 用户资产加一个搜索

需求理解:

• 在用户详情抽屉的"资产"Tab中增加搜索功能
• 当前资产列表使用 ArtDataListCard 组件展示

待实现:

• 搜索框（按商品名称、订单号等搜索）
• 可能需要修改后端API支持搜索参数

---

疑问澄清

优先级问题

1. Bug 2 描述不够清晰，需要进一步说明具体需求：
   • 是否需要在主仪表盘添加新组件？
   • 还是修复现有 ActivityAnalysisDrawer 的问题？
   • 需要展示哪些数据？

技术问题

2. Bug 1 分页问题：
   • 是否只在有搜索条件时出现？
   • 是否与特定浏览器相关？

范围确认

3. Bug 3 盈亏明细：

   • 明细是否需要导出功能？
   • 是否需要按时间范围筛选？
   • 每条明细需要展示哪些具体字段？

4. Bug 4 资产搜索：

   • 支持哪些搜索条件？商品名称？订单号？
   • 是否需要后端支持模糊搜索？