补充后端模型输入参数确认文档

doc/2026-04-09-shangyu-retail-input-params-design.md

@@ -218,6 +218,63 @@
 5. `LoanPricingModelService` 在调用模型前，将个人链路中的开关字段转换为 `0/1`
 6. `ModelService` 继续以 `application/x-www-form-urlencoded` 方式调用模型接口
 
+### 6.3.1 后端模型调用输入参数确认
+
+后端最终发给模型的个人入参，按 Excel 要求确认为以下 16 个字段：
+
+- `serialNum`
+  - 来源：`LoanPricingWorkflowServiceImpl#createLoanPricing` 自动生成
+- `orgCode`
+  - 来源：`LoanPricingWorkflowServiceImpl#createLoanPricing` 默认赋值
+  - 当前代码值：`892000`
+- `runType`
+  - 来源：`LoanPricingWorkflowServiceImpl#createLoanPricing`
+  - 当前值：`1`
+- `custIsn`
+  - 来源：页面输入，经个人创建 DTO 和转换器透传
+- `custType`
+  - 来源：`LoanPricingConverter#toEntity(PersonalLoanPricingCreateDTO)`
+  - 当前值：固定 `个人`
+- `custName`
+  - 来源：页面输入
+  - 说明：入库时加密，调用模型前解密
+- `idType`
+  - 来源：页面输入
+- `idNum`
+  - 来源：页面输入
+  - 说明：入库时加密，调用模型前解密
+- `guarType`
+  - 来源：页面输入
+- `applyAmt`
+  - 来源：页面输入
+- `loanPurpose`
+  - 来源：页面输入
+  - 当前状态：需补齐到个人 DTO、流程实体映射和模型 DTO
+- `loanTerm`
+  - 来源：页面输入
+  - 当前状态：需补齐到个人 DTO、流程实体映射和模型 DTO
+- `bizProof`
+  - 来源：页面开关
+  - 模型值：调用模型前统一转换为 `0/1`
+- `loanLoop`
+  - 来源：页面开关
+  - 当前状态：需补齐到模型 DTO
+  - 模型值：调用模型前统一转换为 `0/1`
+- `collThirdParty`
+  - 来源：页面开关
+  - 模型值：调用模型前统一转换为 `0/1`
+- `collType`
+  - 来源：页面下拉
+  - 模型值：按 `一类/二类/三类` 直接透传
+
+后端调用方式确认如下：
+
+- 参数载体：`ModelInvokeDTO`
+- 参数来源：`BeanUtils.copyProperties(loanPricingWorkflow, modelInvokeDTO)`
+- 请求构造：`ModelService#entityToMap`
+- 请求格式：`application/x-www-form-urlencoded`
+- 发送入口：`ModelService#invokeModel`
+
 ### 6.4 展示闭环
 
 为保证输入项可在详情页回看，个人详情页同步补齐：
@@ -240,6 +297,7 @@
 - 前端源码断言个人新增弹窗已出现 `loanPurpose`、`loanTerm`
 - 前端源码断言 `loanTerm` 为固定下拉、`collType` 选项为 `一类/二类/三类`
 - 后端测试或源码断言 `PersonalLoanPricingCreateDTO`、`LoanPricingConverter`、`ModelInvokeDTO` 已补齐字段
+- 后端测试或日志断言调用模型前最终请求参数完整包含以上 16 个字段
 - 重启后端后，覆盖以下接口验证：
   - 正常场景：完整参数创建成功
   - 必填缺失场景：缺少 `loanPurpose` 或 `loanTerm` 被拦截