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