loan-pricing/openspec/changes/add-execute-rate/tasks.md

实施任务

任务清单

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 依次执行

验收标准

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