# 提案: 添加执行利率设定接口

## 背景

当前利率定价流程已有测算利率（模型输出计算得到），但缺少最终执行利率的设定功能。业务人员需要根据模型测算结果和实际情况，手动设定最终执行的贷款利率。

## 问题

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: 独立的设定接口（采纳）

- **优点**: 职责清晰，实现简单，支持多次修改
- **缺点**: 无明显缺点