Files
ccdi/docs/plans/backend/2026-07-01-external-person-detail-reason-backend-implementation.md

1.1 KiB

外部人员详情原因快照后端实施计划

背景

外部人员「查看详情」的对象异常明细由前端命中标签组装,但命中标签接口未返回 reasonDetail,导致对象卡片只能展示模型名和规则名,缺少和员工详情一致的异常原因快照。

实施内容

  • CcdiProjectRiskHitTagVO 增加 reasonDetail 字段。
  • 在外部人员风险来源 SQL 中透传 ccdi_bank_statement_tag_result.reason_detail
  • selectExternalRiskHitTagsByScope 中按模型和规则聚合命中标签,并优先返回对象级原因快照;对象级为空时返回流水级原因快照。
  • 同步在员工命中标签查询中映射 JSON 内的 reasonDetail,保持 VO 字段语义一致。

影响范围

  • 外部人员预警列表详情、命中模型外部人员详情的 riskPointTagList/hitTagList 响应字段增加 reasonDetail
  • 不改变原有筛选、排序、风险等级和模型统计逻辑。

验证

  • 执行项目风险模型人员与对象明细相关 Mapper 测试。
  • 执行后端模块编译或打包,确认 VO 与 XML 映射无编译和解析问题。