СМ Мобайл 3

Описание системы.

СМ Мобайл 3 предназначен для выполнения работ, связанных со сканированием штриховых кодов товаров или иных предметов, когда задание для работы формируется менеджерами организации, а работа выполняется сотрудниками с использованием ТСД или телефонов с ОС Андроид. Это может быть инвентаризация, контроль остатков, прием или отпуск товара и т.д.

Архитектурно СМ Мобайл 3 представляет собой  приложение для ОС Андроид и облачное приложение, которые взаимодействуют между собой по REST API протоколу с использованием защищенного соединения https . Облачное приложение работает в облачном пространстве (интернет среде) и обслуживается производителем приложения. Андроид приложение устанавливается на устройства организации и работает на территории организации.

Облачное приложение содержит только многоплатформенные компоненты c открытым исходным кодом: Node . js , Nginx, СУБД PostgreSQL .

В облачном приложении для организации выделяется личный кабинет или личное пространство, которое содержит структуры данных для формирования задания и для получения результатов выполнения задания от Андроид приложения. Облачное приложение имеет WEB интерфейс для работы с данными. Организация управляет личным кабинетом с использованием WEB интерфейса администратора. Заполняет его данными, для выполнения заданий, и заданиями, либо вручную, либо используя собственные системы уровня бэк-офис, например,  Супермаг+ или 1С. А также забирает в бэк-офис и обрабатывает в нем результаты выполнения заданий. Для заполнения кабинета данными такими, как списки артикулов и их описание, штриховые коды, перечень мест хранения, цены, остатки, задания и т.д., предоставляется соответствующий REST API протокол. Описание протокола находится в открытом доступе:

https://smmobile3.retail-soft.pro/docs/

WEB страница администратора облачного приложения доступна по URL :

https://smmobile3.retail-soft.pro/admin

Безопасность данных организации в облачном приложении.

Облачное приложение реализовано, как мультитенантное приложение, которое позволяет множеству организаций работать с одним облачным приложением так, как если бы оно было их персональным приложением. Изоляция данных организации обеспечивается добавлением ко всем данным закрытого идентификатора организации. Закрытый идентификатор организации формируется при регистрации организации и создании личного кабинета организации, никому не передается и используется только во внутренних процессах обработки данных. Одновременно с формированием закрытого идентификатора для организации генерируется криптостойкий ключ, который выдается ей при регистрации личного кабинета. Ключ организации используется при создании соединения к облачному приложению. Для обеспечения безопасности и защиты от стороннего взлома, ключ организации используется только при первом обращении при установлении соединения и в дальнейшем заменяется токеном с ограниченным сроком действия, по правилам протокола аутентификации OAuth 2.

Сочетание защищенного протокола обмена https и протокола аутентификации OAuth 2 гарантирует защиту от взлома методом «человек посередине» и защиту от несанкционированного доступа к данным при прямом обращении, способом подбора ключа.

В случае компрометации ключа организации для организации будет доступна блокировка личного кабинета, чтобы защитить свои данные от несанкционированного доступа. Отмена блокировки или замена ключа и перенос данных в новый личный кабинет может быть выполнена только силами организации, обслуживающей облачное приложение.

Непрерывность работы облачного приложения, сохранность данных (бэкап данных и восстановление), обновление и модификация облачного приложения обеспечивается организацией, обслуживающей облачное приложение.

Подготовка данных для работы.

Внимание! Интерфейсы, приведенные ниже, в дальнейшем могут быть изменены.

Сразу после создания личного кабинета организации, в личном кабинете отсутствуют какие-либо данные, и никакая работа оператора Андроид приложения невозможна. Для того чтобы получить доступ к WEB интерфейсу администратора системы и приступить к конфигурированию личного кабинета, для организации при создании личного кабинета автоматически создается должность «Администратор системы» и сотрудник « admin » с паролем « ChangePassword ». Для начала работы необходимо в браузере ввести URL :

https://smmobile3.retail-soft.pro/admin

ключ организации, логин и пароль администратора:

Пароль администратора после логина надо немедленно изменить.

При успешном логине при последующих входах ключ организации вводить не требуется, он запоминается в защищенной области и вместо него показывается название организации:

Должности и сотрудники.

Должности используются для группового управления ролями сотрудников. Сейчас существует две роли для сотрудников – администратор системы и оператор ТСД. Роль «Администратор системы» позволяет сотруднику настраивать систему,  используя WEB интерфейс. Роль «Оператор ТСД» позволяет выполнять задания с помощью программы ТСД. Кроме того, должности используются для того, чтобы можно было назначать задание не только персонально тому или иному сотруднику – оператору ТСД, но и группе сотрудников. Тогда задание может быть выполнено любым сотрудником из этой группы.

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

При дальнейшей работе идентификаторы должностей и сотрудников будут проставляться в задания, которые загружаются из стороннего источника. Сервер, на котором готовятся задания, должен иметь полную информацию о сотрудниках и должностях исполнителей заданий, и информация на сервере СМ Мобайл 3 должна быть точно такая же, за исключением административных должностей и сотрудников – администраторов системы. Администраторы системы не участвую в исполнении заданий, и информация о них может отсутствовать в бэк-офисе организации.

Места хранений.

Справочник мест хранений позволяет управлять заданиями в разрезе магазинов и складов. Код места хранения обязательно указывается в задании. Места хранения можно задавать в интерфейсе администратора и можно получить из внешней системы. Важным является синхронизация списков и кодов мест хранений в бэк-офисе организации и в базе сервера СМ Мобайл 3. Также важно не менять произвольно содержание кодов мест хранений, иначе результаты выполнения ранее созданных заданий будут ложными.

Типы заданий.

Типы заданий являются основным элементом для описания бизнес процесса сотрудника при выполнении задания, а также поведения Андроид приложения СМ Мобайл 3.

Название типа задания показывается сотруднику в задании и должно соответствовать смыслу выполняемой работы. Комментарий служит для пояснения сути типа задания и показывается только в WEB интерфейсе.

Описание типа задания выполняется только в интерфейсе администратора и не может быть загружено извне. Конфигурирование типа задания специфично функционалу Андроид приложения и его поведению и не может быть адекватно сформировано в третьей системе, но коды типов заданий должны быть проставлены в задания, которые формируются в бэк-офисе организации.

В текущей версии страница конфигурирования типа задания выглядит следующим образом:

Смысл и назначение опций типа задания будет описано в отдельном руководстве.

Задания.

Задание представляет собой указание сотруднику или группе сотрудников (должности) или всем сотрудникам выполнить ту или иную работу, например, провести инвентаризацию или прием поставки.

В задании можно указать ожидаемое время начала и окончания работы, чтобы оператор мог определиться с порядком выполнения заданий, если ему назначено несколько заданий.  В задании описываются все данные, которые необходимы для выполнения задания. В случае приема поставки это будет список заказанных артикулов и заказанное количество. Поскольку задание всегда относится к тому или иному типу задания, то тип задания определяет поведение оператора, например, можно ли превышать список артикулов или установлено ли ограничение на количество обрабатываемого товара и т.д.

(интерфейс для бэк-офиса Супермаг+)

При начале работы с заданием оператор ТСД отмечает задание, как взятое в работу, и эта отметка позволяет другим сотрудникам видеть, что работа уже выполняется. Если сотрудник по той или иной причине не может выполнить задание, он может от него отказаться, и тогда задание становится доступным для выполнения другим сотрудникам (если задание дано всем сотрудникам или сотрудникам одной должности).

Для задания всегда фиксируется время начала его фактического выполнения и завершения и сотрудник, выполнивший задание.

Результат выполнения задания, как правило, представляет собой журнал сканирования товаров. Это журнал может иметь интерпретацию в виде спецификации, то есть в виде свертки по артикулам, но с точки зрения хранимых данных результат работы это всегда журнал сканирования товаров. Этот журнал передается в облачное приложение по факту завершения выполнения задания и в дальнейшем может быть забран для обработки службой бэк-офиса организации.

ТСД.

При регистрации организации по соглашению с ней её может быть дано право на эксплуатацию некоторого количества устройств с Андроид приложением. В пределах этого количества организация имеет право зарегистрировать любые устройства, как имеющие право на выполнение заданий. Приложение на  устройствах, не зарегистрированных в системе, будет работать в демо режиме. Регистрация и разрегистрация устройства выполняется на самом устройстве в Андроид приложении сотрудником с правами администратора. Оператор ТСД такими правами не обладает.

В процессе регистрации устройство получает в системе регистрационный номер ( GUID ), с которым будет в дальнейшем работать. Администратор может контролировать перечень зарегистрированных устройств и их соответствие количеству разрешенных устройств:

В случае, когда устройство утеряно, не работоспособно или не доступно для разрегистрации, администратор может выполнить разрегистрацию в интерфейсе администратора. После разрегистрации никакие действия по выполнению задания или выгрузки результатов выполнения задания будут недоступны. Если на устройстве выполнялось задание, его результаты после разрегистрации устройства передать на сервер будет невозможно.