Джерела даних і методологія

Джерела в кожному регіоні

Для кожного регіону в нас є ланцюжок джерел. Спершу ми звертаємося до основного джерела: сайту, API чи офіційного Telegram-каналу енергокомпанії, а для Києва й Дніпра — до YASNO, застосунку ДТЕК. Якщо основне джерело не відповідає або віддає порожні дані, беремо графік з резервного — відкритого агрегатора svitlo.live, який теж збирає дані з сайтів обленерго.

Зараз власне підключення до основного джерела є в 13 регіонах із 25. Для решти графік поки надходить лише через svitlo.live, і ми поступово це змінюємо. Яке джерело спрацювало для конкретного графіка, видно в рядку «Оновлено» на сторінці черги.

Ми не копіюємо зображень графіків, які публікують обленерго, і не використовуємо картинок бота. Шкалу дня, мапу й картки для поширення Вольт малює сам з даних про інтервали.

Як часто оновлюємо

Збирач даних обходить усі джерела кожні 1–3 хвилини. Після кожного обходу:

1. порівнюємо новий графік з попереднім. Якщо щось змінилося, записуємо нову версію і рахуємо, скільки разів графік на цей день уже змінювали;
2. оновлюємо дані для сайту і бота одночасно, тому сайт і бот завжди показують один і той самий графік;
3. сторінки регіонів, де змінився графік, оновлюються на сайті протягом кількох хвилин. Бот одразу надсилає сповіщення тим, хто підписаний на ці черги.

Час «Оновлено» на сторінці показує останню успішну перевірку джерела, а не час, коли змінився графік. Якщо обленерго не змінювало графік з ранку, а ми перевірили його дві хвилини тому, ви побачите свіжий час. Окремо в мапі сайту для пошукових систем ми вказуємо саме час останньої зміни графіка, а не час перевірки.

Свіжість і «застарілі дані»

Якщо ми не можемо отримати графік регіону довше ніж 10 хвилин (джерело недоступне, змінило формат, заблокувало запити), над графіком з'являється попередження: «Дані можуть бути застарілими». Графік ми не ховаємо — останній відомий графік часто ще правильний. Але в такий момент варто звіритися з офіційною сторінкою обленерго з таблиці вище.

Сайт розміщено окремо від збирача даних. Якщо наш сервер тимчасово недоступний, сайт продовжує показувати останні отримані графіки з позначкою часу, а не порожню сторінку.

Що означають стани

Світло є / Світла немає

Години за опублікованим графіком погодинних відключень (ГПВ). Якщо графік опубліковано і в ньому немає відключень для вашої черги, ми пишемо «Світло буде весь день».

Можливе відключення

Години, які джерело саме подає як можливі (наприклад, у ДТЕК є «можливі відключення» окремо від гарантованих). На шкалі вони смугасті. Ми не перетворюємо їх ні на «світло є», ні на «світла немає».

Графік ще не опублікували

Обленерго ще не оприлюднило графік на цей день. Зазвичай графік на завтра з'являється ввечері. Ми не малюємо порожній день як день зі світлом.

Аварійні відключення

Якщо в регіоні діють аварійні відключення (ГАВ, СГАВ), над графіком з'являється червоний банер. Плановий графік лишається видимим, але може не виконуватися. Більше про це — у статті «Що таке ГПВ, ГАВ і СГАВ».

Немає даних

Джерело не віддало графік на цей день. Шкала сіра й пунктирна.

Змінено вручну

Зрідка, коли обленерго публікує графік лише картинкою чи текстом, який ми не можемо надійно розібрати, графік вносить редактор. Такі графіки ми теж позначаємо.

Час і перехід на зимовий час

Усі години на Вольті — київський час. Зсув між літнім і зимовим часом ми рахуємо автоматично. У ніч на 25 жовтня 2026 року годинник переводять з 04:00 на 03:00, тож ця доба триває 25 годин. Тривалість відключень і зворотний відлік рахуються за реальним часом, а не за кількістю годин на циферблаті. Відключення 02:00–05:00 у цю ніч триває чотири години, а не три.

Відключення через північ (наприклад, 22:00–02:00) показуємо як одне відключення, а не як два окремі.

Пошук за адресою

Черги за адресами ми беремо з відкритих довідників і сервісів обленерго та ДТЕК. Кожна відповідь має позначку довіри:

• Офіційні дані — номер черги віддав сервіс енергокомпанії;
• За документом — номер узято з опублікованого переліку адрес (часто PDF). Позначаємо «орієнтовно»;
• Від користувачів — кілька людей підтвердили чергу для адреси. Найнижчий рівень довіри; такі відповіді з'являться пізніше.

Біля відповіді також є дата перевірки. Переліки адрес обленерго переглядають приблизно раз на пів року (чинний період — з 1 жовтня 2026 до 1 квітня 2027), і після кожної зміни ми оновлюємо дані. Номерів особових рахунків ми не зберігаємо і не записуємо в журнали.

Пошук будинку зараз працює в Києві, Дніпрі, на Львівщині, Буковині, Тернопільщині, Закарпатті та Миколаївщині — там енергокомпанії мають відкриті адресні сервіси. В інших регіонах ми даємо посилання на офіційний сервіс і пропонуємо обрати чергу вручну. Капч і захисту від ботів на сайтах енергокомпаній ми не обходимо, тому, наприклад, на Київщині та Донеччині пошук з'явиться лише тоді, коли знайдеться відкрите джерело.

Помилки і виправлення

Ми стежимо автоматично, чи відповідає кожне джерело і чи не змінився його формат. Але помилки трапляються. Найчастіше — через те, що обленерго змінило графік у джерелі, якого ми не читаємо, наприклад лише на картинці.

Якщо графік на Вольті не збігається з офіційним, напишіть нам у Telegram (контакти). Додайте регіон, чергу, дату і посилання на офіційний графік. Ми виправимо дані й розберемося, чому так сталося.