📚 Генри - Telegram бот для рекомендаций книг

Персонализированный Telegram бот для рекомендаций книг с уникальным характером и системой избранного.

🎭 О проекте

Генри - не просто бот для рекомендаций книг, а виртуальный библиотекарь-вампир. Он помнит каждого пользователя, развивает с ним отношения и предлагает книги в зависимости от выбранного настроения (утреннее/дневное/вечернее/ночное).

✨ Особенности

• 🎯 Персонализированные рекомендации по уникальным критериям - вайбам времени суток (утро/день/вечер/ночь)
• ⭐ Система избранного с возможностью отмечать книги как прочитанные
• 💖 Система близости - Генри развивает отношения с пользователем
• 🎃 Сезонные фразы - Хэллоуин и другие праздники
• 📖 Мнение Генри о каждой книге в описании
• 🔄 Удобная навигация с листанием вперед/назад

🚀 Как начать использовать

Для пользователей:

1. Найдите бота в Telegram: https://t.me/HenryMapley_litbot
2. Нажмите "Start" или отправьте команду /start
3. Наслаждайтесь рекомендациями! 📚

Для разработчиков: См. раздел 🛠️ Разработка ниже.

🎮 Как использовать

Основные команды:

• /start - Начать работу с ботом

Навигация:

1. Выбрать книгу → Выбрать время суток → Листать книги
2. Избранное → Просматривать/редактировать сохраненные книги
3. Узнать больше → Информация о боте

Система избранного:

• Добавляйте книги в избранное при просмотре
• Отмечайте как прочитанные/непрочитанные
• Удаляйте ненужные книги
• Фильтруйте по статусу прочтения

🧠 Система близости

Генри развивает отношения с пользователем на основе:

• Времени использования (дни с первого взаимодействия)
• Количества книг в избранном
• Общего количества просмотренных книг

Уровни близости:

• Новичок (< 5 очков) - базовые фразы
• Заинтересованный (5-15 очков) - более личные фразы
• Друг (15+ очков) - дружеские фразы

🛠️ Разработка

Требования для разработки:

• Python 3.8+
• Telegram Bot Token
• SQLite3

Установка для разработчиков:

1. Клонируйте репозиторий:

git clone https://github.com/your-username/henry-bot.git
cd henry-bot

2. Создайте виртуальное окружение:

python -m venv venv
# Windows:
venv\Scripts\activate
# Linux/Mac:
source venv/bin/activate

3. Установите зависимости:

pip install aiogram python-dotenv

4. Настройте переменные окружения: Создайте файл .env в корне проекта:

BOT_TOKEN=your_telegram_bot_token_here
ADMIN_ID=your_telegram_user_id_here

5. Заполните базу книг: Отредактируйте файл db/all_books.json - добавьте книги с описаниями и мнением Генри

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

python main.py

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

База данных:

• SQLite для пользовательских данных
• JSON для базы книг (до ~100 книг)

Архитектура:

• Модульная структура
• Отдельные файлы для разных функций
• Без глобальных переменных
• Асинхронная обработка

Безопасность:

• Переменные окружения для токенов
• Проверка прав доступа для админских функций

🤝 Вклад в проект

1. Форкните репозиторий
2. Создайте ветку для новой функции
3. Внесите изменения
4. Создайте Pull Request

📄 Лицензия

Этот проект распространяется под лицензией MIT

👨‍💻 Автор

Создано с ❤️ для любителей книг и хорошего чтения

---

Генри ждёт вас в Telegram! 📚✨