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

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

@@ -10,6 +10,34 @@
 
 ---
 
+## 后端模型输入参数确认
+
+个人链路最终需要发给模型的 16 个参数如下：
+
+- `serialNum`：服务层自动生成
+- `orgCode`：服务层默认值，当前代码为 `892000`
+- `runType`：服务层默认值 `1`
+- `custIsn`：页面输入透传
+- `custType`：个人链路固定 `个人`
+- `custName`：页面输入，调用模型前解密后透传
+- `idType`：页面输入透传
+- `idNum`：页面输入，调用模型前解密后透传
+- `guarType`：页面输入透传
+- `applyAmt`：页面输入透传
+- `loanPurpose`：页面输入透传
+- `loanTerm`：页面输入透传
+- `bizProof`：页面开关，调用模型前转 `0/1`
+- `loanLoop`：页面开关，调用模型前转 `0/1`
+- `collThirdParty`：页面开关，调用模型前转 `0/1`
+- `collType`：页面下拉透传
+
+调用方式确认：
+
+- 参数载体：`ModelInvokeDTO`
+- 组装方式：`BeanUtils.copyProperties(loanPricingWorkflow, modelInvokeDTO)`
+- 请求格式：`application/x-www-form-urlencoded`
+- 发送入口：`ModelService#invokeModel`
+
 ## 文件结构
 
 - Modify: [ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/dto/PersonalLoanPricingCreateDTO.java](/Users/wkc/Desktop/loan-pricing/loan-pricing/ruoyi-loan-pricing/src/main/java/com/ruoyi/loanpricing/domain/dto/PersonalLoanPricingCreateDTO.java)
@@ -57,13 +85,21 @@ Expected: FAIL，提示字段不存在或转换逻辑未实现
 // 仅断言 PersonalLoanPricingCreateDTO / LoanPricingConverter / ModelInvokeDTO / LoanPricingModelService
 ```
 
-- [ ] **Step 4: 再次运行测试确认失败原因稳定**
+- [ ] **Step 4: 增加最终模型请求参数断言**
+
+```java
+// 断言 requestBody 包含 serialNum、orgCode、runType、custIsn、custType、custName、
+// idType、idNum、guarType、applyAmt、loanPurpose、loanTerm、bizProof、
+// loanLoop、collThirdParty、collType
+```
+
+- [ ] **Step 5: 再次运行测试确认失败原因稳定**
 
 Run: `mvn -pl ruoyi-loan-pricing -Dtest=LoanPricingModelServicePersonalParamsTest test`
 
 Expected: FAIL，失败点与新增字段缺失一致
 
-- [ ] **Step 5: 提交**
+- [ ] **Step 6: 提交**
 
 ```bash
 git add ruoyi-loan-pricing/src/test/java/com/ruoyi/loanpricing/service/LoanPricingModelServicePersonalParamsTest.java
@@ -176,7 +212,8 @@ Run: 调用 `POST /loanPricing/workflow/create/personal`
 Expected:
 - 返回创建成功
 - 请求体包含 `loanPurpose`、`loanTerm`
-- 模型请求中带出 `loanLoop`
+- 模型请求中完整带出 16 个参数
+- 其中 `bizProof`、`loanLoop`、`collThirdParty` 为 `0/1`
 
 - [ ] **Step 3: 验证必填缺失场景**