# 玩家管理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**: 用户资产列表可以按商品名称搜索