3.2 KiB
3.2 KiB
项目人数按流水 cret_no 统计实施记录
背景
- 生产反馈：同一项目上传一个人的流水后，结果总览卡片仍显示两个人。
- 业务确认：项目里的人数只按照流水中的
cret_no计算。 - 本次只调整
ccdi_project.target_count的统计口径，不调整风险人员、风险模型命中人员的归属与展示逻辑。
修改内容
-
调整运行时统计 SQL：
- 文件：
ccdi-project/src/main/resources/mapper/ccdi/project/CcdiBankStatementMapper.xml - 方法：
countMatchedStaffCountByProjectId - 新口径：仅统计
ccdi_bank_statement.cret_no直接匹配ccdi_base_staff.id_card后的去重人数。 - 移除口径：不再纳入家属关系归属员工，不再纳入本方账号账户库归属员工。
- 文件：
-
新增生产回填脚本：
- 文件：
sql/migration/2026-06-02-fix-project-target-count-cret-no-only.sql - 作用：按新口径回写既有项目的
ccdi_project.target_count。
- 文件：
-
补充测试约束：
CcdiBankStatementMapperXmlTest.targetCount_shouldOnlyUseStatementCretNoMatchedStaff
影响范围
- 结果总览顶部“总人数”卡片。
- 项目列表中的目标人数。
- 上传成功、删除上传记录、历史导入、标签重算后写回的
target_count。 - 生产既有项目需要执行新增迁移脚本，否则已存在的
target_count不会自动立即回写。
不变范围
- 风险人员列表仍按打标结果归属员工展示。
- 风险模型卡片
peopleCount仍来自ccdi_project_overview_employee_result。 - 涉疑交易、负面征信、异常账户等结果总览子模块不在本次修改范围。
验证情况
- 已尝试运行：
mvn -pl ccdi-project -Dtest=CcdiBankStatementMapperXmlTest#targetCount_shouldOnlyUseStatementCretNoMatchedStaff test
- 结果：测试编译阶段被既有无关错误阻断，目标测试未执行到断言。
- 阻断点包括：
CcdiBankStatementTest引用的BankStatementItem#setCustomerCertNo、setCustomerSocialCreditCode不存在。CcdiFileUploadServiceImplTest中多处仍按旧的LsfxAnalysisClient.uploadFile(Integer, Object, String)签名编写。
- 已通过静态校验确认：
- 运行时
countMatchedStaffCountByProjectId只统计ccdi_bank_statement.cret_no。 - 新增生产回填脚本不包含
ccdi_staff_fmy_relation、ccdi_account_info、LE_ACCOUNT_NO。
- 运行时
- 已通过源码编译：
mvn -pl ccdi-project -DskipTests compile
生产执行提醒
- 执行包含中文注释的 SQL 脚本时，按项目规则使用：
bin/mysql_utf8_exec.sh sql/migration/2026-06-02-fix-project-target-count-cret-no-only.sql
- 执行后可用以下 SQL 核对单个项目：
SELECT
project.project_id,
project.target_count,
stats.target_count AS expected_target_count
FROM ccdi_project project
LEFT JOIN (
SELECT
bs.project_id,
COUNT(DISTINCT TRIM(bs.cret_no)) AS target_count
FROM ccdi_bank_statement bs
INNER JOIN ccdi_base_staff staff
ON staff.id_card = TRIM(bs.cret_no)
WHERE bs.cret_no IS NOT NULL
AND TRIM(bs.cret_no) != ''
GROUP BY bs.project_id
) stats ON stats.project_id = project.project_id
WHERE project.project_id = {projectId};