# Хоккейное управление для 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.