Когда ничего не помогает

Сначала — быстрая проверка

Прежде чем звонить, потратьте три минуты. Половина обращений закрывается здесь.

1. Подождали ли вы 5–7 минут? Зависший шкаф перезагружается сам — почему.
2. Дело в одной ячейке или во всём шкафу? Откройте соседнюю ячейку. Это первое, что спросят. ⚠️ На молчащем шкафу этот шаг не отвечает ни на что. Открытие из панели — это команда в очередь: шкаф забирает её сам, а не дождавшись его пятнадцать минут, она пропадает. Ни «открылось», ни «не открылось» вы при этом не увидите. Поэтому сперва пункт 1, и только к вернувшемуся шкафу — эта проверка.
3. Есть ли связь на самой точке? Постамат ходит только до нашего сервера, но выходит в сеть через тот же роутер, что и всё остальное.
4. Не было ли работ? Обновление, отключение питания, ремонт в помещении, кто-то что-то переставлял внутри шкафа.

Придёт ли тревога сама — зависит от настроек, а не от того, дописан ли сервер

⚠️ Прежняя запись «письма, SMS и всплывающие сообщения ещё не работают — сервер пишется» устарела. Письма и уведомления в браузер написаны и работают, если серверу выданы настройки почты и ключи уведомлений. SMS наружу не уходит ни при каких настройках — шлюза нет.

Что делать: один раз посмотреть на экране «Доставка уведомлений», какие каналы сервер объявляет рабочими. Если ни одного — проверять панель придётся самим, и ночную тревогу увидят утром. Выяснить это надо при планировании дежурства, а не в момент разбора происшествия.

⚠️ Открыть этот экран дежурный не может — он требует права alerts.configure, которого у роли «оператор» нет: в меню раздела не будет, по прямому адресу панель ответит «Раздел недоступен». Здесь стояло «один раз открыть „Доставку тревог“» — совет, который дежурному выполнить нечем. Спросите администратора и запишите ответ себе: это не то, что можно перепроверить ночью.

✅ Но без ответа вы не остаётесь. На экране «Уведомления», который дежурному открыт, стоит полоса: «Проверить, уходят ли уведомления наружу, ваша роль не может — настройки доставки видит только администратор. Пока не убедились у него: считайте, что уведомление видит только тот, кто смотрит в эту таблицу». У дежурного она стоит всегда — это не сбой и не признак того, что доставка сломана: панель просто не притворяется знающей то, чего ей знать не дают.

⚠️ Сегодня на сервере почта уходит в приёмник на этой же машине (127.0.0.1:1025), то есть письмо формируется и остаётся внутри: в почтовый ящик дежурного оно не придёт, пока владелец не впишет настоящий SMTP. Ночью на это полагаться нельзя; из работающего наружу остаётся уведомление в браузер, и оно требует, чтобы браузер дежурного был на него подписан.

⛔ Здесь стояло: «Читать пришедшее — по ссылке „открыть ящик“ на экране „Доставка тревог“ (/mail/, вход тот же, что в панель)». Дежурному это недоступно дважды: экран со ссылкой администраторский, а сам ящик писем с 7 сентября требует отдельного права sms.outbox.read — в письме лежит код клиента целиком. По прямому адресу /mail/ дежурный получит страницу «Экран писем закрыт: в письмах лежат коды доступа клиентов»; это не поломка входа, и входить заново бесполезно. Значит проверить «письмо и правда ушло» дежурный не может в принципе — на дежурстве считайте почту недоставленной и работайте по уведомлению в браузер и по самой панели.

Что записать перед обращением

Чем точнее эти данные, тем быстрее ответ. Особенно время: у платы бывает сбитое время, и разобрать инцидент можно только по вашим часам.

• Какой постамат — адрес и номер.
• Какая ячейка — номер на дверце, и, если знаете, номер гнезда из карты.
• Время с точностью до минуты, когда это случилось, и по каким часам вы смотрите.
• Что показывала панель — дословно, лучше скриншотом.
• Что вы уже сделали и что из этого получилось.
• Повторяется ли это и как часто. Если по кругу — примерно через сколько минут. Ровный интервал около пяти минут — важнейший признак, скажите о нём отдельно.
• Фото дверцы, замка, экрана — если ехали на место.

Куда обращаться

Контакты в этот документ ещё не внесены

Дежурный разработчик, порядок обращения и время реакции — это решение владельца проекта, и оно не зафиксировано. Здесь оставлено место, чтобы вписать реальные контакты, а не правдоподобную выдумку.

Пока их нет — обращайтесь к владельцу проекта.

Чего оператору делать не надо

Это не про недоверие, а про то, что каждое из этих действий уже приводило к потере устройства или к суткам разбирательства.

• Не разбирайте корпус и не подключайтесь к клеммам на задней стенке. Там служебный разъём: неверное подключение питания через него выводит плату из строя.
• Не заливайте прошивку и не запускайте на плате чужие утилиты. В интернете есть программы для похожих плат замков, и среди их команд есть такие, которые необратимо сжигают замок — плата примет команду молча, без предупреждения.
• Не подключайте постамат в офисную или домашнюю сеть. Пока устройства в отладочном состоянии, любой в той же сети получает над ними полный контроль. В проде они работают в специально настроенной сети, и это не «лишняя предосторожность».
• Не выключайте питание несколько раз подряд. Одно выключение на 10 секунд — максимум, и лучше по согласованию.
• Не закрывайте тревогу без причины. «Наверное, показалось» — не причина. Лучше оставить открытой и передать дальше.

Что делать, пока чинят

С объекта панель может не открыться — это не поломка

Почти всё в этом списке делается в панели, а панель из сети постамата недоступна намеренно — с чего начать, врезка «Почему адресов несколько». Подключив на объекте ноутбук или телефон к местному Wi-Fi, вы получите не ошибку входа, а страницу, которая просто не открывается. Берите свой канал связи (мобильный интернет) — иначе приедете к шкафу и не сможете сделать ничего из написанного ниже.

• Ячейку, которая ведёт себя странно, выведите из работы в панели: «Ячейки» → дверца в списке → «вывести из оборота». Тогда система перестанет её предлагать клиентам и перестанет тревожиться из-за неё, а вы перестанете получать один и тот же сигнал каждые несколько минут. ⚠️ До 4 сентября кнопки не было вовсе, и сделать это можно было только полным обрядом привязки на месте. Пока ячейка в обороте, сервер продолжает назначать её новым арендам — один сгоревший замок так собирает десяток жалоб подряд. 🔴 Вывести и вернуть может только администратор (право cells.edit), и только человек: само оно не «починится» и не вернётся. Дежурный на это кнопку не нажмёт — значит просит администратора, и не откладывает до утра: пока ячейка в обороте, сервер продолжает раздавать её новым арендам. ⚠️ Сначала достаньте из неё вещь, потом выводите. По выведенной дверце кнопка «Открыть удалённо» гаснет, и сервер отказывает словами «сначала верните её в оборот» (apps/api/src/panel/postamats.service.ts, openCell); открыть выведенную умеет только мастер привязки, а он рассчитан на человека у шкафа.
• Смотрите журнал по этой дверце, а не по всему шкафу. На экране «Журнал» есть выбор ячейки; без него события одной дверцы тонут в сотнях чужих. ⚠️ Выбор привязан к шкафу: переключились на соседний постамат — фильтр снимается, и это правильно, иначе пустой журнал читался бы как «ничего не происходило».
• Клиентов обслуживайте вручную: ячейку можно открыть из панели — но только пока шкаф на связи. 🔴 Молчащему шкафу открытие из панели не поможет вовсе: команда живёт пятнадцать минут и, не дождавшись шкафа, пропадает совсем — даже когда связь вернётся. ⚠️ Здесь стояло просто «ячейку можно открыть из панели, а при полном отказе электрики — ключом», и это отправляло человека нажимать кнопку, которая на молчащем шкафу не делает ничего. Отказ электрики — не единственный случай, когда остаётся только аварийный ключ: шкаф без связи, но с питанием выглядит живым, а открывается тоже лишь ключом.
• Записывайте каждое ручное открытие. Иначе следующий дежурный увидит тревогу «дверь открылась без команды» и поедет разбираться с тем, что сделали вы.