修正风险仪表盘总人数员工匹配口径

docs/reports/implementation/2026-03-19-risk-dashboard-target-count-match-staff-fix.md

@@ -0,0 +1,25 @@
+# 风险仪表盘总人数员工匹配口径修正记录
+
+**日期**: 2026-03-19
+**范围**: 后端
+
+## 口径修正
+
+- 原修复将 `target_count` 按项目流水中全部去重身份证号回写
+- 用户确认后的正确口径为：
+  - 统计 `ccdi_bank_statement.cret_no`
+  - 仅保留能匹配 `ccdi_base_staff.id_card` 的记录
+  - 再按去重身份证号数量回写 `ccdi_project.target_count`
+
+## 本次修改
+
+1. 在 `CcdiBankStatementMapper` 新增“按项目统计匹配员工主数据后的去重身份证号人数”查询
+2. 在 `CcdiFileUploadServiceImpl.refreshProjectTargetCount` 中改为调用该查询
+3. 保持导入成功、删除成功后的目标人数刷新时机不变，仅修正统计口径
+4. 新增增量脚本 `sql/migration/2026-03-19-fix-project-target-count-match-staff.sql`，用于修正已错误回填的项目人数
+5. 调整单元测试，锁定“只统计能匹配员工主数据的人数”这一行为
+
+## 验证
+
+- 执行：`mvn -pl ccdi-project -Dtest=CcdiFileUploadServiceImplTest test`
+- 结果：通过