角色与使用场景

角色定义

• 开发者（Developer）：编写场景、调度策略与适配器，实现与验证指标计算，并负责 UNET 接入排查。
• 演示者（Presenter）：在答辩现场选择场景/策略并启动运行，展示链路连通性、指标结果与（后续）Dashboard。
• 评审者（Reviewer）：查看 SRS、运行结果落盘、关键指标曲线与报告，确认可复现与可解释性。

典型使用场景

场景 S1：离线跑完出指标（Demo-0，mock traces）

• 目标：不依赖 UNET 网关，跑通单个场景，输出 metrics.csv 与 eport.md
• 参与者：开发者/演示者
• 成功条件：关键指标可计算、文件齐全、可重复运行；并在报告中明确标注 traces 来源为 mock

场景 S2：UNET Gateway 端到端链路（Demo-1，真实 traces）

• 目标：证明 Python 可通过 fjage gateway 与 UNET 交互，形成真实 traces
• 参与者：开发者/演示者/评审者
• 成功条件：
  • scripts/unet_probe_gateway.py 可连并列出 agent/service
  • 运行过程中能 Tx/Rx，payload header 可解析， races.csv 来源为 gateway

场景 S3：React Dashboard 可视化 + A/B 对比 + 运行控制（Demo-2）

• 目标：在 React + Vite SPA Dashboard 中查看历史 runs、run 详情曲线、完成 A/B 对比，并支持 Start/Stop 控制
• 参与者：演示者/评审者
• 成功条件：
  • runs 列表、详情、A/B 对比可用（React Dashboard 页面）
  • Start/Stop 控制有效；运行中曲线通过 WebSocket 实时更新
  • 数据来源可标注（gateway 优先，不可用时降级需提示）
  • 节点拓扑视图与系统配置页可访问

场景 S4：场景 CRUD 管理（Web 端）

• 目标：通过 Dashboard 或 API 完成场景的创建、查看、编辑与删除，支持 YAML 导入/导出
• 参与者：开发者/演示者
• 成功条件：
  • 可通过 REST API (POST/GET/PUT/DELETE /api/scenarios) 完成场景 CRUD
  • 场景数据同时支持 YAML 文件与数据库两种来源，合并展示
  • 导入 YAML 场景到数据库、导出数据库场景到 YAML 文件均可用
  • 场景编辑后用于新 run 时，使用最新配置

场景 S5：节点健康检查（运维诊断）

• 目标：在 Dashboard 健康检查页面或通过 API 查看所有仿真节点的连接状态、PHY 层状态与 UNet 地址
• 参与者：开发者/演示者
• 成功条件：
  • GET /health 返回数据库、适配器、各节点的综合健康状态（healthy / degraded / unhealthy）
  • GET /health/nodes 返回逐节点的深度检查结果（gateway 连接、probe、PHY 状态、UNet 地址）
  • Dashboard 健康检查页面可视化展示各节点状态