● NTN Stack - 5G Non-Terrestrial Network 智能切換系統
🐳 執行環境: 完全容器化微服務架構 (20+ Docker 容器)
📁 Claude Code 重要: 請必須閱讀 CLAUDE.md 了解 Docker 多容器架構
項目概述
NTN Stack 是一個基於 5G 非地面網路 (Non-Terrestrial Network) 的智能切換系統，專注於衛星通信網路中的先進算法實現。系統採用 Fine-Grained Synchronized Algorithm 和 Fast Access Satellite Prediction Algorithm 等創新技術，實現低延遲、高可靠性的衛星間切換機制。
核心技術架構
前端可視化系統
主介面架構
前端採用 React + TypeScript 架構，提供直觀的 3D 可視化介面用於演示和監控 NTN 算法運行狀態。
導航欄 (Navbar) 功能模組:
- 系統狀態監控面板：實時顯示網路健康度、活躍 UE 數量、衛星連接狀態
- 算法切換控制器：支援 Baseline、Enhanced Prediction、ML Optimized、Synchronized 四種算法模式切換
- 性能指標儀表板：即時顯示 handover 延遲、成功率、預測準確率等關鍵指標
- 系統設定面板：參數調整、測試模式切換、日誌等級配置
側邊欄 (Sidebar) 組件體系:
- 場景選擇器: 提供 Lotus、NTPU、NYCU、Nanliao 四個預建場景
- 設備管理面板: UE 設備列表、衛星狀態監控、網路拓撲顯示
- 算法控制台:
- Fine-Grained Synchronized Algorithm 參數調整
- Fast Access Satellite Prediction 配置選項
- A/B 測試進度監控
- 機器學習模型性能指標
- 視覺化控制: 圖層開關、視角控制、數據過濾選項
3D 立體圖可視化實現
核心渲染引擎: 系統使用 Three.js 作為 3D 渲染核心，配合 React Three Fiber 框架實現高性能的立體可視化。
立體場景組件:
- 地理場景渲染 - 基於真實地理數據的 3D 地形模型 (.glb 格式) - 高精度衛星影像紋理貼圖 - 建築物和地標的幾何精確建模 - 支援多層次細節 (LOD) 渲染優化
- 衛星軌道可視化 - 實時 LEO 衛星軌跡計算和渲染 - 衛星模型動態載入 (sat.glb) - 軌道預測路徑的曲線可視化 - 衛星間通信鏈路的動態連線展示
- UE 設備和移動模式 - 可移動的 UE 設備 3D 模型 (uav.glb) - 設備移動軌跡的即時追蹤 - 信號強度的熱力圖渲染 - 切換決策的視覺化標註
- 波束覆蓋和干擾視觸化 - 衛星波束覆蓋範圍的 3D 錐形投影 - 干擾區域的半透明體積渲染 - SINR (Signal-to-Interference-plus-Noise Ratio) 分佈圖 - 預測性波束管理的動態調整動畫
算法視覺化專用組件:
- Fine-Grained Synchronized Algorithm 展示 - 多 UE 同步切換的時間軸動畫 - 二點預測方法的視覺化對比 (T 和 T+Δt 時間點) - Binary search refinement 過程的迭代可視化 - 同步容忍度範圍的 3D 空間展示
- Fast Access Satellite Prediction 演示 - 軌跡計算的即時預測路徑 - 天氣條件對信號傳播的影響模擬 - 空間分佈優化的約束式衛星選擇過程 - 預測準確率的即時統計圖表
- 干擾分析和緩解可視化 - 多層干擾源的 3D 分佈展示 - 自適應波束成形的動態調整 - 功率控制策略的效果展示 - 跳頻模式的頻譜使用圖
互動功能實現:
- 滑鼠/觸控手勢的 3D 場景操控
- 時間軸控制器用於回放歷史事件
- 即時參數調整對算法行為的影響觀察
- 多視角切換 (俯視、側視、跟隨視角)
後端算法引擎
Phase 1-2: 核心算法實現
- NetStack API: 完整的 5G NTN 協議棧實現，包含 N2、N3、Xn 介面
- SimWorld 引擎: 高精度的物理層仿真，支援 Sionna 框架整合
- Conditional Handover 機制: 基於 3GPP 標準的智能切換決策
Phase 3: 生產環境部署系統
- Blue-Green 部署策略: 零停機時間的服務更新機制
- Canary 漸進式部署: 1%→100% 的安全流量切換
- 即時監控和告警: Prometheus + Grafana 完整監控棧
- 全量部署優化: 自動化的性能調優和資源管理
Phase 4: 持續優化與演進
- A/B 測試框架: 支援四種算法變體的並行對比測試
- 機器學習整合: XGBoost 模型的 handover 決策優化
- 自動化調優: 貝葉斯優化的參數搜索引擎
- 先進算法套件:
- Synchronized Handover Algorithm
- Predictive Beam Management
- Adaptive Interference Mitigation
- Multi-Satellite Coordination
關鍵技術特性
Fine-Grained Synchronized Algorithm
- 無信令同步: 無需 access network 與 core network 間控制信令交互
- 二點預測: T 和 T+Δt 時間點的雙重預測機制
- Binary Search Refinement: 迭代式誤差減半至 RAN 層切換時間以下
- 同步容忍度: 可配置的時間同步精度控制
Fast Access Satellite Prediction
- 軌道可預測性利用: 基於 LEO 衛星軌道特性的預測優化
- 多因素整合: 軌跡計算、天氣資訊、空間分佈的綜合考量
- 約束式策略: 計算複雜度的顯著降低
- 高精度預測: >95% 的切換觸發時間預測準確率
性能指標達成
- Handover 延遲: <50ms (實測 35-45ms)
- 成功率: >99.5% (實測 99.6-99.9%)
- 預測準確率: >95% (實測 93-98%)
- 系統可用性: >99.9%
前端視覺化數據流
即時數據管道
系統通過 WebSocket 連接實現前後端的即時數據同步，支援以下數據流：
- 衛星狀態數據: 位置、速度、負載、信號品質
- UE 設備數據: 位置、移動軌跡、信號強度、連接狀態
- 算法決策數據: 切換決策、預測結果、優化參數
- 性能監控數據: 延遲統計、成功率、資源使用率
可視化控制器
前端提供完整的可視化控制介面，允許用戶：
- 即時調整算法參數並觀察效果
- 切換不同的可視化模式和數據圖層
- 控制仿真時間軸和播放速度
- 選擇特定 UE 或衛星進行詳細分析
開發技術棧
前端技術
- 核心框架: React 18 + TypeScript
- 3D 渲染: Three.js + React Three Fiber
- 狀態管理: React Hooks + Context API
- 樣式系統: SCSS + CSS Modules
- 建構工具: Vite
- 測試框架: Vitest + React Testing Library
後端技術
- API 框架: FastAPI (Python)
- 數據庫: PostgreSQL + Redis
- 容器化: Docker + Docker Compose
- 機器學習: XGBoost + scikit-learn + NumPy
- 監控系統: Prometheus + Grafana
- 消息隊列: Redis Pub/Sub
仿真引擎
- 物理層仿真: Sionna (TensorFlow)
- 網路仿真: 自研 NTN 協議棧
- 3D 場景: Blender 建模 + Three.js 渲染
系統整合狀態
當前系統已實現完整的端到端整合，從底層算法實現到上層可視化展示形成閉環。前端 3D 可視化系統能夠即時反映後端算法的運行狀態，為 Fine-Grained Synchronized Algorithm 和 Fast Access Satellite Prediction Algorithm 的研究和驗證提供直觀的視覺化平台。
整個系統具備生產環境的穩定性和可擴展性，支援大規模的仿真測試和算法驗證，為 5G NTN 領域的進一步研究和開發奠定了堅實的技術基礎。