HaniBlindBox/docs/后台管理bug整理/BUG修复任务计划.md
2026-01-20 20:31:51 +08:00

155 lines
4.7 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 后台管理系统 BUG 修复任务计划
> 创建时间: 2026-01-20 | 状态: 进行中
## 概述
本计划针对后台管理系统中 **9个未修复BUG** 进行分批次修复,按优先级和模块关联性组织任务。
## 修复批次规划
### 第一批:统计报表模块(预计 1 天)
| 任务 | BUG编号 | 问题 | 类型 | 优先级 |
|------|---------|------|------|--------|
| 1.1 | cs100_2 | 用户盈亏统计搜索失败 | 后端 | 高 |
| 1.2 | cs100_3 | 用户邀请统计搜索失败 | 后端 | 高 |
**修复思路:**
- 检查 `StatisticsController` 中用户盈亏/邀请统计接口
- 排查搜索参数用户ID的传递和处理逻辑
- 验证数据库查询语句是否正确
**涉及文件:**
- `server/HoneyBox/src/HoneyBox.Admin.Business/Controllers/StatisticsController.cs`
- `server/HoneyBox/src/HoneyBox.Admin.Business/Services/StatisticsService.cs`
- 前端对应的 API 调用文件
---
### 第二批:商品管理模块(预计 1.5 天)
| 任务 | BUG编号 | 问题 | 类型 | 优先级 |
|------|---------|------|------|--------|
| 2.1 | cs100_4 | 盒子类型"全部"搜索无结果 | 后端 | 高 |
| 2.2 | cs100_5 | 自动下架配置无法设置 | 前端+后端 | 中 |
| 2.3 | cs100_6 | 奖品等级/分类显示异常 | 后端 | 中 |
**修复思路:**
**2.1 盒子类型搜索问题:**
- 检查盒子列表接口的类型过滤逻辑
- 当类型为"全部"通常为0或空应跳过类型过滤条件
**2.2 自动下架配置问题:**
- 检查前端表单的联动显示逻辑
- 确认后端是否正确返回自动下架相关字段
- 验证保存接口是否正确处理这些参数
**2.3 奖品等级/分类显示问题:**
- 检查奖品列表接口的关联查询(等级表、分类表)
- 确认返回的 DTO 中包含等级名称和分类名称
- 检查前端字段映射是否正确
**涉及文件:**
- `server/HoneyBox/src/HoneyBox.Admin.Business/Controllers/GoodsController.cs`
- `server/HoneyBox/src/HoneyBox.Admin.Business/Services/GoodsService.cs`
- `admin-web/src/views/business/goods/` 相关组件
---
### 第三批:营销活动模块(预计 1.5 天)
| 任务 | BUG编号 | 问题 | 类型 | 优先级 |
|------|---------|------|------|--------|
| 3.1 | cs100_11 | 领取记录搜索失败 | 后端 | 高 |
| 3.2 | cs100_13 | 周榜记录服务器错误 | 后端 | 高 |
| 3.3 | cs100_14 | 月榜记录服务器错误 | 后端 | 高 |
**修复思路:**
**3.1 领取记录搜索问题:**
- 检查领取记录接口的用户ID搜索逻辑
- 验证参数类型转换是否正确
**3.2 & 3.3 周榜/月榜服务器错误:**
- 查看服务器日志定位具体异常
- 检查排行榜数据查询逻辑
- 可能是日期范围计算、数据聚合或空数据处理问题
**涉及文件:**
- 营销活动相关 Controller 和 Service
- 排行榜相关数据库查询
---
### 第四批:内容管理模块(预计 0.5 天)
| 任务 | BUG编号 | 问题 | 类型 | 优先级 |
|------|---------|------|------|--------|
| 4.1 | cs100_15 | 单页文章显示H5代码 | 前端 | 中 |
**修复思路:**
- 检查单页详情组件是否使用 `v-html` 渲染富文本内容
- 如果使用了 `{{ content }}`,需改为 `v-html="content"`
- 注意 XSS 安全,必要时对内容进行过滤
**涉及文件:**
- `admin-web/src/views/business/danye/` 相关组件
- `DanyeFormDialog.vue` 或详情展示组件
---
## 任务清单
### ✅ 已完成
- [x] cs100_7 - 购买订单搜索失败
- [x] cs100_8 - 回收订单搜索失败
- [x] cs100_9 - 卡单订单搜索失败
- [x] cs100_10 - 综合订单显示为空
### 🔄 待修复(按优先级排序)
#### 高优先级6个
- [ ] cs100_2 - 用户盈亏统计搜索失败
- [ ] cs100_3 - 用户邀请统计搜索失败
- [ ] cs100_4 - 盒子类型"全部"搜索无结果
- [ ] cs100_11 - 领取记录搜索失败
- [ ] cs100_13 - 周榜记录服务器错误
- [ ] cs100_14 - 月榜记录服务器错误
#### 中优先级3个
- [ ] cs100_5 - 自动下架配置无法设置
- [ ] cs100_6 - 奖品等级/分类显示异常
- [ ] cs100_15 - 单页文章显示H5代码
---
## 时间估算
| 批次 | 模块 | BUG数量 | 预计工时 |
|------|------|---------|----------|
| 第一批 | 统计报表 | 2 | 1 天 |
| 第二批 | 商品管理 | 3 | 1.5 天 |
| 第三批 | 营销活动 | 3 | 1.5 天 |
| 第四批 | 内容管理 | 1 | 0.5 天 |
| **合计** | - | **9** | **4.5 天** |
---
## 验收标准
每个BUG修复后需满足
1. 功能正常,无报错
2. 搜索/查询结果正确
3. 数据显示完整
4. 通过回归测试
---
## 备注
- 修复过程中如发现关联问题,及时记录并评估影响
- 每批次完成后更新 `BUG汇总清单.md` 状态
- 建议先在测试环境验证,再部署到生产环境