vrubelroman/LichessStatTgWeb
0
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
LichessStatTgWeb/LichessClientTG_bot
History
vrubelroman 4a783225af
All checks were successful
CI/CD Pipeline / build-and-deploy (push) Successful in 38s
Details
fix periodic activity-check algorithm silently losing player activity 
Errors from Lichess (timeouts/5xx/invalid tokens) were being disguised
as "no activity" (HTTP 200, games_count/puzzles_in_period=0), causing
the bot to silently advance its checkpoint past real, undetected
activity. Puzzle-fetch failures weren't counted as errors at all, and
the periodic task died permanently after 5 consecutive errors with no
way to recover short of a manual restart. /setperiod also unconditionally
reset the checkpoint, dropping the window between the last check and
the command.

- API now returns success=false/502 on real errors instead of masking
  them as zero activity (models.py, stats_service.py, main.py)
- Puzzle-fetch errors are now treated the same as game-fetch errors:
  retry the same window instead of reporting "no puzzles"
- Notification delivery failures no longer silently advance the
  checkpoint
- Replaced the hard 5-error kill switch with capped backoff that keeps
  retrying indefinitely, plus an admin-bot notification if a player's
  monitoring has been failing for a prolonged period (~2h+)
- /setperiod only clears the checkpoint when disabling notifications,
  preserving continuity when a period is just changed

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-07-02 19:29:06 +00:00
..
admin_bot.py add /sendusers0 2025-11-28 18:28:51 +03:00
bot.py fix periodic activity-check algorithm silently losing player activity 2026-07-02 19:29:06 +00:00
config.py refactor: move bot tokens to .env, remove hardcoded credentials 2026-06-30 18:15:44 +00:00
database.py fix by codex 2026-03-21 22:58:47 +03:00
Dockerfile Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
Dockerfile.admin admin panel 2025-11-13 01:00:48 +03:00
formatters.py fix by codex 2026-03-21 22:58:47 +03:00
helpEN.jpeg заменил картинки 2025-12-03 13:02:14 +03:00
helpRU.jpeg заменил картинки 2025-12-03 13:02:14 +03:00
i18n.py добавлены картинки с подсказкой как добавить игрока 2025-12-03 02:33:38 +03:00
lichess_api.py bug today 2025-11-20 03:14:06 +03:00
message_counters.py add statistics 2025-11-13 13:32:46 +03:00
migrate_tokens.py Исправление двойного ответа и улучшение системы 2025-10-28 21:34:35 +03:00
rate_limiter.py rate limiter 0.2 sec 2025-11-18 15:10:19 +03:00
README.md Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
request_queue.py delay in config and setup = 5sec 2026-02-04 23:51:32 +03:00
requirements.txt Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
run.sh Change API host port to 8002 2026-03-21 23:14:51 +03:00
version.py /addgamer выдает страничку игрока 2025-11-23 16:53:12 +03:00
view_db.py Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00

README.md

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
  1. Проверьте логи:
docker-compose logs -f lichess-bot

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

  1. Установите зависимости:
pip install -r requirements.txt
  1. Скопируйте файл конфигурации:
cp .env.example .env
  1. Запустите бота:
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. Логи контейнера на наличие ошибок