https://crystals.atlassian.net/browse/SRTB-9935

https://crystals.atlassian.net/browse/CR-14524

10.4.21.0

Участились случаи длительного отсутствия связи с магазинами. В такие периоды данные о продажах не синхронизируются, что приводит к:

• Некорректной складской отчетности.

• Отсутствию данных для финансового анализа.

• Риску безвозвратной потери данных при сбое локального хранилища.

В версии 10.4.21.0 реализована функциональность, позволяющая персоналу магазина вручную выгружать данные на внешний USB-накопитель для последующей передачи в офис и импорта в центральную систему.

• Обеспечение бесперебойного сбора и передачи данных о продажах при отсутствии сетевого соединения.

• Устранение пробелов в отчетности для поддержания актуальности данных по всей сети.

• Снижение операционных рисков, связанных с простоем точек продаж из-за потери связи.

• Минимизация зависимости от качества каналов связи в удаленных локациях.

• Обеспечение резервного канала передачи данных без необходимости в сложной дополнительной инфраструктуре.

1. Инициация выгрузки

В функциональном меню кассы должна быть доступна функция «Выгрузить на USB».

2. Формирование данных

• Касса готовит к выгрузке неотправленные данные: чеки, Z/X-отчёты и транзакции лояльности.

• Данные формируются в файлы, соответствующие топикам Kafka.

• Для контроля целостности касса вычисляет хеш-сумму каждого файла.

3. Запись данных на USB

• Подготовленные файлы передаются на USB-накопитель.

• Файлы, успешно записанные на USB, помечаются на кассе статусом “отправлено в Kafka” и при появлении связи не выгружаются в Kafka.

• Данные передаются в зашифрованном виде с использованием симметричного шифрования.

• Во время передачи на экране отображается индикатор с сообщением “Идет сохранение документов”.

4. Обработка ошибок

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

5. Логирование

Все операции выгрузки фиксируются в логах с указанием меток времени, периода выгрузки, итогового статуса и описания возникших ошибок.

• Загрузка файлов производится в директорию /home/tc/storage/documents-upload/, которая содержит:

  • failed/ - проблемные файлы

  • sent/ - отправленные файлы

  • source/ - скопированные, но неотправленные файлы

Open

• Касса регулярно проверяет заданную директорию на наличие новых файлов (загруженных с USB или локального компьютера) для отправки в Kafka.

• Проверка выполняется только при активной настройке module_name=ESB_FILE_UPLOADER → property_key=enabled в таблице sales_management_properties (SMP).

  • Если enabled = true - проверка включена.

  • Если enabled = false - проверка отключена.

• При перезагрузке касса выполняет проверку указанной папки на наличие файлов, подлежащих выгрузке.

1. Инициация загрузки

В функциональном меню кассы должна быть доступна функция «Загрузить на кассу».

2. Запись данных с USB на кассу

• Касса проверяет хеш-сумму файлов.

• При совпадении хеша данные копируются на кассу.

• При несовпадении файл помечается как “проблемный” и перемещается в отдельную директорию. Такие файлы в Kafka не выгружаются.

• Во время загрузки на экране отображается индикатор “Идет загрузка документов“.

• Если были найдены проблемные файлы, по завершении загрузки появляется блокирующее сообщение: «Присутствуют проблемные файлы. Не удалось выгрузить [N] файлов.»

• Нажатие кнопки «Отмена» закрывает уведомление.

• Ограничение: Для выгрузки проблемных файлов требуется вмешательство сервисного инженера.

3. Передача невыгруженных файлов с кассы в Kafka

• Полученные и сохранённые файлы касса выгружает в Kafka.

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

Касса проверяет целевую директорию на наличие новых, невыгруженных файлов. При их обнаружении касса отправляет эти файлы в Kafka.

Для пользователя Старший кассир установлена привилегия Выгрузка данных о продажах.

1. На кассе авторизуется Старший кассир и подключает USB-накопитель к кассе.

2. Вызывает функцию меню Выгрузка данных о продажах → пункт Выгрузить на USB.

Open

4. Касса копирует данные на USB-накопитель и помечает их статусом “отправлено в Kafka”.

5. В процессе выгрузки на кассе отображается индикатор выполнения (спиннер).

Open

6. По завершении операции касса отображает сообщение “Документы выгружены“. Кассир извлекает USB-накопитель.

Open

1. На кассе авторизуется Старший кассир и подключает USB-накопитель к кассе.

2. Вызывает функцию меню Выгрузка данных о продаже → пункт Загрузить на кассу.

Open

3. Касса копирует с накопителя невыгруженные ранее файлы.

4. В процессе копирования на кассе отображается индикатор выполнения (спиннер).

Open

5. По завершении операции касса отображает сообщение “Документы загружены на кассу“. Кассир извлекает USB-накопитель.

Open

6. Касса отправляет полученные файлы в Kafka.

Попытка выгрузить или загрузить данные при неподключенном USB-накопителе.

Open

Отсутствие данных для выгрузки.

Open

Отсутствие данных для загрузки.

Open

Нехватка свободного места на USB.

Open

• При повторной выгрузке данных с одного и того же USB-накопителя в Kafka могут создаваться дублирующиеся сообщения.

• Для USB-накопителей используется файловая система FAT32.

• В текущей реализации (версия 10.4.21.0) касса выгружает только те файлы, которые ранее не были отправлены в Kafka. Документ помечается статусом «отправлено в Kafka» только после получения подтверждения о успешном приёме от Kafka.

• В текущей реализации (версия 10.4.21.0) для обработки и выгрузки файлов, помеченных как «проблемные», требуется вмешательство сервисного инженера.

  • Текущее поведение: При обнаружении на USB-накопителе битых файлов касса по завершении загрузки отображает уведомление: “Присутствуют проблемные файлы. Не удалось выгрузить [N] файлов.”

В разделе Персонал → Роли кассиров для требуемого кассового пользователя задайте привилегию Управление → Выгрузка данных о продажах → кликните Добавить к роли → кликните Сохранить.

Open

1. Перейдите в Кассовый модуль → кликните Шаблоны касс → откройте на редактирование требуемый шаблон клавиатурной кассы.

Open

2. Перейдите на вкладку ИНТЕРФЕЙС → нажмите РЕДАКТИРОВАТЬ КОНФИГУРАЦИЮ.

Open

3. Создайте новую группу кнопок → введите название, например, Выгрузка данных о продажах → кликните ПРИМЕНИТЬ.

Open

4. Перейдите в созданную группу.

Open

5. Назначьте функцию кассы Выгрузить на USB → кликните ПРИМЕНИТЬ.

Open

6. Назначьте функцию кассы Загрузить на кассу → кликните ПРИМЕНИТЬ.

Open

7. Созданные кнопки отобразятся в меню. Нажмите ПРИМЕНИТЬ.

Open

8. Кликните СОХРАНИТЬ → перезагрузите кассовый модуль.

Open

Open

1. В шаблоне кассы самообслуживания перейдите на вкладку ИНТЕРФЕЙС → нажмите НАСТРОЙКА МЕНЮ КОНСУЛЬТАНТА.

Open

2. Далее назначьте кнопки по инструкции для POS, начиная с п.3.

Open

3. После перезагрузки в меню консультанта отобразится добавленный блок кнопок.

Open

Для включения автоматической выгрузки документов в ESB из файлов после загрузки их на кассу выполните скрипт на сервере по базе данных set.

USB-накопитель монтируется автоматически при вызове функций «Выгрузить на USB» или «Загрузить на кассу».

Для проверки текущего статуса используется команда:

Возможные статусы:

• 0 - накопитель примонтирован

• 1 - накопитель подключен, но не примонтирован

• 2 - накопитель не подключен

Open

Информация о процессах выгрузки и загрузки сохраняется в файл document.log.

Пример содержимого лог-файла: