64 lines
2.1 KiB
Markdown
64 lines
2.1 KiB
Markdown
# 提案: 添加执行利率设定接口
|
||
|
||
## 背景
|
||
|
||
当前利率定价流程已有测算利率（模型输出计算得到），但缺少最终执行利率的设定功能。业务人员需要根据模型测算结果和实际情况，手动设定最终执行的贷款利率。
|
||
|
||
## 问题
|
||
|
||
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: 独立的设定接口（采纳）
|
||
|
||
- **优点**: 职责清晰，实现简单，支持多次修改
|
||
- **缺点**: 无明显缺点
|