Кодовый Чистомат это устройство для автоматического приема и выдачи заказов химчистки, прачечной. Конструктивно он представляет собой шкаф с ячейками, дверки которого оборудованы автономными кодовыми замками, работающими от батареек.
Шкаф с кодовыми замками клиент изготавливает самостоятельно, специалисты Агбис будут рады помочь с выбором конструкции шкафа и кодовых замков. Шкаф может быть любого размера, с любым количеством ячеек, из любого материала, все зависит от потребностей владельца. Кодовые замки должны поддерживать возможность изменения кода открытия замка вводом мастер-кода.
Кодовый Чистомат выполняет функции приемного пункта для клиентов химчистки, прачечной:
Для осуществления этих функций реализованы операции, выполняемые сотрудником (курьером):
Сам Кодовый чистомат не подключается ни к электросети, ни к сети Интернет. Взаимодействие клиентов и сотрудников с кодовым Чистоматом осуществляется посредством смартфона или компьютера через онлайн систему «Агбис Чистоматы».
Если на смартфоне клиента или сотрудника отсутствует Интернет, работа с кодовым Чистоматом возможна через оператора по телефону.
Информирование клиента об изменениях статуса заказа, передача ссылки на оплату заказа осуществляется посредством сообщений в СМС или мессенджере.
Кодовый Чистомат не оборудуется терминалом оплаты, информационным экраном. Поэтому в нем невозможно принимать оплату банковскими картами или показом на экране QR кода для оплаты.
Оплата заказа клиентом производится через Интернет переходом по ссылке, присылаемой в сообщении о подтверждении заказа. Это сообщение формируется после доставки заказа из Чистомата в цех химчистки и оформления заказа в системе Агбис Химчистка.
Ниже описана работа в системе «Агбис Чистоматы» для различных ролей пользователей.
На странице Работа -> Панель управления отображаются основные показатели выбранной фирмы:
Для показателей Передано в чистку и Выдано клиентам период выбирается отдельно: неделя, месяц или год. Неделя начинается в понедельник, время рассчитывается в часовом поясе фирмы. Название чистомата в таблице является ссылкой на его ячейки.
В блок Быстрые действия можно добавить до шести доступных пользователю операций. Для настройки нажмите +.
Клиент открывает публичную страницу конкретного чистомата сканированием QR-кода, размещенного на Чистомате. На первом экране отображается адрес чистомата и предлагается выбрать действие: Сдать вещи или Получить вещи. Если в настройках фирмы загружен логотип, он выводится сверху по центру на всех публичных страницах.
Тексты над и под основными блоками публичных страниц настраиваются в фирме. Допускается HTML-форматирование. Отдельные тексты предусмотрены для стартовой страницы, сдачи вещей, отсутствия свободных ячеек, ввода телефона при получении, готовых заказов и отсутствия готовых заказов.
Путь: Фирма и доступ -> Настройки фирмы. Основные тексты публичных страниц находятся в свернутых блоках. Дополнительные адреса и контакты находятся в свернутом блоке Публичные QR-ссылки, контакты и политика конфиденциальности:
Все ссылки необязательны. Заполненное поле должно содержать HTTPS-адрес без логина и пароля. Пустая или некорректная ссылка не публикуется. Система не создает юридические документы и не подставляет адреса: администратор указывает только утвержденные фирмой ссылки.
Настройки Отправлять СМС после забора грязных вещей курьером и Отправлять СМС о готовности заказа после сессии курьера по умолчанию выключены. Первая отправляет сообщение после фактического извлечения грязной вещи. Вторая обрабатывает только готовые заказы, помещенные во время завершенного визита курьера. Транспортная ошибка Agent сохраняет подготовленную команду в очереди со стабильным идентификатором; незавершенное размещение в AX или ошибка подготовки СМС для готового заказа оставляет отметку для ручной отправки оператором.
Номер телефона вводится в формате, настроенном для фирмы. По умолчанию используется формат +7XXXXXXXXXX. После ввода система показывает экран подтверждения. Если номер указан неверно, клиент нажимает Изменить номер телефона и вводит его заново.
Результаты получения доступны только для номера, подтвержденного в текущей QR-сессии. Для защиты от перебора по умолчанию разрешены три подтвержденных поиска на идентификатор браузера за 15 минут и 60 поисков на IP-адрес за один час. Повторное открытие уже разрешенного результата в пределах 15 минут не расходует новую попытку. При превышении лимита система предлагает повторить позже.
Если из-за отсутствия интернета страница чистомата в браузере клиента не открывается, воспользоваться чистоматом можно, позвонив оператору по номеру телефона, размещенному на Чистомате. В этом случае всю информацию, которая необходима для сдачи или получения заказа, оператор запрашивает у клиента по телефону, после чего оператор называет ему номер ячейки и код замка.
После выдачи ячейки система создает заказ на сдачу вещи и переводит ячейку в красный статус, чтобы она больше не выдавалась другим клиентам.
Экран выбора типа вещи появляется не всегда:
Если ячейка требуемого размера занята, система может выдать свободную ячейку большего размера. Из подходящих свободных ячеек выбирается наименьший достаточный размер с учетом настроенного приоритета размеров.
Если в чистомате нет подготовленных свободных ячеек, клиент видит сообщение об отсутствии доступных ячеек и не может продолжить сдачу.
Если типы вещей настроены, но ни для одного типа нет подходящей ячейки, система сообщает, что нет подготовленных ячеек для настроенных типов вещей.
При обычном обновлении этой страницы доступность ячеек проверяется повторно. Если подходящая ячейка появилась, клиент возвращается к началу QR-сценария и может продолжить сдачу без повторного сканирования кода.
Для фирмы можно задать максимальное количество одновременных сдач одного клиента в одном чистомате. В лимит входят только заказы клиента, ожидающие обработки. Готовые заказы в ячейках в этот лимит не входят.
Если лимит достигнут, после ввода телефона система выводит соответствующее сообщение. Продолжить сдачу можно после обработки предыдущих вещей курьером или оператором.
Если лимит позволяет и остались подготовленные ячейки, клиент может нажать Сдать еще одну вещь?. Телефон повторно вводить не нужно. Система возвращает клиента к выбору типа вещи либо сразу выдает следующую ячейку, если выбор типа не требуется.
Если номер телефона ранее не был найден, после первой сдачи может открыться форма знакомства. Клиент указывает фамилию, имя и, при наличии, отчество. Можно отправить данные, сдать еще одну вещь или завершить сценарий без заполнения ФИО.
Форма содержит два обязательных, изначально отмеченных согласия: на обработку персональных данных и на ознакомление с политикой конфиденциальности и пользовательским соглашением. При настроенных HTTPS-ссылках названия документов открываются в новой вкладке. Без настроенных ссылок обязательный текст остается без переходов. Отправить форму можно только при включенных двух отметках; отдельная запись о согласии не сохраняется.
Если для чистомата настроен активный опрос после сдачи, на финальном экране появляется ссылка Пройти опрос. Опрос не блокирует завершение сдачи, а ответы хранятся отдельно от заказа.
Текст завершения настраивается в фирме. Значение по умолчанию: Спасибо. Ваши вещи размещены в чистомате. На этой странице могут отображаться настроенные фирмой кнопки сайта и приложения, а также ссылки ВКонтакте, Одноклассники и MAX; пустые настройки не выводятся. При включенной настройке после забора сданных вещей курьером клиенту отправляется информационная СМС с номером пломбы. Ошибка отправки не блокирует работу курьера; при временной недоступности Agent команда сохраняется в очереди со стабильным идентификатором.
1111 без СМС с кодом. При выключённой настройке этот шаг пропускается.При открытии страницы результата система уже отмечает оплаченные готовые заказы выданными и освобождает ячейки, до фактического открытия дверцы. Отдельной кнопки завершения в QR-сценарии нет. Один номер ячейки показывается только один раз. Если дверца не открылась или вещь не удалось забрать, нужно обратиться к сотруднику с номером заказа, чистомата и ячейки; повторный просмотр страницы не возвращает заказ в готовые.
Ссылка /locker/link/... открывает отдельную страницу готовых заказов и не требует кода получения. Сначала клиент вводит последние четыре цифры телефона, указанного в заказе; до успешной проверки список чистоматов и сведения о заказах не показываются. Если чистоматов несколько, клиент выбирает нужный. Для оплаченного заказа показываются номер ячейки и код замка; для неоплаченного — только сообщение об оплате. После физического получения и закрытия дверцы клиент нажимает Завершить для одного заказа или Готово для нескольких. Защищённое действие повторно проверяет состояние и только тогда отмечает выдачу. После успешного завершения список может стать пустым и показать, что готовые заказы не найдены.
Если в текущем чистомате нет готовых заказов для введенного телефона, система выводит соответствующее сообщение. Если готовые вещи есть в других чистоматах этой фирмы, дополнительно показываются их адреса.
После записи выдачи ячейка переводится в желтый статус, код замка и номер пломбы очищаются, а событие записывается в Работа -> История. Прежняя связь заказа с ячейкой остаётся в истории.
Если для чистомата настроен активный опрос после получения, рядом с результатом появляется ссылка Пройти опрос. Опрос не блокирует получение вещи.
Для последних четырех цифр телефона действуют отдельные ограничения СМС-ссылки: не более пяти попыток на браузер и пяти попыток на конкретную ссылку за 15 минут, а также не более 100 попыток с одного IP-адреса за час. Эти лимиты не расходуют бюджет подтвержденных поисков в QR-сценарии.
Курьер открывает раздел Работа -> Курьер, выбирает чистомат и проходит этапы строго по порядку:
Служебные ячейки курьером не обрабатываются. При пропуске рабочей ячейки курьер указывает причину длиной не менее восьми символов. После размещения всех готовых заказов он выбирает Больше нет готовых заказов, выполняет остальные обязательные проверки и завершает визит. Если были забраны сданные вещи, соответствующая накладная переводится в статус В пути. При включённой настройке СМС о готовности после завершения визита отправляется для размещённых в этом визите заказов; отправка при повторном размещении наблюдалась на локальном TEST.
Для фиолетовой ячейки курьер сверяет заказ и выбирает Возврат вещей на фабрику, затем сохраняет действие один раз. На локальном TEST заказ WEB перешёл в состояние На хранении (8), ячейка стала жёлтой и свободной, а прежняя связь с ней сохранилась в карточке как история. Заказ AX при этом остался готовым (4); создана отдельная исходящая накладная готового заказа KIND=0, без смешения с накладной грязных вещей. После подготовки пустая ячейка снова стала зелёной. Завершение визита не приняло и не продублировало исходящую накладную.
После приёмки этой накладной на фабрике и оформления новой входящей накладной для того же заказа курьер повторно разместил его в зелёной ячейке. WEB обновил ту же карточку На хранении → Готов к выдаче (8 → 4), без второй карточки; новая ячейка стала фиолетовой. Размещение и завершение визита подтверждены на локальном TEST. Офлайн-повтор, действия оператора по забору и курьерский вариант Клиент забрал в этом сценарии не проверены.
Раздел Настройка чистоматов -> Ячейки позволяет:
Для помеченного готового заказа рядом с телефоном в фиолетовой ячейке отображается ссылка отправить смс о заказе. Она открывает отдельное окно подтверждения. После успешной отправки или надежной постановки подготовленной команды в очередь отметка снимается.
В журнале ячеек колонка Время в статусе (ч.) показывает количество полных часов с момента последнего изменения статуса. Служебная ячейка выделяется серым цветом, не участвует в счетчиках и метриках, не попадает в список Требуют внимания и недоступна клиенту, оператору и курьеру для размещения заказа.
Код генерируется при открытии действия подготовки и при сохранении не меняется повторно. При необходимости курьер может изменить код отдельным действием. Активные коды не повторяются внутри одного чистомата.
Перед использованием необходимо:
В списке чистоматов отображаются название, адрес, состояние ячеек и активность. Операции позволяют редактировать чистомат, удалить запись при отсутствии заказов в ячейках, добавить ячейки, добавить заказ и открыть QR-ссылку.
В форме чистомата настраиваются название, номер, внешний SCLADS.ID, склад назначения AX, публичный QR-токен, адрес, заметки, активность и поведение опросов.
В списке ячеек доступны фильтры по чистомату, номеру пломбы, телефону клиента, статусу, нарушению упаковки и признаку Требуют внимания.
Флажок Служебная ячейка резервирует ячейку для внутреннего хранения. Такая ячейка остается в списке и выделяется серым цветом, но не учитывается в метриках, цветовых счетчиках и списке проблемных ячеек. Ее пропускает сценарий курьера; она недоступна клиентам по QR и не используется для размещения заказов оператором или курьером.
Колонки списка: чистомат, номер ячейки, размер ячейки, номер пломбы, код замка, телефон клиента, проблема упаковки, время в статусе и операции.
Операции:
При ручном размещении оператор обязательно указывает телефон клиента и выбирает тип размещения: сданные вещи или готовый заказ. Телефон проверяется по настройкам фирмы; клиент ищется или создается по тем же правилам, что и в QR-сценарии. Для готового заказа при наличии права можно сразу отправить СМС о готовности.
Размер описывает физическую вместимость ячейки. Поле Вместимость используется для замещения размеров: если для типа вещи требуется маленькая ячейка, а маленьких подготовленных ячеек нет, система может выдать среднюю или большую ячейку.
Размер назначается конкретным ячейкам в разделе Ячейки и начинает влиять на клиента через связь с типом вещи.
Типы вещей определяют варианты, которые клиент может выбрать при сдаче через QR-сценарий. Если типов нет, шаг выбора пропускается. Если доступен один тип, он выбирается автоматически. Если типов несколько, клиент выбирает подходящий вариант.
Клиенту показываются только типы, для которых есть зеленая не удаленная ячейка разрешенного размера. После выбора система подбирает самую маленькую подходящую ячейку, затем учитывает приоритет и номер ячейки.
Связь определяет минимальный размер ячейки для выбранного типа вещи. Если вещь помещается в маленькую ячейку, достаточно настроить связь с маленьким размером: при отсутствии маленьких свободных ячеек система сможет выдать среднюю или большую.
Рекомендуемый порядок настройки:
Перед первой настройкой ролей и пользователей выполните синхронизацию:
Синхронизируются чистоматы, ячейки, размеры, типы вещей, связи типов с размерами и пользователи AX. При временной недоступности агента действия сохраняются локально и ставятся в очередь. После восстановления связи очередь передается в AX.
Роли необходимо создать до добавления пользователей фирмы. Импортированные пользователи AX отображаются в разделе Фирма и доступ -> Пользователи.
Путь: Фирма и доступ -> Шаблоны ролей.
Пользователь с ролью Босс может создавать, редактировать и удалять собственные шаблоны своей фирмы. Системные шаблоны изменять нельзя, а шаблоны других фирм не отображаются. Изменения собственного шаблона применяются к связанным ролям. При удалении шаблона необходимо выбрать роль, которая заменит его у затронутых пользователей фирмы.
Путь: Фирма и доступ -> Роли -> Добавить роль фирмы.
Права доступа определяют реальный доступ. Если право выключено, страницу нельзя открыть даже по прямой ссылке.
Скрыть пункты меню управляет только отображением закрепленного меню и не выдает права. Если в группе нет доступных видимых пунктов, вся группа скрывается.
В настройках роли также можно выбрать видимые пункты пользовательской документации и изменить порядок их отображения. Скрытие родительского раздела автоматически скрывает дочерние пункты, поэтому состояние настроек остается однозначным.
Стартовая страница должна быть разрешена выбранной роли, иначе после входа пользователь увидит запрет доступа.
Пункты Фирмы и Добавить фирму не назначаются ролям фирмы. Они доступны только администраторам сайта и служебному пользователю AX с логином Agbis или Агбис. Раздел Сервис и пункт документации для администратора сайта доступны только системному администратору сайта.
Право Отправка СМС о заказах разрешает операцию Отправить СМС о заказах в списках заказов и клиентов. Перед отправкой система повторно проверяет ID клиента в AX по номеру телефона и при необходимости обновляет локальные данные.
Путь: Фирма и доступ -> Фирмы -> Редактировать.
Роль по умолчанию необязательна, если каждому пользователю назначена персональная роль. Она используется только в автоматических сценариях, когда система уже определила пользователя и должна выдать стандартный набор прав фирмы.
Если роль по умолчанию не задана, существующие пользователи продолжают работать по персональным ролям, а пользователь без назначенной роли не получает доступ автоматически.
Путь: Фирма и доступ -> Пользователи -> Добавить пользователя фирмы.
Пользователь вводит:
Список фирм на форме входа не показывается. По ID определяется активная фирма. Агент ищет активного пользователя этой фирмы сначала по точному логину, затем по полному нормализованному номеру телефона.
Доступ разрешается, только если пользователь AX найден в пользователях фирмы, его запись активна и ему назначена активная роль. В противном случае система запрещает вход и предлагает обратиться к администратору.
Пользователь AX с логином Agbis или Агбис входит как администратор сайта без назначения роли фирмы. Успешные и неуспешные входы, IP-адрес, а также нажатие Выход записываются в Работа -> История.
Над заполненными административными таблицами доступны кнопки Экспорт CSV и Экспорт XLSX. В файл попадают строки текущего представления с учетом фильтров и сортировки. Служебные колонки операций и подробностей не экспортируются. Если таблица разбита на страницы, каждую страницу нужно экспортировать отдельно.
CheckAppLic.public_token чистомата: device_id=<public_token>, app_id=CB.0.has_license=0, AX-команды чистомата остаются в очереди.license_last_success_at меняется только при положительном ответе.disabled=1 всегда блокирует работу.Если лицензия неактивна, обмен с AX ведет себя как при недоступном агенте: локальное действие допускается только в существующем offline-режиме, а команда сохраняется в очереди.
Очередь изолирована по чистоматам: license-defer или ошибка одной машины не останавливает строки других машин. Для одной машины сохраняется порядок FIFO; фирменная команда без machine_id по-прежнему может остановить общую очередь фирмы.
После восстановления лицензии выполняется полная синхронизация машины и ячеек с AX. Состояние восстановления снимается только после успешной синхронизации обеих частей; затем выполняется штатный replay очереди.
Демонстрационный чистомат используется для проверки клиентских сценариев без рабочей лицензии.
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-чистомат показывает +71111111111; сдача всегда привязывается к demo-клиенту.
Операторское размещение сдаваемых вещей в demo-чистомат также игнорирует введенный телефон и использует demo-клиента.
При размещении готового заказа в demo-чистомат локальный заказ и AX-события привязываются к demo-клиенту независимо от данных исходного клиента заказа.
В интерфейсе курьера показывается demo-клиент, чтобы исходные данные клиента не выглядели владельцем заказа в demo-чистомате.
При получении по QR любой введённый телефон также заменяется на +71111111111. При выключённой настройке кода получения дополнительной проверки нет. При включённой настройке используется demo-код 1111 без проверки телефона/заказа в AX и без СМС с кодом. Это не код замка ячейки.
Подписанная СМС-ссылка на готовые заказы формируется и отправляется отдельно на +71111111111; факт доставки зависит от СМС-шлюза.
Скрытое поле телефона оператора для demo-чистомата является штатным поведением: backend всегда подставляет 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.
disabled=1 означает, что чистомат временно не работает.status не меняется и по-прежнему отвечает только за видимость/активность записи.disabled не синхронизируется в AX.public_token.Включать и выключать чистомат может только пользователь фирмы с базовым шаблоном роли boss. Проверка выполняется по шаблону роли, а не по отображаемому названию.
Drupal site administrator сохраняет административный доступ.
Выключение блокируется понятным сообщением, если:
При переходе по QR выключенного чистомата клиент видит сообщение: Чистомат временно не работает. 404 и фатальная ошибка для этого случая не используются.
После включения обычный чистомат снова ожидает первый положительный ответ лицензии. До этого рабочие сценарии и AX-обмен не считаются доступными.
Demo-флаг и режим настройки не отменяют disabled. Режим настройки может обходить только проверку лицензии для невыключенного чистомата.
Во время поиска заказа, выдачи ячейки, сохранения настроек или обмена с AX экран показывает выполняемое действие. Дождитесь результата и не нажимайте повторно. Если связь прервалась, сначала проверьте карточку заказа и историю; физическую операцию не повторяйте без проверки.
Выбранная для размещения ячейка временно бронируется. Если её уже выбрал другой сотрудник, используйте другую предложенную свободную ячейку. При сообщении об истёкшей брони обновите выбор и подтвердите новую ячейку до размещения вещей.
В разделе Работа → Заказы журнал предназначен для просмотра. Используйте фильтры по телефону, имени клиента и части номера пломбы. Описание заказа отображается полностью. Изменяйте состояние через доступное действие ячейки или рабочий этап курьера. История показывает номер пломбы на момент события.
Введите телефон в формате фирмы и проверьте его на экране подтверждения. Для исправления выберите Изменить номер телефона. Если включён код получения по QR, для обычного Чистомата введите код подтверждения из сообщения, а для demo-Чистомата — фиксированный 1111 без СМС с кодом. При выключённой настройке проверки кода нет. Код получения — отдельный код, а не код замка ячейки. Подписанная ссылка из СМС не требует этого подтверждения. Номер ячейки и код замка выдаются только для оплаченных заказов. Если заказ не оплачен, оплатите его и повторите получение после обновления оплаты.
Если визит не закончен, используйте ссылку продолжения существующего визита. Не начинайте второй визит для той же незавершённой работы. Ограничение параллельных визитов задаёт фирма.
При временной недоступности AX допустимые действия сохраняются в очереди. Постановка в очередь не означает, что AX уже получил результат. После восстановления связи дождитесь синхронизации и проверьте состояние заказа. Не создавайте повторное размещение для уже сохранённого действия. При отметке о необходимости СМС оператор открывает её подтверждение и отправляет сообщение через штатное действие.
Сверьте номер ячейки и пломбу, затем выберите фактический результат проверки. Не отмечайте отсутствующие вещи как забранные. Сообщите оператору о расхождении. Текст сообщения клиенту об отсутствии вещей настраивает фирма; к нему автоматически добавляются номер ячейки и адрес чистомата.