# 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 前人工核对目标库和表结构差异。
