hockey_new/UPDATE_ANALYTICS_RU.md

Аналитика матча — build 2026.09.27.2

Откройте Статистика → Аналитика. Здесь появились сравнение игроков, подсказки к эфиру и личная подборка текстов. Это обновление включает все предыдущие исправления v1–v5.

Сравнение игроков

• Выбор двух игроков обеих команд, в том числе двух партнёров по команде.
• Переключение «Карьера КХЛ / Сезон» и «Всего / За матч».
• Отдельные показатели полевых игроков и вратарей. Игры, проценты и коэффициент надёжности не делятся повторно на число матчей.
• По умолчанию доступна заявка на матч. Галочка «Все игроки текущих команд» добавляет активный состав выбранного турнира.
• Сезон берётся из таблицы статистики выбранного турнира и текущей команды; карьера учитывает все клубы КХЛ. Можно выбрать этап карьеры: все, регулярный чемпионат, плей-офф, Кубок Надежды.
• Неизвестное значение показывается прочерком. При отсутствии игр показатель «за матч» не рассчитывается. Неоднозначная сезонная запись не выбирается автоматически.

Подсказки

Ближайшие статистические отметки:

• Игры, голы, передачи, очки и победы: шаг 50.
• Сухие матчи вратарей: шаг 10.
• Фильтр расстояния до отметки: 1, 3, 5 или 10.
• Показывается игрок, команда, текущее значение, цель, дата данных и ссылка на карточку КХЛ.
• Точная достигнутая отметка отображается отдельно. Она не обозначается как достигнутая сегодня.

Дни рождения игроков:

• Расчёт относительно даты выбранного матча, включая матчи, к которым готовятся заранее.
• Только в день матча либо ±3, ±7, ±14 дней; по умолчанию ±7.
• Указаны дата, возраст в день рождения и сколько дней до или после матча.
• Дата берётся из карточки игрока в БД; при её отсутствии — из однозначно сопоставленного профиля КХЛ.
• Переход между декабрём и январём учитывается. Для 29 февраля используется только реальная дата в високосном году, без автоматического переноса праздника.
• Если дата матча или дата рождения неизвестна, расчёт не выдумывается.
• Фильтры: обе команды / одна команда, все подсказки / статистические юбилеи / дни рождения, поиск по номеру или имени.

Статистические подсказки используют снимок БД. Они не прибавляют к нему события текущего матча: иначе возможен двойной учёт уже загруженных событий. Дни рождения доступны и без карьерных чисел, если известна дата рождения.

Подборка и тексты

Кнопка «Подготовить титр» открывает редактируемые тексты RUS/ENG. Их можно сохранить, скопировать по языку или скачать общей подборкой TXT. Можно добавить собственную заметку.

Подборка сохраняется в таблице hockey_analytics_drafts: отдельно по аккаунту и матчу, до 200 записей. Сохранённые тексты остаются после перезапуска, замены файлов и входа с другого компьютера. Обновление статистики не переписывает подготовленную формулировку. Несохранённые черновики остаются только в текущей вкладке; их можно снова открыть в «Моя подборка». Перед закрытием страницы браузер предупреждает о несохранённых изменениях.

При одновременном редактировании одной записи в двух вкладках устаревшее сохранение отклоняется. Локальный текст остаётся в редакторе. Нажмите «Обновить подборку», затем откройте нужную сохранённую запись.

Зритель может сравнивать, готовить тексты и сохранять свою подборку. Эти действия не меняют владельца, события, таймеры и подборку другого аккаунта. Аналитика не отправляет команды в Agent или vMix. Готовый текст копируется в существующий титр; выдача в эфир остаётся в существующем управлении владельца матча. Перед эфиром проверьте имя ENG: если английского имени нет в источнике, используется доступное имя без выдуманной транслитерации.

Нагрузка и обновление

Данные читаются из БД при открытии аналитики, смене охвата/этапа или нажатии «Обновить статистику из БД». Смена игрока, амплуа, периода и режима пересчёта работает в браузере без новых запросов. Периодического опроса для аналитики нет; новые библиотеки и фоновые процессы не добавлены.

Редактор и выбор игрока не пересоздаются при фоновых обновлениях матча. Источники КХЛ обновляются через прежнюю вкладку «Настройки → КХЛ сайт»; после загрузки нажмите «Обновить статистику из БД» в аналитике. «Обновить подборку» загружает сохранения с других вкладок этого аккаунта.

Установка

1. Остановите сервер проекта и распакуйте обновление в существующую папку проекта с заменой файлов.
2. Запустите сервер: новая таблица создаётся штатным добавочным обновлением схемы PostgreSQL.
3. Обновите страницу и откройте «Статистика → Аналитика».

Архив не содержит пользовательские настройки, .env, базы данных, локальный архив КХЛ и данные Agent. Настройки кнопок, шорткатов и Mapping не заменяются. Проверки перечислены в VALIDATION_ANALYTICS_RU.md.