Мастер привязки ячеек

Мастер — это способ заполнить карту ячеек так, чтобы каждая строка была доказана, а не записана со слов. Работают вдвоём или в одиночку, но обязательно у открытого шкафа: часть шагов делается руками.

Мастер есть в панели

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

Привязка карты — самый долгий шаг дня установки, и в общем порядке установки она стоит после регистрации терминала. Полный распорядок дня — COMMISSIONING.md в репозитории проекта.

Идея в одном абзаце

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

Порядок действий

1. Откройте шкаф и держите доступ к дверцам. Все дверцы в начале должны быть закрыты — так виден каждый щелчок.
2. В панели выберите шкаф и начните привязку. Мастер идёт по гнёздам по очереди: CH01, CH02, … Пропущенные гнёзда можно вернуть в конце. На новом шкафу мастер сперва предложит завести черновую карту — см. врезку ниже. Без неё шкафу нечего открывать.
3. Мастер шлёт «открыть» на текущее гнездо. Слушайте щелчок и смотрите, какая дверца отошла.
4. Если дверца открылась — назовите её. Введите номер, который написан на этой дверце снаружи (или наклейте номер, если его ещё нет). Это и есть привязка «ячейка ↔ гнездо».
5. Закройте дверцу рукой. Дожмите до щелчка. Мастер должен показать, что увидел закрытие, — вот это и есть подтверждение.
6. Мастер записывает строку карты и переходит к следующему гнезду.
7. В конце — выборочная проверка. Откройте три-четыре ячейки по номерам из панели и убедитесь, что открылись именно они. Особенно проверьте соседние номера: перепутанные местами ячейки — самая незаметная и самая неприятная ошибка.

На новом шкафу сперва черновая карта, и надо дождаться, пока шкаф её заберёт

Шкаф открывает только те ячейки, которые есть в его карте, и сверяет гнездо с ней. Сделано это ради безопасности: если карта в панели и карта в шкафу разойдутся, клиенту откроется чужая дверца. Команды «открой гнездо номер семь, что бы на нём ни висело» у шкафа нет вовсе.

Поэтому на шкафу, где карты ещё нет, открывать нечего. Мастер предлагает завести черновую карту — заготовки на все гнёзда. Они создаются выведенными из оборота: клиенту такая ячейка не достанется, показываться свободной не будет, и открыть её умеет только сам мастер. Это важно: шкаф, на котором привязку бросили на середине, не превращается в набор обещаний.

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

Почему обязателен шаг «закройте рукой»

Открытие само по себе не доказывает ничего: пустое гнездо тоже показывает «открыто», всегда и без всяких команд. Доказательством служит именно закрытие после открытия — момент, когда датчик впервые сказал «нажат».

Если после команды ничего не произошло

Три причины, в порядке убывания вероятности.

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

Третий случай — не ошибка, а обычное дело. Карта затем и нужна, чтобы связать «как подключили» с «как написано на дверце».

⚠️ Обратите внимание на формулировку: неудачная привязка называется «не доказано», а не «замка нет». Это не придирка к словам — отсутствие замка доказать невозможно в принципе, и вот почему.

Чего делать не надо

• Не нажимайте «открыть» несколько раз подряд. Импульс на замок длится треть секунды, и очередь нажатий только запутает: вы перестанете понимать, на какое из них шкаф отвечает. Подождите пару секунд и повторите один раз.
• Не заполняйте карту «по памяти» или копированием с другого шкафа. Провода в двух одинаковых с виду шкафах могут быть разведены по-разному.
• Не привязывайте ячейку, у которой не подтвердилось закрытие. Такая ячейка в работе будет вечно выглядеть открытой и вечно давать тревогу, а под возврат вещи её отдавать нельзя вообще: система не сможет проверить, что клиент закрыл дверцу.

Когда мастер нужен снова

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

Замена планшета карту не затрагивает: она хранится в панели, а не в шкафу.