Files
hockey_new/README.md

42 lines
2.7 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
BUILD194 · `2026.10.21.5`
Операторская панель: матчи и составы Stat2TV/КХЛ, таймеры, удаления, статистика,
SQL/Mapping и передача титров в vMix через персональные Agent.
Номер установленной сборки возвращает `/api/health`; исходный номер находится в `app.py`.
Для передачи Mapping по титрам в BUILD194 обновите Windows Agent до **1.5.5**,
сохранив его `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.