Спорт · теннис · Outstaff

ITF → KTF Ratings: Интеграция рейтингов ITF для Федерации тенниса Казахстана

Сделали интеграцию, которая забирает рейтинги казахстанских теннисистов из ITF и передаёт их в систему KTF: по расписанию, с проверкой данных и без ручного переноса. Рейтинги стали появляться в системе федерации вовремя.

Роль: Backend-разработка интеграции (outstaff)
Стек: PHPLaravelPostgreSQLITF APICron и очередиВалидация данных
Сайт: ktf.kz

Вовремярейтинг в KTF сразу после публикации в ITF
Автосинхронизация по расписанию без ручного переноса
100%записей проходят проверку перед загрузкой

О проекте

Федерация тенниса Казахстана (KTF) развивает теннис в стране: проводит турниры, формирует сборные и ведёт рейтинги игроков. Международные позиции теннисистов определяет ITF — Международная федерация тенниса. Федерации нужно, чтобы актуальный рейтинг ITF по каждому казахстанскому игроку был в её системе сразу после публикации.

Какие задачи решали

Получение рейтингов из ITF

Задача

Рейтинги ITF обновляются регулярно, а в KTF их переносили вручную: данные запаздывали, а сотрудники тратили время на рутину.

Что сделали

Интеграция с источником рейтингов ITF: загрузка по категориям и разрядам
Синхронизация по расписанию сразу после публикации нового рейтинга
Повторные попытки и таймауты, если внешний сервис недоступен
Журнал каждой синхронизации: сколько записей получено, обновлено и отправлено на проверку

Рейтинги приходят в систему KTF вовремя и без ручной выгрузки.

Получено1 248

Обновлено в KTF1 236

На проверке12

Запуск	Категория	Записей	Статус
29.09 06:00	Юниоры · одиночный	412	Готово
29.09 06:00	Юниоры · парный	386	Готово
29.09 06:00	Взрослые · одиночный	254	Готово
29.09 06:00	Взрослые · парный	196	Повтор · 2/3

06:00:02 GET rankings · 200 OK06:00:41 validate · 1 236 ok · 12 review06:00:43 commit · ktf.ratings

Сопоставление игроков ITF и KTF

Задача

В ITF и KTF разные идентификаторы, а имена пишутся по-разному — латиницей и кириллицей. Рейтинг мог попасть не тому игроку.

Что сделали

Привязка игрока KTF к его ITF ID
Поиск совпадений по имени, дате рождения и стране, если ID ещё не привязан
Очередь спорных совпадений для ручного подтверждения
Защита от дублей игроков в базе федерации

Каждый рейтинг попадает в профиль нужного игрока.

Запись ITF

SEITKAZY, Alikhan

ITF ID: 800412345
Дата рождения: 12.04.2008
Страна: KAZ
Позиция: #214

Кандидаты в базе KTF

СА

Сейтказы Алихан12.04.2008 · Алматы

96%

СА

Сейтказин Алихан03.11.2007 · Шымкент

61%

Привязать ITF IDДругой игрок

✓ ITF ID не привязан✓ Дата рождения совпадает✓ Страна: KAZ

Валидация и передача данных в KTF

Задача

Ошибочные или неполные данные не должны попадать в рейтинг федерации, а обмен должен работать стабильно.

Что сделали

Проверка формата, обязательных полей и допустимых значений
Сравнение с предыдущим рейтингом: позиции, очки и изменения
Загрузка в одной транзакции: рейтинг обновляется целиком или не обновляется вовсе
История рейтинга по каждому игроку

В системе KTF всегда актуальный и корректный рейтинг, а обмен с ITF работает без сбоев.

✓ 1 236 записей прошли проверкуОбновлено 29.09 · 06:00

№	Игрок	ITF	Очки	Изм.
1	Мухамеджанова Дана	#87	1240	▲ 4
2	Сейтказы Алихан	#214	815	▲ 11
3	Оспанова Аружан	#263	690	▼ 3
4	Ким Тимур	#301	605	—
5	Жумабек Нурислам	#348	540	▲ 7