添加执行利率接口

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

@@ -0,0 +1,77 @@
+# 实施任务
+
+## 任务清单
+
+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