SIGINT

Echtzeit-OSINT-Dashboard mit Live-Flugzeug-, Schiffs-, Erdbeben-, Feuer-, Wetter- und Ereignisverfolgung auf einer interaktiven Globus-Karte. Entwickelt mit Bun, React 19 und einer benutzerdefinierten Canvas 2D + Web Worker Rendering-Engine. Installierbar als PWA.

Screenshot

Inhaltsverzeichnis

• SIGINT
  • Screenshot
  • Inhaltsverzeichnis
  • Features
    • Live-Daten
    • Intelligence
    • Visualisierung
    • Plattform
  • Installation
  • Quick Start
  • Umgebungsvariablen
  • Datenquellen
  • Tests
  • Deployment
    • Entwicklung
    • Produktion
    • Produktion mit TLS
    • Heroku
    • Bereinigung
  • PWA
  • Dokumentation
  • Lizenz
  • Autor

Features

Live-Daten

• Flugzeugverfolgung (adsb.fi)
• AIS-Schiffsverfolgung (aisstream.io)
• Seismische Überwachung (USGS)
• Feuer-Hotspot-Erkennung (NASA FIRMS)
• Schwerwetterwarnungen (NOAA)
• GDELT-Ereignis-Intelligence
• RSS-Nachrichtenaggregation (6 Weltquellen)
• HLS-Videostreams (iptv-org)

Intelligence

• Korrelationsmaschine mit quellenübergreifenden Produkten und bewerteten Alarmen
• Klassifizierung von Militärflugzeugen
• Watch-Modus (automatische Globus-Tour)
• Entity-Dossier mit Fotos, Routen, Metadaten

Visualisierung

• Globus- und flache Kartenprojektionen
• Mehrfachbereichs-Layout mit Größenänderung, Minimierung, Voreinstellungen
• Kamera-Fixierung, Isolationsmodi, Punktewiedergabe
• Globale Suche mit Live-Globus-Filterung
• Virtuell scrollende Datentabelle
• Live-Ticker

Plattform

• Dunkle/helle Designs
• Mobil responsive mit separaten Layout-Voreinstellungen
• PWA mit Offline-Unterstützung, Update-Benachrichtigungen, Pull-to-Refresh
• Offline-Anzeige mit Konnektivitätserkennung
• Cookie-authentifizierte API (HMAC-SHA256, HttpOnly)

Installation

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

Erstellen Sie eine .env-Datei im Projektverzeichnis mit mindestens:

SIGINT_SERVER_SECRET=<Ausgabe von openssl rand -hex 32>

Fügen Sie optional Schlüssel für Schiffs- und Feuersdaten hinzu:

AISSTREAM_API_KEY=<Ihr aisstream.io-Schlüssel>
FIRMS_MAP_KEY=<Ihr NASA FIRMS-Schlüssel>

Quick Start

Siehe Deployment für Entwicklungs-, Produktions- und Heroku-Optionen.

Umgebungsvariablen

Datenquellen

Tests

bun test            # alle Tests ausführen
bun test --watch    # Watch-Modus
bun run docker:test # in Docker ausführen

Deployment

Entwicklung

bun run docker:dev:up          # https://localhost (selbstsigniertes Zertifikat)
bun run docker:dev:down        # stoppen

Nur für die Entwicklung: Fixture-Überschreibungen

Zwei Umgebungsvariablen umgehen Live-Datenabrufe in der Entwicklung, sodass Sie gegen einen bekannten eingefrorenen Zustand arbeiten können. Beide sind durch NODE_ENV !== "production"" geschützt und werden in Produktions-Builds ignoriert.

Labels entsprechen /^[a-z0-9-]+$/ (OWASP A01 – strenge Whitelist vor Datei-Lookup) und lösen auf tests/fixtures/<source>/<label>.json auf. Ungültige Labels werfen einen Fehler beim Start; fehlende Dateien werfen einen Fehler mit dem aufgelösten Pfad. Zur Verwendung:

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

Oder über Docker Compose (docker-compose.dev.yml übergibt beide weiter):

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

Produktion

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

Produktion mit TLS

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

Heroku

git push heroku main

Bereinigung

bun run docker:clean:all       # Container, Volumes, Images entfernen

PWA

SIGINT ist als Progressive Web App installierbar. Nach dem Besuch der bereitgestellten App:

• Desktop (Chrome/Edge): Klicken Sie auf das Installationssymbol in der Adressleiste
• iOS Safari: Teilen > Zum Home-Bildschirm hinzufügen
• Android Chrome: Menü > Zum Home-Bildschirm hinzufügen

Der Service Worker speichert die App-Shell für den Offline-Start zwischen. Live-Daten werden aus IndexedDB geladen, wenn offline. Eine Offline-Anzeigeleiste erscheint bei Verbindungsverlust, mit einer ERNEUT-VERSUCHEN-Schaltfläche und Pull-to-Refresh auf Touch-Geräten. Wenn ein Update verfügbar ist, fordert ein Banner den Benutzer zum Neuladen auf – keine stillen Codenachladungen während der Sitzung.

Dokumentation

Vollständige technische Dokumentation in docs/ mit Architektur, Datenfluss, Feature-System, Bereichssystem, Rendering, Caching, Suche und Einschränkungen.

Lizenz

Dual-Lizenz:

• Nicht-kommerziell kostenlos unter der SIGINT Non-Commercial License
• Kommerziell – Autor kontaktieren für Konditionen

Autor

Anthony Tropeano