SIGINT

Painel OSINT em tempo real com rastreamento ao vivo de aeronaves, embarcações, atividade sísmica, incêndios, clima e eventos em um globo interativo. Construído com Bun, React 19 e um mecanismo de renderização personalizado em Canvas 2D + Web Worker. Instalável como PWA.

Captura de tela

Índice

• SIGINT
  • Captura de tela
  • Índice
  • Recursos
    • Dados ao Vivo
    • Inteligência
    • Visualização
    • Plataforma
  • Instalação
  • Início Rápido
  • Variáveis de Ambiente
  • Fontes de Dados
  • Testes
  • Implantação
    • Desenvolvimento
    • Produção
    • Produção com TLS
    • Heroku
    • Limpeza
  • PWA
  • Documentação
  • Licença
  • Autor

Recursos

Dados ao Vivo

• Rastreamento de aeronaves (adsb.fi)
• Rastreamento de embarcações AIS (aisstream.io)
• Monitoramento sísmico (USGS)
• Detecção de focos de incêndio (NASA FIRMS)
• Alertas de clima severo (NOAA)
• Inteligência de eventos GDELT
• Agregação de notícias RSS (6 fontes mundiais)
• Feeds de vídeo HLS (iptv-org)

Inteligência

• Mecanismo de correlação com produtos entre fontes e alertas pontuados
• Classificação de aeronaves militares
• Modo de observação (tour automatizado pelo globo)
• Dossiê de entidades com fotos, rotas e metadados

Visualização

• Projeções de globo e mapa plano
• Layout multipainel redimensionável com arrastar, minimizar e predefinições
• Travamento de câmera, modos de isolamento e renderização de rastros
• Busca global com filtragem ao vivo no globo
• Tabela de dados com rolagem virtual
• Feed de ticker ao vivo

Plataforma

• Temas claro/escuro
• Responsivo para dispositivos móveis com predefinições de layout separadas
• PWA com suporte off-line, notificações de atualização e puxar para atualizar
• Indicador off-line com detecção de conectividade
• API autenticada por cookie (HMAC-SHA256, HttpOnly)

Instalação

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

Crie um arquivo .env na raiz do projeto com, no mínimo:

SIGINT_SERVER_SECRET=<output of openssl rand -hex 32>

Opcionalmente, adicione chaves para dados de embarcações e incêndios:

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

Início Rápido

Consulte Implantação para opções de desenvolvimento, produção e Heroku.

Variáveis de Ambiente

Fontes de Dados

Testes

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

Implantação

Desenvolvimento

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

Substituições de fixtures somente para desenvolvimento

Duas variáveis de ambiente contornam as buscas de dados ao vivo em desenvolvimento para que você possa trabalhar com um estado congelado conhecido. Ambas são condicionadas a NODE_ENV !== "production" e ignoradas em builds de produção.

Os rótulos correspondem a /^[a-z0-9-]+$/ (OWASP A01 — allowlist rigorosa antes de qualquer consulta a arquivos) e resolvem para tests/fixtures/<source>/<label>.json. Rótulos inválidos geram erro na inicialização; arquivos ausentes geram erro com o caminho resolvido. Para usar:

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

Ou via Docker Compose (docker-compose.dev.yml repassa ambas):

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

Produção

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

Produção com TLS

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

Heroku

git push heroku main

Limpeza

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

PWA

O SIGINT é instalável como um Progressive Web App. Após visitar o aplicativo implantado:

• Desktop (Chrome/Edge): Clique no ícone de instalação na barra de endereços
• iOS Safari: Compartilhar > Adicionar à Tela de Início
• Android Chrome: Menu > Adicionar à Tela de Início

O service worker armazena em cache o shell do aplicativo para inicialização off-line. Os dados ao vivo são carregados do IndexedDB quando off-line. Uma barra indicadora de off-line aparece quando a conectividade é perdida, com um botão RETRY e puxar para atualizar em dispositivos com tela de toque. Quando há uma atualização disponível, um banner solicita que o usuário recarregue — sem trocas silenciosas de código no meio da sessão.

Documentação

Documentação técnica completa em docs/ cobrindo arquitetura, fluxo de dados, sistema de recursos, sistema de painéis, renderização, cache, busca e restrições.

Licença

Licenciamento duplo:

• Não comercial gratuito sob a Licença Não Comercial do SIGINT
• Comercial entre em contato com o autor para os termos

Autor

Anthony Tropeano