mrsk_bot/README.md
2025-10-02 20:35:37 +03:00

79 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

---
# 🚨 Бот отключений электроэнергии (МРСК Белгород)
Telegram-бот, который автоматически парсит и отображает актуальную информацию об **плановых**, **внерегламентных** и **аварийных** отключениях электроэнергии в г. Белгород.
Данные берутся с официального сайта [МРСК Центра и Приволжья](https://www.mrsk-1.ru/).
---
## Возможности
- Просмотр трёх типов отключений
- Автоматическое обновление данных каждые **5 минут**
- Удобный интерфейс через Telegram
- Подробное логирование запросов и ошибок
---
## 🛠 Технологии
- Python 3.11
- [aiogram](https://docs.aiogram.dev/) (v2)
- requests, pytz
- Docker (для развёртывания)
---
## Запуск
### 1. Клонируйте репозиторий
### 2. Настройте конфигурацию
Отредактируйте файл `config.py`:
```python
token = 'ВАШ_TELEGRAM_BOT_TOKEN'
URL_APP = 'https://ваш-домен.ru'
```
### 3. Соберите и запустите через Docker
```bash
docker build -t power-outage-bot .
docker run -d \
--name power-bot \
-p 5000:5000 \
-v $(pwd)/logs:/app/logs \
power-outage-bot
```
> Убедитесь, что ваш сервер доступен по `URL_APP` и настроен reverse proxy (например, Nginx) на порт 5000.
---
## 📁 Структура проекта
```
.
├── bot.py # Основной файл бота
├── main.py # Парсер данных с сайта МРСК
├── config.py # Конфигурация (токен, URL, API-эндпоинты)
├── requirements.txt # Зависимости Python
├── Dockerfile # Для сборки образа
├── logs/ # Директория для логов (бот.log, parser.log, users.log)
└── README.md
```
---
## Обратная связь
Если у вас есть вопросы, предложения или вы нашли баг — пишите: [@pikusQQ](https://t.me/pikusQQ)
---
> ⚠️ **Важно**: Бот использует **webhook**, поэтому должен быть развёрнут на сервере с HTTPS.
---