HaniBlindBox/.kiro/specs/admin-bugfix/tasks.md

# Implementation Plan: 后台管理系统 BUG 修复

## Overview

本实现计划针对后台管理系统中 9 个未修复 BUG 进行分批次修复。按模块和优先级组织任务，确保核心功能优先修复。

## 任务概览

| 批次 | 模块 | BUG数量 | 预计工时 |
|------|------|---------|----------|
| 1. 统计报表模块修复 | Statistics | 2 | 2h |
| 2. 商品管理模块修复 | Goods | 3 | 4h |
| 3. 营销活动模块修复 | Marketing | 3 | 3h |
| 4. 内容管理模块修复 | Content | 1 | 1h |
| 5. 测试验证 | All | - | 2h |
| **总计** | - | **9** | **12h** |

---

## Tasks

- [x] 1. 统计报表模块修复
  - [x] 1.1 修复用户盈亏统计搜索 (cs100_2)
    - 定位 `StatisticsService.cs` 中用户盈亏统计方法
    - 检查用户ID参数接收和处理逻辑
    - 修复参数类型转换（string -> int）
    - 添加空值和无效值处理
    - 测试搜索功能正常返回
    - _Requirements: 1.1, 1.2, 1.3, 1.4_

  - [x] 1.2 修复用户邀请统计搜索 (cs100_3)
    - 定位 `StatisticsService.cs` 中用户邀请统计方法
    - 检查用户ID参数接收和处理逻辑
    - 修复参数类型转换（string -> int）
    - 添加空值和无效值处理
    - 测试搜索功能正常返回
    - _Requirements: 2.1, 2.2, 2.3, 2.4_

  - [x] 1.3 Checkpoint - 统计报表模块验证
    - 验证用户盈亏统计搜索正常
    - 验证用户邀请统计搜索正常
    - 验证无结果时显示正确提示

- [ ] 2. 商品管理模块修复
  - [ ] 2.1 修复盒子类型全部搜索 (cs100_4)
    - 定位 `GoodsService.cs` 中盒子列表查询方法
    - 检查类型过滤条件构建逻辑
    - 修复：当类型为0或null时跳过类型过滤
    - 前端检查"全部"选项传递的值
    - 测试选择"全部"时返回所有盒子
    - _Requirements: 3.1, 3.2, 3.3, 3.4_

  - [ ] 2.2 修复自动下架配置 (cs100_5)
    - 检查后端 `BoxResponse` 是否包含自动下架字段
    - 检查后端保存接口是否处理自动下架字段
    - 检查前端表单联动逻辑（v-if/v-show）
    - 修复前端表单字段绑定
    - 测试开启配置后可正常设置参数
    - 测试保存后数据正确持久化
    - _Requirements: 4.1, 4.2, 4.3, 4.4_

  - [ ] 2.3 修复奖品等级分类显示 (cs100_6)
    - 定位 `GoodsService.cs` 中奖品列表查询方法
    - 添加等级表和分类表的关联查询（LEFT JOIN）
    - 修复 DTO 映射，确保 LevelName 和 CategoryName 正确赋值
    - 处理关联数据为空的情况（显示"未设置"）
    - 测试奖品列表显示正确的等级和分类名称
    - _Requirements: 5.1, 5.2, 5.3, 5.4_

  - [ ] 2.4 Checkpoint - 商品管理模块验证
    - 验证盒子类型"全部"搜索正常
    - 验证自动下架配置可正常设置
    - 验证奖品等级和分类显示正确

- [ ] 3. 营销活动模块修复
  - [ ] 3.1 修复领取记录搜索 (cs100_11)
    - 定位营销活动相关 Service 中领取记录查询方法
    - 检查用户ID参数接收和处理逻辑
    - 修复参数类型转换（string -> int）
    - 添加空值和无效值处理
    - 测试搜索功能正常返回
    - _Requirements: 6.1, 6.2, 6.3, 6.4_

  - [ ] 3.2 修复周榜记录服务器错误 (cs100_13)
    - 定位周榜记录查询方法
    - 检查服务器日志定位具体异常
    - 修复日期范围计算逻辑（周起止日期）
    - 添加异常捕获和友好错误提示
    - 处理空数据情况
    - 测试周榜页面正常加载
    - _Requirements: 7.1, 7.2, 7.3, 7.4_

  - [ ] 3.3 修复月榜记录服务器错误 (cs100_14)
    - 定位月榜记录查询方法
    - 检查服务器日志定位具体异常
    - 修复日期范围计算逻辑（月起止日期）
    - 添加异常捕获和友好错误提示
    - 处理空数据情况
    - 测试月榜页面正常加载
    - _Requirements: 8.1, 8.2, 8.3, 8.4_

  - [ ] 3.4 Checkpoint - 营销活动模块验证
    - 验证领取记录搜索正常
    - 验证周榜记录页面正常加载
    - 验证月榜记录页面正常加载

- [ ] 4. 内容管理模块修复
  - [ ] 4.1 修复单页文章显示H5代码 (cs100_15)
    - 定位单页详情/编辑组件
    - 将 `{{ content }}` 改为 `v-html="content"`
    - 添加 DOMPurify 进行 XSS 防护
    - 添加内容区域样式（图片自适应等）
    - 测试文章内容正确渲染
    - _Requirements: 9.1, 9.2, 9.3, 9.4_

  - [ ] 4.2 Checkpoint - 内容管理模块验证
    - 验证单页文章内容正确渲染
    - 验证图片和格式正常显示
    - 验证XSS防护生效

- [ ] 5. 综合测试验证
  - [ ] 5.1 回归测试
    - 测试所有修复的功能点
    - 测试相关功能无副作用
    - 测试边界条件和异常情况

  - [ ] 5.2 更新BUG状态
    - 更新 `docs/后台管理bug整理/BUG汇总清单.md` 状态
    - 更新各BUG详细文档状态
    - 记录修复方案和验证结果

  - [ ] 5.3 Final Checkpoint
    - 确认所有9个BUG已修复
    - 确认无新增问题
    - 如有问题，询问用户

---

## 验收检查清单

### 统计报表模块
- [ ] cs100_2: 用户盈亏统计按用户ID搜索正常
- [ ] cs100_3: 用户邀请统计按用户ID搜索正常

### 商品管理模块
- [ ] cs100_4: 盒子类型"全部"搜索返回所有盒子
- [ ] cs100_5: 自动下架配置可正常设置和保存
- [ ] cs100_6: 奖品等级和分类显示正确名称

### 营销活动模块
- [ ] cs100_11: 领取记录按用户ID搜索正常
- [ ] cs100_13: 周榜记录页面正常加载
- [ ] cs100_14: 月榜记录页面正常加载

### 内容管理模块
- [ ] cs100_15: 单页文章内容正确渲染（非HTML代码）

---

## 文件路径参考

### 后端文件（可能涉及）
- `server/HoneyBox/src/HoneyBox.Admin.Business/Controllers/StatisticsController.cs`
- `server/HoneyBox/src/HoneyBox.Admin.Business/Services/StatisticsService.cs`
- `server/HoneyBox/src/HoneyBox.Admin.Business/Controllers/GoodsController.cs`
- `server/HoneyBox/src/HoneyBox.Admin.Business/Services/GoodsService.cs`
- `server/HoneyBox/src/HoneyBox.Admin.Business/Controllers/MarketingController.cs`
- `server/HoneyBox/src/HoneyBox.Admin.Business/Services/MarketingService.cs`

### 前端文件（可能涉及）
- `server/HoneyBox/src/HoneyBox.Admin/admin-web/src/views/business/statistics/`
- `server/HoneyBox/src/HoneyBox.Admin/admin-web/src/views/business/goods/`
- `server/HoneyBox/src/HoneyBox.Admin/admin-web/src/views/business/marketing/`
- `server/HoneyBox/src/HoneyBox.Admin/admin-web/src/views/business/danye/`

### 参考文档
- `docs/后台管理bug整理/BUG汇总清单.md`
- `docs/后台管理bug整理/BUG-统计报表-002-用户盈亏统计搜索失败.md`
- `docs/后台管理bug整理/BUG-统计报表-003-用户邀请统计搜索失败.md`
- `docs/后台管理bug整理/BUG-商品管理-004-盒子类型全部搜索无结果.md`
- `docs/后台管理bug整理/BUG-商品管理-005-自动下架配置无法设置.md`
- `docs/后台管理bug整理/BUG-商品管理-006-奖品等级分类显示异常.md`
- `docs/后台管理bug整理/BUG-营销活动-011-领取记录搜索失败.md`
- `docs/后台管理bug整理/BUG-营销活动-013-周榜记录服务器错误.md`
- `docs/后台管理bug整理/BUG-营销活动-014-月榜记录服务器错误.md`
- `docs/后台管理bug整理/BUG-内容管理-015-单页文章显示H5代码.md`

---

## Notes

- 每个模块修复后进行 Checkpoint 验证
- 优先修复高优先级 BUG（接口请求失败、服务器错误）
- 修复过程中如发现关联问题，及时记录
- 所有修复需要在测试环境验证后再部署生产