获取可用的地面站列表

获取数据组合维度信息

获取调试状态 - 仅在显式开启 SMARTNODE_DEBUG_API 时可用，默认返回 404。

按请求 ID 查询单条调度决策轨迹。 路径参数： - req_id: 请求 ID，如 "REQ_0001" 成功返回 200 + 轨迹 JSON； 未找到时返回 404 + 标准化错误。

返回所有调度决策轨迹记录（有限长度环形缓冲，最多 500 条）。 可选查询参数： - limit (int): 最多返回最近 N 条轨迹（默认返回全部） - outcome (str): 按结果过滤，可取 "scheduled"、"rejected"、"rerout

计算卫星到地面站的多普勒频移。 参数 ---- sat_pos : dict 含 lat/lon/alt（m）的卫星位置。 sat_vel : dict 含 vx/vy/vz（km/s）的 ECEF 速度矢量。 g

从环境变量 SMARTNODE_LOG_LEVEL 或 LOG_LEVEL 解析日志级别。 SMARTNODE_LOG_LEVEL 优先级高于 LOG_LEVEL（兼容旧约定）。 默认返回 logging.INFO。

获取卫星相对地面站的精确仰角/方位角/斜距。 参数 ---- sat_pos : dict 含 lat/lon/alt（alt 单位 m）的卫星位置。 gs_pos : dict 含 lat/lon 的地面站，可选 alt（m）

获取随遇接入站信息

返回所有 LEO/MEO 卫星在当前时刻起的一个轨道周期内的位置采样点。 用于前端在 Cesium 中绘制空间轨道折线与地面星下点轨迹。 查询参数： - steps (int): 每颗卫星的采样点数量，范围 [20, 360]，默认 90。 返回格式：

分页、过滤与排序的请求列表接口。 Query Parameters: page (int, ≥1, default=1) page_size (int, 1-200, default=20) status (

⭐ 资源状态API：展示各类资源的实时可用性 包括卫星、地面站、中继星的占用/空闲状态

获取资源时间轴数据（用于资源占用可视化） 返回所有资源（卫星、地面站、中继星）的时间占用情况

获取实时资源利用率数据

获取仿真数据

返回指定仿真时刻的卫星位置快照，用于前端态势回放。 查询参数: t (float, 必填): 目标仿真时刻（秒）。须落在历史时间窗口 [current_time - 3600, current_time] 内。 响应: {

获取系统信息

从环境变量 SMARTNODE_TIME_SCALE 读取仿真时间倍率。 未设置或值无效时回退到默认值 10（与历史行为一致）。 建议范围：1（实时）~ 600（极速仿真）。

返回当前令牌身份与角色对应的权限。

返回黄金基准字典（模块级缓存）。

从 golden/scenario_snapshots.json 加载并返回黄金快照字典。 供需要直接断言黄金数据的测试使用，避免重复加载文件。 Returns: dict: 黄金场景快照字典（包含 task_cmd_immediate、raw_image_dir

加载并返回黄金快照字典（供外部测试直接断言）。

Serve the separated frontend shell.

* 启动 SSE 连接，订阅 /api/v1/stream。 * 成功后停止回退轮询；断线后自动重连（浏览器原生行为）。 * 若服务端返回非 2xx 或 5 秒内未收到任何事件，则降级为轮询模式。

Mark the resource form as needing re-population from backend data.

每次测试独立引擎（seed=0, autostart=False）。

每次测试独立引擎（seed=GOLDEN_SEED, autostart=False）。

ISS-like 圆轨道（a≈6778 km，倾角 51.6°，初始位置赤道/本初子午线）。

ISS-like 圆轨道（开启 J2）。

ISS-like 圆轨道（关闭 J2，纯二体）。

判断两颗卫星之间是否存在激光 ISL 几何可见性（视线不被地球遮挡）。 Parameters ---------- sat1_pos, sat2_pos : dict 卫星位置，含 ``lat``、``lon``（度）、``alt``（米）。 Re

固定轨道根数的 LEO 卫星 OrbitalElements 实例（模块作用域）。

GEO 星间链路（ISL）链路预算。 Parameters ---------- distance_km : float 两颗 GEO 卫星之间距离 (km)。 Returns ------- LinkBudgetResult

存活探针：进程可响应即存活。

Mark the resource form as populated (no re-sync needed until next reset).

Return Prometheus text exposition format metrics.

* Called when the user drags the range slider. * @param fraction — value in [0, 1] representing position in the time range.

测试结束时输出关键指标摘要到控制台。

OpenAPI 3.1 规范（机器可读）。

极轨圆轨道（a=7000 km，倾角 90°）。

返回 ECI 位置向量 (x_km, y_km, z_km)（仅 SGP4 路径；二体路径抛出 NotImplementedError）。

使用 SGP4 由 TLE 两行根数传播卫星位置。 参数 ---- tle_line1 : str TLE 第一行（74 字符 NORAD 格式）。 tle_line2 : str TLE 第二行（74 字符 NORAD 格式）。

仅保留最近 keep 条统计快照，返回删除行数。

返回当前身份的限流配额信息（用于客户端自适应退避）。

对被装饰路由按 limit/window 限速（优先按身份，回退 IP）。

就绪探针：仿真线程存活才视为就绪，否则 503。 同时挂载 /api/ready（K8s / Compose 约定俗成的短路径）与 /api/readyz。 校验逻辑：仿真引擎 running 标志为真且后台线程存活，才认为服务就绪。 非就绪时返回 HTTP 503，供 K

* 从 /api/orbit_tracks 拉取各卫星的轨道采样点，并在 Cesium 中绘制： * - 空间轨道折线（带高度，颜色区分 LEO/MEO） * - 贴地星下点轨迹（alt=0） * 复用已有实体，仅在卫星集合变化时重建。

释放一个活跃波束槽位。 Parameters ---------- beam_key : str 之前通过 :meth:`allocate` 分配的波束标识。 Returns -------

显式标注需要鉴权的路由（实际校验由 before_request 统一完成）。

要求当前身份角色不低于 min_role，否则返回 403。

重置随机源以进入确定性模式（影响后续地面站抽样/调度/背景任务/轨道生成）。

每个测试前后重置 api 模块的 _saved_snapshot。

将引擎状态回滚到快照时刻。 恢复后引擎进入 **回放模式**：主仿真循环暂停（``running=False``）， /api/data 返回快照时刻的态势数据，直到调用方显式调用 ``engine.start_simulation()`` 或 ``

Snap back to the live edge and resume real-time following.