使用数据鸟瞰图
在一个完整的企业级系统中，随着页面、组件、数据表、API 以及行为流的数量不断增加，各组件之间的调用与依赖网络会变得极其庞杂。
数据关系鸟瞰图是 Zion 平台提供的高级可视化血缘分析工具。它将项目中所有的数据库实体、前端组件、后端逻辑单元以“节点”与“关系连线”的关系网络图谱实时呈现，协助您快速了解项目架构、分析变更影响并快速排错。
1. 核心图谱构成
数据鸟瞰图采用直观的 “节点-连线（Node-Edge）” 图论拓扑结构来表达整个系统：
- 节点（Nodes）：代表系统中的某一个物理存在或逻辑单元。节点的大小根据其被连接的数量自动动态缩放。连接或引用越多的核心节点，其在图谱中的圆形面积越大。
- 连线（Edges）：代表两个节点之间的依赖、流转或控制关系，带有明确的方向箭头，指明数据的来龙去脉。
1.1 节点类型
鸟瞰图中主要包含以下八种高频节点：
- 数据表：已创建的数据库实体表。
- API：集成的外部第三方 API 接口定义。
- 行为流：已编排后端的业务逻辑流。
- 变量：客户端变量、页面变量、或行为流局部内部变量。
- 组件数据：前台画布中各组件的输入或输出值。
- AI：您配置创建的 ZAI 智能体。
- 角色权限：系统中定义的访问控制角色。
- 触发器：自动运行的数据库触发事件。
1.2 关系连线类型
连线上的属性和箭头指向表达了具体的数据流转机制：
- 调用：节点间的嵌套调用，例如“行为流 A”在执行中调用了“API B”。
- 创建/修改/删除：对数据库执行的写操作。
- 读取/作为数据源：对数据的查询、加载。例如某页面以“商品表”作为数据源。
- 触发：事件的执行触发。如“某触发器”在满足条件时启动了“某行为流”。
- 作为类型定义：类型声明。如将“账户”系统表作为类型去约束并定义了一个客户端全局变量。
- 作为知识库/工具：AI 节点专属关联。如 ZAI 智能体绑定了某张表作为知识库，或绑定了某个 API 作为其工具。
2. 操作指南
数据鸟瞰图是实时的、高度互动的可视化工具，您可以通过以下步骤高效使用它：
唤出鸟瞰图
在项目编辑器的 “数据模型设计”、“行为流” 或 “ZAI 智能体” 画布顶部，随时点击 “数据鸟瞰图” 功能按钮。系统会自动加载当前上下文，并生成以当前操作对象为中心原点的局部依赖关系网络。
与节点进行深度交互
- 鼠标悬停：悬停在任意节点上，可快速查看其物理 ID、类型及核心备注信息。
- 高亮聚焦：点击任意节点，全图其他无关节点会自动淡化，仅会深度高亮聚焦与当前节点有直接连接的所有连线和关联节点。
- 一键跳转编辑：双击节点，编辑器将立即跳转至该节点所在的具体逻辑或数据表编辑位置，实现秒级定位。
筛选与模糊搜索
- 节点筛选：在顶部筛选区，可以通过勾选特定节点类型（如只保留数据表和行为流），过滤无关干扰，保持图谱清爽。
- 关系过滤：在右侧控制面板中，勾选特定的连接关系（如只看“修改”和“删除”），快速审查数据的写入链路。
- 全局搜索：支持在顶部和右侧进行模糊文本检索，帮助您在数千个节点中瞬间捕捉到特定的组件或关联字段。
3. 典型实战排障场景
场景一：评估“删除表/字段”的波及范围
- 挑战：由于业务调整需要删除数据表中的某个字段，但担心该字段被前台多个页面、或后端的行为流引用，贸然删除会导致线上崩溃。
- 解决：在鸟瞰图中选中该字段节点，高亮其所有的“读取/引用”连线。您可以清晰地顺着箭头找到所有依赖该字段的行为流节点和前端页面组件，先逐一解除绑定，再安全地将字段从数据库中下线。
场景二：排查数据“莫名其妙被改动”的源头
- 挑战：数据库中的某个字段（如用户积分
points）的数据经常出现异常更新，但在大量的页面中很难通过肉眼找出是哪个按钮在乱写数据。 - 解决：打开鸟瞰图，聚焦于
points属性节点。将关系连线筛选为 “修改 (UPDATE)”。系统将清晰呈现出所有对其具有写入修改权的前端组件或后端行为流节点，让潜在的逻辑 Bug 无处遁形。
Last updated on