137 lines
4.7 KiB
Markdown
137 lines
4.7 KiB
Markdown
# 项目详情风险明细异常账户人员信息后端实施记录
|
||
|
||
## 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`
|