Оператору: с чего начать
Этот раздел — для человека, который следит за постаматами и выезжает к ним. Без жаргона: каждое незнакомое слово объясняется там, где встречается первый раз, а всё вместе собрано в словарике.
Панель оператора написана: карта ячеек, аренды и коды, журнал, тревоги, привязка каналов, объезд. Но система целиком ещё не запущена, и три вещи стоит знать заранее:
- сервер и приложение постамата пишутся прямо сейчас;
- уведомления наружу пока не уходят — ни письма, ни SMS, ни всплывающие сообщения в браузере. Тревогу видно только в самой панели, а значит ночная тревога будет замечена утром. Панель говорит это прямым текстом на своём экране;
- часть возможностей нарисована, но подписана «пока не работает» — так и задумано, честнее, чем прятать.
Названия экранов и кнопок могут отличаться от текста ниже. Смысл действий — нет.
Пять вещей, которые надо знать сразу
Их стоит прочитать один раз целиком. Каждая из них иначе выясняется в поле, ночью.
1. Кнопки «закрыть» не существует
Шкаф умеет только открывать ячейку. Внутри замка пружина: когда приходит команда, язычок убирается примерно на треть секунды, и дверца больше ничем не держится. Закрывает дверцу человек рукой, и язычок защёлкивается сам.
Поэтому в панели никогда не будет кнопки «закрыть ячейку». Если дверца осталась открытой — её надо закрыть руками, командой это не исправить.
2. «Открыто» и «закрыто» — это показания датчика
В каждом замке есть маленький выключатель: дверца закрыта — он нажат, дверца открыта — отпущен. Шкаф докладывает именно его состояние.
Из этого следует важное: «закрыто» шкаф знает точно, а вот «открыто» у него означает две разные вещи сразу — либо дверца действительно открыта, либо на этом месте вообще нет замка. Различить их шкаф не умеет. Отсюда растёт всё, что написано про карту ячеек.
3. Подтверждение открытия не значит, что дверь открылась
Когда вы нажимаете «открыть», шкаф отвечает «команду принял». Это подтверждение приёма команды, а не факта открытия. Открылась ли дверца, знает только датчик — и узнаёт он это примерно через полсекунды.
Практически: после команды всегда смотрите на состояние ячейки, а не на сообщение «команда отправлена».
4. Если приложение зависнет, шкаф перезагрузится сам примерно через пять минут
Так задумано. Внутри платы есть маленький «надзиратель», который перезагружает её, если программа перестала подавать признаки жизни. Постамат стоит без присмотра, и это дешевле, чем присылать человека.
Что из этого следует для вас: увидев «шкаф не отвечает», подождите 5–7 минут. Часто он оживёт сам. Подробнее — почему шкаф перезагружается сам.
5. Карта ячеек задаётся руками — и это не лень разработчиков
Шкаф не может сам выяснить, в каких его гнёздах есть замки, а какие пустые (см. пункт 2). Поэтому соответствие «ячейка номер 5 — это гнездо номер 12» вносится человеком через мастер привязки. Ошибка в карте означает, что клиенту откроется чужая ячейка, поэтому мастер устроен так, чтобы ошибиться было трудно.
Куда идти
| Задача | Страница |
|---|---|
| понять, из чего состоит шкаф | Как устроен шкаф |
| настроить новый шкаф | Карта ячеек, Мастер привязки |
| понять, что показывает панель | Состояния ячейки |
| открыть ячейку | Как открыть ячейку |
| открыть ячейку по звонку клиента | Опознание звонящего |
| разобраться с тревогой | Тревоги: что делать |
| клиент не может ввести код | Код клиента и блокировка |
| ничего не помогает | Когда ничего не помогает |
День установки нового постамата описан отдельно — в файле COMMISSIONING.md в репозитории
проекта. Там порядок шагов и приёмка; половина шагов необратима, поэтому его читают
до выезда, а не на месте.