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

玩家管理Bug修复 - 共识文档

需求确认

Bug 1: 玩家列表分页失效

现象: 点击下一页后自动跳回第1页 确认范围: 在玩家列表页面点击分页控件的下一页时出现

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

确认理解: 需要修复/完善活动的盈亏分析功能

• 目标：完善现有的 ActivityAnalysisDrawer 组件功能

Bug 3: 用户盈亏分析明细

确认理解: 在用户盈亏分析中增加订单级明细列表

• 每条明细显示：订单信息、支付金额、获得奖品价值
• 包含使用的优惠券、道具卡及其价值

Bug 4: 用户资产搜索

确认理解: 在用户详情抽屉的资产Tab中增加搜索功能

---

技术实现方案

Bug 1 修复方案

根因分析:

• 玩家管理页面使用 useTable hook 管理分页
• ArtTable 组件通过 pagination:current-change 事件通知页码变化
• 页面监听该事件调用 handleCurrentChange → getData(params)
• 问题可能出在 useTable.ts 中搜索参数和分页参数的同步逻辑

修复方案:

• 检查 handleCurrentChange 函数中页码参数的传递
• 确保分页参数不被搜索参数覆盖

Bug 2 修复方案

现有功能: ActivityAnalysisDrawer.vue 已有活动数据分析功能 待完善: 确认功能是否正常工作，是否需要增强

Bug 3 实现方案

新增功能:

1. 后端新增API: GET /api/admin/users/{user_id}/profit_loss/details
   • 返回每笔订单的盈亏明细
   • 包含：订单信息、支付金额、获得价值、使用的优惠券/道具卡
2. 前端增加明细列表组件

Bug 4 实现方案

新增功能:

1. 后端API修改: GET /api/admin/users/{user_id}/inventory 支持搜索参数
2. 前端在资产Tab增加搜索框

---

验收标准

1. Bug 1: 玩家列表可以正常翻页，页码不会跳回第一页
2. Bug 2: 活动盈亏仪表盘功能正常工作
3. Bug 3: 用户盈亏分析页可以查看订单明细列表
4. Bug 4: 用户资产列表可以按商品名称搜索