Диагностика терминала учёта смен

Автоматическая выгрузка журнала, проверка отказов и скачивание диагностики без USB

Как включается

Нужны сервер 2SKLAD 2.198.0 или новее и приложение «Учёт смен» 0.8.1, номер сборки 18 или новее. Установите обновление поверх прежнего APK, не удаляйте приложение и не очищайте его данные: привязка и локальные события нужны для диагностики. После обновления откройте приложение; повторная привязка не нужна.

Журнал отправляется автоматически вместе с обычной синхронизацией: после действий сотрудника, раз в две минуты на активном экране и через Android WorkManager в фоне (интервал от 15 минут, система может откладывать работу). При выключенном устройстве, отсутствии интернета или принудительно остановленном приложении отправка не выполняется. После восстановления связи/запуска записи передаются повторно. Можно нажать «Синхронизировать сейчас» в настройках терминала.

При первом запуске версии 0.8.1 создаётся диагностический снимок последних 1000 локальных событий смен за семь дней. Он включает ожидающие, принятые, отклонённые события и серверные зеркала. Это позволяет разобрать сбой, возникший до обновления. Старый текстовый журнал распознавания лиц целиком не отправляется.

Где читать журнал

1. Откройте «Учёт смен → Терминалы» на сайте.
2. У нужного терминала нажмите «Журнал».
3. Укажите даты получения записей сервером и, при необходимости, сотрудника. Нажмите «Показать». Даты и отображаемое время — по Москве.
4. Сравните время на устройстве и время получения сервером. При отсутствии связи между ними может быть большой промежуток.
5. В данных видны этап синхронизации, ID события и смены, локальное/серверное состояние, ответ и нормализованная причина отказа. Например, already_open означает отказ начать ещё одну смену при уже открытой на сервере.
6. За один раз показывается до 500 записей. «Более ранние» открывает следующую страницу. «Скачать показанные JSON» сохраняет только текущую страницу с выбранным отбором для разбора службой поддержки.

Пустой журнал не доказывает отсутствие действий сотрудника: проверьте версию приложения, связь, привязку, работу фоновой синхронизации и даты получения. Общие ошибки синхронизации без ID сотрудника видны при выборе «Все». Журнал доступен сотрудникам с правом просмотра раздела «Учёт смен» своей компании. Терминал может только передавать свой журнал, а не читать административный раздел.

Что хранится и чего журнал не делает

• Передаются только структурированные поля событий и синхронизации. Токены, PIN, фразы биометрии, фотографии, шаблоны лиц и свободный текст HTTP-ответов не передаются. ФИО в веб-журнале подставляется из справочника сотрудников склада.
• На устройстве очередь ограничена 5000 диагностических записей. При длительном отсутствии сети самые старые диагностические записи вытесняются. Сами события смен из EventStore при этом не удаляются.
• На сервере журнал хранится 14 дней с момента получения, максимум 20 000 записей на терминал. Старые записи очищаются автоматически.
• Повторная отправка подтверждается без дублей. Сбой загрузки диагностики не отменяет и не проводит смену и не пересчитывает рабочее время.
• Установка диагностической версии сама по себе не исправляет ранее неверно учтённую смену. По журналу администратор проверяет ситуацию, а правка смены выполняется отдельно с причиной, по обычным правилам учёта.

Если смена уже закрыта на сервере, но терминал считает её открытой

Установите сервер 2.199.0 или новее, затем APK 0.8.2, сборка 19 или новее поверх прежнего приложения. Откройте терминал и нажмите «Синхронизировать». Обновление сверит локальные смены с сервером; ожидающие отправки отметки и история сохранятся. Повторная привязка и очистка данных не нужны.

Если связь отсутствует, действие показывает «Ожидает отправки». Подтверждение «Смена начата» или «Смена завершена» относится к ответу сервера именно на это действие. При отказе повторите распознавание для свежего состояния; если ситуация неясна, откройте журнал терминала и обратитесь к администратору.

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