96 lines
3.2 KiB
Markdown
96 lines
3.2 KiB
Markdown
# 玩家管理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** 资产搜索：
|
||
- 支持哪些搜索条件？商品名称？订单号？
|
||
- 是否需要后端支持模糊搜索？
|