SIGINT

インタラクティブな地球儀上で航空機、船舶、地震、火災、天気、イベントをリアルタイム追跡するOSINTダッシュボード。Bun、React 19、カスタムCanvas 2D + Web Workerレンダリングエンジンで構築。PWAとしてインストール可能。

スクリーンショット

目次

• SIGINT
  • スクリーンショット
  • 目次
  • 機能
    • ライブデータ
    • インテリジェンス
    • ビジュアライゼーション
    • プラットフォーム
  • インストール
  • クイックスタート
  • 環境変数
  • データソース
  • テスト
  • デプロイメント
    • 開発
    • 本番
    • TLS対応本番
    • Heroku
    • クリーンアップ
  • PWA
  • ドキュメント
  • ライセンス
  • 作者

機能

ライブデータ

• 航空機追跡（adsb.fi）
• AIS船舶追跡（aisstream.io）
• 地震モニタリング（USGS）
• 火災ホットスポット検出（NASA FIRMS）
• 悪天候アラート（NOAA）
• GDELTイベントインテリジェンス
• RSSニュース集約（世界6ソース）
• HLSビデオフィード（iptv-org）

インテリジェンス

• クロスソースプロダクトとスコア付きアラートを備えた相関エンジン
• 軍用機の分類
• ウォッチモード（地球儀の自動ツアー）
• 写真、航路、メタデータ付きエンティティ台帳

ビジュアライゼーション

• 地球儀および平面地図投影
• ドラッグ、最小化、プリセット対応のマルチペイン・リサイズ可能レイアウト
• カメラロックオン、分離モード、軌跡レンダリング
• ライブ地球儀フィルタリング付きグローバル検索
• 仮想スクロール対応データテーブル
• ライブティッカーフィード

プラットフォーム

• ダーク/ライトテーマ
• 専用レイアウトプリセットによるモバイルレスポンシブ対応
• オフラインサポート、更新通知、プル・トゥ・リフレッシュ対応のPWA
• 接続検出付きオフラインインジケーター
• Cookie認証API（HMAC-SHA256、HttpOnly）

インストール

git clone https://github.com/iitoneloc/sigint.git
cd sigint
bun install

プロジェクトルートに.envファイルを最低限以下の内容で作成します：

SIGINT_SERVER_SECRET=<output of openssl rand -hex 32>

船舶・火災データ用のキーを任意で追加します：

AISSTREAM_API_KEY=<your aisstream.io key>
FIRMS_MAP_KEY=<your NASA FIRMS key>

クイックスタート

開発、本番、Herokuの各オプションについてはデプロイメントを参照してください。

環境変数

データソース

テスト

bun test            # run all tests
bun test --watch    # watch mode
bun run docker:test # run in Docker

デプロイメント

開発

bun run docker:dev:up          # https://localhost (self-signed cert)
bun run docker:dev:down        # stop

開発専用フィクスチャの上書き

開発中にライブデータ取得をショートサーキットする2つの環境変数で、既知の固定状態に対して作業できます。どちらもNODE_ENV !== "production"でゲートされ、本番ビルドでは無視されます。

ラベルは/^[a-z0-9-]+$/に一致し（OWASP A01 — ファイル参照前の厳格な許可リスト）、tests/fixtures/<source>/<label>.jsonに解決されます。無効なラベルは起動時に例外をスローし、ファイルが存在しない場合は解決されたパスとともに例外をスローします。使用例：

CYCLONES_FIXTURE=multi-storm bun run dev
AIRCRAFT_FIXTURE=conus-snapshot bun run dev

またはDocker Compose経由（docker-compose.dev.ymlが両方をそのまま渡します）：

CYCLONES_FIXTURE=single-cat5 bun run docker:dev:up

本番

bun run docker:prod:up         # http://localhost:5500
bun run docker:prod:down       # stop

TLS対応本番

DOMAIN=sigint.example.com bun run docker:prod:tls:up
bun run docker:prod:tls:down   # stop

Heroku

git push heroku main

クリーンアップ

bun run docker:clean:all       # remove containers, volumes, images

PWA

SIGINTはプログレッシブWebアプリ（PWA）としてインストールできます。デプロイ済みアプリを訪問した後：

• デスクトップ（Chrome/Edge）：アドレスバーのインストールアイコンをクリック
• iOS Safari：共有 > ホーム画面に追加
• Android Chrome：メニュー > ホーム画面に追加

サービスワーカーはオフラインブート用にアプリシェルをキャッシュします。オフライン時にはライブデータをIndexedDBから読み込みます。接続が失われるとオフラインインジケーターバーが表示され、タッチデバイスではRETRYボタンとプル・トゥ・リフレッシュが利用できます。アップデートが利用可能な場合、バナーがリロードを促します — セッション中のサイレントなコード差し替えはありません。

ドキュメント

アーキテクチャ、データフロー、機能システム、ペインシステム、レンダリング、キャッシング、検索、制約事項を網羅した完全な技術ドキュメントはdocs/にあります。

ライセンス

デュアルライセンス：

• 非商用はSIGINT非商用ライセンスの下で無料
• 商用は条件について作者に連絡

作者

Anthony Tropeano