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

Requirements Document

Introduction

本文档定义了后台管理系统中 9 个未修复 BUG 的修复需求。这些 BUG 涉及统计报表、商品管理、营销活动和内容管理四个模块，主要问题类型包括接口请求失败、服务器内部错误、数据显示异常和功能不可用。

Glossary

• Admin_System: 后台管理系统
• Statistics_Module: 统计报表模块
• Goods_Module: 商品管理模块
• Marketing_Module: 营销活动模块
• Content_Module: 内容管理模块
• User_Profit_Stats: 用户盈亏统计
• User_Invite_Stats: 用户邀请统计
• Box_Management: 盒子管理
• Prize_Management: 奖品管理
• Claim_Record: 领取记录
• Weekly_Rank: 周榜记录
• Monthly_Rank: 月榜记录
• Danye_Management: 单页管理

Requirements

Requirement 1: 用户盈亏统计搜索修复 (cs100_2)

User Story: As an administrator, I want to search user profit/loss statistics by user ID, so that I can analyze individual user's financial performance.

Acceptance Criteria

1. WHEN an administrator enters a user ID in the search field, THE Admin_System SHALL return the profit/loss statistics for that user
2. WHEN the search is executed, THE Admin_System SHALL NOT display "请求失败" error
3. THE Admin_System SHALL validate the user ID parameter before sending the request
4. THE Admin_System SHALL display appropriate message when no results are found

Requirement 2: 用户邀请统计搜索修复 (cs100_3)

User Story: As an administrator, I want to search user invitation statistics by user ID, so that I can track user referral performance.

Acceptance Criteria

1. WHEN an administrator enters a user ID in the search field, THE Admin_System SHALL return the invitation statistics for that user
2. WHEN the search is executed, THE Admin_System SHALL NOT display "请求失败" error
3. THE Admin_System SHALL validate the user ID parameter before sending the request
4. THE Admin_System SHALL display appropriate message when no results are found

Requirement 3: 盒子类型全部搜索修复 (cs100_4)

User Story: As an administrator, I want to search all box types when selecting "全部" filter, so that I can view the complete box list.

Acceptance Criteria

1. WHEN an administrator selects "全部" as box type filter, THE Admin_System SHALL return all boxes regardless of type
2. WHEN box type is "全部" (value 0 or empty), THE Admin_System SHALL skip the type filter condition in the query
3. THE Admin_System SHALL display the complete box list when "全部" is selected
4. THE Admin_System SHALL NOT return empty results when boxes exist in the database

Requirement 4: 自动下架配置修复 (cs100_5)

User Story: As an administrator, I want to configure auto-delist settings when editing/creating a box, so that boxes can be automatically removed from listing.

Acceptance Criteria

1. WHEN an administrator enables "自动下架配置", THE Admin_System SHALL display the configuration parameters
2. THE Admin_System SHALL allow setting auto-delist time or conditions
3. WHEN the form is submitted, THE Admin_System SHALL save the auto-delist configuration correctly
4. THE Admin_System SHALL return auto-delist fields in the box detail response

Requirement 5: 奖品等级分类显示修复 (cs100_6)

User Story: As an administrator, I want to see correct prize level and category names in the prize list, so that I can manage prizes effectively.

Acceptance Criteria

1. WHEN an administrator views the prize list, THE Admin_System SHALL display the correct level name (not "0级")
2. WHEN an administrator views the prize list, THE Admin_System SHALL display the correct category name (not "未知" or empty)
3. THE Admin_System SHALL perform proper join queries to fetch level and category information
4. THE Admin_System SHALL map the level and category fields correctly in the response DTO

Requirement 6: 领取记录搜索修复 (cs100_11)

User Story: As an administrator, I want to search claim records by user ID, so that I can track user reward claims.

Acceptance Criteria

1. WHEN an administrator enters a user ID in the search field, THE Admin_System SHALL return the claim records for that user
2. WHEN the search is executed, THE Admin_System SHALL NOT display "请求失败" error
3. THE Admin_System SHALL validate the user ID parameter before sending the request
4. THE Admin_System SHALL display appropriate message when no results are found

Requirement 7: 周榜记录修复 (cs100_13)

User Story: As an administrator, I want to view weekly ranking records, so that I can monitor weekly user performance.

Acceptance Criteria

1. WHEN an administrator accesses the weekly rank page, THE Admin_System SHALL display the ranking data
2. THE Admin_System SHALL NOT display "服务器内部错误"
3. THE Admin_System SHALL handle empty data gracefully
4. THE Admin_System SHALL calculate date ranges correctly for weekly data

Requirement 8: 月榜记录修复 (cs100_14)

User Story: As an administrator, I want to view monthly ranking records, so that I can monitor monthly user performance.

Acceptance Criteria

1. WHEN an administrator accesses the monthly rank page, THE Admin_System SHALL display the ranking data
2. THE Admin_System SHALL NOT display "服务器内部错误"
3. THE Admin_System SHALL handle empty data gracefully
4. THE Admin_System SHALL calculate date ranges correctly for monthly data

Requirement 9: 单页文章内容渲染修复 (cs100_15)

User Story: As an administrator, I want to view article content as rendered HTML, so that I can preview the actual display.

Acceptance Criteria

1. WHEN an administrator clicks on an article, THE Admin_System SHALL display rendered content (not raw HTML code)
2. THE Admin_System SHALL use v-html or equivalent to render HTML content
3. THE Admin_System SHALL sanitize HTML content to prevent XSS attacks
4. THE Admin_System SHALL preserve formatting and images in the rendered content