loan-pricing/openspec/changes/add-execute-rate/proposal.md

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

背景

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

问题

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

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