LichessStatTgWeb/LichessClientTG_bot

Lichess Telegram Bot

Телеграм бот для получения статистики игроков Lichess с использованием вашего веб-сервиса.

Возможности

• Добавление пользователей: Добавление игроков Lichess с токеном или без
• Выбор активного игрока: Глобальный выбор активного игрока для всех чатов
• Статистика: Получение статистики за сегодня, вчера и неделю
• Периодические уведомления: Настройка автоматических уведомлений о активности игрока

Команды

• /start - Начать работу с ботом
• /adduser - Добавить нового игрока Lichess
• /getgamers - Выбрать активного игрока
• /today - Статистика за сегодня
• /yesterday - Статистика за вчера
• /week - Статистика за неделю
• /setperiod - Настроить периодические уведомления

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

С помощью Docker (рекомендуется)

1. Убедитесь, что ваш Lichess API сервис запущен на http://localhost:8001

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

docker-compose up -d

3. Проверьте логи:

docker-compose logs -f lichess-bot

Локальная установка

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

pip install -r requirements.txt

2. Скопируйте файл конфигурации:

cp .env.example .env

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

python bot.py

Конфигурация

Основные настройки находятся в файле config.py:

• TELEGRAM_BOT_TOKEN - Токен вашего телеграм бота
• LICHESS_STATS_API_BASE_URL - URL вашего веб-сервиса (по умолчанию http://localhost:8001)
• PERIOD_OPTIONS - Доступные периоды для уведомлений
• POLL_INTERVAL - Интервал опроса Telegram API (1.0 секунда)
• POLL_TIMEOUT - Таймаут для Long Polling (30 секунд)
• DROP_PENDING_UPDATES - Игнорировать накопившиеся обновления при запуске
• ALLOWED_UPDATES - Типы обновлений для обработки

Структура проекта

├── bot.py              # Основной файл бота
├── database.py         # Работа с базой данных SQLite
├── lichess_api.py      # API клиент для Lichess и вашего сервиса
├── formatters.py       # Форматирование ответов
├── config.py           # Конфигурация
├── requirements.txt    # Python зависимости
├── Dockerfile          # Docker образ
├── docker-compose.yml  # Docker Compose конфигурация
└── README.md          # Документация

API Endpoints

Бот использует следующие endpoints вашего сервиса:

• GET /today/{username} - Статистика за сегодня
• GET /yesterday/{username} - Статистика за вчера
• GET /week/{username} - Статистика за неделю
• GET /games/{username}/period - Игры за период
• GET /puzzle/period - Задачи за период (требует токен)

База данных

Используется SQLite база данных с таблицами:

• gamers - Игроки Lichess
• chat_active_gamers - Активные игроки по чатам (не используется для глобального режима)

Логирование

Бот ведет подробные логи всех операций. В Docker контейнере логи можно просмотреть командой:

docker-compose logs -f lichess-bot

Мониторинг

Docker Compose включает health checks для мониторинга состояния сервисов.

Поддержка

При возникновении проблем проверьте:

1. Запущен ли ваш Lichess API сервис на порту 8001
2. Правильность токена телеграм бота
3. Логи контейнера на наличие ошибок