⚽ SoccerLife AI Assist

1. Общая архитектура

SoccerLife AI Assist перехватывает и анализирует данные матча с soccerlife.ru в реальном времени. Данные поступают из двух источников:

  Browser                 soccerlife.ru
     │
     ├── GET /game.php?id=XXXXX  ──►  HTML-страница матча
     │        └── переменная _inf (JSON)
     │             ├── Состав обеих команд с side=1/2
     │             ├── Цвета формы, имена, номера
     │             └── Метаданные матча (время старта, минута)
     │
     └── GET /ajax/moves.php?game_id=X&minute=Y  ──►  JSON
              ├── Позиции всех игроков (каждый ~1с)
              ├── Траектория мяча
              ├── Позиция арбитра + игровые события
              └── Покрывает следующие 5 игровых минут
  

2. API-эндпоинты soccerlife.ru

game.php — страница матча

GET https://soccerlife.ru/game.php?id={game_id}

HTML-страница. Содержит встроенный JavaScript с переменной _inf (подробнее в разделе 3). Авторизация не требуется для просмотра.

moves.php — позиции и события

GET https://soccerlife.ru/ajax/moves.php?game_id={game_id}&minute={minute}

Возвращает JSON с позициями всех сущностей на следующие ~5 игровых минут.

Ответ:

{
  "status":      1,           // 1 = OK
  "next_minute": 41,          // когда запрашивать следующий блок
  "check_time":  1774698554,  // unix timestamp сервера
  "time":        1774698599,  // время обработки запроса
  "moves": {
    "ENTITY_ID": ["frame1", "frame2", ...],
    ...
  }
}

game4.php — параллельные результаты

GET https://soccerlife.ru/ajax/game4.php?action=live_results&game_id={id}&type=1

Возвращает HTML-таблицу с результатами других матчей, идущих параллельно в том же чемпионате. Полезно для отслеживания турнирной ситуации.

3. Переменная _inf — метаданные матча

Встроена в HTML как _inf = {...} (второе присваивание — JSON-формат).

Структура верхнего уровня

Объект participants[PLAYER_ID]

{
  "type":         1,           // 1=игрок, 2=мяч (entity "7"), 3=арбитр (entity "89")
  "side":         1,           // 1=хозяева, 2=гости
  "kit_id":       3629,        // ID комплекта формы
  "kit_color":    "#4747eb",   // основной цвет формы
  "text_color":   "#fff",      // цвет номера
  "circle_color": "#fff",      // цвет подложки
  "position":     "AM",        // амплуа (GK, CD, DM, CM, AM, ST, LD, RD, LW, RW, LM, RM, LB, RB)
  "name":         "Йилмаз",   // фамилия игрока
  "number":       "90"         // номер на спине
}

Дополнительно из JS-переменной game_inf:

4. Формат moves.php — движения и события

Ключи объекта moves

Формат одного кадра (frame)

Каждый элемент массива — строка вида:

"duration:action:x:y:direction[:label]"

Первый кадр (INITIAL) — особый формат

"0:69:39:28:2:am"   → action=69, начальная позиция, команда=2, амплуа=am
"699.2:69:52:-10:2" → запасной игрок (y=-10)

Система координат поля

• X: 0–104 — ширина поля слева направо
• Y: 0–69 — высота поля
• Хозяева обычно защищают левые ворота (GK при x≈9)
• Гости обычно защищают правые ворота (GK при x≈99)
• y=-10 / x=-10 — сущность вне поля (запасной или мяч вышел за линию)

5. Коды действий (action codes)

Универсальные

Коды игроков

Коды мяча (entity "7")

6. Траектория мяча

Entity "7" содержит полную траекторию мяча каждого 5-минутного блока. Анализируя её, можно определить:

Пример сырых данных мяча

"699.4:69:52:4:0"    — стартовая позиция, центр поля
"0.9:2:58:4:0"       — качение вправо
"1:4:58:10:0"        — качение вправо вверх
"1.3:3:39:4:0"       — воздушная траектория (навес/удар)
"0.8:2:-10:26:0"     — мяч вышел за линию (x=-10)
"7.7:20:-10:26:0"    — мяч ещё вне поля (вратарь берёт)
"0:22:6:42:0"        — мяч установлен у ворот (от ворот / угловой)
"1:20:6:42:0"        — удар от ворот

7. Игровые события (labels)

Метки-события появляются только у entity "89" (арбитр). Игроки в moves.php меток событий не имеют — только арбитр объявляет события.

Определение скорера гола

В moves.php нет прямой метки «кто забил». Применяем эвристику:

1. Определяем атакующую команду по позиции мяча у ворот соперника
2. Берём координату ворот соперника (x ≈ 9 или x ≈ 99)
3. Находим игрока атакующей команды, ближайшего к этим воротам в момент гола

8. Наши эндпоинты (web_app.py)

SSE события потока /stream/{game_id}

9. Поток данных

  Запуск стрима (/stream/{game_id})
       │
       ▼
  fetch_game_info(game_id)          ← GET game.php → _inf JSON
       │
       ├── team membership (side 1/2)
       ├── player names & positions
       └── kit colors

  SSE → event: game_info            ← клиент получает составы и цвета
       │
       └── LOOP: minute = start_minute → 90
              │
              ▼
         fetch moves.php?minute=N
              │
              ▼
         parse_chunk()
              ├── _parse_entity() × 40 сущностей
              │     ├── Первый кадр (action=69) → стартовая позиция, амплуа
              │     └── Остальные кадры → анимация, duration без initial frame
              │
              └── _extract_events()
                    ├── Пропускаем initial frame (duration — плейсхолдер)
                    ├── Собираем labeled frames от entity "89"
                    ├── Пропускаем метки амплуа (cd, dm, gk...) как non-events
                    └── Дедуплицируем повторяющиеся события (< 10с интервал)

  SSE → event: chunk               ← клиент рендерит игроков на поле
       │                              и показывает все события как "pending"
       │
       └── LOOP: событие за событием
              │
              ▼
         sleep(event.second - elapsed)
              │
              ▼
         SSE → event: game_event   ← клиент активирует pending → fired
  

Файлы проекта