loan-pricing/doc/implementation-report-2026-04-03-retail-display-fields.md

个人模型详情缺失展示字段补齐实施记录

实施时间

• 2026-04-03

修改内容

• 补齐个人详情页“业务信息”中的 借款期限
• 补齐个人模型输出“测算结果”中的 5 个字段：
  • 历史利率
  • 产品最低利率下限
  • 平滑幅度
  • 最终测算利率
  • 参考利率
• 在后端 ModelRetailOutputFields 中新增对应 5 个字段定义
• 在零售模型 mock 数据中补齐对应 5 个字段样例值
• 新增零售模型输出表结构迁移脚本，并同步更新建表基线 SQL
• 新增后端字段断言测试与前端源码断言脚本

修改文件

• ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/entity/ModelRetailOutputFields.java
• ruoyi-loan-pricing/src/main/resources/data/retail_output.json
• ruoyi-loan-pricing/src/test/java/com/ruoyi/loanpricing/domain/entity/ModelRetailOutputFieldsTest.java
• ruoyi-ui/src/views/loanPricing/workflow/components/PersonalWorkflowDetail.vue
• ruoyi-ui/src/views/loanPricing/workflow/components/ModelOutputDisplay.vue
• ruoyi-ui/tests/retail-display-fields.test.js
• ruoyi-ui/package.json
• sql/add_model_retail_output_rate_fields_20260403.sql
• sql/model_retail.sql
• sql/loan_pricing_schema_20260328.sql
• sql/loan_pricing_prod_init_20260331.sql
• doc/2026-04-03-retail-display-fields-design.md
• doc/2026-04-03-retail-display-fields-backend-plan.md
• doc/2026-04-03-retail-display-fields-frontend-plan.md
• doc/implementation-report-2026-04-03-retail-display-fields.md

验证方式

1. 新增后端测试，断言 ModelRetailOutputFields 包含 5 个新增字段，先失败后通过
2. 新增前端源码断言脚本，断言个人详情页与模型输出页已补齐字段，先失败后通过
3. 执行前端生产构建，确认页面代码可正常打包
4. 检查开发库 model_retail_output_fields 表结构，确认最初缺少 5 个新列
5. 执行 sql/add_model_retail_output_rate_fields_20260403.sql 到开发库，并再次确认 5 个新列存在
6. 重新编译并重启后端，确保新的实体字段已进入运行中的 SQL 映射
7. 创建新的个人流程 20260403100514909，调用详情接口确认返回以下真实值：
   • loanRateHistory = 6.40
   • minRateProduct = 5.50
   • smoothRange = -0.10
   • finalCalculateRate = 6.05
   • referenceRate = 5.95
8. 启动前端开发服务并使用浏览器自动化打开详情页，确认：
   • 页面出现 借款期限
   • 切换到“测算结果”页签后，5 个新增字段及对应值均可见
9. 验证结束后，停止本次启动的前后端进程

验证结果

• mvn -pl ruoyi-loan-pricing -Dtest=ModelRetailOutputFieldsTest test 首次失败，补齐后通过
• npm --prefix ruoyi-ui run test:retail-display-fields 首次失败，补齐后通过
• npm --prefix ruoyi-ui run build:prod 成功，输出包含 Build complete.
• 已确认开发库 model_retail_output_fields 初始缺少：
  • loan_rate_history
  • min_rate_product
  • smooth_range
  • final_calculate_rate
  • reference_rate
• 已执行迁移脚本并确认以上 5 列存在
• 已确认旧后端进程因未加载最新依赖导致 SQL 仍缺新列，重编译并重启后问题消失
• 已创建个人流程 20260403100514909 并通过详情接口拿到 5 个新增字段的真实值
• 已通过浏览器自动化确认个人详情页展示位与“测算结果”页签展示均正确
• 本次验证期间启动的前后端进程均已停止

说明

• loanTerm 本次仅补齐详情页展示位；个人创建表单当前无该字段录入入口，不属于本次“模型返回字段更新”范围
• 为保证新字段在新环境中也可正常落库，本次同步更新了零售模型输出表的建表基线 SQL