wkc/ccdi
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
c5b2033a3dde110943d33335d9368394ca8824ba
ccdi/docs/reports/implementation/2026-05-29-graph-precommit-summary.md
wjj 19a60c987e 新增图谱功能及验收清单
2026-06-01 17:22:51 +08:00

7.9 KiB
Raw Blame History

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

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/ 仍保持忽略，浏览器截图不纳入提交。
Reference in New Issue View Git Blame Copy Permalink