🎬 Telegram Movie Bot

Бот для поиска информации о фильмах и игры в угадывание фильмов по описанию.

📋 Основные функции

🔍 Поиск фильмов

• Поиск фильмов по названию
• Отображение подробной информации о фильме:
  • Название и описание
  • Рейтинг
  • Постер
  • Жанры и страны
  • Год выпуска
  • Длительность
  • Ссылки для просмотра
• Навигация по результатам поиска с помощью кнопок

🎲 Случайный фильм

• Получение случайного фильма из топ-250
• Возможность получить другой случайный фильм
• Отображение всей информации о фильме

🎮 Игра "Угадай фильм"

• Игра на угадывание фильмов по описанию
• 5 вопросов в каждой игре
• 4 варианта ответа для каждого вопроса
• Подсчет правильных ответов
• Итоговая статистика с оценкой результата
• Возможность начать новую игру

📊 Статистика и история

• История поиска фильмов
• Статистика просмотров фильмов
• Отображение количества показов каждого фильма

🛠 Команды бота

• /start - Начать работу с ботом
• /help - Показать справку по командам
• /game - Начать игру "Угадай фильм"
• /random - Показать случайный фильм из топ-250
• /history - Показать историю поиска
• /stats - Показать статистику просмотров

🎯 Особенности игры "Угадай фильм"

1. Начало игры

   • Команда /game запускает новую игру
   • Игра состоит из 5 вопросов
   • Каждый вопрос содержит описание фильма и 4 варианта ответа

2. Процесс игры

   • После каждого ответа показывается правильный ответ
   • Отображается текущий счет
   • Кнопка "Следующий вопрос" для продолжения игры

3. Итоги игры

   • После 5 вопросов показывается итоговый результат
   • Отображается количество правильных ответов
   • Показывается процент правильных ответов
   • Дается оценка результата:
     • 100% - "Отличный результат! Вы настоящий киноман!"
     • 80-99% - "Отличная работа! Вы хорошо разбираетесь в кино!"
     • 60-79% - "Хороший результат! Есть куда расти!"
     • <60% - "Неплохо! Стоит посмотреть больше фильмов!"

🔧 Технические детали

• Бот использует API Кинопоиска для получения информации о фильмах
• Кэширование топ-250 фильмов для быстрой работы
• Асинхронная обработка запросов
• Логирование всех действий для отладки
• Поддержка групповых и личных чатов

📝 Требования

• Python 3.7+
• aiogram
• aiohttp
• python-dotenv
• SQLite (для хранения истории и статистики)

⚙️ Установка и запуск

1. Клонируйте репозиторий
2. Установите зависимости:

   pip install -r requirements.txt

3. Создайте файл .env с необходимыми переменными:

   TELEGRAM_TOKEN_NEW=ваш_токен_бота
   KINOPOISK_API_KEY=ваш_ключ_api_кинопоиска
   

4. Запустите бота:

   python bot.py