loan-pricing/doc/2026-04-16-shangyu-corporate-alignment-backend-plan.md

上虞对公利率测算字段对齐后端实施计划

目标

• 对齐对公创建接口、模型调用入参、流程详情返回、mock 返回和 SQL 基线。

实施内容

• 创建请求字段改为 Excel 上传指标 口径：
  • 新增 repayMethod
  • isTradeConstruction 改为 isTradeBuildEnt
  • 移除对公创建链路中的 isAgriGuar、isTechEnt
• 流程主表实体补 repayMethod，并将 isTradeBuildEnt 映射到数据库列 is_trade_construction
• 对公模型输出实体补齐：
  • repayMethod
  • isTradeBuildEnt
  • loanRateHistory
  • minRateProduct
  • smoothRange
  • finalCalculateRate
  • referenceRate
• 对公模型输出实体不再暴露：
  • isAgriGuar
  • midEntTax
  • cardOverdue
• 企业模型入参统一值域：
  • isGreenLoan、isTradeBuildEnt、collThirdParty 发送 0/1
  • repayMethod 发送 分期/不分期
• 企业流程详情主利率改为 finalCalculateRate
• mock 继续保留 data.mappingOutputFields 包装层，只更新企业字段集合和值域

SQL 调整

• loan_pricing_workflow 新增 repay_method
• model_corp_output_fields 新增：
  • repay_method
  • is_trade_build_ent
  • loan_rate_history
  • min_rate_product
  • smooth_range
  • final_calculate_rate
  • reference_rate
• 已同步更新：
  • sql/loan_pricing_workflow.sql
  • sql/model_corp.sql
  • sql/loan_pricing_schema_20260328.sql
  • sql/loan_pricing_prod_init_20260331.sql
  • sql/2026-04-16-shangyu-corporate-alignment.sql

验证

• 运行后端定向单测，确认对公字段和详情主利率断言通过
• 使用 /login/test 获取 token 后调用对公创建和详情接口，确认：
  • 正常场景成功
  • 缺少 repayMethod 返回校验错误
  • 详情返回包含新增字段且 loanRate = finalCalculateRate