BUILD191 · 2026.10.21.2

ОБНОВЛЕНИЕ СУЩЕСТВУЮЩЕЙ VM
hockey_BUILD191_update.zip содержит накопленные изменения BUILD190 и BUILD191.
Он подходит для исходной BUILD189 и уже установленной BUILD190.
Пакет не содержит .env, действующие настройки, пароли, базы, данные КХЛ,
снимки XML и Agent.exe. Полный архив — снимок присланной VM, не заменяйте
им более новые действующие настройки.

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

BUILD191
Исправлена отправка таймера при пустом выборе Agent: команда больше не может
уйти на ранее выбранное устройство сессии. Отсутствующее поле старого API
сохраняет совместимость, явно пустое поле отклоняется сервером.
Проверки приведены к действующим контрактам без skip/xfail. Полный набор:
565 passed, 0 failed. Итоги, ограничения и сценарии — docs/validation.json.
Дополнительно пройден локальный сценарий трёх матчей с шестью Agents:
60 циклов по 64 поля на устройство, ошибки ACK, медленный источник,
переподключение и передача управления. CLI для повторения включён в tests/.

MAPPING И ЖУРНАЛ (BUILD190)
Mapping считается применённым после подтверждения Agent. Сохранение меняет
шаблон; кнопка ▶/↻ публикует его выбранному Agent. Другие устройства сохраняют
свою опубликованную версию. Повтор после разрыва не сбрасывает native Countdown.
Журнал доступен администратору: кнопка «Журнал» или /logs с любого компьютера
или телефона, который имеет доступ к серверу. Есть даты, 7 дней, месяц,
участник, матч, Agent, поиск, сортировка и скачивание TXT/JSONL.
Хранятся текущий и предыдущий календарные месяцы по Москве; старые удаляются.
Секреты маскируются. Замеры загрузки интерфейса записываются как browser.ready.

Проверки локальные: без рабочего PostgreSQL, Stat2TV, Windows Agent.exe и vMix.
Проверку на реальной VM выполните после установки перед эфиром.
Инструкции: README.md, docs/OPERATOR.md, ADMIN.md, ARCHITECTURE.md, CHANGELOG.md.
История прежних документов: docs/history.zip.