4.1 KiB
4.1 KiB
流程列表执行利率展示设计文档
1. 背景
当前贷款定价流程列表页中，“执行利率(%)”列头已经调整为执行利率语义，但列表列绑定字段仍为 loanRate。这会导致页面展示的仍是贷款利率字段，而不是数据库 loan_pricing_workflow.execute_rate 中保存的实际执行利率数据。
本次需求明确限定为：
- 只调整流程列表页
- 展示数据库中的执行利率实际数据
- 不扩散到详情页、接口定义、数据库结构或其他页面
2. 已确认约束
- 仅修改流程列表页展示逻辑
- 保持后端列表接口
/loanPricing/workflow/list不变 - 保持实体
LoanPricingWorkflow、数据库表loan_pricing_workflow结构不变 - 不新增兼容字段、不增加补丁式映射、不做过度设计
3. 现状分析
当前链路如下：
- 后端列表接口直接返回
LoanPricingWorkflow LoanPricingWorkflow同时包含loanRate和executeRate字段- 前端流程列表页列头为“执行利率(%)”
- 但该列
prop仍绑定为loanRate
因此，页面展示语义与实际数据源不一致。
4. 方案对比
方案一：前端列表列直接切换为 executeRate
做法：
- 保持列表列头“执行利率(%)”不变
- 将流程列表页该列绑定从
loanRate改为executeRate
优点：
- 改动最小
- 数据语义正确
- 不影响后端接口和数据库结构
- 符合最短路径实现要求
缺点：
- 无明显缺点，前提是后端实体已正常返回
executeRate
方案二：后端把 executeRate 映射到 loanRate
做法：
- 保持前端不变
- 在后端列表返回前，将执行利率写入
loanRate
优点：
- 前端改动更少
缺点：
- 字段语义混乱
- 容易影响其他使用
loanRate语义的场景 - 属于补丁式方案，不符合本次约束
方案三：新增列表专用 VO
做法：
- 为流程列表单独定义返回对象
- 新增专门展示字段承载执行利率
优点：
- 语义清晰
缺点：
- 对本次需求明显过度设计
- 引入额外接口对象和转换逻辑
5. 设计结论
采用方案一。
最终实现为：
- 仅修改
ruoyi-ui/src/views/loanPricing/workflow/index.vue - 保持列表列头为“执行利率(%)”
- 将该列表列的
prop从loanRate调整为executeRate - 让页面直接展示数据库
loan_pricing_workflow.execute_rate的实际值
6. 数据链路设计
本次改动后的链路为：
- 数据库表
loan_pricing_workflow.execute_rate保存执行利率 - MyBatis Plus 将该字段映射到实体
LoanPricingWorkflow.executeRate - 列表接口
/loanPricing/workflow/list返回LoanPricingWorkflow集合 - 前端流程列表页从
scope.row.executeRate展示执行利率
这样可以保证列表展示内容与数据库实际业务含义一致。
7. 边界与非目标
本次不包含以下内容：
- 不修改详情页执行利率展示逻辑
- 不修改执行利率录入接口
- 不修改
loanRate字段的业务含义 - 不修改数据库注释、表结构或初始化 SQL
- 不新增空值兜底文案或格式化规则
如果某条记录尚未设定执行利率，则列表按当前表格默认行为展示空值。
8. 风险与控制
本次风险点只有一个：页面列头与字段绑定不一致。
对应控制方式：
- 明确将流程列表页利率列绑定切换为
executeRate - 不对后端做语义映射，避免影响其他逻辑
- 通过源码核对和页面验证确认展示值来源正确
9. 验证方案
实施后需要完成以下验证：
- 查看流程列表页源码，确认列头仍为“执行利率(%)”
- 查看流程列表页源码，确认该列
prop为executeRate - 在存在执行利率数据的记录上，确认列表展示值与数据库
execute_rate一致 - 确认本次改动未影响列表查询、详情查看和执行利率设定功能
10. 实施范围
- 前端：1 个文件
- 后端：无代码改动
- 数据库：无改动
本次属于前端展示绑定修正，不涉及接口契约和存储模型变更。