📊 Light Monitor Kyiv (v1.2.1)

Інтелектуальна аналітика електромережі для вашої HomeLab.

Important

СТАТУС ПРОЕКТУ: Активну роботу цього проекту на бойовому сервері ЗУПИНЕНО. Весь функціонал перенесено та вдосконалено в межах нового проекту flash-monitor-kyiv. Код залишається повністю відкритим — ви можете вільно завантажувати, форкати та використовувати його у своїх цілях.

---

🔍 Огляд

Light Monitor Kyiv — це спеціалізований інструмент для глибокого аналізу стабільності електромережі. На відміну від простих сповіщувачів, ця система зосереджена на порівнянні реальних подій з офіційними графіками та генерації детальної інфографіки.

Проект ідеально підходить для розгортання на малопотужному обладнанні (Raspberry Pi, старі ноутбуки, VPS), оскільки написаний на чистому Python з мінімальними залежностями.

---

🚀 Основні можливості

• 📊 Аналітика «План vs Факт»: Автоматичне виявлення відхилень від офіційних графіків ДТЕК/Yasno.
• ⏱️ Хірургічна точність: Фіксація подій з точністю до секунди та розрахунок часу «запізнення» або «раннього ввімкнення».
• 📈 Візуалізація: Генерація денних та тижневих звітів у Dark Mode для Telegram та Web.
• 📱 Web Dashboard: Легка веб-панель для моніторингу статусу в реальному часі.

---

🏗 Як це працює

Система складається із сервера (цей проект) та зовнішніх сенсорів.

graph LR
    subgraph Sensors ["📡 СЕНСОРИ (Зовнішні)"]
        Router["🏠 <b>Роутер / ESP32</b><br/>(Надсилає Heartbeat)"]
    end

    subgraph Core ["🧠 ЯДРО (Bare-Metal)"]
        API["🧪 <b>Python Server</b><br/>(Слухає запити)"]
        Parser["🕷️ <b>Analyzer</b><br/>(Парсить графіки)"]
        Viz["🎨 <b>Matplotlib</b><br/>(Генерує звіти)"]
    end

    subgraph Notify ["🔔 КАНАЛИ"]
        TG["✈️ Telegram Bot"]
        Web["🌐 Web Panel"]
    end

    Router -- "HTTP Push" --> API
    API --> Parser
    Parser --> Viz
    Viz --> TG
    Viz --> Web

Loading

Примітка: Ваш роутер або IoT-пристрій має бути налаштований на надсилання простого HTTP-запиту до сервера щоразу, коли з'являється живлення.

---

📦 Встановлення (Bare-Metal)

Проект розроблений для прямого встановлення на Linux (Ubuntu/Debian).

1. Налаштування

git clone https://github.com/weby-homelab/light-monitor-kyiv.git
cd light-monitor-kyiv
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

2. Конфігурація

Налаштуйте файл .env (токен бота та ID каналу) та config.json (ваша група відключень).

3. Автоматизація

Для стабільної роботи налаштуйте системний сервіс (power_monitor.service) та додайте завдання Cron для регулярного оновлення графіків (див. INSTRUCTIONS.md).

---

📜 Ліцензія

Розповсюджується за ліцензією MIT.

© 2026 Weby Homelab — інфраструктура, яка не здається.
Зроблено з ❤️ у Києві під звуки сирен та блекаутів...