# 📊 Lichess Statistics Bot - О боте

## 🎯 Что это?

**Lichess Statistics Bot** — это Telegram-бот для автоматического отслеживания статистики игроков на платформе Lichess.org. Бот предоставляет детальную информацию о рейтингах, играх, задачах и активности игроков в режиме реального времени.

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

### 📈 Статистика и аналитика
- **Статистика за сегодня** — мгновенный обзор активности за текущий день по всем отслеживаемым игрокам
- **Статистика за вчера** — анализ вчерашних результатов по всем отслеживаемым игрокам
- **Статистика за неделю** — недельный отчет о прогрессе по всем отслеживаемым игрокам
- **Статистика за год/1000 игр** — детальная статистика за последний год или последние 1000 рейтинговых игр
- **Рейтинги по режимам** — отслеживание рейтинга в Bullet, Blitz, Rapid, Classical и Correspondence
- **Статистика задач** — количество решенных задач (puzzles) с детализацией правильных и неправильных ответов
- **Множественное отслеживание** — команды статистики автоматически показывают данные по всем игрокам с активностью
- **Информативные сообщения** — бот показывает процесс обработки запросов и уведомляет о завершении

### 🔔 Автоматические уведомления
- **Периодические отчеты** — настройка автоматических уведомлений с заданным интервалом
- **Умные уведомления** — бот отправляет сообщения только при наличии активности
- **Гибкие настройки** — выбор интервала: 15 минут, 30 минут, 1 час, 2 часа, 3 часа, 6 часов, 12 часов, 24 часа
- **Удобный формат** — интервалы отображаются в понятном формате (например, "1 hour" вместо "60 minutes")

### 👥 Управление отслеживанием
- **Множественное отслеживание** — добавление неограниченного количества игроков
- **Активный игрок** — выбор основного игрока для быстрого доступа к статистике
- **Простое управление** — добавление и удаление игроков через удобные команды

## 👨‍👩‍👧‍👦 Для кого этот бот?

### 🎓 Для тренеров
- **Отслеживание учеников** — мониторинг прогресса всех ваших подопечных в одном месте
- **Анализ активности** — понимание, кто и как часто тренируется
- **Контроль выполнения заданий** — отслеживание решения задач и игровой активности
- **Сравнительный анализ** — возможность отслеживать нескольких учеников одновременно

### 🏆 Для игроков
- **Собственный прогресс** — отслеживание своих результатов и рейтинга
- **Мониторинг соперников** — следите за активностью и прогрессом ваших соперников
- **Отслеживание друзей** — держите руку на пульсе активности ваших друзей по шахматам
- **Мотивация** — регулярные уведомления помогают поддерживать регулярность тренировок

### 👨‍👩‍👧 Для родителей
- **Контроль активности детей** — узнавайте, когда и как часто ваш ребенок играет
- **Отслеживание прогресса** — видите рост рейтинга и улучшение результатов
- **Безопасность** — получайте уведомления о активности без необходимости постоянно проверять сайт
- **Множество детей** — отслеживайте нескольких детей одновременно

### 🤝 Для всех
- **Отслеживание друзей** — следите за активностью ваших друзей на Lichess
- **Мониторинг соперников** — анализируйте игру ваших постоянных соперников
- **Сравнение результатов** — отслеживайте несколько игроков для сравнения прогресса
- **Гибкость** — каждый может настроить бота под свои нужды

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

1. **Найдите бота в Telegram**: [@LichessStat_bot](https://t.me/LichessStat_bot)
2. **Отправьте команду** `/start` для начала работы
3. **Добавьте игроков** с помощью команды `/addgamer` или `/addtoken`
4. **Выберите активного игрока** через `/getgamers` (для команды `/setperiod`)
5. **Получайте статистику** командами `/today`, `/yesterday`, `/week` — они автоматически покажут данные по всем игрокам с активностью
6. **Получите расширенную статистику** через `/lastYear_or_1000games` для детального анализа
7. **Настройте уведомления** через `/setperiod` для автоматических отчетов по активному игроку
8. **Свяжитесь с разработчиком** через `/support` для обратной связи

## 📋 Доступные команды

- `/start` — начало работы с ботом и добавление первого игрока
- `/addgamer` — добавить игрока Lichess для отслеживания (только имя пользователя)
- `/addtoken` — добавить игрока с токеном для получения статистики по задачам
- `/getgamers` — выбрать активного игрока из вашего списка
- `/delgamer` — удалить игрока из списка отслеживания
- `/today` — статистика за сегодня по всем отслеживаемым игрокам с активностью
- `/yesterday` — статистика за вчера по всем отслеживаемым игрокам с активностью
- `/week` — статистика за неделю по всем отслеживаемым игрокам с активностью
- `/lastYear_or_1000games` — статистика за последний год или последние 1000 рейтинговых игр (по всем игрокам с активностью)
- `/setperiod` — настроить периодические уведомления для активного игрока (интервалы: 15 минут, 30 минут, 1 час, 2 часа, 3 часа, 6 часов, 12 часов, 24 часа)
- `/support` — контактная информация для обратной связи с разработчиком

## 💡 Примеры использования

### Пример 1: Тренер отслеживает учеников
```
Тренер добавляет всех своих учеников в бот.
Настраивает уведомления каждые 2 часа.
Получает регулярные отчеты об активности каждого ученика.
```

### Пример 2: Игрок следит за соперником
```
Игрок добавляет своего постоянного соперника.
Проверяет его статистику перед важной партией.
Отслеживает изменения рейтинга.
```

### Пример 3: Родитель контролирует активность ребенка
```
Родитель добавляет аккаунт ребенка с токеном.
Настраивает ежедневные уведомления.
Получает информацию о количестве игр и решенных задач.
```

## 🔗 Связь с Lichess

Бот использует официальный API Lichess.org для получения данных. Все данные актуальны и синхронизированы с платформой в реальном времени.

## 📞 Обратная связь

**Отзывы и предложения:** [@vrubelr](https://t.me/vrubelr) — буду рад отзывам и предложениям!

---

**Попробуйте бота прямо сейчас:** [https://t.me/LichessStat_bot](https://t.me/LichessStat_bot)