# 图谱预备提交改动与功能清单

## 1. 提交范围建议

本清单按“图谱功能”口径整理预备提交内容。提交前建议只纳入下列图谱相关文件，避免混入其他业务、环境配置或本地产物。

### 1.1 后端图谱代码

- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiFundGraphController.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/controller/CcdiRelationGraphController.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiFundGraph*.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/dto/CcdiRelationGraph*.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiFundGraph*.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/domain/vo/CcdiRelationGraph*.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiFundGraphMapper.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/mapper/CcdiRelationGraphMapper.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiFundGraphService.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/ICcdiRelationGraphService.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiFundGraphServiceImpl.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiRelationGraphServiceImpl.java`
- `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiFundGraphMapper.xml`
- `ccdi-project/src/main/resources/mapper/ccdi/project/CcdiRelationGraphMapper.xml`

### 1.2 前端图谱代码

- `ruoyi-ui/src/api/ccdi/graph/fundGraph.js`
- `ruoyi-ui/src/api/ccdi/graph/relationGraph.js`
- `ruoyi-ui/src/views/ccdiProject/components/detail/graph/FundGraphSection.vue`
- `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisFundFlowTab.vue`
- `ruoyi-ui/src/views/ccdiProject/components/detail/SpecialCheck.vue`
- `ruoyi-ui/src/views/ccdiProject/components/detail/ProjectAnalysisDialog.vue`

### 1.3 数据库脚本

- `sql/ccdi/graph/01_lx_fund_graph_mysql_ddl.sql`
- `sql/ccdi/graph/02_lx_fund_graph_seed_test_data.sql`
- `sql/ccdi/graph/03_lx_relation_graph_mysql_ddl.sql`
- `sql/ccdi/graph/04_lx_relation_graph_build_mysql.sql`
- `sql/ccdi/graph/05_lx_relation_graph_seed_test_data.sql`
- `sql/ccdi/graph/06_lx_fund_graph_existing_table_supplement.sql`

说明：

- `01`、`03` 是新环境建表参考。
- `06` 是资金流图谱已建表环境补字段、补索引脚本，不删除、不重建、不清空基座数据。
- 生产数据库变更由人工确认后手动执行，不随应用发布自动执行。

### 1.4 文档与验收记录

- `docs/plans/backend/2026-05-28-fund-graph-backend-implementation.md`
- `docs/plans/frontend/2026-05-28-fund-graph-frontend-implementation.md`
- `docs/plans/fullstack/2026-05-28-graph-development-decisions.md`
- `docs/plans/fullstack/2026-05-28-graph-production-db-change-list.md`
- `docs/reports/implementation/2026-05-28-fund-graph-special-check-implementation.md`
- `docs/reports/implementation/2026-05-29-fund-graph-review-fixes-implementation.md`
- `docs/reports/implementation/2026-05-29-fund-graph-statement-query-fix.md`
- `docs/reports/implementation/2026-05-29-graph-acceptance-doc-and-verification.md`
- `docs/reports/implementation/2026-05-29-graph-precommit-summary.md`
- `docs/tests/plans/2026-05-29-graph-acceptance-checklist.md`
- `docs/tests/records/2026-05-29-graph-acceptance-record.md`

### 1.5 提交前需要谨慎确认的文件

- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiModelParamServiceImpl.java`
- `ccdi-project/src/main/java/com/ruoyi/ccdi/project/service/impl/CcdiProjectOverviewServiceImpl.java`

这两个文件只增加 `@Lazy` 解决服务循环依赖，属于图谱运行联动修复，可纳入图谱提交。

以下文件当前工作区存在改动，但是否属于图谱提交需单独确认：

- `ruoyi-admin/src/main/resources/application-dev.yml`
- `tongweb_62318.properties`
- `ruoyi-ui/src/views/ccdiProject/components/detail/FamilyAssetLiabilityDetail.vue`
- `ruoyi-ui/src/views/ccdiProject/components/detail/FamilyAssetLiabilitySection.vue`
- `ruoyi-ui/src/views/ccdiProject/components/detail/RiskModelSection.vue`
- `ruoyi-ui/src/views/ccdiProject/components/detail/RiskPeopleSection.vue`

以下内容不建议纳入提交：

- `output/` 下的浏览器截图和验收临时产物。
- `docs/prototypes/` 下的视觉探索图片，除非本次明确要提交设计参考图。
- `ruoyi-admin/src/main/resources/!cLEZGP.docx`。
- `.DS_Store`。

## 2. 功能清单

### 2.1 资金流图谱

- 主体搜索：按身份证号、姓名或 `object_key` 定位资金流主体。
- 一跳图谱：以当前主体为中心查询一层资金往来。
- 实时聚合：基于 `lx_fund_flow_detail_edge` 按当前筛选条件聚合金额、笔数、首末交易时间。
- 日期筛选：按 `trx_date` 做交易日期范围过滤。
- 金额筛选：支持最小汇总金额和金额范围过滤。
- 方向筛选：支持支出 `1`、收入 `2`。
- 家庭关系标签：资金边可展示已写入 `lx_fund_flow_detail_edge.family_relation_type` 的配偶、父母、子女等标签；后端不实时按家庭表匹配。
- 边明细下钻：点击真实资金边分页查看逐笔流水。
- 节点详情：点击节点查看主体字段、证件号、账户数、累计金额和笔数。
- 节点穿透：可穿透节点支持“设为中心查询”和“一层展开”。
- 手工资金流向：支持人工录入主体级资金流向边。
- 手工边展示：手工边参与图谱展示和统一排序，但不提供逐笔流水下钻。
- 排序与上限：真实边和手工边合并后统一按金额、笔数、最近交易时间排序并按 `limit` 截断。
- 缺参提示：手工新增缺少起点或终点时返回明确业务提示。

### 2.2 关系图谱

- 主体搜索：按身份证号、姓名、统一社会信用代码或 `object_key` 查主体。
- 一跳关系图谱：以主体为中心展示家庭、股东、法人关系。
- 家庭关系边：展示员工与家庭成员关系。
- 股东持股边：展示自然人股东、企业股东与企业之间的持股关系。
- 法定代表人边：展示法人和企业之间的代表关系。
- 节点详情：展示主体名称、证件号或统一社会信用代码、主体类型、来源类型。
- 边详情：按关系来源展示关系类型、企业名称、持股比例、出资额、家庭关系字段等。
- 疑似同名企业：按人员姓名召回工商法人和自然人股东候选。
- 同名过多阻断：同名候选过多时提示缩小线索范围。
- 年龄过滤：能解析出生日期时过滤企业成立时未满 18 岁的候选。

### 2.3 页面集成

- 专项排查页：原图谱占位卡替换为真实图谱工作台。
- 专项排查资金图谱：展示搜索区、图谱画布、右侧节点/边详情、边明细分页。
- 专项排查关系图谱：展示关系搜索、图谱画布、右侧节点/边详情、疑似企业面板。
- 项目分析弹窗资金流向：展示简版资金图谱，不展示逐笔流水表。
- 项目分析弹窗关系图谱：展示简版关系图谱，切换页签时触发图谱 resize。
- 图谱画布：使用 ECharts 渲染节点、边、方向、标签和关系区分样式。

### 2.4 数据库与部署

- 资金流图谱新环境表结构脚本。
- 资金流图谱测试数据脚本。
- 资金流图谱已建表补充脚本。
- 关系图谱新环境表结构脚本。
- 关系图谱构建脚本。
- 关系图谱测试数据脚本。
- 统一 `utf8mb4`、`utf8mb4_general_ci` 口径。
- 图谱 DDL 不自动随应用发布执行。

## 3. 最新内容检查

截至 2026-05-29，本预备提交清单已按当前代码和验收结果更新：

- 当前范围是“资金流图谱 + 关系图谱”。
- 当前资金流图谱验收样例为 `617673198109148314`。
- 当前关系图谱验收样例为 `330101198001010011`。
- `docs/tests/` 下本轮图谱验收清单和记录已纳入本次提交清单。
- `output/` 仍保持忽略，浏览器截图不纳入提交。
