# 资金流图谱接口超时优化实施记录

## 背景

- 生产反馈：资金流图谱页面请求 `/ccdi/project/fund-graph/graph` 出现接口超时。
- 截图中的请求参数为 `keyword=330781199401056317`，属于身份证号精确查询场景。
- 生产数据量约 61 万主体时，原主体定位 SQL 将身份证精确匹配、姓名模糊匹配、`object_key` 精确匹配混在同一个 `OR` 条件内，并叠加 `ORDER BY CASE`，容易导致优化器选择低效执行计划。

## 修改内容

1. 拆分主体定位查询：
   - 文件：`ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFundGraphMapper.java`
   - 文件：`ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFundGraphMapper.xml`
   - 新增 `selectFundGraphSubjectsByExactKeyword`，只查询 `idnocfno = keyword` 与 `object_key = keyword`。
   - 新增 `selectFundGraphSubjectsByName`，仅在精确查询无结果后再执行 `name LIKE '%keyword%'`。
   - `selectFundGraphSubjects` 保留为 `object_key` 主键查询，不再执行额外排序。

2. 调整 Service 调用顺序：
   - 文件：`ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFundGraphServiceImpl.java`
   - `/search` 与 `/graph` 的中心节点解析统一走 `selectSubjects`。
   - 有 `objectKey` 时直接主键查询。
   - 无 `objectKey` 且有 `keyword` 时，先精确查询；精确命中后直接返回，不再执行姓名模糊查询。

3. 优化图谱边查询入口：
   - 文件：`ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFundGraphMapper.xml`
   - 新增 `subjectJoinRowsByCenter`，将“中心主体作为起点”和“中心主体作为终点”拆为两段 `UNION ALL`。
   - `selectFundGraphEdges` 改为引用 `subjectJoinRowsByCenter`，避免在主体表两侧使用 `from_subject.object_key OR to_subject.object_key` 作为过滤入口。

## 影响范围

- 资金流图谱主体搜索：`GET /ccdi/project/fund-graph/search`
- 资金流图谱查询：`GET /ccdi/project/fund-graph/graph`
- 边明细查询 `GET /ccdi/project/fund-graph/edge-detail` 仍使用原明细 SQL 片段，未改变入参和返回结构。
- 本次未新增数据库字段或索引脚本；现有 DDL 中已包含 `lx_fund_flow_subject_node.idnocfno`、`name` 和 `object_key` 相关索引。

## 验证情况

- 已通过静态断言确认：
  - Mapper 与 XML 已新增精确查询和姓名查询方法。
  - XML 中已移除 `OR n.name LIKE` 的精确/模糊混用形态。
  - `selectFundGraphEdges` 已引用 `subjectJoinRowsByCenter` 且包含 `UNION ALL`。
- 已通过 XML 格式检查：
  - `xmllint --noout ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFundGraphMapper.xml`
- 已通过 MyBatis XML 解析和 SQL 渲染临时检查：
  - `selectFundGraphSubjectsByExactKeyword`
  - `selectFundGraphSubjectsByName`
  - `selectFundGraphEdges`
- 已通过源码编译：
  - `mvn -pl ccdi-project -am -DskipTests compile`

## 验证阻断说明

- 直接执行 `mvn -pl ccdi-project -DskipTests compile` 会使用本地仓库中的旧依赖模块，出现既有签名不一致错误；使用 `-am` 联编依赖模块后通过。
- 直接执行 `mvn -pl ccdi-project -Dtest=CcdiFundGraphTimeoutOptimizationTest test` 时，测试编译阶段被既有无关测试源码阻断，未进入本次临时测试断言：
  - `CcdiBankStatementTest` 仍引用 `BankStatementItem#setCustomerCertNo`、`setCustomerSocialCreditCode`。
  - `CcdiFileUploadServiceImplTest` 仍按旧的 `LsfxAnalysisClient.uploadFile(Integer, Object, String)` 签名编写。

## 生产核对建议

- 发布后用生产超时样例身份证号重新请求 `/ccdi/project/fund-graph/graph`，核对接口耗时与返回图谱中心节点。
- 如生产库是历史库，先确认以下索引存在：

```sql
SHOW INDEX FROM lx_fund_flow_subject_node WHERE Key_name IN (
  'PRIMARY',
  'idx_lx_fund_flow_subject_idnocfno',
  'idx_lx_fund_flow_subject_name'
);

SHOW INDEX FROM lx_fund_flow_own_account_edge WHERE Key_name IN (
  'idx_lx_fund_flow_own_from_key',
  'idx_lx_fund_flow_own_to_key'
);

SHOW INDEX FROM lx_fund_flow_detail_edge WHERE Key_name IN (
  'idx_lx_fund_flow_detail_from_date',
  'idx_lx_fund_flow_detail_to_date'
);
```