ccdi/docs/reports/implementation/2026-03-31-project-detail-risk-details-abnormal-account-backend-implementation.md

项目详情风险明细异常账户人员信息后端实施记录

1. 实施概述

• 实施日期：2026-03-31
• 实施目标：为项目详情风险明细补齐“异常账户人员信息”的真实后端分页查询与统一导出能力
• 实施范围：ccdi-project 模块结果总览控制器、服务层、Mapper SQL、统一工作簿导出器及对应测试

2. 新增接口与对象

2.1 新增接口

• GET /ccdi/project/overview/abnormal-account-people
  • 入参：projectId、pageNum、pageSize
  • 返回：rows、total
  • 权限：ccdi:project:query

2.2 新增 DTO / VO / Excel 对象

• CcdiProjectAbnormalAccountQueryDTO
  • 承载异常账户分页查询入参
• CcdiProjectAbnormalAccountItemVO
  • 承载单条异常账户明细
• CcdiProjectAbnormalAccountPageVO
  • 承载分页查询结果 rows/total
• CcdiProjectAbnormalAccountExcel
  • 承载统一导出第 3 个 sheet 的行数据

3. Mapper SQL 口径

异常账户分页与导出统一复用同一套基础查询口径：

• 仅查询当前项目：tr.project_id = projectId
• 仅查询异常账户模型：tr.model_code = 'ABNORMAL_ACCOUNT'
• 仅查询对象型结果：tr.bank_statement_id is null
• 仅查询员工本人账户：account.owner_type = 'EMPLOYEE' 且 account.owner_id = tr.object_key
• 仅在 reason_detail 中命中具体账号时返回：instr(tr.reason_detail, account.account_no) > 0
• 排序统一为：异常发生时间 desc -> 账号 asc -> 规则编码 asc

字段映射如下：

• accountNo：ccdi_account_info.account_no
• accountName：优先 ccdi_account_info.account_name，为空回退 ccdi_base_staff.name
• bankName：ccdi_account_info.bank
• abnormalType：ccdi_bank_statement_tag_result.rule_name
• abnormalTime
  • SUDDEN_ACCOUNT_CLOSURE 取 invalid_date
  • DORMANT_ACCOUNT_LARGE_ACTIVATION 从 reason_detail 提取首次交易日期
• status
  • 1 -> 正常
  • 2 -> 已销户

4. 服务层与统一导出改动

4.1 服务层

• 在 ICcdiProjectOverviewService 中新增：
  • getAbnormalAccountPeople(queryDTO)
  • exportAbnormalAccountPeople(projectId)
• 在 CcdiProjectOverviewServiceImpl 中实现：
  • 项目存在性校验
  • 分页默认值 pageNum=1、pageSize=5
  • 分页结果直接映射为 CcdiProjectAbnormalAccountPageVO
  • 导出结果映射为 CcdiProjectAbnormalAccountExcel

4.2 统一导出

• exportRiskDetails(...) 现在会同时查询：
  • 涉疑交易明细
  • 员工负面征信信息
  • 异常账户人员信息
• CcdiProjectRiskDetailWorkbookExporter.export(...) 方法签名扩展为接收异常账户列表
• 第 3 个 sheet 异常账户人员信息 从“仅表头”改为“表头 + 真实数据行”
• 第 3 个 sheet 列顺序固定为：
  • 账号
  • 开户人
  • 银行
  • 异常类型
  • 异常发生时间
  • 状态

5. 自动化验证

5.1 基线验证

执行命令：

mvn -pl ccdi-project -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=CcdiProjectOverviewControllerContractTest,CcdiProjectOverviewControllerTest,CcdiProjectOverviewMapperSqlTest,CcdiProjectOverviewServiceImplTest,CcdiProjectRiskDetailWorkbookExporterTest test

验证结果：

• 40 个相关既有测试通过

5.2 任务内 TDD 验证

按计划分别执行并通过：

mvn -pl ccdi-project -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=CcdiProjectOverviewControllerContractTest,CcdiProjectOverviewControllerTest test
mvn -pl ccdi-project -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=CcdiProjectOverviewMapperSqlTest test
mvn -pl ccdi-project -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=CcdiProjectOverviewServiceAbnormalAccountTest test
mvn -pl ccdi-project -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=CcdiProjectOverviewServiceImplTest,CcdiProjectRiskDetailWorkbookExporterTest test

5.3 最终回归

执行命令：

mvn -pl ccdi-project -am -Dsurefire.failIfNoSpecifiedTests=false -Dtest=CcdiProjectOverviewControllerContractTest,CcdiProjectOverviewControllerTest,CcdiProjectOverviewMapperSqlTest,CcdiProjectOverviewServiceAbnormalAccountTest,CcdiProjectOverviewServiceImplTest,CcdiProjectRiskDetailWorkbookExporterTest test

结果：

• 47 个测试全部通过
• BUILD SUCCESS

6. 手工联调与进程处理

• 本次未执行手工联调
• 未启动新的后端 java -jar ruoyi-admin.jar 进程
• 因未启动额外前后端进程，无额外进程需要关闭

7. 结果结论

• 异常账户人员信息分页接口已具备真实查询能力
• 页面查询与统一导出第 3 个 sheet 已复用同一套异常账户明细口径
• 返回字段已覆盖：
  • accountNo
  • accountName
  • bankName
  • abnormalType
  • abnormalTime
  • status