outsource/HaniBlindBox
3
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
ed65e1966c
HaniBlindBox/.kiro/specs/admin-bugfix/tasks.md
gpu 8a0dabb03c 333
2026-01-20 20:31:51 +08:00

7.5 KiB
Raw Blame History

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

  • 1. 统计报表模块修复

    • 1.1 修复用户盈亏统计搜索 (cs100_2)

      • 定位 StatisticsService.cs 中用户盈亏统计方法
      • 检查用户ID参数接收和处理逻辑
      • 修复参数类型转换（string -> int）
      • 添加空值和无效值处理
      • 测试搜索功能正常返回
      • Requirements: 1.1, 1.2, 1.3, 1.4

    • 1.2 修复用户邀请统计搜索 (cs100_3)

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

    • 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（接口请求失败、服务器错误）
  • 修复过程中如发现关联问题，及时记录
  • 所有修复需要在测试环境验证后再部署生产