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

Fuentes de datos

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.

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

El service worker almacena en caché el app shell para el arranque sin conexión. Los datos en vivo se cargan desde IndexedDB cuando no hay conexión. Cuando se pierde la conectividad, aparece una barra indicadora sin conexión con un botón REINTENTAR y deslizar para actualizar en dispositivos táctiles. Cuando hay una actualización disponible, un banner le pide al usuario que recargue — no hay intercambios de código silenciosos a mitad de sesión.

Documentación

Documentación técnica completa en docs/ que cubre arquitectura, flujo de datos, sistema de funcionalidades, sistema de paneles, renderizado, almacenamiento en caché, búsqueda y limitaciones.

Licencia

Licencia dual:

• No comercial: gratuita bajo la Licencia No Comercial de SIGINT
• Comercial: contacta con el autor para conocer los términos

Autor

Anthony Tropeano