SIGINT

Dashboard OSINT in tempo reale con tracciamento live di aeromobili, imbarcazioni, attività sismica, incendi, meteo ed eventi su un globo interattivo. Realizzato con Bun, React 19 e un motore di rendering personalizzato Canvas 2D + Web Worker. Installabile come PWA.

Screenshot

Indice dei contenuti

• SIGINT
  • Screenshot
  • Indice dei contenuti
  • Caratteristiche
    • Dati live
    • Intelligence
    • Visualizzazione
    • Piattaforma
  • Installazione
  • Avvio rapido
  • Variabili d'ambiente
  • Fonti dati
  • Test
  • Distribuzione
    • Sviluppo
    • Produzione
    • Produzione con TLS
    • Heroku
    • Pulizia
  • PWA
  • Documentazione
  • Licenza
  • Autore

Caratteristiche

Dati live

• Tracciamento aeromobili (adsb.fi)
• Tracciamento imbarcazioni AIS (aisstream.io)
• Monitoraggio sismico (USGS)
• Rilevamento hotspot incendi (NASA FIRMS)
• Allerte meteo severe (NOAA)
• Intelligence eventi GDELT
• Aggregazione notizie RSS (6 fonti mondiali)
• Feed video HLS (iptv-org)

Intelligence

• Motore di correlazione con prodotti cross-source e avvisi con punteggio
• Classificazione degli aeromobili militari
• Modalità Watch (tour automatico del globo)
• Dossier delle entità con foto, rotte e metadati

Visualizzazione

• Proiezioni a globo e mappa piatta
• Layout multi-pannello ridimensionabile con trascinamento, minimizzazione e preset
• Blocco della camera, modalità di isolamento, rendering delle scie
• Ricerca globale con filtro live sul globo
• Tabella dati a scorrimento virtuale
• Feed ticker live

Piattaforma

• Temi scuro/chiaro
• Responsive per mobile con preset di layout separati
• PWA con supporto offline, notifiche di aggiornamento e pull-to-refresh
• Indicatore offline con rilevamento della connettività
• API autenticata tramite cookie (HMAC-SHA256, HttpOnly)

Installazione

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

Crea un file .env nella root del progetto contenente come minimo:

SIGINT_SERVER_SECRET=<output of openssl rand -hex 32>

Aggiungi opzionalmente le chiavi per i dati di imbarcazioni e incendi:

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

Avvio rapido

Consulta Distribuzione per le opzioni di sviluppo, produzione ed Heroku.

Variabili d'ambiente

Fonti dati

Test

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

Distribuzione

Sviluppo

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

Override delle fixture solo per lo sviluppo

Due variabili d'ambiente bypassano i fetch dei dati live in sviluppo, così puoi lavorare su uno stato congelato noto. Entrambe sono condizionate a NODE_ENV !== "production" e ignorate nelle build di produzione.

Le etichette corrispondono a /^[a-z0-9-]+$/ (OWASP A01 — allowlist rigorosa prima di qualsiasi accesso ai file) e si risolvono in tests/fixtures/<source>/<label>.json. Le etichette non valide sollevano un'eccezione all'avvio; i file mancanti sollevano un'eccezione con il percorso risolto. Per usarle:

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

Oppure tramite Docker Compose (docker-compose.dev.yml le passa entrambe):

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

Produzione

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

Produzione con TLS

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

Heroku

git push heroku main

Pulizia

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

PWA

SIGINT è installabile come Progressive Web App. Dopo aver visitato l'app distribuita:

• Desktop (Chrome/Edge): Fai clic sull'icona di installazione nella barra degli indirizzi
• iOS Safari: Condividi > Aggiungi alla schermata Home
• Android Chrome: Menu > Aggiungi alla schermata Home

Il service worker mette in cache la shell dell'app per l'avvio offline. I dati live vengono caricati da IndexedDB quando si è offline. Quando si perde la connettività, appare una barra indicatrice dello stato offline con un pulsante RETRY e pull-to-refresh sui dispositivi touch. Quando è disponibile un aggiornamento, un banner invita l'utente a ricaricare — nessuno scambio di codice silenzioso a metà sessione.

Documentazione

Documentazione tecnica completa in docs/ che copre architettura, flusso di dati, sistema delle feature, sistema dei pannelli, rendering, caching, ricerca e vincoli.

Licenza

Doppia licenza:

• Non commerciale gratuita secondo la SIGINT Non-Commercial License
• Commerciale contatta l'autore per i termini

Autore

Anthony Tropeano