清洗流水本方证件号格式

docs/reports/implementation/2026-06-30-bank-statement-cret-no-normalization.md

@@ -0,0 +1,25 @@
+# 2026-06-30 流水本方证件号清洗实施记录
+
+## 背景
+
+业务核对发现，业务侧上传文件名存在“身份证号-姓名”的不规范写法，流水平台返回的本方证件号也可能沿用该形式，且横线前可能存在空格。该值落库到 `ccdi_bank_statement.cret_no` 后，会导致结果总览按身份证号匹配员工、亲属或外部主体时无法命中。
+
+## 修改内容
+
+- 修改 `CcdiBankStatement.fromResponse`，在流水平台响应转换为本地流水实体时清洗 `cretNo`。
+- 清洗规则：
+  - 先去除首尾空格。
+  - 将全角横线、长横线、短横线统一视为半角横线。
+  - 如存在横线，仅保留横线前的身份证号部分，并再次去除首尾空格。
+- 新增单元测试覆盖半角横线和全角横线场景。
+
+## 影响范围
+
+- 仅影响后续新拉取或新上传后落库的流水。
+- 不修改表结构、接口协议、打标规则和前端页面。
+- 改动范围很小，只在流水接口响应转换为本地实体时做字段清洗。
+- 已经落库的历史脏数据需要单独清洗 `ccdi_bank_statement.cret_no` 后重新打标，才能恢复结果总览命中。
+
+## 验证
+
+- 运行 `mvn -pl ccdi-project "-Dtest=CcdiBankStatementTest" test`。