Files
ccdi/docs/reports/implementation/2026-07-20-credit-html-local-cleanup-backend-implementation.md

42 lines
1.6 KiB
Markdown
Raw Normal View History

2026-07-20 15:55:28 +08:00
# 征信本地文件清理后端实施记录
## 修改内容
- 为征信 HTML 存储服务增加本地文件删除能力,并限制删除范围为 `ruoyi.profile/credit-html`
- 征信上传调用外部解析接口后立即删除本地文件,再继续解析结果校验与入库。
- 解析失败时同样清理文件;清理异常不覆盖原始解析错误。
- 删除失败时当前文件不再入库,批量上传继续处理后续文件。
## 影响范围
- 后端模块:`ccdi-info-collection`
- 前端、接口协议、数据库结构均无变更。
- 外部 `remotePath` 测试接口无变更。
## 验证情况
### 定向测试
执行命令:
```bash
mvn -pl ccdi-info-collection -am -Dtest=CcdiCreditInfoServiceImplTest -Dsurefire.failIfNoSpecifiedTests=false test
```
结果:通过,共执行 9 个用例,失败 0、错误 0。已覆盖解析成功、解析失败、结果校验失败、入库失败、删除失败、批量继续处理、真实文件删除、重复删除和越界路径拒绝。
### 模块测试
执行命令:
```bash
mvn -pl ccdi-info-collection -am test
```
结果:共执行 178 个用例,本次修改相关测试全部通过;模块整体存在 1 个失败和 1 个错误:
- `CcdiBaseStaffMapperTest.mapperXml_shouldUseStableOrderForBaseStaffPagination`:员工 Mapper 排序契约断言失败。
- `CcdiBaseStaffServiceImplTest.selectBaseStaffById_shouldReturnSelfOwnedAssetInfoList`:员工详情测试返回空对象并触发空指针。
上述失败位于未修改的员工信息代码与测试中,与本次征信本地文件清理无关,本次未扩大范围处理。