Files
hockey_new/UPDATE_ANALYTICS_RU.md
2026-09-27 00:47:30 +03:00

59 lines
8.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Аналитика матча — 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`.