☁️ SkyVellum - Ваш персональный метеоролог

SkyVellum - погодный бот, который следит за погодой за вас. Получайте актуальные данные, прогнозы и аналитические отчёты прямо в Telegram.

🌟 Функциональность

✔️ Регистрация пользователей с выбором города
✔️ Получение текущей погоды
✔️ Прогноз погоды на 5 дней
✔️ Еженедельный анализ погоды с тенденциями и прогнозом
✔️ Автоматическое уведомление о погоде каждое утро
✔️ Еженедельный аналитический отчёт по воскресеньям
✔️ Команда доступная только администратору /stats - с данными по количеству активных пользователей и списка городов

⚙️ Технические особенности

• Язык: Python 3.13
• Фреймворк: aiogram 3.19.x
• Архитектура: Асинхронная, модульная для высокой производительности и возможности легко расширять функционал
• БД: SQLite, управление с помощью SQLAlchemy
• Логирование: Встроенная система логов
• Планировщик задач: Для автоматической отправки уведомлений
• Контейнеризация: Docker
• Тестирование: Набор тестов для проверки работоспособности

🛠️ Запуск бота

1. .env файл с токенами Telegram, OpenWeatherMap, ID админа и .
2. Запуск бота через Docker:

   docker-compose up --build  # Пересборка контейнера
   docker-compose up -d  # Запуск в фоновом режиме

3. Управление контейнером:

   docker-compose logs -f bot  # Просмотр логов
   docker-compose down  # Остановка контейнера
   docker-compose restart bot  # Перезапуск
   docker exec -it skyvellum_bot /bin/bash  # Вход в контейнер

🗄️ База данных

• users — хранит информацию о пользователях и их городах
• weather_data — исторические данные для аналитики

📸 Примеры работы

Утренний прогноз

Еженедельный отчёт

Текущая погода

📩 Обратная связь

Есть идеи или вопросы? Открывайте issue или создавайте pull request в репозитории.