# Хоккейное управление для vMix

BUILD190 · `2026.10.21.1`

Операторская панель: матчи и составы Stat2TV/КХЛ, таймеры, удаления, статистика,
SQL/Mapping и передача титров в vMix через персональные Agent.
Номер установленной сборки возвращает `/api/health`; исходный номер находится в `app.py`.

## Запуск

На 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.

## Документация

- [Оператор: матч, mapping и таймеры](docs/OPERATOR.md).
- [Администратор: установка, обновление, восстановление и очистка](docs/ADMIN.md).
- [Архитектура и хранение данных](docs/ARCHITECTURE.md).
- [Изменения и архив прежних инструкций](docs/CHANGELOG.md).

Действующие настройки находятся в `settings/local/` либо `HOCKEY_UI_DATA_DIR`.
При обновлении сохраняйте их, `.env`, конфигурацию Agent, данные КХЛ и базы PostgreSQL.