SIGINT

Panel de OSINT en tiempo real con seguimiento en vivo de aeronaves, embarcaciones, actividad sísmica, incendios, clima y eventos en un globo interactivo. Construido con Bun, React 19 y un motor de renderizado personalizado en Canvas 2D + Web Worker. Instalable como PWA.

Captura de pantalla

Tabla de contenidos

• SIGINT
  • Captura de pantalla
  • Tabla de contenidos
  • Características
    • Datos en vivo
    • Inteligencia
    • Visualización
    • Plataforma
  • Instalación
  • Inicio rápido
  • Variables de entorno
  • Fuentes de datos
  • Pruebas
  • Despliegue
    • Desarrollo
    • Producción
    • Producción con TLS
    • Heroku
    • Limpieza
  • PWA
  • Documentación
  • Licencia
  • Autor

Características

Datos en vivo

• Seguimiento de aeronaves (adsb.fi)
• Seguimiento de embarcaciones AIS (aisstream.io)
• Monitoreo sísmico (USGS)
• Detección de focos de calor (NASA FIRMS)
• Alertas meteorológicas severas (NOAA)
• Inteligencia de eventos GDELT
• Agregación de noticias RSS (6 fuentes mundiales)
• Transmisiones de video HLS (iptv-org)

Inteligencia

• Motor de correlación con productos entre fuentes y alertas con puntuación
• Clasificación de aeronaves militares
• Modo vigilancia (recorrido automático del globo)
• Dossier de entidades con fotos, rutas y metadatos

Visualización

• Proyecciones de globo y mapa plano
• Diseño multipanel redimensionable con arrastre, minimización y ajustes preestablecidos
• Bloqueo de cámara, modos de aislamiento y renderizado de estelas
• Búsqueda global con filtrado en vivo del globo
• Tabla de datos con desplazamiento virtual
• Fuente de ticker en vivo

Plataforma

• Temas claro/oscuro
• Adaptable a móviles con ajustes de diseño independientes
• PWA con soporte sin conexión, notificaciones de actualización y deslizar para actualizar
• Indicador sin conexión con detección de conectividad
• API autenticada por cookies (HMAC-SHA256, HttpOnly)

Instalación

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

Crea un archivo .env en la raíz del proyecto que contenga como mínimo:

SIGINT_SERVER_SECRET=<output of openssl rand -hex 32>

Opcionalmente, añade claves para los datos de embarcaciones e incendios:

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

Inicio rápido

Consulta Despliegue para las opciones de desarrollo, producción y Heroku.

Variables de entorno

Variable	Requerida	Descripción
SIGINT_SERVER_SECRET	Sí	Clave de firma de tokens de autenticación. openssl rand -hex 32
AISSTREAM_API_KEY	No	Clave de aisstream.io para datos de embarcaciones en vivo
FIRMS_MAP_KEY	No	Clave de NASA FIRMS para datos de incendios
DOMAIN	No	Dominio para TLS de Let's Encrypt
PORT	No	Puerto del servidor (predeterminado: 5500)

Fuentes de datos

Capa	Fuente	Intervalo
Aeronaves	adsb.fi (barrido de teselas del lado del servidor, 37 teselas × 250 nm)	240s
Embarcaciones	aisstream.io (WebSocket del servidor)	300s
Sismos	USGS (del lado del cliente)	420s
Incendios	NASA FIRMS (del lado del servidor)	600s
Clima	NOAA (del lado del cliente)	300s
Eventos	GDELT 2.0 (del lado del servidor)	15m
Noticias	6 fuentes RSS (del lado del servidor)	10m

Pruebas

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

Despliegue

Desarrollo

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

Anulaciones de fixtures solo para desarrollo

Dos variables de entorno evitan las descargas de datos en vivo en desarrollo para que puedas trabajar con un estado congelado conocido. Ambas están condicionadas a NODE_ENV !== "production" y se ignoran en las compilaciones de producción.

Variable de entorno	Fuente anulada	Etiquetas válidas
CYCLONES_FIXTURE	/api/cyclones/latest (el servidor consulta NHC)	single-cat3, single-cat5, multi-storm, subtropical-example, tropical-depression, empty-out-of-season
AIRCRAFT_FIXTURE	/api/aircraft/states (el servidor consulta el barrido de teselas de adsb.fi)	(ninguna incluida — captúrala mediante bun run scripts/capture-fixture.ts aircraft <label>)

Las etiquetas deben coincidir con /^[a-z0-9-]+$/ (OWASP A01 — lista de permisos estricta antes de cualquier búsqueda de archivos) y se resuelven en tests/fixtures/<source>/<label>.json. Las etiquetas no válidas generan un error al iniciar; los archivos faltantes generan un error con la ruta resuelta. Para usarlas:

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

O mediante Docker Compose (docker-compose.dev.yml las transmite ambas):

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

Producción

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

Producción con TLS

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

Heroku

git push heroku main

Limpieza

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

PWA

SIGINT es instalable como una aplicación web progresiva (PWA). Tras visitar la aplicación desplegada:

• Escritorio (Chrome/Edge): Haz clic en el icono de instalación de la barra de direcciones
• iOS Safari: Compartir > Añadir a pantalla de inicio
• Android Chrome: Menú > Añadir a pantalla de inicio