Conjunction Alert Simulator (CAS)

衛星の TLE を入力すると、今後7日間に接近する宇宙デブリを検出し、3D で軌道と最接近点（TCA）を表示し、回避マニューバの効果を試算する Web アプリです。

v1.53.0（Phase 10AT） — purge 履歴表示 + preview CSV API + fleet 先頭へ。Phase 10AS purge ポーリング + preview CSV + fleet 最後へ。Phase 10AQ offset Enter + reload purge API + dry-run JSON row_errors。Phase 10AM reload 履歴 Redis + dry-run 折りたたみ + 艦隊名フィルタ。Phase 10AJ summary CSV + retention インポート + reload ポーリング。Phase 10AG 艦隊別 breach 履歴 retention + ルール apply + alertnames フィルタ。Phase 10AE breach gauge ルール + 履歴フィルタ。Phase 10AA breach 横断一覧 + 手動上書き。Phase 10T STM open 巻き戻し + Alertmanager silences API。Phase 10S risk_level 別 per-fleet Prometheus メトリクス + Alertmanager breach push。Phase 10R 6×6 アラート STM（escalated 状態、alert_stm_service 正本化、state-machine API）。Phase 10Q per-fleet Prometheus アラートメトリクス（FLEET_ALERT_METRICS_ENABLED、rule 雛形 API）。Phase 10P PagerDuty 双方向 webhook、Phase 10O PagerDuty lifecycle、Phase 10N fleet 別 API SLO、Phase 10M CDM TCA シフト、Phase 10L PagerDuty 通知、Phase 10K TLE RTN 共分散伝播、Phase 10J API SLO DB 永続化、Phase 10I Ops UI OIDC SSO、Phase 10H API 99.9% SLO、Phase 10G 自動対策計画、Phase 10F 自動 Δv スイープ、Phase 10E 自動 Pc 再計算、Phase 10D Pc 再計算、Phase 10C COLA スイープ、Phase 10B SLA metrics、Phase 10A COLA preview、Phase 9E API Key 認証、Phase 9D スケールアウト、Phase 9C アラート triage、Phase 9B 定期スクリーニング、Phase 9A 艦隊レジストリ、Phase 8 Space-Track CDM、Phase 6 Live Demo も含む OSS 作品です。

2 分デモ（ローカル）

git clone https://github.com/maouM-cmd/conjunction-alert-simulator.git
cd conjunction-alert-simulator
python -m venv venv
venv\Scripts\pip install -r requirements.txt
venv\Scripts\python -m uvicorn backend.app.main:app --host 127.0.0.1 --port 8000

1. ブラウザで http://127.0.0.1:8000/app/ を開く
2. デモ TLE 読込 → 高精度 Pc ON → 接近解析（閾値 50 km）
3. イベントを選択 → 3D 表示 → 回避試算

Docker 代替: docker compose up --build -d → http://localhost:8000/app/

Live Demo

https://conjunction-alert-simulator.onrender.com/app/ — Render Free tier（API 同一オリジン）。初回は cold start で 30〜60 秒かかることがあります（UI が /health 待機を表示）。起動後 デモ TLE 読込 → 高精度 Pc ON → 接近解析（閾値 50 km）。

再デプロイ手順: docs/deploy-render-phase6c.md | CI/CD: docs/deploy-render-cicd.md | URL 正本: docs/LIVE_DEMO_URL.md

方法	手順
Render（稼働中）	deploy-render-phase6c.md — render.yaml Blueprint
Fly.io	deploy-cloud.md — fly.toml

機能

• 自衛星 TLE 入力 → デブリ接近イベント一覧（閾値可変）
• 衝突確率 Pc — Foster 2D（一覧デフォルト）、opt-in で Alfriend encounter plane + TLE RTN 非等方共分散
• Webhook 通知 — 高リスクイベントを Webhook へ POST（generic / Slack Incoming Webhook / Slack Bot / SMTP メール）
• 高度帯プリフィルタ — UI/API で ON/OFF、候補デブリ件数メタ（Phase 7C）
• CDM RTN compare-alert — Space-Track detail から RTN σ 取得、sigma_source: cdm_covariance（Phase 7A）
• CDM σ on 一覧 — 手動 cdm_text または Space-Track CDM 自動適用（Phase 8A、要認証）
• CDM インポート — RTN 共分散の encounter plane 射影、外部 Pc vs CAS 3方式比較
• Space-Track CDM アラート — cdm_public 取得、一覧比較、CAS から CDM KVN エクスポート
• コンステレーション監視 — 最大 25 衛星の TLE 一括接近解析（ProcessPool 並列、Space-Track CDM 自動適用 対応）
• CesiumJS による 3D 軌道可視化・TCA マーカー・タイムスライダー
• prograde / retrograde / normal 方向の Δv 試算（Before/After）

技術スタック

• Backend: Python 3.12, FastAPI, SGP4
• Frontend: HTML + CesiumJS（ビルド不要）
• データ: CelesTrak（デフォルト）/ Space-Track（オプション）

Space-Track 連携（オプション）

1. Space-Track でアカウント作成
2. .env.example を .env にコピーして認証情報を設定

copy .env.example .env
# SPACE_TRACK_USER / SPACE_TRACK_PASSWORD を編集
# TLE_PROVIDER=spacetrack

未設定時は CelesTrak のみ使用。Space-Track 失敗時は CelesTrak に自動フォールバック。

セットアップ

cd C:\Users\admin\OneDrive\ドキュメント\conjunction-alert-simulator
python -m venv venv
venv\Scripts\pip install -r requirements.txt

起動

# API サーバ（プロジェクトルートから）
venv\Scripts\python -m uvicorn backend.app.main:app --reload --host 127.0.0.1 --port 8000

# 別ターミナルで静的フロント（任意）
cd frontend
python -m http.server 8080

ブラウザで http://127.0.0.1:8080 を開く（API は http://127.0.0.1:8000）。

FastAPI 経由でフロントも配信する場合は http://127.0.0.1:8000/app/ を開いてください。

Docker で起動（Phase 4C / 9A / 9D）

copy .env.example .env   # 任意（Space-Track 利用時は編集）
docker compose up --build -d
# worker 水平スケール（Phase 9D）:
docker compose up --build -d --scale worker=3

• UI: http://localhost:8000/app/
• ヘルス: curl http://localhost:8000/health
• メトリクス: curl http://localhost:8000/metrics
• Fleet API（Phase 9A）: compose 起動時 postgres + DATABASE_URL が自動設定。GET /api/v1/fleets で艦隊一覧（最大 10,000 衛星）。
• Screening（Phase 9B / 9D）: redis + worker + beat。51+ 衛星は 50 sat/chunk に自動分割。
• Ops（Phase 9C〜10C）: triage + 回避試算（Δv スイープ）+ 試算→対策計画 + Screening lag SLA

Scale-out 環境変数（Phase 9D）

env	デフォルト	用途
FLEET_MAX_SATELLITES	10000	艦隊 active 衛星上限
SCREENING_CHUNK_SIZE	50	1 Celery ジョブあたり衛星数
SCREENING_MAX_WORKERS	2	chunk 内 ProcessPool 数
CELERY_WORKER_CONCURRENCY	2	worker プロセス数

Production hardening（Phase 9E）

env	デフォルト	用途
CAS_API_KEY_REQUIRED	false	true で fleet/screening/ops を保護
CAS_ADMIN_API_KEY	(未設定)	艦隊作成・初回 API Key 発行
AUDIT_LOG_RETENTION_DAYS	90	監査ログ保持日数

詳細は docs/deploy.md、商用運用ロードマップは docs/requirements-commercial-ops.md を参照。

Webhook 通知（任意）

.env に以下を設定:

Incoming Webhook（Phase 5C）:

ALERT_WEBHOOK_URL=https://hooks.slack.com/services/XXX/YYY/ZZZ
ALERT_WEBHOOK_FORMAT=slack
ALERT_PC_THRESHOLD=0.00001

Slack Bot Token（Phase 7B） — ALERT_WEBHOOK_URL 不要:

ALERT_WEBHOOK_FORMAT=slack_bot
SLACK_BOT_TOKEN=xoxb-...
SLACK_CHANNEL_ID=C0123456789

SMTP メール（Phase 8B） — ALERT_WEBHOOK_URL 不要:

ALERT_WEBHOOK_FORMAT=smtp
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_FROM=cas@example.com
SMTP_TO=ops@example.com
SMTP_USER=cas@example.com
SMTP_PASSWORD=secret
SMTP_USE_TLS=true

Slack App 作成: api.slack.com → OAuth Scopes chat:write（公開チャンネルなら chat:write.public も可）→ ワークスペースにインストール → Bot User OAuth Token とチャンネル ID を .env に設定。

解析リクエストで notify_webhook: true を指定するか、UI の Webhook テスト / POST /api/v1/alerts/webhook/test で接続確認。/health の alert_delivery_format で配信モードを確認可能。batch 解析でも notify_webhook 対応（fleet 一括 POST）。

CLI（軌道伝播プロトタイプ）

venv\Scripts\python -m backend.cli.propagate --tle1 samples/iss.tle --tle2 samples/debris-sample.tle

API 概要

エンドポイント	メソッド	概要
/health	GET	死活監視
/metrics	GET	Prometheus メトリクス（Phase 9D）
/api/v1/conjunctions	POST	接近イベント検出
/api/v1/conjunctions/batch	POST	複数衛星一括接近解析
/api/v1/alerts/webhook/test	POST	Webhook 接続テスト
/api/v1/cdm/parse	POST	CDM テキスト解析
/api/v1/cdm/compare	POST	CDM vs CAS 比較
/api/v1/cdm/fetch	POST	Space-Track CDM アラート取得
/api/v1/cdm/compare-alert	POST	CDM アラート + TLE 自動比較
/api/v1/cdm/export	POST	接近イベント → CDM KVN
/api/v1/orbit	POST	軌道点列（3D 表示用）
/api/v1/maneuver/preview	POST	回避マニューバ試算

詳細は docs/api-design.md を参照。

ドキュメント

• 要件定義書 Phase 6A
• 要件定義書 Phase 6C
• 要件定義書 Phase 6B
• Render CI/CD Phase 6B
• Render デプロイ Phase 6C
• Live Demo URL
• GitHub Release 手順
• 要件定義書 Phase 6E
• 要件定義書 Phase 6F
• 要件定義書 Phase 6G
• 要件定義書 Phase 7
• Qiita 投稿手順
• GitHub Social Preview
• 要件定義書 Phase 1
• 要件定義書 Phase 2
• 要件定義書 Phase 3
• 要件定義書 Phase 3.5
• 要件定義書 Phase 4A
• 要件定義書 Phase 4A-Ext
• 要件定義書 Phase 4B
• 要件定義書 Phase 4B-Ext
• 要件定義書 Phase 4C
• 要件定義書 Phase 4D
• 要件定義書 Phase 5A
• 要件定義書 Phase 5B
• 要件定義書 Phase 5C
• 要件定義書 Phase 5D
• クラウドデプロイ
• Zenn 投稿手順
• GitHub About 設定
• 公開チェックリスト v1.1.0
• CHANGELOG
• デプロイ手順
• API 設計書
• アーキテクチャ

ライセンス

MIT License — 詳細は LICENSE

技術記事

Live Demo	conjunction-alert-simulator.onrender.com/app/
Zenn	Conjunction Alert Simulator を作った
Release	v1.44.0 — Phase 10AK
Social Preview	設定済み — 手順
Phase 7 要件	docs/requirements-phase7.md
公開チェックリスト	docs/publish-checklist-v1.1.0.md
GitHub About	docs/publish-github-about.md

デモ

初期画面
接近一覧（Advanced Pc）
3D 軌道
回避試算
CDM 比較

UI デモ: 「デモ TLE 読込」→ 高精度 Pc ON → 接近解析（閾値 50 km）→ イベント選択 → 3D 表示 → 試算実行

手順: docs/demo/README.md | 技術ブログ: docs/demo/blog-zenn.md | Zenn 投稿: docs/publish-zenn.md