Files
hockey_new/README.md

56 lines
4.3 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.

# Хоккейное управление для vMix
BUILD200 · `2026.11.05.1`
Рядом с MAIN TIMER появился переключатель «Плашки · F2». Он разрешает связанные
удаления, пустые ворота и отложенный штраф; без разрешения выдаётся основной счёт.
Выключение снимает связанные плашки и сохраняет работу часов и заполнение данных.
Разрешение сохраняется для выбранного матча; у нового матча оно выключено.
При встречных удалениях 2/4 минуты плашка сохраняет закреплённую сторону при
переходе 4on4 → PP, без повторной выдачи уже показанного Input.
При включённом F2 после гола в большинстве команды vMix подтверждаются до завершения
удаления в панели; при ошибке доставки карточка сохраняется для проверки.
Обычный гол не требует отметки «ШБ»: она нужна только для штрафного броска.
Правила 2+2 и больших штрафов сохранены; подробнее — в инструкции оператора.
Зритель получает DATA/Mapping в свой Agent, управляющие действия доступны оператору.
В BUILD200 используется прежний **Agent 1.5.6**, его конфигурация сохраняется.
Операторская панель: матчи и составы Stat2TV/КХЛ, таймеры, удаления, статистика,
SQL/Mapping и передача титров в vMix через персональные Agent.
Номер установленной сборки возвращает `/api/health`; исходный номер находится в `app.py`.
Для передачи Mapping и срочных команд обновите Windows Agent до **1.5.6**,
сохранив его `agent_config.json`; порядок — в [инструкции обновления](docs/ADMIN.md#обновление-и-восстановление).
## Запуск
На Windows запустите `START.bat`. На Linux из каталога проекта:
```bash
python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt
.venv/bin/python check_remote_database.py
.venv/bin/python -m uvicorn app:app --host 0.0.0.0 --port 8000
```
Нужны доступные PostgreSQL `HOCKEY_DATABASE_URL` и `WFL_DATABASE_URL`,
действующие учётные записи и настройки Stat2TV. Интерфейс: `http://127.0.0.1:8000/`.
Для эфира используйте один процесс Uvicorn, без `--reload` и нескольких workers.
Журнал открывается кнопкой **«Журнал»** в верхней панели или по адресу `/logs`.
Для просмотра с другого компьютера/телефона используйте адрес вашего сервера и
учётную запись администратора. Отдельная страница журнала не загружает весь UI.
В **«Диагностике»** доступна **«Готовность к эфиру»** выбранных матча и Agent:
назначение, связь, Mapping, связанные поля и подтверждения отправки.
## Документация
- [Оператор: матч, mapping и таймеры](docs/OPERATOR.md).
- [Администратор: установка, обновление, восстановление и очистка](docs/ADMIN.md).
- [Архитектура и хранение данных](docs/ARCHITECTURE.md).
- [Изменения и архив прежних инструкций](docs/CHANGELOG.md).
Действующие настройки находятся в `settings/local/` либо `HOCKEY_UI_DATA_DIR`.
При обновлении сохраняйте их, `.env`, конфигурацию Agent, данные КХЛ и базы PostgreSQL.