# 智能派单功能实现说明

## 功能概述

实现了自动扫描 `WAITING` 状态的订单，通过 `ISmartDispatchService.recommendRiders` 方法进行智能派单，并将订单和推荐的师傅关联保存到中间表中。

## 核心功能

### 1. 自动扫描和派单
- **定时任务**: `AutoDispatchQuartz` 每5分钟自动扫描等待状态的订单
- **派单服务**: `OrderDispatchServiceImpl` 实现智能派单逻辑
- **状态管理**: 订单状态从 `WAITING(0)` 更新为 `ALLOCATED(6)`

### 2. 中间表设计
- **表名**: `kx_order_rider_recommend`
- **主要字段**:
  - `order_no`: 订单编号
  - `rider_id`: 推荐的师傅ID
  - `rider_name`: 师傅姓名
  - `match_score`: 匹配度分数
  - `recommend_order`: 推荐排序(1表示最优推荐)
  - `status`: 推荐状态(0-待处理, 1-已分配, 2-师傅拒绝, 3-超时)

### 3. 管理功能
- **Controller**: `KxOrderRiderRecommendController` 提供CRUD操作
- **手动派单**: 支持手动触发指定订单的派单功能
- **查询功能**: 根据订单号查询推荐的师傅列表

## 主要类文件

### 实体类和数据访问
1. `KxOrderRiderRecommend.java` - 中间表实体类
2. `KxOrderRiderRecommendVo.java` - 视图对象
3. `KxOrderRiderRecommendBo.java` - 业务对象
4. `KxOrderRiderRecommendMapper.java` - 数据访问接口
5. `KxOrderRiderRecommendMapper.xml` - MyBatis映射文件

### 业务服务
1. `IOrderDispatchService.java` - 派单服务接口
2. `OrderDispatchServiceImpl.java` - 派单服务实现
3. `IKxOrderRiderRecommendService.java` - 推荐记录服务接口
4. `KxOrderRiderRecommendServiceImpl.java` - 推荐记录服务实现

### 控制器和定时任务
1. `KxOrderRiderRecommendController.java` - 管理控制器
2. `AutoDispatchQuartz.java` - 自动派单定时任务

### 数据库脚本
1. `kx_order_rider_recommend.sql` - 中间表创建脚本

## 工作流程

1. **定时扫描**: 每5分钟扫描状态为 `WAITING` 的订单
2. **参数构建**: 根据订单信息构建 `SmartDispatchParamBo` 参数
3. **智能推荐**: 调用 `ISmartDispatchService.recommendRiders` 获取推荐师傅
4. **保存关联**: 将推荐结果批量插入到中间表
5. **状态更新**: 更新订单状态为 `ALLOCATED`

## 配置说明

### 定时任务配置
- **执行频率**: 每5分钟执行一次 (`0 */5 * * * ?`)
- **可以根据业务需要调整执行频率**

### 推荐策略
- **匹配度计算**: 基于服务类型、距离、评分、经验等因素
- **紧急程度**: 根据配送费判断订单紧急程度
- **服务关键词**: 目前使用默认关键词，可扩展为根据商品类型动态设置

## 扩展点

1. **服务关键词优化**: 可以根据订单商品类型动态设置服务关键词
2. **推荐策略调整**: 可以根据业务需求调整匹配度计算权重
3. **通知机制**: 可以加入师傅推送通知功能
4. **监控报警**: 可以加入派单失败的监控和报警机制

## 使用说明

### 自动派单
系统会自动运行，无需人工干预。

### 手动派单
可以通过以下API手动触发订单派单：
```
POST /rider/orderRiderRecommend/dispatch/{orderNo}
```

### 查询推荐记录
可以通过以下API查询订单的推荐师傅：
```
GET /rider/orderRiderRecommend/listByOrderNo/{orderNo}
```

## 注意事项

1. **数据库表**: 需要先执行 `kx_order_rider_recommend.sql` 创建中间表
2. **依赖关系**: 依赖现有的 `ISmartDispatchService` 智能派单服务
3. **事务处理**: 派单过程使用事务确保数据一致性
4. **错误处理**: 包含完善的异常处理和日志记录
5. **幂等性**: 对于已有推荐记录的订单会跳过处理，避免重复派单