Files
hockey_new/README.md

50 lines
3.6 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
BUILD198 · `2026.10.22.4`
Данные титра подтверждаются перед его выдачей. Связанные Overlay 2/3 снимаются
перед верхним счётом; автоматические пути одного Input используют общую задержку.
Выбор управления матчем завершается до блокирующего окна загрузки. Зритель
сохраняет заполнение титров своему Agent, управляющие действия доступны оператору.
Для срочной очереди обновите сервер и Windows Agent до **1.5.6**.
Существующий `agent_config.json` сохраните. Поздние составы по-прежнему
отправляются без переоткрытия матча, окно показывает реальные этапы загрузки.
Операторская панель: матчи и составы 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.