# 后台管理系统 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` 状态
- 建议先在测试环境验证，再部署到生产环境
