添加执行利率接口

2026-01-22 15:04:40 +08:00
parent 50178923f8
commit c102714f92
13 changed files with 586 additions and 3 deletions
--- a/openspec/changes/add-execute-rate/design.md
+++ b/openspec/changes/add-execute-rate/design.md
@@ -0,0 +1,153 @@
+# 设计文档: 执行利率设定接口
+
+## 数据库设计
+
+### 表结构变更
+
+**表名**: `loan_pricing_workflow`
+
+**新增字段**:
+
+| 字段名          | 类型          | 可空 | 默认值  | 说明      |
+|--------------|-------------|----|------|---------|
+| execute_rate | varchar(20) | 是  | NULL | 执行利率(%) |
+
+**DDL**:
+
+```sql
+ALTER TABLE `loan_pricing_workflow`
+ADD COLUMN `execute_rate` varchar(20) DEFAULT NULL COMMENT '执行利率(%)' AFTER `loan_rate`;
+```
+
+## 接口设计
+
+### 设定执行利率接口
+
+**请求方式**: `PUT /loanPricing/workflow/{serialNum}/executeRate`
+
+**权限要求**: 无特殊权限要求（与查询接口一致）
+
+**路径参数**:
+
+| 参数名       | 类型     | 必填 | 说明     |
+|-----------|--------|----|--------|
+| serialNum | String | 是  | 业务方流水号 |
+
+**请求体**:
+
+```json
+{
+  "executeRate": "4.20"
+}
+```
+
+**参数说明**:
+
+| 参数名         | 类型     | 必填 | 说明                   |
+|-------------|--------|----|----------------------|
+| executeRate | String | 是  | 执行利率，字符串格式（如 "4.20"） |
+
+**响应示例**:
+
+成功 (200):
+
+```json
+{
+  "code": 200,
+  "msg": "设定成功"
+}
+```
+
+失败 (404):
+
+```json
+{
+  "code": 404,
+  "msg": "记录不存在"
+}
+```
+
+失败 (500):
+
+```json
+{
+  "code": 500,
+  "msg": "设定失败"
+}
+```
+
+## 代码设计
+
+### Entity 层
+
+**LoanPricingWorkflow.java**
+
+```java
+/** 执行利率(%) */
+private String executeRate;
+```
+
+### Service 层
+
+**ILoanPricingWorkflowService.java**
+
+```java
+/**
+ * 设定执行利率
+ * @param serialNum 业务方流水号
+ * @param executeRate 执行利率
+ * @return 是否成功
+ */
+boolean setExecuteRate(String serialNum, String executeRate);
+```
+
+**LoanPricingWorkflowServiceImpl.java**
+
+- 实现上述方法
+- 根据 `serialNum` 更新记录的 `execute_rate` 字段
+- MyBatis Plus 会自动填充 `update_by` 和 `update_time`
+
+### Controller 层
+
+**LoanPricingWorkflowController.java**
+
+```java
+/**
+ * 设定执行利率
+ */
+@Operation(summary = "设定执行利率")
+@Log(title = "利率定价流程", businessType = BusinessType.UPDATE)
+@PutMapping("/{serialNum}/executeRate")
+public AjaxResult setExecuteRate(
+        @Parameter(description = "业务方流水号")
+        @PathVariable("serialNum") String serialNum,
+        @RequestBody Map<String, String> request)
+{
+    String executeRate = request.get("executeRate");
+    boolean success = loanPricingWorkflowService.setExecuteRate(serialNum, executeRate);
+    return success ? success() : error("设定失败");
+}
+```
+
+### VO 层变更
+
+**LoanPricingWorkflowVO.java**
+
+- 添加 `executeRate` 字段到 VO，确保详情接口返回执行利率
+
+## 数据校验
+
+1. **记录存在性**: 根据 `serialNum` 查询记录，不存在则返回 404
+2. **更新结果检查**: 检查更新操作影响行数，0 行表示记录不存在
+3. **格式校验**: 执行利率为字符串格式，前端传递格式化后的值（如 "4.20"）
+
+## 事务处理
+
+- 使用 MyBatis Plus 的 `updateById` 方法，自动处理事务
+- 更新失败时抛出异常，由全局异常处理器处理
+
+## 日志记录
+
+- 使用 `@Log` 注解记录操作日志
+- 日志类型: `BusinessType.UPDATE`
+- 自动记录操作人和操作时间
--- a/openspec/changes/add-execute-rate/proposal.md
+++ b/openspec/changes/add-execute-rate/proposal.md
@@ -0,0 +1,63 @@
+# 提案: 添加执行利率设定接口
+
+## 背景
+
+当前利率定价流程已有测算利率（模型输出计算得到），但缺少最终执行利率的设定功能。业务人员需要根据模型测算结果和实际情况，手动设定最终执行的贷款利率。
+
+## 问题
+
+1. 数据库表中没有存储执行利率的字段
+2. 后端缺少设定执行利率的接口
+3. API 文档需要更新
+
+## 提案概述
+
+为利率定价流程添加执行利率设定功能，允许业务人员为流程记录设定/更新最终执行利率。
+
+### 功能范围
+
+1. **数据库变更**
+    - 在 `loan_pricing_workflow` 表中添加 `execute_rate` 字段
+
+2. **后端接口**
+    - 新增 `PUT /loanPricing/workflow/{serialNum}/executeRate` 接口
+    - 支持设定和更新执行利率
+    - 无需特殊权限控制（与查询接口保持一致）
+    - 可多次修改执行利率
+
+3. **API 文档更新**
+    - 在 `doc/api/loan-pricing-workflow-api.md` 中添加新接口文档
+
+## 影响范围
+
+- 数据库: `loan_pricing_workflow` 表
+- 后端:
+    - Entity: `LoanPricingWorkflow.java`
+    - Service: `ILoanPricingWorkflowService.java` 及实现类
+    - Controller: `LoanPricingWorkflowController.java`
+- 文档: `doc/api/loan-pricing-workflow-api.md`
+
+## 设计考虑
+
+1. **字段类型**: 使用 `varchar(20)` 类型，与 `loan_rate` 保持一致
+2. **可空性**: 允许为 NULL，未设定时返回 null
+3. **可修改性**: 允许多次修改，记录 `update_by` 和 `update_time`
+4. **权限控制**: 暂不加独立权限，所有登录用户可操作（后续可根据需要添加）
+5. **接口语义**: 使用 PUT 语义表示更新资源
+
+## 替代方案
+
+### 方案 A: 添加专门的审批流程（未采纳）
+
+- **优点**: 流程更规范，支持审批
+- **缺点**: 实现复杂度高，当前需求不明确
+
+### 方案 B: 在创建接口中直接支持（未采纳）
+
+- **优点**: 减少接口数量
+- **缺点**: 业务上执行利率是在查看测算结果后设定的，与创建分离更合理
+
+### 方案 C: 独立的设定接口（采纳）
+
+- **优点**: 职责清晰，实现简单，支持多次修改
+- **缺点**: 无明显缺点
--- a/openspec/changes/add-execute-rate/specs/loan-pricing-workflow/spec.md
+++ b/openspec/changes/add-execute-rate/specs/loan-pricing-workflow/spec.md
@@ -0,0 +1,27 @@
+# loan-pricing-workflow Delta
+
+## ADDED Requirements
+
+### Requirement: 执行利率设定
+
+系统 SHALL 提供设定执行利率的接口,允许业务人员为利率定价流程设定或更新最终执行利率。
+
+#### Scenario: 设定执行利率
+
+- **WHEN** 业务人员对已存在的利率定价流程调用设定执行利率接口,提供有效的业务方流水号和执行利率值
+- **THEN** 系统更新该流程记录的执行利率字段,返回成功响应,并自动记录更新者和更新时间
+
+#### Scenario: 更新已有执行利率
+
+- **WHEN** 业务人员对已设定执行利率的流程再次调用设定接口
+- **THEN** 系统覆盖更新执行利率为新的值
+
+#### Scenario: 设定不存在的流程
+
+- **WHEN** 业务人员提供的业务方流水号不存在
+- **THEN** 系统返回"记录不存在"的错误信息
+
+#### Scenario: 执行利率在详情中返回
+
+- **WHEN** 业务人员查询流程详情
+- **THEN** 系统在响应数据中包含 `executeRate` 字段(如果已设定则返回值,否则返回 null)
--- a/openspec/changes/add-execute-rate/tasks.md
+++ b/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