154 lines
3.2 KiB
Markdown
154 lines
3.2 KiB
Markdown
# 设计文档: 执行利率设定接口
|
||
|
||
## 数据库设计
|
||
|
||
### 表结构变更
|
||
|
||
**表名**: `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`
|
||
- 自动记录操作人和操作时间
|