BUILD190 · 2026.10.21.1

Для обновления существующей VM используйте hockey_BUILD190_update.zip.
Распакуйте его В КОРЕНЬ существующего проекта с заменой файлов.
Пакет не содержит .env, действующие настройки, пароли, базы, карточки КХЛ
и Agent.exe. Они остаются в вашем проекте.

1. Остановите службу приложения в удобное время. Сохраните резервную копию
   проекта и PostgreSQL. Существующие настройки после изготовления присланного
   архива могут быть новее: не заменяйте их файлами из полного архива.
2. Распакуйте пакет изменённых файлов в корень проекта.
3. Из активного Python/venv приложения установите зависимости:
      python -m pip install -r requirements.txt
   Linux с .venv: .venv/bin/python -m pip install -r requirements.txt
4. Посмотрите план очистки и при необходимости примените его:
      python cleanup_project.py --dry-run
      python cleanup_project.py --apply
   Исторические документы удалятся только при точном совпадении с копиями
   в docs/history.zip. Изменённые вами файлы и рабочие данные сохраняются.
5. Перезапустите существующую службу. Для ручного запуска:
      python -m uvicorn app:app --host 0.0.0.0 --port 8000 --workers 1
   Windows: START.bat. Не используйте --reload и несколько workers для эфира.
6. Проверьте /api/health: build 2026.10.21.1. Откройте панель, выберите нужный
   Agent/матч, проверьте счёт, игрока, удаление и численный состав на vMix.
   При первом запуске существующие привязки Mapping фиксируются автоматически.

СОХРАНЕНИЕ MAPPING
Сохранение меняет шаблон. Для обновления выбранного Agent нажмите ▶/↻ рядом
с конфигом. Остальные Agent сохраняют свою опубликованную версию. ✓ означает
актуальную публикацию; ↻ — что есть новая версия. Общие SQL-источники остаются
общими: изменения SQL проверяйте вне эфира.

ЖУРНАЛ
Кнопка «Журнал» находится в верхней панели и доступна администратору.
С телефона/другого компьютера: адрес вашего сервера + /logs, например
http://АДРЕС_СЕРВЕРА:8000/logs. Вход под учётной записью администратора.
Периоды: сегодня / 7 дней / месяц / все доступные / произвольные даты.
Есть поиск, участник, матч, Agent, уровень, раздел, сортировка, TXT/JSONL.
Скачивается весь выбранный период. Хранятся текущий и предыдущий календарные
месяцы по Москве, более старые удаляются автоматически.
Логи — logs/ или HOCKEY_LOG_DIR; секреты маскируются.

СКОРОСТЬ ИНТЕРФЕЙСА
Сжатие и кэширование скриптов/стилей, параллельная загрузка и меньше
перерисовок. В журнале browser.ready видны замеры конкретного компьютера.

ПРОВЕРКИ
Новые сценарии mapping/участников/журнала и браузер проверены локально.
91 проверка финального поведенческого набора прошла, дополнительные проверки
входа с телефона/выхода при недоступной авторизации тоже прошли.
В исходном архиве уже было 59 падающих тестов; список и точные итоги находятся
в docs/validation.json. Полный набор после последних правок не перезапускался.
Рабочий PostgreSQL, Stat2TV, Windows Agent.exe и живой vMix при разработке
не подключались: полную эфирную проверку выполните после установки.

Основные инструкции: README.md и docs/OPERATOR.md, ADMIN.md, ARCHITECTURE.md,
CHANGELOG.md. Прежние 46 документов доступны в docs/history.zip.