# 商品交易量排行榜定时任务

## 功能说明

本功能实现了每天12点自动查询交易量最多的100个商品并存储到Redis中的定时任务。

## 实现内容

### 1. 数据库查询
- 在 `OrderItemMapper` 中添加了 `selectTopTradingProducts` 方法
- 查询条件：已完成订单（status = 3）且未删除订单（delete_status = 0）
- 按销售数量降序排列，取前100个商品
- 统计信息包括：商品ID、商品名称、图片、总销售数量、总销售金额、订单数量

### 2. 服务层实现
- 在 `OrderItemService` 接口中添加了 `cacheTopTradingProducts` 方法
- 在 `OrderItemServiceImpl` 中实现了缓存逻辑
- 将查询结果以JSON格式存储到Redis，过期时间为24小时

### 3. 定时任务
- 创建了 `OrderScheduledTask` 定时任务类
- 使用 `@Scheduled(cron = "0 0 12 * * ?")` 配置每天12点执行
- 在主应用类 `DromaraApplication` 上已添加了 `@EnableScheduling` 注解

### 4. 控制器接口
- 添加了手动触发缓存的接口：`POST /oms/order/cacheTopTradingProducts`
- 添加了获取缓存数据的接口：`GET /oms/order/getTopTradingProducts`

## 使用方法

### 1. 自动执行
定时任务会在每天12点自动执行，无需手动干预。

### 2. 手动触发
如果需要立即执行缓存任务，可以调用以下接口：

```bash
POST /oms/order/cacheTopTradingProducts?limit=100
```

参数说明：
- `limit`: 查询的商品数量，默认为100

### 3. 查看缓存结果
可以通过以下接口查看缓存的数据：

```bash
GET /oms/order/getTopTradingProducts
GET /oms/order/getTopTradingProducts?date=2024-01-15
```

参数说明：
- `date`: 可选，指定查看某一天的缓存数据，格式为yyyy-MM-dd

### 4. 返回数据格式
缓存的数据包含以下字段：
- `product_id`: 商品ID
- `product_name`: 商品名称
- `pic`: 商品图片
- `out_product_id`: 商品编码
- `product_category_id`: 商品分类ID
- `total_quantity`: 总销售数量
- `total_amount`: 总销售金额
- `order_count`: 订单数量

## 技术实现

### 1. SQL查询逻辑
```sql
SELECT 
    oi.product_id, 
    oi.product_name, 
    oi.pic, 
    oi.out_product_id, 
    oi.product_category_id, 
    SUM(oi.quantity) as total_quantity, 
    SUM(oi.quantity * oi.sale_price) as total_amount, 
    COUNT(DISTINCT o.id) as order_count 
FROM oms_order_item oi 
JOIN oms_order o ON oi.order_id = o.id 
WHERE o.status = 3  -- 已完成订单
    AND o.delete_status = 0  -- 未删除订单
GROUP BY oi.product_id, oi.product_name, oi.pic, oi.out_product_id, oi.product_category_id 
ORDER BY total_quantity DESC 
LIMIT #{limit}
```

### 2. Redis缓存
- Key格式：`top_trading_products:yyyy-MM-dd`
- 过期时间：24小时
- 数据格式：JSON字符串

### 3. 异常处理
- 完善的异常处理和日志记录
- 手动触发接口返回详细的错误信息
- 定时任务异常不会影响系统正常运行

## 注意事项

1. **数据准确性**：只统计已完成订单的商品，确保数据的准确性
2. **性能考虑**：大量订单数据时，查询可能需要较长时间
3. **缓存更新**：每天12点自动更新，也可手动触发
4. **数据过期**：缓存数据24小时自动过期，避免数据过期问题

## 扩展功能

如需扩展功能，可以考虑：
1. 按时间范围统计（如最近7天、30天）
2. 按商品分类统计
3. 添加更多统计维度（如销售额、利润率等）
4. 支持多租户数据隔离