Як працює карта шахедів NEPTUN — від Telegram до карти за 5 секунд
Коли ви бачите на карті шахедів NEPTUN траєкторію дрона, що рухається з Херсонщини на Миколаївщину — за цим стоїть складний технічний процес, який займає лише 5 секунд від появи повідомлення в Telegram до відображення на вашому екрані.
Етап 1: Збір даних з Telegram
NEPTUN моніторить десятки офіційних Telegram-каналів у реальному часі. Це канали Обласних Військових Адміністрацій (ОВА) всіх 25 регіонів України, канал Повітряних сил ЗСУ та інші верифіковані джерела.
Коли ОВА публікує повідомлення на кшталт “Увага! Шахеди зі сходу, курс на захід. Миколаївська область” — наш worker-процес миттєво отримує це повідомлення та передає його на обробку.
Етап 2: ШІ-аналіз повідомлення
Кожне повідомлення проходить через модуль штучного інтелекту, який виконує кілька задач одночасно:
- Класифікація загрози — визначає тип: шахед, крилата ракета, балістична ракета, КАБ або розвідувальний БПЛА
- Виділення регіону — визначає, яка область згадується в повідомленні
- Геокодування — перетворює текстовий опис місцеположення (наприклад, “на захід від Миколаєва”) у географічні координати
- Визначення напрямку — аналізує курс руху загрози (північ, захід тощо)
Етап 3: Побудова траєкторій
Це найцікавіша частина. Модуль траєкторного аналізу отримує послідовність повідомлень про один і той самий об’єкт з різних регіонів і будує прогнозовану траєкторію руху.
Наприклад, якщо шахед зафіксований спочатку в Херсонській, потім у Миколаївській, а потім в Одеській області — система будує вектор руху та прогнозує, куди він рухається далі. Це дозволяє користувачам заздалегідь отримати попередження.
💡 Траєкторії на карті — це не точні координати GPS, а прогноз на основі послідовності повідомлень ОВА. Використовуйте їх як додатковий інструмент оцінки обстановки.
Етап 4: Оновлення карти в реальному часі
Оброблені дані надсилаються на сервер через Redis і миттєво транслюються всім підключеним користувачам через технологію SSE (Server-Sent Events). Це означає, що вам не потрібно оновлювати сторінку — карта оновлюється автоматично кожні 5 секунд.
Для мобільного додатку одночасно надсилається push-сповіщення через Firebase Cloud Messaging, яке приходить навіть коли додаток закритий.
Етап 5: Статус тривоги
Паралельно з відстеженням шахедів, NEPTUN отримує офіційний статус повітряної тривоги по всіх 25 областях через API ukrainealarm.com. Ці дані оновлюються кожні 10 секунд та відображаються на карті кольорами: червоний — тривога активна, зелений — відбій.
Архітектура системи
Telegram-канали ОВА
↓ (миттєво)
Python Worker — збір повідомлень
↓ (ШІ-аналіз, ~1с)
Класифікація + Геокодування + Траєкторії
↓ (Redis pub/sub)
Next.js сервер → SSE до браузера
↓ (5 секунд)
Карта на вашому екрані 🗺️
Надійність та масштабування
NEPTUN працює на кластері з 4 серверних процесів за nginx-балансувальником. Це забезпечує стабільну роботу навіть під час масованих атак, коли тисячі користувачів одночасно перевіряють карту. Середній uptime — 99.5%+.
Підсумок
Карта шахедів NEPTUN — це не просто картинка. Це складна система збору, аналізу та візуалізації даних, яка працює 24/7 і допомагає мільйонам українців бути в курсі повітряної обстановки. Спробуйте карту тривог прямо зараз.