# 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。