Довідка: Завантаження

Огляд

Екран "Завантаження" призначений для сканування штрихкодів посилок при завантаженні товарів у транспортний засіб за маршрутом. Дозволяє відстежувати прогрес завантаження, сортувати клієнтів за відстанню, керувати порядком клієнтів та зберігати прогрес сканування.

📋 Структура екрана

Екран складається з двох основних частин:

1. Екран вибору маршруту

• Список маршрутних листів — вибір маршруту для завантаження

• Фільтр за датами — вибір періоду для відображення маршрутів

• Вибір міста — встановлення міста для розрахунку відстаней

2. Екран завантаження клієнтів

• Список клієнтів — клієнти маршруту з документами для завантаження

• Панель сканування — інтерфейс для сканування штрихкодів

• Прогрес сканування — відстеження відсканованих місць

• Сортування клієнтів — автоматичне та ручне сортування

📄 Екран вибору маршруту

Список маршрутних листів

Екран відображає список маршрутних листів, доступних для завантаження:

Елементи інтерфейсу:

• Список маршрутів — картки маршрутних листів з інформацією

• Кнопка оновлення — оновлення списку маршрутів

• Кнопка вибору міста — встановлення міста для розрахунку відстаней

Дії:

• Тап по маршруту — відкриває екран завантаження для вибраного маршруту

• Оновлення списку — завантаження актуальних маршрутів з сервера

Особливості:

• Показуються тільки маршрути з документами типу "delivery" (доставка)

• Клієнти відображаються у зворотному порядку (останній клієнт першим)

• Автоматичний розрахунок відстаней до клієнтів при виборі маршруту

Вибір міста

Кнопка вибору міста дозволяє встановити місто за замовчуванням для розрахунку відстаней:

Функції:

• Вибір міста — вибір зі списку українських міст

• Скидання міста — повернення до використання поточної GPS позиції

• Збереження в профілі — вибране місто зберігається в налаштуваннях профілю

Пріоритет розрахунку відстаней:

1. Місто з профілю (якщо встановлено)

2. Поточна GPS позиція (якщо доступна)

📦 Екран завантаження клієнтів

Заголовок екрана

У заголовку відображається:

• Номер маршруту — номер маршрутного листа (тільки цифри)

• Статистика документів — загальна кількість документів у маршруті

• Прогрес сканування — кількість відсканованих штрихкодів / загальна кількість

Кнопки в заголовку:

• Скидання сортування — повернення до автоматичного сортування за відстанню (показується тільки при ручній перестановці)

• Скидання прогресу — очищення всіх відсканованих штрихкодів

• Вибір міста — зміна міста для розрахунку відстаней

Панель сканування

Панель сканування відображається залежно від вибраного режиму:

Режим камери

• Індикатор режиму — синя панель з іконкою камери

• Прогрес — кількість відсканованих / загальна кількість

• Підказка — "Натисніть кнопку знизу"

• Кнопка сканування — плаваюча кнопка внизу екрана

Режим клавіатури

• Індикатор режиму — помаранчева панель з іконкою клавіатури

• Поле введення — текстове поле для введення штрихкоду

• Кнопка відправки — кнопка для обробки введеного коду

• Автофокус — поле автоматично отримує фокус при відкритті екрана

Режим Broadcast

• Індикатор режиму — зелена панель з іконкою Wi-Fi

• Підказка — "Використовуйте зовнішній сканер"

• Автоматична обробка — штрихкоди обробляються автоматично при скануванні

Список клієнтів

Список клієнтів відображається у вигляді карток з можливістю перетягування:

Інформація в картці клієнта:

• Номер за порядком — червоний кружок з номером (від дальнього до ближнього)

• Ім'я клієнта — назва клієнта

• Телефон — номер телефону клієнта (якщо вказано)

• Адреса — адреса клієнта

• Відстань — відстань до клієнта (якщо розраховано)

• Прогрес завантаження — кількість відсканованих місць / загальна кількість місць

• Прапорець повернення — іконка повернення (якщо є документи повернення)

Кольорова індикація карток:

• Біла — клієнт без документів або без відсканованих місць

• Синя — частково відскановано (є відскановані місця, але не всі)

• Зелена — повністю відскановано (всі місця відскановані)

Документи клієнта:

• Номер накладної — номер документа

• Коментар — коментар до документа (якщо є, відображається червоним)

• Прогрес документа — кількість відсканованих штрихкодів / загальна кількість

Кольорова індикація документів:

• Сірий — документ без штрихкодів або без відсканованих

• Синій — частково відскановано

• Зелений — повністю відскановано

• Градієнт — для частково відсканованих документів

Сортування клієнтів

Автоматичне сортування

За замовчуванням клієнти сортуються автоматично:

• За відстанню — від дальнього до ближнього (від більшої відстані до меншої)

• Джерело відстаней — місто з профілю або поточна GPS позиція

• При завантаженні — сортування виконується при відкритті екрана

Ручне сортування

Користувач може змінити порядок клієнтів:

• Перетягування — утримуйте картку клієнта та перетягніть у потрібне місце

• Збереження порядку — ручний порядок зберігається автоматично

• Індикатор — помаранчева панель показує, що використовується ручний порядок

Скидання до автоматичного сортування:

• Кнопка сортування — натисніть іконку сортування в заголовку

• Відновлення — клієнти будуть відсортовані за відстанню від дальнього до ближнього

Сканування штрихкодів

Обробка відсканованих кодів

При скануванні штрихкоду виконується перевірка:

1. Перевірка дубліката — якщо штрихкод вже був відсканований:

• Відтворюється звук помилки

• Показується повідомлення "Це місце вже було відскановано!"

• Штрихкод не додається

2. Перевірка належності — якщо штрихкод не знайдено в документах маршруту:

• Відтворюється звук помилки

• Показується повідомлення "Штрихкод не відноситься до поточних накладних"

• Штрихкод не додається

3. Успішне сканування — якщо штрихкод валідний:

• Штрихкод додається до списку відсканованих

• Відтворюється звук успіху

• Оновлюється прогрес сканування

• Прогрес зберігається в локальне сховище

Звукові сигнали

• Успіх — короткий звуковий сигнал при успішному скануванні

• Помилка — довший звуковий сигнал при помилці

• Haptic feedback — вібрація пристрою при відсутності звукових файлів

Збереження прогресу

• Автозбереження — прогрес зберігається після кожного успішного сканування

• Відновлення — при повторному відкритті маршруту прогрес відновлюється

• Скидання прогресу — кнопка в заголовку дозволяє скинути весь прогрес

Логування сесій

Система автоматично логує сесії завантаження:

Початок сесії:

• Генерується унікальний ID сесії

• Відправляється інформація про маршрут, кількість місць, документів та штрихкодів

• Відправляється інформація про пристрій

Сканування:

• Логується кожне сканування з вказівкою:

• Штрихкод

• Режим сканування (камера/клавіатура/broadcast)

• Статус (success/duplicate/not_found)

• Інформація про пристрій

Завершення сесії:

• Сесія завершується при закритті екрана

• Відправляється інформація про завершення

Скидання прогресу:

• Логується скидання прогресу сканування

🔧 Додаткові функції

Вибір міста для розрахунку відстаней

Встановлення міста:

1. Натисніть кнопку вибору міста в заголовку

2. Виберіть місто зі списку

3. Відстані перераховуються автоматично

4. Місто зберігається в налаштуваннях профілю

Скидання міста:

1. Натисніть кнопку вибору міста

2. Виберіть "Скинути"

3. Буде використовуватися поточна GPS позиція

4. Відстані перераховуються автоматично

Пріоритет розрахунку:

• Якщо вибрано місто — використовується місто

• Якщо місто не вибрано — використовується GPS позиція

• Якщо GPS недоступний — відстані не розраховуються

Перерахунок відстаней

Відстані перераховуються в наступних випадках:

• При виборі нового міста

• При скиданні міста

• При зміні GPS позиції (якщо місто не вибрано)

Методи розрахунку:

• Batch-запит — основний метод (розрахунок для всіх клієнтів одразу)

• Fallback — резервний метод (індивідуальний розрахунок при помилці batch-запиту)

Скидання прогресу

Функція скидання:

• Очищає всі відскановані штрихкоди

• Видаляє збережений прогрес з локального сховища

• Логує скидання в систему

• Вимагає підтвердження перед виконанням

Коли використовувати:

• При помилці в скануванні

• При необхідності почати завантаження заново

• При зміні маршруту або клієнтів

⚠️ Важливі зауваження

Режими сканування

Режим камери:

• Вимагає дозвіл на використання камери

• Працює на будь-яких пристроях з камерою

• Натисніть кнопку сканування для активації камери

Режим клавіатури:

• Підходить для Bluetooth сканерів

• Сканер емулює введення з клавіатури

• Поле введення автоматично отримує фокус

Режим Broadcast:

• Для вбудованих сканерів (наприклад, Urovo)

• Сканер відправляє Android Intent

• Не вимагає додаткових дій від користувача

Фільтрація клієнтів

В екрані завантаження відображаються тільки клієнти:

• З документами типу "delivery" (доставка)

• Що мають хоча б один документ доставки

Клієнти без документів доставки не відображаються.

Збереження даних

Автоматичне збереження:

• Прогрес сканування зберігається після кожного успішного сканування

• Ручний порядок клієнтів зберігається при зміні

• Налаштування міста зберігаються в профілі

Відновлення даних:

• При повторному відкритті маршруту прогрес відновлюється

• Ручний порядок клієнтів відновлюється

• Місто з профілю завантажується автоматично

Продуктивність

Оптимізація:

• Використовується кешування стану карток клієнтів

• Оновлення UI тільки при зміні даних

• Batch-запити для розрахунку відстаней

Рекомендації:

• При великій кількості клієнтів може знадобитися час на розрахунок відстаней

• Використовуйте вибір міста для прискорення розрахунку відстаней

• Уникайте частого перемикання між маршрутами

📱 Використання

Початок завантаження

1. Відкрийте екран "Завантаження"

2. Виберіть маршрут зі списку

3. Дочекайтеся завантаження клієнтів та розрахунку відстаней

4. Почніть сканування штрихкодів

Сканування штрихкодів

Режим камери:

1. Натисніть кнопку сканування внизу екрана

2. Наведіть камеру на штрихкод

3. Дочекайтеся автоматичного розпізнавання

Режим клавіатури:

1. Наведіть сканер на штрихкод

2. Штрихкод автоматично введеться в поле

3. Натисніть Enter або кнопку відправки

Режим Broadcast:

1. Натисніть кнопку сканера на пристрої

2. Штрихкод обробиться автоматично

Зміна порядку клієнтів

1. Утримуйте картку клієнта

2. Перетягніть у потрібне місце

3. Порядок збережеться автоматично

Скидання до автоматичного сортування

1. Натисніть іконку сортування в заголовку

2. Клієнти будуть відсортовані за відстанню

Скидання прогресу

1. Натисніть кнопку оновлення в заголовку

2. Підтвердіть скидання прогресу

3. Всі відскановані штрихкоди будуть очищені

🎯 Поради з використання

1. Вибір міста — встановіть місто за замовчуванням для швидкого розрахунку відстаней

2. Перевірка прогресу — слідкуйте за прогресом в заголовку екрана

3. Кольорова індикація — використовуйте кольори карток для швидкої оцінки прогресу

4. Ручне сортування — використовуйте перетягування для оптимізації маршруту

5. Звукові сигнали — звертайте увагу на звуки для контролю сканування

6. Збереження прогресу — прогрес зберігається автоматично, можна закрити і повернутися пізніше

❓ Часті питання

П: Чому не відображаються відстані до клієнтів?

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

П: Чи можна змінити порядок клієнтів?

В: Так, можна перетягувати картки клієнтів для зміни порядку. Порядок зберігається автоматично.

П: Що робити, якщо відсканував неправильний штрихкод?

В: Використовуйте функцію "Скидання прогресу" для очищення всіх відсканованих штрихкодів і почніть заново.

П: Чи зберігається прогрес при закритті екрана?

В: Так, прогрес зберігається автоматично і відновлюється при повторному відкритті маршруту.

П: Чому деякі клієнти не відображаються?

В: В екрані завантаження відображаються тільки клієнти з документами типу "delivery" (доставка).

П: Як вибрати режим сканування?

В: Режим сканування вибирається в налаштуваннях додатку (Налаштування → Режим сканера).

🔗 Пов'язані розділи

• Маршрутні листи — робота з маршрутами

• Сканування — налаштування режимів сканування

• Налаштування — налаштування додатку