产品定位与范围

产品定位

本系统是一个面向“水声通信场景仿真实验”的数字孪生调度与观测原型。

UNET/UnetSim：提供通信与信道仿真（底座）
本系统：提供可复现实验编排（Orchestrator）、调度策略（Scheduler）、一致性同步（Barrier/Clock）、指标采集与可视化（API + Dashboard）

目标（Goals）

多节点场景可复现运行（场景配置可版本化）
至少两种调度策略可切换对比（Round-robin + 自适应策略）
逻辑时间步进 + Barrier，保证顺序一致与可复现
全量日志/事件采集，输出吞吐、时延、丢包、同步误差、调度开销
支持历史 run 列表、A/B 指标对比与回放
提供实时可视化监控与运行控制（MVP 采用 Streamlit）

非目标（Non-goals）

不实现/替换 UNET 的物理层与复杂信道算法
不在 MVP 阶段实现复杂的保守/乐观离散事件同步算法
不强制要求直接改动 UNET 内核（优先网关/日志适配）

约束与假设

UNET 相关操作必须封装在 UnetAdapter 抽象层中，避免版本差异影响主流程
支持两条集成路径：
- Path-1（优先）：通过 fjage gateway 进行 subscribe/request 控制与采集
- Path-2（兜底）：仅依赖日志文件解析完成采集与可视化闭环
可复现要求：同一场景 + 同一 seed + 同一策略与参数，重复运行结果一致（或方差可解释）