mrsk_bot/README.md
2025-10-02 21:11:22 +03:00

66 lines
2.0 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. Настройте конфигурацию
Скопируйте `.env.example` в `.env` и отредактируйте.
```python
BOT_TOKEN=xxxxxxxxxxxxxxxxxxxxx
WEBHOOK_URL=https://ваш-домен.ru
```
### 3. Соберите и запустите через Docker
```bash
docker build -t mrsk_bot .
docker run -d \
--name mrsk_bot \
-p 5000:5000 \
-v $(pwd)/logs:/app/logs \
mrsk_bot
```
- Или через docker compose
> Убедитесь, что ваш сервер доступен по `URL_APP` и настроен reverse proxy (например, Nginx) на порт 5000.
---
## Обратная связь
Если у вас есть вопросы, предложения или вы нашли баг — пишите: [@pikusQQ](https://t.me/pikusQQ)
---
> ⚠️ **Важно**: Бот использует **webhook**, поэтому должен быть развёрнут на сервере с HTTPS.
---