1. 课程导论：金融图谱API概述、发布回放验证的重要性、课程目标与学习路径
1.1 金融图谱API概述
金融图谱API是一套基于知识图谱技术构建的金融数据服务接口，它将海量、异构的金融实体（公司、人物、产品、事件）及其多维关系（股权、供应链、担保、关联交易）抽象为图结构，并通过标准化RESTful端点对外暴露。与传统关系型数据库API相比，金融图谱API天然支持深度链路查询、社区发现和影响力传导分析，是风控、投研和监管科技场景的核心基础设施。
| 维度 | 传统API（关系型） | 金融图谱API |
|---|---|---|
| 数据模型 | 表、行、外键 | 节点、边、属性 |
| 查询能力 | 多表JOIN，深度受限 | 图遍历，任意深度 |
| 典型场景 | 客户信息查询 | 实控人穿透、担保圈识别 |
| 变更影响 | Schema变更需迁移 | 图模式灵活，增量扩展 |
核心能力：金融图谱API支持
GET /entities/{id}/neighbors、POST /paths、GET /communities等图原生操作，一次请求即可返回多层关联路径，避免多次RPC调用。
1.2 发布回放验证的重要性
金融图谱API的发布过程涉及图模式变更、索引重建、数据回流和路由切换。任何环节的失误都可能导致查询结果不一致、延迟飙升甚至图结构损坏。发布回放验证是一种将生产环境真实请求流量在预发或灰度环境重新执行，并对比响应结果与基线版本一致性的质量保障方法。
- 回归覆盖：回放真实流量，覆盖手工测试难以构造的边界路径和长尾查询。
- 结果一致性：逐字段比对响应JSON结构、节点ID、边权重和路径长度，发现语义漂移。
- 性能退化：记录P50/P95/P99延迟，对比基线版本，识别因图遍历算法变更导致的性能回退。
- 数据完整性：验证回放结果中实体数量、关系数量与基线一致，防止数据丢失或重复。
常见陷阱：仅依赖单元测试和集成测试，无法捕获因图数据分布变化（如新增大量边）导致的查询超时或内存溢出。发布回放验证是生产级质量保障的最后一道防线。
1.3 课程目标与学习路径
本课程旨在培养学员独立设计、搭建和运维金融图谱API发布回放验证体系的能力。课程从基础概念出发，逐步深入到工程实践，最终实现自动化回放流水线。
1.4 课程核心交付物
完成本课程后，学员将获得以下可直接应用于工作的产出物：
- 回放验证框架：一套基于Go/Python的流量录制、回放与Diff引擎源码。
- CI/CD流水线模板：集成Jenkins/GitLab CI的发布回放验证Job配置。
- 质量门禁规则：延迟阈值、结果差异率、数据完整性检查的量化标准。
- 回放报告模板：包含通过率、性能对比、差异明细的HTML/PDF报告。
前置要求：学员需具备基本的RESTful API使用经验，了解图数据库（Neo4j/JanusGraph）概念更佳。每章末尾提供扩展阅读和练习，建议动手完成。