# 实施任务

## 任务清单

1. **添加数据库字段**
    - 文件: 创建 SQL 迁移脚本 `sql/add_execute_rate_field.sql`
    - 操作: 在 `loan_pricing_workflow` 表中添加 `execute_rate` 字段
    -
    DDL: `ALTER TABLE loan_pricing_workflow ADD COLUMN execute_rate varchar(20) DEFAULT NULL COMMENT '执行利率(%)' AFTER loan_rate;`
    - 验证: 字段添加成功

2. **更新 Entity 类**
    - 文件: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/entity/LoanPricingWorkflow.java`
    - 操作: 添加 `executeRate` 字段及注释
    - 验证: 字段添加成功，位于 `loanRate` 字段之后

3. **更新 VO 类**
    - 文件: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/vo/LoanPricingWorkflowVO.java`
    - 操作: 添加 `executeRate` 字段及注释
    - 验证: 字段添加成功

4. **更新 Service 接口**
    - 文件: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/service/ILoanPricingWorkflowService.java`
    - 操作: 添加 `setExecuteRate(String serialNum, String executeRate)` 方法声明
    - 验证: 方法添加成功

5. **实现 Service 方法**
    - 文件: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/service/impl/LoanPricingWorkflowServiceImpl.java`
    - 操作: 实现 `setExecuteRate` 方法
    - 逻辑: 根据 serialNum 查询记录，更新 execute_rate 字段
    - 验证: 方法实现完成

6. **添加 Controller 接口**
    - 文件: `ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/controller/LoanPricingWorkflowController.java`
    - 操作: 添加 `PUT /{serialNum}/executeRate` 接口方法
    - 验证: 接口添加成功，添加 Swagger 注解

7. **更新 API 文档**
    - 文件: `doc/api/loan-pricing-workflow-api.md`
    - 操作: 在接口列表中添加"设定执行利率"接口文档
    - 内容: 接口地址、请求参数、响应示例、说明
    - 验证: 文档更新完整

8. **后端编译验证**
    - 操作: 运行 `mvn clean compile` 或 IDE 编译
    - 验证: 编译成功无错误

9. **接口功能验证**
    - 操作:
        - 启动后端服务
        - 调用 `PUT /loanPricing/workflow/{serialNum}/executeRate` 接口
        - 调用 `GET /loanPricing/workflow/{serialNum}` 接口验证返回值
    - 验证:
        - 设定执行利率成功
        - 再次设定可覆盖更新
        - 不存在的 serialNum 返回 404
        - 详情接口正确返回 executeRate

## 依赖关系

- 任务 1 必须首先执行（数据库字段）
- 任务 2、3 可并行执行（Entity 和 VO）
- 任务 4、5 依次执行（Service 接口 -> 实现）
- 任务 6 依赖任务 5
- 任务 7 可在任务 6 完成后执行
- 任务 8、9 依次执行

## 验收标准

- [x] 数据库字段 `execute_rate` 添加成功
- [x] Entity 和 VO 类添加 `executeRate` 字段
- [x] Service 接口和实现方法添加成功
- [x] Controller 接口添加成功并编译通过
- [x] API 文档更新完整
- [x] 接口调用成功，执行利率正确保存
- [x] 详情接口正确返回 `executeRate`
- [x] 不存在的记录返回 404