SIGINT

Панель мониторинга OSINT в реальном времени с отслеживанием самолётов, судов, сейсмической активности, пожаров, погоды и событий на интерактивном глобусе. Создана с помощью Bun, React 19 и собственного движка рендеринга на Canvas 2D + Web Worker. Устанавливается как PWA.

Скриншот

Содержание

• SIGINT
  • Скриншот
  • Содержание
  • Возможности
    • Живые данные
    • Аналитика
    • Визуализация
    • Платформа
  • Установка
  • Быстрый старт
  • Переменные окружения
  • Источники данных
  • Тестирование
  • Развёртывание
    • Разработка
    • Продакшн
    • Продакшн с TLS
    • Heroku
    • Очистка
  • PWA
  • Документация
  • Лицензия
  • Автор

Возможности

Живые данные

• Отслеживание самолётов (adsb.fi)
• Отслеживание судов AIS (aisstream.io)
• Сейсмический мониторинг (USGS)
• Обнаружение очагов пожаров (NASA FIRMS)
• Предупреждения об опасных погодных явлениях (NOAA)
• Событийная аналитика GDELT
• Агрегация RSS-новостей (6 мировых источников)
• Видеопотоки HLS (iptv-org)

Аналитика

• Движок корреляции с кросс-источниковыми продуктами и ранжированными оповещениями
• Классификация военных самолётов
• Режим наблюдения (автоматический облёт глобуса)
• Досье на объекты с фотографиями, маршрутами и метаданными

Визуализация

• Глобус и плоские проекции карты
• Многопанельный изменяемый макет с перетаскиванием, сворачиванием и пресетами
• Фиксация камеры на объекте, режимы изоляции, отрисовка следов
• Глобальный поиск с живой фильтрацией на глобусе
• Таблица данных с виртуальной прокруткой
• Живая бегущая лента

Платформа

• Тёмная/светлая темы
• Адаптивность для мобильных устройств с отдельными пресетами макета
• PWA с поддержкой офлайн-режима, уведомлениями об обновлениях и pull-to-refresh
• Индикатор офлайн-режима с определением подключения
• API с аутентификацией через cookie (HMAC-SHA256, HttpOnly)

Установка

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

Создайте файл .env в корне проекта, содержащий как минимум:

SIGINT_SERVER_SECRET=<output of openssl rand -hex 32>

При желании добавьте ключи для данных о судах и пожарах:

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

Быстрый старт

Варианты для разработки, продакшна и Heroku см. в разделе Развёртывание.

Переменные окружения

Источники данных

Тестирование

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

Развёртывание

Разработка

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

Переопределения фикстур только для разработки

Две переменные окружения отключают получение живых данных в процессе разработки, чтобы вы могли работать с известным фиксированным состоянием. Обе активируются только при NODE_ENV !== "production" и игнорируются в продакшн-сборках.

Метки должны соответствовать /^[a-z0-9-]+$/ (OWASP A01 — строгий список разрешённых значений перед любым обращением к файловой системе) и разрешаться в tests/fixtures/<source>/<label>.json. Недопустимые метки вызывают ошибку при запуске; отсутствующие файлы — ошибку с указанием соответствующего пути. Для использования:

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

Или через Docker Compose (docker-compose.dev.yml передаёт обе переменные):

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

Продакшн

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

Продакшн с TLS

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

Heroku

git push heroku main

Очистка

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

PWA

SIGINT можно установить как прогрессивное веб-приложение (PWA). После посещения развёрнутого приложения:

• Десктоп (Chrome/Edge): нажмите значок установки в адресной строке
• iOS Safari: «Поделиться» > «На экран "Домой"»
• Android Chrome: «Меню» > «На экран "Домой"»

Сервисный воркер кэширует оболочку приложения для запуска в офлайн-режиме. В офлайн-режиме живые данные загружаются из IndexedDB. При потере соединения появляется панель-индикатор офлайн-режима с кнопкой RETRY и pull-to-refresh на сенсорных устройствах. Когда доступно обновление, баннер предлагает пользователю перезагрузиться — код не подменяется незаметно во время сеанса.

Документация

Полная техническая документация — в docs/. Она охватывает архитектуру, потоки данных, систему функций, систему панелей, рендеринг, кэширование, поиск и ограничения.

Лицензия

Двойное лицензирование:

• Некоммерческое — бесплатно по некоммерческой лицензии SIGINT
• Коммерческое — свяжитесь с автором для получения условий

Автор

Anthony Tropeano