Files

78 lines
3.0 KiB
Markdown
Raw Permalink Normal View History

2026-01-22 15:04:40 +08:00
# 实施任务
## 任务清单
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