Baskerville42 / outage-data-ua

outage-data-ua Публічне сховище та інструменти для автоматичного збирання, парсингу, візуалізації (HTML) і автоматичної генерації PNG‑зображень графіків планових/аварійних відключень електроенергії в Україні. Проєкт отримує дані з відкритих вебсторінок постачальників та зберігає їх у JSON «як є» у директорії . Далі ці дані відображаються у фіксованому шаблоні HTML і конвертуються у PNG‑зображення, які зберігаються у . --- Формат даних Кожен регіон зберігається у файлі . Базова структура (скорочено): • — планові відключення на тиждень для кожної групи (тижневий шаблон). Зберігається «як є», без нормалізації структури. • — фактичні/аварійні відключення на сьогодні та завтра для кожної групи. Також зберігається «як є». • Кожен із об’єктів ( і ) містить поле та — дата й час, на які інформація актуальна (значення з джерела; парсер не змінює формат, зазвичай у часовій зоні Europe/Kyiv). • Блок мінімальний: тільки та (хеш вмісту + ). • У разі помилки парсингу парсер оновлює лише (наприклад, , код 422), не стираючи попередні / . • Актуальний шаблон структури — у файлі . Детальні приклади полів і — у поточних JSON у . --- Зображення • Згенеровані PNG зображення зберігаються у директоріях . • Формат назв файлів: , наприклад: відповідає групі . • У репозиторії присутні актуальні зображення для доступних регіонів; вони оновлюються разом із даними. --- Обмеження та антибот • У CI тепер використовується безголовий браузер (Playwright, Chromium), який виконує JS і встановлює cookies — це допомагає коректно проходити антибот‑перевірки та отримувати «справжній» HTML. • Якщо замість сторінки приходить WAF‑HTML, парсер виставляє код помилки (напр., 422) і зберігає наявні дані. --- Ліцензія та юридичні застереження • Дані збираються з публічно доступних джерел. Дотримуйтеся умов використання сайтів. • Репозиторій не претендує на право власності на первинні дані; див. LICENSE (MIT).