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

## 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 基线验证

执行命令：

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

验证结果：

- 40 个相关既有测试通过

### 5.2 任务内 TDD 验证

按计划分别执行并通过：

```bash
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 最终回归

执行命令：

```bash
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`
