78 lines
3.0 KiB
Markdown
78 lines
3.0 KiB
Markdown
# 实施任务
|
||
|
||
## 任务清单
|
||
|
||
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
|