planet/docs/plans/earth-predicted-orbit-plan.md

Earth Predicted Orbit Plan

Source note: this plan absorbs useful ideas from a sisyphus-created draft formerly stored at .sisyphus/plans/predicted-orbit.md.

Goal

在 Earth 中锁定卫星时，显示“预测轨道”而不是只有历史尾迹：

• 从当前时刻开始
• 绕地球一圈
• 当前点最亮
• 向后沿轨道逐步衰减

Current State

当前已经有：

• 卫星历史轨迹
• 锁定卫星
• 轨道高亮与相关联动

但“预测轨道”仍然不是一套稳定、可验证的单独功能计划。

Why It Is Valuable

预测轨道可以明显提升：

• 锁定卫星后的空间可读性
• 轨道类型辨识
• 演示解释力

相比短历史尾迹，预测轨道更符合用户对“这颗卫星接下来会怎么走”的预期。

Scope

Phase 1

• 锁定卫星时显示一整圈预测轨道
• 解锁时隐藏
• 不替代现有普通轨迹系统

Phase 2

• 根据轨道类型调整采样率
• GEO / MEO / LEO 不同密度
• 进一步减少 fallback 轨迹的比例

Implementation Direction

1. Orbit period

基于 meanMotion 估算轨道周期。

2. Predicted samples

以固定采样步长从 now -> now + period 推算轨迹点。

3. Render object lifecycle

预测轨道应是一个独立渲染对象：

• show
• update
• hide
• dispose

4. Visual semantics

预测轨道不应与普通尾迹混淆：

• 更稳定
• 更完整
• 透明度沿轨道衰减
• 当前点附近更亮

Known Risks

1. TLE propagation gaps

部分卫星可能出现 SGP4 计算不足，需要 fallback。

2. Multiple orbit lines

必须确保：

• 锁定切换前先清旧轨道
• 页面隐藏/销毁时清理

3. Performance

GEO 轨道点数高，采样率需要按轨道类型分层。

Acceptance

1. 锁定单颗卫星时只显示一条预测轨道
2. 解锁后轨道立即清除
3. 不同轨道类型下点数可控
4. 页面切换回来不会闪出旧轨道残留

Satellite Footprint Follow-Up Items

从技术文档迁出的 footprint 后续项，作为卫星覆盖能力的计划 backlog：

1. 为 iridium-next 新建独立 footprint adapter。
2. 在 UI 上补一个只读提示，让用户知道当前卫星是否支持 footprint。
3. 如果未来拿到 GEO beam contour / operator metadata，再为 GEO 开 operator-specific footprint。