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

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

日期: 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
• 结果：通过