66 lines
5.5 KiB
Markdown
66 lines
5.5 KiB
Markdown
# Хоккейное управление для vMix
|
||
|
||
BUILD202 · `2026.11.05.3`
|
||
|
||
После гола в большинстве плашка удаления сначала снимается. Изменение её времени
|
||
и подписи выполняется после подтверждения OUT и настроенного интервала анимации;
|
||
карточка завершается в панели после подтверждения нужных команд vMix. Для первой
|
||
половины 2+2 скрытая плашка подготавливается на 2:00 и возвращается с новыми данными.
|
||
Длительность снятия задаётся у цели удаления в конструкторе. ACK команды сам по
|
||
себе не подтверждает завершение GT-анимации — проверьте интервал на вашем титре.
|
||
|
||
Рядом с MAIN TIMER появился переключатель «Плашки · F2». Он разрешает связанные
|
||
удаления, пустые ворота и отложенный штраф; без разрешения выдаётся основной счёт.
|
||
Выключение снимает связанные плашки и сохраняет работу часов и заполнение данных.
|
||
Разрешение сохраняется для выбранного матча; у нового матча оно выключено.
|
||
|
||
При встречных удалениях 2/4 минуты плашка сохраняет закреплённую сторону при
|
||
переходе 4on4 → PP, без повторной выдачи уже показанного Input.
|
||
При ошибке или неизвестном результате доставки карточка сохраняется для ручной
|
||
проверки; эфирное действие автоматически не повторяется.
|
||
Кнопка «ШБ» удалена; сохранённый ранее флаг больше не блокирует обычные голы.
|
||
При явно переданном источником типе `penalty_shot` сохраняется соответствующее исключение.
|
||
В инструкции описаны правила малых, 2+2 и больших штрафов, выбор при равных
|
||
остатках и случаи, которые требуют решения оператора: очередь штрафов,
|
||
отложенные назначения и состав овертайма.
|
||
Зритель получает DATA/Mapping в свой Agent, управляющие действия доступны оператору.
|
||
В BUILD202 используется прежний **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.
|