146 lines
7.9 KiB
Markdown
146 lines
7.9 KiB
Markdown
# 图谱预备提交改动与功能清单
|
||
|
||
## 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/` 仍保持忽略，浏览器截图不纳入提交。
|