65 lines
3.8 KiB
Markdown
65 lines
3.8 KiB
Markdown
# 征信解析远程路径调用改造实施记录
|
||
|
||
## 背景
|
||
|
||
天座征信解析接口调用方式变更：不再直接 multipart 上传 HTML 文件，改为先将 HTML 保存到业务服务器可访问目录，再将完整远程访问地址作为 `remotePath` 以 `application/x-www-form-urlencoded` 表单参数提交到新接口。
|
||
|
||
本次按新接口文档确认输出外层结构为 `success/code/data/mappingOutputFields`，其中 `mappingOutputFields.payload` 内部仍沿用原有 `lx_header/lx_debt/lx_publictype` 结构。
|
||
|
||
## 修改内容
|
||
|
||
1. 后端上传处理
|
||
- 上传入口 `/ccdi/creditInfo/upload` 保持不变。
|
||
- 新增 `CreditHtmlStorageService`，校验通过后的 HTML 保存到 `ruoyi.profile/credit-html/...`。
|
||
- 根据 `credit-parse.api.file-public-base-url` 与 `/profile/credit-html/...` 拼接生成 `remotePath`。
|
||
- 征信维护落库逻辑改为调用 `CreditParseClient.parse(remotePath)`，后续日期校验、落库、失败记录逻辑保持原样。
|
||
|
||
2. 天座接口客户端
|
||
- `CreditParseClient` 改为提交 `serialNum/orgCode/runType/remotePath/model` 表单参数。
|
||
- `HttpUtil` 增加 `postUrlEncodedForm` 方法，统一提交 `application/x-www-form-urlencoded`。
|
||
- 新增 `CreditParseInvokeResponse`、`CreditParseInvokeData`，承载新外层响应结构。
|
||
- 业务解析只读取 `data.mappingOutputFields` 下的 `message/status_code/payload`。
|
||
|
||
3. 配置
|
||
- `application-dev.yml`、`application-pro.yml`、`application-nas.yml`、`application-uat.yml` 同步调整 `credit-parse.api.url` 到 `/api/service/interface/invokeService/xfeature`。
|
||
- 新增 `credit-parse.api.file-public-base-url`、`org-code=902000`、`run-type=1`、`model=LXCUSTALL`。
|
||
|
||
4. 本地 mock
|
||
- `lsfx-mock-server` 新增支持 `/api/service/interface/invokeService/xfeature`。
|
||
- mock 接收新表单参数并通过 `remotePath` 读取 HTML。
|
||
- mock 返回新外层结构，payload 仍按旧结构生成。
|
||
|
||
5. 测试覆盖
|
||
- `CreditParseControllerTest` 覆盖新调试入口、默认模型、客户端异常、表单参数完整性。
|
||
- `CcdiCreditInfoServiceImplTest` 覆盖 HTML 保存路径与 `remotePath` 拼接、旧日期拦截、成功落库、从新外层结构读取旧 payload。
|
||
|
||
## 验证结果
|
||
|
||
1. 接口文档核对
|
||
- 已读取 `天座征信解析接口文档.xlsx`，确认调用方式为 `POST application/x-www-form-urlencoded`。
|
||
- 已确认输入参数为 `serialNum/orgCode/runType/remotePath/model`。
|
||
- 已确认输出结构为 `success/code/data/mappingOutputFields`。
|
||
|
||
2. 单元测试与编译
|
||
- `mvn -pl ccdi-lsfx -Dtest=CreditParseControllerTest test`：通过，4 个用例成功。
|
||
- `mvn -pl ccdi-info-collection -am -Dtest=CcdiCreditInfoServiceImplTest -Dsurefire.failIfNoSpecifiedTests=false test`：通过，3 个用例成功。
|
||
- `mvn -pl ccdi-lsfx,ccdi-info-collection -am compile`：通过。
|
||
|
||
3. 联调验证
|
||
- 通过 `bin/restart_java_backend.sh restart` 启动后端。
|
||
- 启动本地 mock 后，通过 `/ccdi/creditInfo/upload` 上传临时 HTML。
|
||
- 后端日志确认调用参数包含：
|
||
- `model=LXCUSTALL`
|
||
- `remotePath=http://127.0.0.1:62318/profile/credit-html/2026/05/12/credit_remote_path_test_20260512190228A001.html`
|
||
- mock 日志确认收到 `POST /api/service/interface/invokeService/xfeature` 并返回 200。
|
||
- 上传结果：`successCount=1`、`failureCount=0`。
|
||
- 列表与详情均可查询到解析后的征信负面信息和债务信息。
|
||
- 联调测试身份证号 `330781199001019999` 对应数据已通过删除接口清理，复查列表 `total=0`。
|
||
|
||
## 影响范围
|
||
|
||
- 影响征信维护上传入口、征信解析客户端、本地 mock、相关环境配置。
|
||
- 前端上传入口和页面接口路径不变。
|
||
- 不保留旧 multipart 外部接口兼容逻辑。
|
||
|