ccdi/docs/tests/records/2026-05-29-graph-acceptance-record.md

2026-05-29 图谱功能验收执行记录

1. 执行信息

• 执行时间：2026-05-29 17:36 ~ 17:43（Asia/Shanghai）
• 验收环境：本机真实服务
• 前端地址：http://localhost/
• 后端地址：http://localhost:62318
• 验收清单：docs/tests/plans/2026-05-29-graph-acceptance-checklist.md
• 测试项目：projectId=90342，项目名 test拉取行内流水
• 管理员账号：admin

2. 构建与静态验证

项目	命令	结果
后端编译	mvn -pl ccdi-project -am compile -DskipTests	通过
前端 Node 确认	nvm use; node -v	nvm 不可用，实际 Node 为 v22.22.0
前端构建	npm run build:prod	通过，有既有资源体积 warning

说明：

• Maven 输出存在既有重复依赖声明 warning：ccdi-info-collection 中 ccdi-lsfx 依赖重复。
• 前端构建只有资源体积 warning，无编译失败。

3. 接口验收

3.1 鉴权

• 未登录访问 /ccdi/project/fund-graph/search：返回 401，符合预期。
• 未登录访问 /ccdi/project/relation-graph/search：返回 401，符合预期。
• 使用 /login 登录成功，后续接口带 Bearer token 验收。

3.2 资金流图谱

测试身份证号：617673198109148314

接口/场景	结果
/ccdi/project/fund-graph/search?keyword=617673198109148314	code=200，查到 1 个主体
/ccdi/project/fund-graph/graph?keyword=617673198109148314&limit=20&minTotalAmount=0	code=200，10 个节点、18 条边、72 笔、总金额 302844.78
日期范围查询	code=200，18 条边、72 笔
direction=1 支出查询	code=200，9 条边、45 笔
direction=2 收入查询	code=200，9 条边、27 笔
第一条资金边明细分页	code=200，返回 5 条，总数 5
手工新增资金流向缺少起点	返回 code=500，业务提示：起点主体不能为空

结论：

• 资金图谱核心查询、方向筛选、边明细分页可用。
• 手工新增缺少必填项时已返回明确提示，未出现服务端异常栈。

3.3 关系图谱

测试身份证号：330101198001010011

接口/场景	结果
/ccdi/project/relation-graph/search?keyword=330101198001010011	code=200，查到 1 个主体
/ccdi/project/relation-graph/graph?keyword=330101198001010011&limit=80	code=200，3 个节点、2 条边
/ccdi/project/relation-graph/suspected-enterprises	code=200，返回 1 条疑似企业，blocked=false

结论：

• 关系图谱接口可用，疑似企业查询可用。

4. 页面验收

使用 Playwright CLI 打开真实页面 http://localhost/ 执行：

1. 登录系统。
2. 进入初核项目管理。
3. 打开项目 90342 的详情页。
4. 切换到“专项排查”。
5. 在“资金流图谱”输入 617673198109148314 并查询。
6. 切换“关系图谱”，输入 330101198001010011 并查询。
7. 检查控制台和网络请求。

结果：

• 专项排查页面可正常加载图谱分析区域。
• 资金流图谱查询后页面展示 18 条资金边、72 笔、302,844.78 元。
• 关系图谱查询接口返回 200，页面无白屏。
• 图谱相关网络请求：
  • /dev-api/ccdi/project/fund-graph/graph?keyword=617673198109148314&minTotalAmount=1000&limit=20 返回 200
  • /dev-api/ccdi/project/relation-graph/graph?keyword=330101198001010011&limit=80 返回 200
• 浏览器控制台 error 数量为 0。
• 截图证据：output/playwright/graph-acceptance-special-check.png

5. 注意事项

编号	级别	事项	影响	建议
GRAPH-002	P2	当前 PowerShell 环境 nvm 不可用	不满足“前端命令前先 nvm use”的执行规范	修复 nvm 安装或 PATH；本轮实际使用 Node v22.22.0
GRAPH-004	P2	资金流 DDL 原先只有新建表口径，已建旧表需要差异补充	生产若已建旧表但缺字段，单靠 CREATE TABLE IF NOT EXISTS 不会补齐	已补充 sql/ccdi/graph/06_lx_fund_graph_existing_table_supplement.sql，执行前需人工核对

6. 阶段性结论

本轮未发现图谱接口 500、页面白屏或浏览器控制台 error。资金流图谱和关系图谱在当前本机真实服务上均可查询。

当前图谱主链路验收通过。剩余事项为环境类或发布前核对类事项：GRAPH-002 需要修复本机 nvm 环境，GRAPH-004 需要在生产执行补充 SQL 前人工核对目标库和表结构差异。