Виджет — бесконечная загрузка / не коннектится

В gold-периоде 1564 сообщения упоминают виджет — второй по частоте кейс после «PC офлайн». Часто связан с релизами и/или подключением к MQTT.

Как выглядит запрос

«Проблемы с виджетами были разные, вот 15 пк […] spider1234 Королев Ривер парк.» — админ клуба, conv 10

«Несколько клубов жалуются на бесконечную загрузку.» — Сергей Пестрак, conv 10

«а ты это берёшь как кейс, где админ ничего не знает, что у него стоит изи, почему-то, хотя в срм есть, защита экрана есть и виджет есть» — обсуждение сценария, conv 80

«вопрос, если человек щас играт в кс, могу ли я перезагрузить виджет?» — админ Клиент, conv 27

Что проверить в первые 2 минуты

Какая версия виджета? CRM → Устройство → показывает версию. Если только что был релиз — вероятно, это оно.
Подключение к MQTT — в EMQX PC виден?
Сколько PC в клубе с такой проблемой? Один — локальный кейс. Больше трёх — массовый инцидент.
ClientService живой? Если да, но виджет висит — это чистый widget-баг, не инфра.

Типичные причины

Релиз виджета с багом. Признак: одновременные жалобы из разных клубов. Anton Mamonov (conv 10): «ну мы релиз делали, там были проблемы, что виджет не коннектился».
Клон-контаминация / потерянный токен. Виджет не знает, кто он — бесконечный лоадер. Решение — скрипт очистки регистри (см. PC офлайн).
Сетевой сбой в клубе. Илья Бояршинов (conv 27): «да скорей всего с сетевым оборудованием была проблема».
Старая версия виджета + новая CRM. После обновления CRM виджет может перестать коннектиться, пока не накатим апдейт.

Как чинить

Сценарий A: Один PC завис в лоадере

Проверь, идёт ли у этого PC активная сессия.
Если сессии нет — можно перезапустить виджет смело. Anton Mamonov (conv 27): «да, у него ничего не сломается».
Если сессия идёт — предупреди админа, перезапуск потеряет 1-2 секунды игрового состояния, но клиент не вылетит.
Перезапуск: через MeshCentral → Task Manager → IZIWidget.exe → Restart. Либо перезапустить ClientService — он виджет поднимает.

Сценарий B: Несколько клубов жалуются одновременно

Это массовый инцидент. Порядок действий:

Зови Anton Mamonov / Anton / Artem C++ в #dev.
Напиши шаблонное сообщение клубам: «Знаем о проблеме, инженер смотрит».
Зафиксируй клубы и номера PC в задаче — разработке пригодится.

Сценарий C: Виджет не видит токен

Используется связка из PC офлайн — скрипт очистки регистри + переактивация через IZIInstall.

Эталонный ответ клиенту

Спокойный кейс:

«Привет. Да, можешь перезагрузить виджет — если игрок в КС, он ничего не потеряет. Если после перезапуска лоадер останется — пиши, подключусь через меш.»

Массовый инцидент:

«Есть проблема на стороне нашего релиза виджета — чинят. Если нужно срочно — ребут PC помогает, но это временно. Отпишу, как выкатим фикс.»

Когда эскалировать

Массовые жалобы (3+ клуба) → Anton Mamonov + #dev.
Виджет коннектится, но визуально поломан → #dev с скриншотом.
Скрипт очистки не помог → Artem C++.