LichessStatTgWeb/LichessWebServices
vrubelroman e8ced9bca7 Добавлена документация и скрипты для работы с БД
- Удалены лишние .gitignore из подпапок (теперь один общий в корне)
- Добавлен import_db.sh для импорта базы данных
- Создана документация: docs/ARCHITECTURE.md для разработчиков
- Создана документация: docs/USER_GUIDE.md для пользователей
- Обновлен .gitignore для исключения временных файлов
2025-10-28 21:38:10 +03:00
..
API_DOCUMENTATION.md Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
docker-compose.yml Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
Dockerfile Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
lichess_client.py Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
main.py Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
models.py Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
README.md Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
requirements.txt Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00
stats_service.py Создание единого проекта Lichess Statistics Ecosystem 2025-10-26 20:23:26 +03:00

Lichess Statistics API

REST API сервис для получения статистики игроков Lichess.org по играм и решению задач.

Возможности

  • Получение статистики за сегодняшний день
  • Получение статистики за вчерашний день
  • Получение статистики за последние 7 дней
  • Поддержка режимов игры: Bullet, Blitz, Rapid
  • Статистика по решению задач (пазлов)
  • Расчет изменения рейтинга
  • Подсчет побед, поражений и ничьих

Запуск с Docker

1. Сборка и запуск контейнера

# Сборка образа
docker-compose build

# Запуск сервиса
docker-compose up -d

2. Проверка работы

Сервис будет доступен по адресу: http://localhost:8000

API Endpoints

Получить статистику за сегодня

GET /stats/{username}/today

Получить статистику за вчера

GET /stats/{username}/yesterday

Получить статистику за неделю

GET /stats/{username}/week

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

Статистика за сегодня

curl http://localhost:8000/stats/vrubelroman/today

Статистика за вчера

curl http://localhost:8000/stats/vrubelroman/yesterday

Статистика за неделю

curl http://localhost:8000/stats/vrubelroman/week

Формат ответа

{
  "message": "Статистика за сегодняшний день",
  "data": {
    "username": "vrubelroman",
    "tasks": {
      "total": 28,
      "solved": 25,
      "unsolved": 3
    },
    "games": {
      "bullet": {
        "games_played": 7,
        "rating_change": 30,
        "final_rating": 2320,
        "wins": 5,
        "losses": 0,
        "draws": 0
      },
      "blitz": {
        "games_played": 5,
        "rating_change": 32,
        "final_rating": 2224,
        "wins": 5,
        "losses": 0,
        "draws": 0
      },
      "rapid": {
        "games_played": 2,
        "rating_change": -10,
        "final_rating": 2210,
        "wins": 1,
        "losses": 1,
        "draws": 0
      }
    }
  }
}

Остановка сервиса

docker-compose down

Логи

Для просмотра логов:

docker-compose logs -f