# 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