Кодовый чистомат работает офлайн: ячейки открываются цифровыми кодами, а действия клиентов, курьеров и операторов фиксируются в системе «Агбис Чистоматы». Курьер связывает чистомат с производством и отмечает все выполненные операции.
На странице Работа → Панель управления отображаются основные показатели выбранной фирмы:
Для показателей «Передано в чистку» и «Выдано клиентам» период выбирается отдельно: неделя, месяц или год. Неделя начинается в понедельник, время рассчитывается в часовом поясе фирмы. Название чистомата в таблице является ссылкой на его ячейки.
В блок «Быстрые действия» можно добавить до шести доступных пользователю операций. Для настройки нажмите «+».
Клиент открывает публичную страницу конкретного чистомата по QR-коду. На первом экране отображается адрес чистомата и предлагается выбрать действие: «Сдать вещи» или «Получить вещи». Если в настройках фирмы загружен логотип, он выводится сверху по центру на всех публичных страницах.
Тексты над и под основными блоками публичных страниц настраиваются в фирме. Допускается HTML-форматирование. Отдельные тексты предусмотрены для стартовой страницы, сдачи вещей, отсутствия свободных ячеек, ввода телефона при получении, готовых заказов и отсутствия готовых заказов.
Номер телефона вводится в формате, настроенном для фирмы. По умолчанию используется формат +7XXXXXXXXXX. После ввода система показывает экран подтверждения. Если номер указан неверно, клиент нажимает «Изменить номер телефона» и вводит его заново.
После выдачи ячейки система создает заказ на сдачу вещи и переводит ячейку в красный статус, чтобы она больше не выдавалась другим клиентам.
Экран выбора типа вещи появляется не всегда:
Если ячейка требуемого размера занята, система может выдать свободную ячейку большего размера. Из подходящих свободных ячеек выбирается наименьший достаточный размер с учетом настроенного приоритета размеров.
Если в чистомате нет подготовленных свободных ячеек, клиент видит сообщение об отсутствии доступных ячеек и не может продолжить сдачу.
Если типы вещей настроены, но ни для одного типа нет подходящей ячейки, система сообщает, что нет подготовленных ячеек для настроенных типов вещей.
При обычном обновлении этой страницы доступность ячеек проверяется повторно. Если подходящая ячейка появилась, клиент возвращается к началу QR-сценария и может продолжить сдачу без повторного сканирования кода.
Для фирмы можно задать максимальное количество одновременных сдач одного клиента в одном чистомате. В лимит входят только грязные вещи клиента, ожидающие обработки. Готовые заказы в ячейках в этот лимит не входят.
Если лимит достигнут, после ввода телефона система выводит соответствующее сообщение. Продолжить сдачу можно после обработки предыдущих вещей курьером или оператором.
Если лимит позволяет и остались подготовленные ячейки, клиент может нажать «Сдать еще одну вещь?». Телефон повторно вводить не нужно. Система возвращает клиента к выбору типа вещи либо сразу выдает следующую ячейку, если выбор типа не требуется.
Если номер телефона ранее не был найден, после первой сдачи может открыться форма знакомства. Клиент указывает фамилию, имя и, при наличии, отчество. Можно отправить данные, сдать еще одну вещь или завершить сценарий без заполнения ФИО.
Если для чистомата настроен активный опрос после сдачи, на финальном экране появляется ссылка «Пройти опрос». Опрос не блокирует завершение сдачи, а ответы хранятся отдельно от заказа.
Текст завершения настраивается в фирме. Значение по умолчанию: «Спасибо. Ваши вещи размещены в чистомате.». При включенной настройке после забора грязных вещей курьером клиенту отправляется информационная СМС с номером пломбы. Повторная отправка при восстановлении связи с агентом блокируется.
Для каждой готовой вещи система показывает номер ячейки и код замка. Одна и та же ячейка выводится только один раз.
Если в текущем чистомате нет готовых заказов для введенного телефона, система выводит соответствующее сообщение. Если готовые вещи есть в других чистоматах этой фирмы, дополнительно показываются их адреса.
После подтвержденного получения ячейка переводится в желтый статус, код замка и номер пломбы очищаются, а событие записывается в Работа → История.
Если для чистомата настроен активный опрос после получения, рядом с результатом появляется ссылка «Пройти опрос». Опрос не блокирует получение вещи.
Курьер открывает раздел Работа → Курьер, выбирает чистомат и проходит этапы строго по порядку:
Служебные ячейки курьером не обрабатываются. При пропуске рабочей ячейки курьер обязан указать причину длиной не менее восьми символов. После обработки всех рабочих ячеек курьер завершает работу с чистоматом. Если были забраны грязные вещи, накладная переводится в статус «В пути».
Раздел Настройка чистоматов → Ячейки позволяет:
В журнале ячеек колонка «Время в статусе (ч.)» показывает количество полных часов с момента последнего изменения статуса. Служебная ячейка выделяется серым цветом, не участвует в счетчиках и метриках, не попадает в список «Требуют внимания» и недоступна клиенту, оператору и курьеру для размещения заказа.
Код генерируется при открытии действия подготовки и при сохранении не меняется повторно. При необходимости курьер может изменить код отдельным действием. Активные коды не повторяются внутри одного чистомата.
Перед использованием необходимо:
Перед первой настройкой ролей и пользователей выполните синхронизацию:
Синхронизируются чистоматы, ячейки, размеры, типы вещей, связи типов с размерами и пользователи АХ. При временной недоступности агента действия сохраняются локально и ставятся в очередь. После восстановления связи очередь передается в АХ.
Роли необходимо создать до добавления пользователей фирмы. Импортированные пользователи АХ отображаются в разделе Фирма и доступ → Пользователи.
Путь: Фирма и доступ → Шаблоны ролей.
Пользователь с ролью Босс может создавать, редактировать и удалять собственные шаблоны своей фирмы. Системные шаблоны изменять нельзя, а шаблоны других фирм не отображаются. Изменения собственного шаблона применяются к связанным ролям. При удалении шаблона необходимо выбрать роль, которая заменит его у затронутых пользователей фирмы.
Путь: Фирма и доступ → Роли → Добавить роль фирмы.
Права доступа определяют реальный доступ. Если право выключено, страницу нельзя открыть даже по прямой ссылке.
Скрыть пункты меню управляет только отображением закрепленного меню и не выдает права. Если в группе нет доступных видимых пунктов, вся группа скрывается.
В настройках роли также можно выбрать видимые пункты пользовательской документации и изменить порядок их отображения. Скрытие родительского раздела автоматически скрывает дочерние пункты, поэтому состояние настроек остается однозначным.
Стартовая страница должна быть разрешена выбранной роли, иначе после входа пользователь увидит запрет доступа.
Пункты Фирмы и Добавить фирму не назначаются ролям фирмы. Они доступны только администраторам сайта и служебному пользователю АХ с логином Agbis или Агбис. Раздел Сервис и пункт документации для администратора сайта доступны только системному администратору сайта.
Право Отправка СМС о заказах разрешает операцию «Отправить СМС о заказах» в списках заказов и клиентов. Перед отправкой система повторно проверяет ID клиента в АХ по номеру телефона и при необходимости обновляет локальные данные.
Путь: Фирма и доступ → Фирмы → Редактировать.
Роль по умолчанию необязательна, если каждому пользователю назначена персональная роль. Она используется только в автоматических сценариях, когда система уже определила пользователя и должна выдать стандартный набор прав фирмы.
Если роль по умолчанию не задана, существующие пользователи продолжают работать по персональным ролям, а пользователь без назначенной роли не получает доступ автоматически.
Путь: Фирма и доступ → Пользователи → Добавить пользователя фирмы.
Пользователь вводит:
Список фирм на форме входа не показывается. По ID определяется активная фирма. Агент ищет активного пользователя этой фирмы сначала по точному логину, затем по полному нормализованному номеру телефона.
Доступ разрешается, только если пользователь АХ найден в пользователях фирмы, его запись активна и ему назначена активная роль. В противном случае система запрещает вход и предлагает обратиться к администратору.
Пользователь АХ с логином Agbis или Агбис входит как администратор сайта без назначения роли фирмы. Успешные и неуспешные входы, IP-адрес, а также нажатие «Выход» записываются в Работа → История.
Над заполненными административными таблицами доступны кнопки «Экспорт CSV» и «Экспорт XLSX». В файл попадают строки текущего представления с учетом фильтров и сортировки. Служебные колонки операций и подробностей не экспортируются. Если таблица разбита на страницы, каждую страницу нужно экспортировать отдельно.
Демонстрационный чистомат используется для проверки клиентских сценариев без рабочей лицензии.
public_token.disabled=1 всегда блокирует чистомат, включая demo и режим настройки.disabled=0, demo-чистомат работает без проверки лицензии.disabled=0, режим настройки тоже работает без проверки лицензии.Demo-признак может менять только:
boss.Роль определяется по базовому шаблону, а не по отображаемому названию.
Режим настройки может менять только Drupal site administrator.
Все грязные вещи и готовые заказы в demo-чистомате оформляются на клиента:
АгбисDemo+71111111111Если телефон уже есть в AX, используется найденный CONTR_ID, а локальный AX ID обновляется. Если телефона нет, клиент создается через существующий механизм поиска и создания AX-клиента.
В публичном QR-сценарии demo-чистомат не спрашивает телефон клиента. Сдача сразу привязывается к demo-клиенту.
Операторское размещение грязных вещей в demo-чистомат также игнорирует введенный телефон и использует demo-клиента.
При размещении готового заказа в demo-чистомат локальный заказ и AX-события привязываются к demo-клиенту независимо от данных исходного клиента заказа.
В интерфейсе курьера показывается demo-клиент, чтобы исходные данные клиента не выглядели владельцем заказа в demo-чистомате.
Перед replay очередь повторно проверяет demo-клиента по телефону 71111111111 и подставляет текущий CONTR_ID.
Для команд используются стабильные ключи:
locker-load:dirty:<order_id>locker-load:ready:<order_id>ready-placement:<firm_id>:<doc_num>:<cell_id>resolve-demo-client:<firm_id>:71111111111Drupal не должен ставить повторную pending-команду с тем же ключом. Полная идемпотентность в AX требует поддержки request_id на стороне Agent для ADD_LOCKER_LOAD_EVENT и PLACE_READY_ORDER_IN_LOCKER.
Над заполненными административными таблицами доступны кнопки «Экспорт CSV» и «Экспорт XLSX». В файл попадают строки текущего представления с учетом фильтров и сортировки. Служебные колонки операций и подробностей не экспортируются. Если таблица разбита на страницы, каждую страницу нужно экспортировать отдельно.
Демонстрационный чистомат используется для проверки клиентских сценариев без рабочей лицензии.
public_token.disabled=1 всегда блокирует чистомат, включая demo и режим настройки.disabled=0, demo-чистомат работает без проверки лицензии.disabled=0, режим настройки тоже работает без проверки лицензии.Demo-признак может менять только:
boss.Роль определяется по базовому шаблону, а не по отображаемому названию.
Режим настройки может менять только Drupal site administrator.
Все грязные вещи и готовые заказы в demo-чистомате оформляются на клиента:
АгбисDemo+71111111111Если телефон уже есть в AX, используется найденный CONTR_ID, а локальный AX ID обновляется. Если телефона нет, клиент создается через существующий механизм поиска и создания AX-клиента.
В публичном QR-сценарии demo-чистомат не спрашивает телефон клиента. Сдача сразу привязывается к demo-клиенту.
Операторское размещение грязных вещей в demo-чистомат также игнорирует введенный телефон и использует demo-клиента.
При размещении готового заказа в demo-чистомат локальный заказ и AX-события привязываются к demo-клиенту независимо от данных исходного клиента заказа.
В интерфейсе курьера показывается demo-клиент, чтобы исходные данные клиента не выглядели владельцем заказа в demo-чистомате.
Перед replay очередь повторно проверяет demo-клиента по телефону 71111111111 и подставляет текущий CONTR_ID.
Для команд используются стабильные ключи:
locker-load:dirty:<order_id>locker-load:ready:<order_id>ready-placement:<firm_id>:<doc_num>:<cell_id>resolve-demo-client:<firm_id>:71111111111Drupal не должен ставить повторную pending-команду с тем же ключом. Полная идемпотентность в AX требует поддержки request_id на стороне Agent для ADD_LOCKER_LOAD_EVENT и PLACE_READY_ORDER_IN_LOCKER.
Выключение временно блокирует рабочие сценарии чистомата без удаления записи и без изменения поля status.
disabled = 1 означает, что чистомат временно не работает.status не меняется и по-прежнему отвечает только за видимость/активность записи.disabled не синхронизируется в AX.public_token.Включить.Включать и выключать чистомат может только пользователь фирмы с базовым шаблоном роли boss. Проверка выполняется по шаблону роли, а не по отображаемому названию.
Drupal site administrator сохраняет административный доступ.
Выключение блокируется понятным сообщением, если:
При переходе по QR выключенного чистомата клиент видит сообщение: Чистомат временно не работает. 404 и фатальная ошибка для этого случая не используются.
После включения обычный чистомат снова ожидает первый положительный ответ лицензии. До этого рабочие сценарии и AX-обмен не считаются доступными.
Demo-флаг и режим настройки не отменяют disabled. Режим настройки может обходить только проверку лицензии для невыключенного чистомата.