添加执行利率接口

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: 独立的设定接口（采纳）
+
+- **优点**: 职责清晰，实现简单，支持多次修改
+- **缺点**: 无明显缺点