Як користуватися системою

Повний посібник з усіх функцій Rapid Ant

Огляд системи

Rapid Ant — це платформа для управління логістичними заявками всередині компанії. Система дозволяє створювати заявки на перевезення, призначати водіїв та транспорт, відстежувати виконання в реальному часі та аналізувати ефективність.

Ролі користувачів

Ініціатор

Основний автор заявок на перевезення. Бачить власні заявки та їхній статус. (Створювати заявки можуть усі ролі.)

Заявки, Нова заявка

Менеджер

Керує всіма заявками: призначає водіїв, змінює статуси, планує маршрути.

Заявки, Керування, Водії

Водій

Бачить призначені рейси, підтверджує зміну, виконує заявки.

Рейси

Комірник

Приймає вантаж на склад компанії та підтверджує фізичне отримання.

Склад

Керівник

Повний доступ: аналітика, команда, транспорт, графік, локації, контакти.

Аналітика, Команда, Транспорт, Графік, Локації, Контакти, Заявки, Керування

Сценарії заявок

У системі підтримуються три типи заявок. Кожен тип має власний сценарій руху вантажу, набір статусів та учасників. Нижче — візуальні схеми потоку.

Нижче — повний покроковий опис кожного сценарію: хто діє, яку кнопку натискає, у який статус переходить заявка, та хто отримує email та Telegram-сповіщення. Символ 📧📱 позначає одночасну відправку email + Telegram.

Отримання (pickup)

Зовнішній постачальник (магазин, відділення Нової Пошти, склад контрагента) → офіс/склад компанії. Фінальне підтвердження — комірник на складі компанії.

Приклад: компанія купила товар у Rozetka, водій забирає його з відділення Нової Пошти та привозить на власний склад.

PICKUP (Отримання) — зовнішня точка А → офіс компанії Б ① Створення — Ініціатор / Менеджер Status: new 📧📱 → менеджери, керівник ② Призначення — Менеджер обирає водія + авто Status: new → queued (авто) 📧📱 → водій (з кнопками) ③ Розпочати — Водій натискає "Розпочати" Status: queued → active 📧📱 → ініціатор ④ Забрав вантаж — Водій підтверджує забір у А Status: active → received_by_driver 📧📱 → ініціатор ⑤ Прибув на місце — Водій доставив на офіс компанії Status: received_by_driver → delivered_to_office 📧📱 → ініціатор + комірник (з кнопкою) ⑥ Прийнято — Комірник підтверджує прийом Status: delivered_to_office → done (авто) 📧📱 → ініціатор
1
Створення заявкиІніціатор або Менеджер

На сторінці Нова заявка обирає тип Отримання. Адреса А — зовнішня (магазин чи відділення), Адреса Б — офіс або склад компанії. За потреби одразу прикріпляє фото або ТТН у формі. Натискає Створити заявку. Статус: Нова. Сповіщення (email + Telegram, тип created або urgent залежно від пріоритету) — всім менеджерам і керівникам компанії.

2
Призначення водіяМенеджер

На Керування відкриває заявку, у панелі призначення обирає водія + транспорт. Статус автоматично змінюється на В черзі. Водій отримує email + Telegram (тип assigned) — у Telegram з кнопками ▶️ Розпочати / ℹ️ Деталі / Відкрити в застосунку.

3
Старт рейсуВодій

На Рейси бачить призначену заявку. Може натиснути Деталі щоб переглянути повні дані перед стартом. Готовий — натискає Розпочати. Статус: В черзі В роботі. Ініціатор отримує email + Telegram (тип started).

4
Забір вантажуВодій

Водій приїхав до постачальника, отримав вантаж. Натискає Забрав вантаж у застосунку (або 📦 Забрав вантаж у Telegram-боті). Статус: В роботі У водія. Ініціатор отримує email + Telegram (тип picked_up).

5
Прибуття на офісВодій

Привіз товар на склад. Натискає Прибув на місце. Статус: У водія Доставлено. Сповіщення ініціатору (тип arrived) + окреме email + Telegram усім комірникам компанії з кнопкою 📥 Прийняти на склад у чаті.

6
Прийом складомКомірник

На Склад бачить заявку у секції Очікує приймання, перевіряє вантаж, натискає Прийнято на склад. Статус: Доставлено Прийнято складом → автоматично Виконано. Ініціатор отримує фінальне email + Telegram (тип received — «Прийнято складом»).

Відправка (shipment)

Офіс компанії → зовнішній отримувач (клієнт, Нова Пошта, кур'єр). Складу на фінальній точці немає — заявка закривається одразу після доставки.

SHIPMENT (Відправка) — офіс компанії А → зовнішня точка Б ① Створення — Ініціатор / Менеджер Status: new 📧📱 → менеджери, керівник ② Призначення — Менеджер обирає водія + авто Status: new → queued (авто) 📧📱 → водій (з кнопками) ③ Розпочати — Водій натискає "Розпочати" Status: queued → active 📧📱 → ініціатор ④ Забрав зі складу — Водій підтверджує забір у А Status: active → received_by_driver 📧📱 → ініціатор ⑤ Доставлено — Водій віддав отримувачу Status: received_by_driver → delivered_to_office → done (авто) 📧📱 → ініціатор
1
Створення заявкиІніціатор або Менеджер

Обирає тип Відправка. Адреса А — офіс компанії, Адреса Б — отримувач (клієнт, відділення НП). Додатково може заповнити Сума страхування, Хто оплачує, Адреса доставки. Статус: Нова. Email + Telegram менеджерам і керівникам.

2
ПризначенняМенеджер

Обирає водія та транспорт → статус В черзі. Email + Telegram водію з actionable-кнопками.

3
Старт та забір зі складуВодій

Натискає Розпочати В роботі. Прибув на склад, забрав товар → Забрав зі складу У водія. Ініціатор отримує сповіщення на кожен крок.

4
Доставка отримувачуВодій

Довіз до отримувача (клієнт, магазин, відділення) — натискає Доставлено (у Telegram: ✅ Доставлено). Статус: У водія Доставлено автоматично Виконано — без кроку комірника. Ініціатор отримує email + Telegram (тип arrived — «Доставлено»).

Ключова відмінність від Отримання: немає кроків 5–6 (комірник). Заявка завершується одразу після клацання Доставлено.

Переміщення (transfer)

Внутрішнє переміщення між двома офісами однієї компанії: цехами, складами, філіями. Потребує налаштованих локацій та контактів (див. розділи Локації і Контакти). Фінальне підтвердження — комірник офісу призначення.

TRANSFER (Переміщення) — офіс А → офіс Б (обидва ваші) ① Створення — Ініціатор / Менеджер обирає локації А + Б, контактів Status: new 📧📱 → менеджери, керівник ② Призначення — Менеджер обирає водія + авто Status: new → queued (авто) 📧📱 → водій (з кнопками) ③ Розпочати — Водій натискає "Розпочати" Status: queued → active 📧📱 → ініціатор ④ Забрав у А — Водій підтверджує забір Status: active → received_by_driver 📧📱 → ініціатор ⑤ Прибув на Б — Водій доставив у офіс Б Status: received_by_driver → delivered_to_office 📧📱 → ініціатор + комірник Б (з кнопкою) ⑥ Прийнято на Б — Комірник Б підтверджує прийом Status: delivered_to_office → done (авто) 📧📱 → ініціатор
1
Створення заявкиІніціатор або Менеджер

Обирає тип Переміщення. Замість текстових адрес з'являються випадаючі списки: Пункт А (звідки), Контактна особа А, Пункт Б (куди), Контактна особа Б. Адреса та координати автоматично копіюються з локації. Контакти фільтруються за прив'язаною локацією (якщо вказана). Статус: Нова. Email + Telegram менеджерам.

2
ПризначенняМенеджер

Обирає водія + транспорт → В черзі. Email + Telegram водію.

3
Старт і забір у АВодій

Розпочати В роботі. Приїхав на офіс А → Забрав у А У водія. Комірник на А фізично передає вантаж — це координація на місці, без клацання у системі.

4
Прибуття на БВодій

Довіз до офісу Б → Прибув на місце Доставлено. Email + Telegram ініціатору (тип arrived) та комірникам на офісі Б з кнопкою 📥 Прийняти на склад.

5
Прийом на складі БКомірник

На Склад натискає Прийнято на склад. Статус: Доставлено Прийнято складом → автоматично Виконано. Email + Telegram ініціатору (тип received).

Винятки та аварійні шляхи

  • На будь-якому етапі менеджер/керівник може скасувати заявку → статус Скасовано.
  • Водій може натиснути Не виконано якщо щось пішло не так → статус Не виконано з обов'язковим коментарем.
  • Перехід Прийнято складом Виконано відбувається автоматично — комірнику не треба натискати окрему кнопку завершення.
  • Для Відправки перехід Доставлено Виконано теж автоматичний — комірника на зовнішньому пункті немає.

Статуси за типом

СтатусОтриманняВідправкаПереміщення
Нова
В черзі
В роботі
У водія
Доставлено
Прийнято складом--
Виконано
Скасовано
Не виконано

Для Відправки немає статусу Прийнято складом — після доставки зовнішньому отримувачу заявка автоматично переходить у Виконано.

Статуси заявок

Кожна заявка проходить через послідовність статусів. Тепер система має 9 статусів — 3 нових гранулярних кроки дозволяють бачити, на якому саме етапі перевезення знаходиться вантаж. Нижче показано основний потік та хто ініціює кожен перехід.

НоваВ черзіВ роботіУ водіяДоставленоПрийнято складомВиконано
В роботіНе виконано(водій не зміг виконати)
Будь-який статусСкасовано
Нова

Заявку щойно створено. Очікує на обробку менеджером.

Хто змінює: Ініціатор

В черзі

Менеджер призначив водія та транспорт. Заявка в черзі на виконання.

Хто змінює: Менеджер

В роботі

Водій розпочав виконання рейсу (натиснув "Розпочати").

Хто змінює: Водій / Менеджер

У водія

Водій підтвердив, що фізично забрав вантаж у точці А. Ініціатор отримує email-сповіщення.

Хто змінює: Водій

Доставлено

Водій прибув з вантажем у точку Б. Для заявок з комірником — чекаємо на його підтвердження; для відправки — автоматичне завершення.

Хто змінює: Водій

Прийнято складом

Комірник підтвердив фізичний прийом вантажу на склад. Наступний крок — автоматичний перехід у Виконано.

Хто змінює: Комірник

Виконано

Рейс завершено. Заявка виконана.

Хто змінює: Система / Комірник

Не виконано

Водій не зміг виконати заявку (не отримано / не доставлено). Коментар з причиною обов'язковий.

Хто змінює: Водій

Скасовано

Заявку скасовано. Причина зазначається в коментарі.

Хто змінює: Менеджер

Рівні пріоритету

ТерміновоТерміновий пріоритет. Заявка виділяється червоним кольором та потрапляє на початок черги. Менеджер отримує спеціальне сповіщення.
ЗвичайнийСтандартний пріоритет. Більшість заявок мають цей рівень.
НизькийНизький пріоритет. Виконується після термінових та звичайних заявок.

Створення заявки

Заявку може створити будь-яка роль — ініціатор, менеджер, водій, комірник або керівник. Кнопка Нова заявка доступна на сторінці Заявки та на головних сторінках кожної ролі (Рейси, Склад, Аналітика, Керування). Будь-яка створена заявка стартує у статусі new і чекає на призначення менеджером.

Система підтримує чотири типи заявок: Отримання, Відправка, Переміщення та Бронювання транспорту (останнє винесено в окремий розділ Бронювання транспорту). Заповнювати форму можна трьома способами: вручну, вставивши текстовий опис для ШІ-розбору, або продиктувавши через мікрофон. Детальніше — у розділі AI функції.

  1. 1Перейдіть на сторінку Заявки у бічному меню.
  2. 2Натисніть кнопку Нова заявка.
  3. 3Оберіть тип заявки: Отримання, Відправка або Переміщення. Кнопка Переміщення активна лише якщо у компанії налаштована хоча б одна локація (див. розділ Локації).
  4. 4Заповніть обов'язкові та додаткові поля форми. За потреби прикріпіть фото та документи прямо у формі — тепер вкладення додаються одразу разом із заявкою.
  5. 5Натисніть Створити заявку для збереження. Після створення вас автоматично перенаправить на сторінку деталей.

Обов'язкові поля

Тип заявкиОтримання або Відправка
ДатаДата, на яку потрібно перевезення
Адреса АПочаткова точка маршруту
Адреса БКінцева точка маршруту
ПріоритетТерміново, Звичайний або Низький

Поля для заявки на отримання

Тип адресиНП, Rozetka, Епіцентр, внутрішній, інше
Номер ТТННомер ТТН або замовлення

Поля для заявки на відправку

Сума страхуванняСума страхування відправлення
Хто оплачуєХто оплачує відправку
Адреса доставкиАдреса отримувача

Поля для заявки на переміщення

Локація АОфіс відправлення зі списку (керується у Налаштуваннях → Локації)
Локація БОфіс призначення зі списку
Контакт на АЛюдина, яка видасть вантаж (зі списку Контакти)
Контакт на БЛюдина, яка зустріне водія на прийомі

Тип Переміщення використовує лише власні локації та контакти компанії — зовнішніх адрес тут немає. Перш ніж користуватися — заповніть довідники на сторінках НалаштуванняЛокації та Контакти.

Спільні додаткові поля

ЧасБажаний час виїзду
Тип вантажуОпис вантажу
Вага (кг)Орієнтовна вага вантажу
Об'ємОб'єм у довільній формі (наприклад, 2 палети)
Контактна особаІм'я та телефон
Деталі для водіяОбмеження по часу, відомості про відправника, будь-яка корисна інформація для виконання рейсу

Поле «Внутрішній коментар» прибрали — воно було видиме ініціатору та вводило в оману. Для внутрішнього обговорення команди використовуйте стрічку коментарів на сторінці деталей заявки — вона працює як чат, і до кожного коментаря можна прикріпити фото.

Більшість полів є не обов'язковими — заповнюйте лише те, що потрібно. Фото та документи можна прикріпити після створення заявки на сторінці деталей.

Список заявок за замовчуванням — на сьогодні

Сторінка Заявки (/app/requests) відкривається з фільтром на поточну дату. Під фільтром з'являється підказка: «Показано заявки на сьогодні. Змініть діапазон дат, щоб побачити інші.» Змініть діапазон або оберіть конкретний день, щоб подивитися історію чи плани. На сторінці Керування фільтр за датою не накладається — менеджер бачить увесь беклог.

Голосовий ввід

Якщо у вашій компанії налаштовано ШІ, у формі створення заявки з'являється вкладка Голос. Натисніть на неї, щоб продиктувати заявку голосом.

  1. 1Перейдіть на вкладку Голос у формі нової заявки.
  2. 2Натисніть кнопку запису та продиктуйте деталі заявки природною мовою (наприклад, "Завтра потрібно забрати посилку з Нової Пошти на вулиці Хрещатик 10, пріоритет терміновий").
  3. 3Система розпізнає мовлення (Whisper) та за допомогою ШІ (Claude) автоматично заповнить поля форми.
  4. 4Перегляньте витягнуті поля. Кожне поле має індикатор впевненості: висока, середня, низька. Відредагуйте поля з низькою впевненістю вручну.
  5. 5Натисніть Підтвердити для збереження заявки.

Автопідказки адрес

Поля адрес (Адреса А та Адреса Б) показують підказки з OpenStreetMap під час введення тексту. Підказки пріоритизовані для України. Оберіть адресу зі списку — система збереже координати для відображення маршруту на карті та автоматичного розрахунку відстані.

Фото та документи (одразу у формі)

Вкладення тепер обираються прямо у формі — натисніть Додати файли у розділі вкладень, оберіть фото чи документи, перегляньте мініатюри. Файли будуть автоматично завантажені після створення заявки, а ви одразу опинитеся на сторінці деталей. Двокрокового переходу більше немає. Додати ще вкладення можна й пізніше — детальніше в розділі Вкладення та коментарі.

AI функції

Rapid Ant має три вбудовані ШІ-інструменти, які прискорюють роботу з заявками: автоматичний розбір тексту, голосовий ввід та розумну рекомендацію при призначенні водія.

Швидке заповнення з тексту

У формі створення заявки оберіть вкладку ШІ та вставте вільний текст — наприклад, повідомлення з месенджера чи виписку зі звернення. Claude проаналізує його і заповнить поля форми.

  1. 1Відкрийте Нова заявка та перейдіть на вкладку ШІ.
  2. 2Вставте текст з описом перевезення (адреси, вантаж, терміни).
  3. 3Натисніть Розпізнати. За кілька секунд поля заповняться автоматично.
  4. 4Перевірте індикатори впевненості біля кожного поля та відредагуйте все, що потрібно, перед збереженням.

Голосовий ввід

На вкладці Голос натисніть кнопку мікрофона та продиктуйте заявку природною мовою. Запис обробляється Whisper (транскрипція українською), після чого Claude витягає поля так само, як при текстовому розборі.

ШІ-рекомендація водія та транспорту

Під час призначення заявки менеджер бачить блок ШІ рекомендує — Claude аналізує деталі заявки, графік водіїв та наявний транспорт і пропонує оптимальний варіант. Детальніше — у розділі Керування заявками.

AI-помічник у Telegram

Керівник може ставити запитання про дані компанії природною мовою прямо в Telegram — командою /ai. Докладніше — у розділі Telegram-бот.

ШІ допомагає, але остаточне рішення завжди за людиною — перевіряйте та коригуйте результат перед збереженням.

Керування заявками (Менеджер)

Перегляд та фільтрація

На сторінці Керування менеджер бачить усі заявки компанії. У правому верхньому куті — кнопка Нова заявка: менеджер може створити заявку прямо звідси, не повертаючись на Заявки. Доступні фільтри:

  • Пошук — за номером заявки, адресою або контактом
  • Фільтр за статусом (Нова, В черзі, В роботі, Виконано, Скасовано, Не виконано)
  • Фільтр за пріоритетом (Терміново, Звичайний, Низький)
  • Фільтр за датою (конкретний день або діапазон)

Призначення водія та транспорту

Відкрийте заявку зі статусом Нова та оберіть водія і транспортний засіб у панелі призначення.

Авто-черга: при призначенні водія статус автоматично змінюється на В черзі.

ШІ-рекомендація призначення

При натисканні Призначити у верхній частині панелі відображається блок ШІ рекомендує з пропозицією оптимального водія та транспортного засобу. Рекомендація містить:

  • Рекомендованого водія та транспорт
  • Обґрунтування вибору українською мовою
  • Попередження (якщо є) — наприклад, водій вже має багато заявок

Натисніть на рекомендацію, щоб прийняти її одним дотиком, або оберіть водія та транспорт вручну зі списку нижче.

Розумна фільтрація водіїв

Панель призначення показує водіїв у кілька груп: на зміні, попереднє призначення та поза зміною. Біля кожного водія відображається час зміни (наприклад, 08:00–18:00). Водії, чия зміна не покриває час заявки, позначаються як Поза зміною і відображаються внизу списку.

Попереднє призначення: тепер можна призначати заявки на водіїв, які ще не підтвердили зміну (раніше вони блокувалися). Це зручно для планування заздалегідь — наприклад, на завтра.

Зміна статусу вручну

В черзіВ роботі— кнопка "Розпочати"
В роботіВиконано— кнопка "Завершити"
Будь-якийСкасовано— кнопка "Скасувати"

Порядок маршруту

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

Редагування та видалення

Редагувати заявку можна лише у статусах Нова та В черзі. Видалення переносить заявку до архіву — вона не зникає остаточно.

Водій

Підтвердження зміни

На початку робочого дня водій підтверджує свою зміну на сторінці Рейси. Це сигналізує менеджерам, що водій на зв'язку та готовий до виконання заявок.

Попереднє призначення: навіть якщо водій ще не підтвердив зміну, менеджер уже може призначити на нього заявку. Щойно водій підтвердить зміну — заявки з'являться у нього у списку.

Перегляд призначених заявок

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

Виконання заявки (степпер)

Водій проходить заявку по кроках — на кожному кроці тільки одна основна кнопка. Це прибирає плутанину та дає менеджеру й ініціатору точну картину у реальному часі.

В черзіВ роботі— кнопка "Розпочати"
В роботіУ водія— кнопка "Забрав вантаж"
У водіяДоставлено— кнопка "Прибув на місце"

Перегляд перед стартом: у статусі В черзі на картці тепер дві кнопки — Деталі (вторинна, з іконкою Info) відкриває повну сторінку заявки, а Розпочати (основна) — стартує рейс. Водій може спокійно ознайомитися з адресою, вантажем і коментарем, перш ніж виїжджати. На інших етапах під кнопкою основної дії з'являється невеликий лінк Повні деталі заявки.

Що відбувається далі — залежить від типу заявки:

Отримання / Переміщення:

  • Після Доставлено у водія з'являється індикатор "Очікуємо на комірника".
  • Комірник підтверджує прийом → Прийнято складом автоматично Виконано.

Відправка:

  • Після Доставлено заявка одразу переходить у Виконано — складу на фінальній точці немає.

Кнопка "Не виконано"

На будь-якому з етапів водій може натиснути Не виконано, якщо виникла непереборна проблема (не отримано / не доставлено). Коментар з причиною обов'язковий; за потреби — фото.

На кожному кроці водій може додати коментар та прикріпити фото (наприклад, фото ТТН при отриманні).

Історія рейсів

Водій може переглянути виконані та невиконані заявки за попередні дні для звітності.

Склад (Комірник)

Комірник — це п'ята роль у системі, відповідальна за фізичний прийом вантажу на склад компанії. Комірник замикає ланцюг для заявок на Отримання та Переміщення.

Сторінка "Склад"

Робоче місце комірника — сторінка Склад (/app/warehouse). Інтерфейс розділений на дві секції:

  • Очікує приймання — заявки у статусі Доставлено: водій уже приїхав, потрібна дія комірника. Біля кожної картки — кнопка Прийняти.
  • В дорозі — заявки, що зараз рухаються до складу (статуси В роботі та У водія). Допомагає спланувати завантаженість складу.

Процес приймання

  1. 1Комірник отримує email-сповіщення, щойно водій натиснув Прибув на місце.
  2. 2Відкриває сторінку Склад, перевіряє картку заявки у секції Очікує приймання.
  3. 3Перевіряє вантаж фізично. За потреби — додає фото чи коментар (наприклад, фіксація пошкоджень).
  4. 4Натискає Прийняти. Заявка переходить у Прийнято складом, а далі — автоматично у Виконано.

Для заявок Відправка комірник не задіяний — після доставки зовнішньому отримувачу заявка закривається автоматично.

Бронювання транспорту

Окрім трьох транспортних сценаріїв, у системі є четвертий тип заявки Бронювання транспорту. Він не має маршруту: це резервування конкретного авто на період часу. Зручно, коли машина потрібна для разової поїздки, обслуговування чи виїзду без оформлення повноцінного перевезення.

Вкладка Бронювання транспорту у формі нової заявки активна лише тоді, коли в компанії є хоча б один активний транспортний засіб (див. розділ Панель керівника → керування транспортом).

Створення бронювання

  1. 1У формі Нова заявка оберіть тип Бронювання транспорту.
  2. 2Вкажіть Дата початку та Дата завершення періоду, на який потрібне авто.
  3. 3Оберіть режим: З водієм — рейс виконує призначений водій; Без водія — авто бере сам ініціатор.
  4. 4Оберіть транспортний засіб. Авто, вже заброньовані на ці дати, недоступні — система позначає їх як Зайнято іншим водієм або бронюванням на цю дату.
  5. 5Натисніть Створити заявку. Поля пріоритету та часу для бронювання не потрібні — у формі їх немає.

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

Виконання бронювання

У бронюванні немає кроків забору та доставки — лише два прості переходи: взяти авто та повернути його.

  • З водієм — кнопки Взяв авто і Повернув авто бачить призначений водій на сторінці Рейси.
  • Без водія — ті самі кнопки бачить сам ініціатор на сторінці деталей заявки.
  • Якщо поїздка не відбулася — кнопка Не виконано з обов'язковою причиною.

Бронювання у дашборді

На дашборді керівника окремий блок показує зведення по автопарку: В оренді зараз, Повернуті та Усього бронювань — швидкий зріз завантаженості транспорту.

Закриття змін

Закриття змін — це структурований чек-лист кінця робочого дня для локацій компанії (склад, цех, філія). Замість усного «все гаразд» працівник проходить перелік пунктів за зонами та фіксує стан кожного.

Чек-листи закриття (шаблони)

Керівник налаштовує чек-лист для кожної локації на сторінці НалаштуванняЧек-листи закриття (/app/settings/closing-templates). Чек-лист складається з:

  • Зон — ділянок локації (наприклад, Склад, Офіс, 3 поверх). Кнопка Нова зона; зони можна перейменовувати та видаляти.
  • Пунктів — конкретних перевірок усередині зони (наприклад, Вимкнено світло, Зачинено ворота). Кнопка Новий пункт.

Поки для локації не створено чек-лист, замість нього показується підказка «Чек-лист ще не налаштовано».

Сесія закриття

Коли працівник починає закриття, система створює сесію — миттєвий знімок поточного чек-листа з власним номером. Навіть якщо чек-лист згодом змінять, уже розпочата сесія залишиться незмінною. Для однієї локації одночасно існує лише одна активна сесія.

Сесія проходить стани: Триває (заповнюється) → Завершено. Сесію також можна скасувати.

Заповнення чек-листа

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

  • Без зауважень — пункт у нормі.
  • Із зауваженнями — є проблема; варто додати коментар, а за потреби — фото.

Заповнювати можна двома способами: у веб-застосунку на сторінці Закриття або прямо в Telegram — бот веде працівника по пунктах кнопками.

QR-код локації

Для кожної локації система генерує QR-код. Працівник сканує його телефоном — і одразу потрапляє у закриття саме цієї локації через Telegram, навіть якщо не має облікового запису в системі. Це зручно для тимчасових працівників і підрядників.

Перегляд і звіти

Менеджер і керівник бачать усі сесії на сторінці Закриття (/app/closings) — кожна показує локацію, ініціатора та стан. Завершена сесія формує звіт (HTML / PDF) з переліком усіх пунктів і зауважень — його можна зберегти чи роздрукувати.

Якщо сесію розпочали, але не завершили вчасно, система автоматично нагадує про прострочене закриття.

Карта та відстань

На сторінці деталей заявки відображається інтерактивна карта з маршрутом, якщо адреси були обрані з автопідказок (тобто мають координати).

Що показує карта

  • Маркер А — початкова точка маршруту
  • Маркер Б — кінцева точка маршруту
  • Лінія маршруту — автомобільний маршрут між точками А та Б

Відстань та час

Під картою відображається розрахована відстань у кілометрах (км) та орієнтовний час у дорозі у хвилинах (хв). Розрахунок базується на автомобільному маршруті.

Карта використовує тайли OpenStreetMap з темною темою. Якщо адреси були введені вручну (без вибору з підказок), карта не відображається.

Нова Пошта

Для заявок на Отримання та Відправку система інтегрована з Новою Поштою. Якщо в полі Тип адреси обрати НП, замість текстового поля адреси з'являється пошук відділень.

Вибір відділення

Почніть вводити місто чи номер відділення — система покаже список відділень Нової Пошти. Оберіть потрібне, і адреса заповниться автоматично разом із координатами для карти. Поле підписане відповідно до типу заявки: Відділення НП (звідки забрати) для отримання та Відділення НП (куди відправити) для відправки.

Номер ТТН

Якщо ввести номер ТТН (14 цифр), система звіряє його з Новою Поштою та автоматично підтягує дані відправлення:

  • Отримання — за номером ТТН підтягуються вага, опис вантажу та контакт відправника.
  • Відправка — якщо ТТН уже створено, підтягуються вага та вантаж.

Статус посилки за ТТН система перевіряє автоматично — не потрібно вручну заходити на сайт перевізника.

Вкладення та коментарі

Завантаження файлів

Фото та документи можна додати у двох місцях: одразу після створення заявки (крок Вкладення) або пізніше на сторінці деталей. Підтримувані формати: зображення (JPG, PNG, WebP) та PDF. Максимальний розмір одного файлу — 10 МБ. Для заявок на отримання зручно прикріпити фото ТТН, для відправлень — фото вантажу та супровідних документів.

Коментарі

Розділ коментарів дозволяє членам команди обговорювати заявку. До коментаря можна прикріпити фото. Коментарі видно всім учасникам, які мають доступ до заявки.

Коли хтось залишає коментар до заявки, ініціатор та призначений водій отримують email-сповіщення (якщо увімкнене у налаштуваннях).

Коментарі водія

Водії можуть додавати фото та коментарі при завершенні або відмові заявки. Наприклад, фото ТТН при відправці або фото пошкодження при невдалому отриманні.

Профіль

Усі користувачі можуть редагувати свій профіль на сторінці НалаштуванняПрофіль (або за адресою /app/settings/profile).

Редаговані поля

Ім'яВаше ім'я, що відображається у системі
ПідрозділВідділ зі списку, що керує керівник компанії
ТелефонНеобов'язково. Потрібен для SMS-сповіщень; залиште порожнім, щоб вимкнути SMS

Фото профілю

На сторінці профілю можна завантажити аватар — зображення з'являтиметься у списках, коментарях та сповіщеннях. Підтримувані формати: JPEG, PNG, WebP. Максимальний розмір — 2 МБ. Файл зберігається у захищеному сховищі Supabase.

Інформація лише для читання

EmailЕлектронна пошта облікового запису
РольВаша роль у системі (Ініціатор, Менеджер, Водій, Керівник)
КомпаніяНазва вашої компанії
Дата реєстраціїДата створення облікового запису

Налаштування email

Кожен користувач може самостійно обрати, які email-сповіщення отримувати. Налаштування винесені на окрему сторінку НалаштуванняСповіщення (/app/settings/notifications). Зміни зберігаються автоматично; тумблери виконані в iOS-стилі.

Фільтрація за роллю

Список налаштувань більше не показує всі 14 типів сповіщень всім підряд — тепер відображаються лише ті, що дійсно стосуються ролі користувача. Це прибирає зайві перемикачі, які все одно не впливали б на нічого.

  • Водій — призначення, забір, прибуття, прийом, скасування, термінові, коментарі (без дайджесту та тижневого звіту).
  • Комірник — прибуття водія, прийом, коментарі, термінові, забір, скасування, завершення.
  • Ініціатор — всі події по власних заявках: підтвердження, старт, забір, прибуття, прийом, завершення, скасування, коментарі, термінові.
  • Менеджер — створення, підтвердження, старт, забір, прибуття, прийом, завершення, скасування, прострочення, термінові, коментарі.
  • Керівник — усі 14 типів, включно з щоденним дайджестом та тижневим звітом.

Основні типи сповіщень

  • Нові заявки — про створення заявки (для менеджерів)
  • Призначення — коли вас призначають на заявку (для водіїв)
  • Підтвердження — коли водій підтверджує зміну
  • Початок рейсу — коли водій розпочинає виконання
  • Забір вантажу — водій підтвердив, що забрав вантаж у точці А
  • Прибуття — водій приїхав у точку Б (для комірника — із кнопкою «Прийняти»)
  • Прийом складом — комірник підтвердив фізичний прийом
  • Завершення — коли заявку виконано
  • Скасування — коли заявку скасовано
  • Прострочення — заявка не виконана у заплановану дату
  • Термінові — окремий канал для заявок з пріоритетом urgent
  • Коментарі — коли до заявки додають коментар
  • Щоденний дайджест — підсумок активності за день (керівник)
  • Тижневий звіт — зведення за тиждень (керівник)

SMS-канал

Окрім email і Telegram, сповіщення можуть надходити по SMS. Щоб увімкнути цей канал, вкажіть номер телефону на сторінці Налаштування Профіль. Тоді в таблиці налаштувань з'явиться окрема колонка SMS — для тих типів подій, що підтримують цей канал для вашої ролі. Без указаного телефону SMS вимкнено.

Вимкнення сповіщення впливає лише на канали доставки — email, Telegram і SMS; усі події залишаються видимими у системі та в журналі сповіщень.

Панель керівника

Аналітика

Дашборд показує ключові показники ефективності (KPI):

  • Загальна кількість заявок
  • Створено та виконано сьогодні
  • Відсоток виконання
  • Середній час виконання
  • Розподіл за статусами (кругова діаграма)
  • Розподіл за пріоритетами (стовпчикова діаграма)

Для детального аналізу натисніть Експорт CSV — вивантажте всі заявки у табличний формат.

Управління командою

На сторінці Команда керівник може:

  • Запрошувати нових членів команди через email
  • Призначати ролі: Ініціатор, Менеджер, Водій, Комірник та Керівник
  • Змінювати роль існуючого користувача прямо у списку — оберіть потрібну роль у випадному меню навпроти імені (включаючи нову роль Комірник для прийому вантажу на склад)
  • Переглядати активних користувачів та їхні ролі

Відділи та структура

На сторінці Відділи керівник керує списком відділів, які користувачі обирають у профілі та при прийнятті запрошення. Детальніше — у розділі Відділи.

Експорт даних

Для звітності керівник може вивантажити дані компанії у CSV — заявки, показники водіїв або журнал змін. Детальніше — у розділі Експорт даних.

Управління транспортом

На сторінці Транспорт доступно:

  • Додавання нового транспорту (номер, модель, вантажопідйомність)
  • Редагування характеристик
  • Активація / деактивація транспорту
  • Перегляд поточного статусу кожного транспортного засобу

Графік водіїв

На сторінці Графік керівник налаштовує тижневий розклад водіїв: доступність, час початку та закінчення зміни для кожного дня.

Локації та контакти

На сторінках Локації (/app/settings/locations) та Контакти (/app/settings/contacts) керівник і менеджер ведуть довідники власних офісів та людей — вони потрібні для створення заявок типу Переміщення. Детальніше — у розділах Локації та Контакти.

Графік заявок

На сторінці Графік заявок (/app/schedule) менеджер і керівник бачать календар із кількістю заявок на кожен день. Детальніше — у розділі Графік заявок.

Відділи

Керівник самостійно формує перелік відділів компанії на сторінці НалаштуванняВідділи (/app/settings/departments). Цей перелік використовується у профілях користувачів та при прийнятті запрошень — замість вільного тексту користувач обирає відділ зі списку.

Що можна робити

  • Додавати нові відділи
  • Перейменовувати існуючі
  • Перетягувати відділи для зміни порядку у списках
  • Деактивувати відділ — він зникає з вибору, але залишається у профілях, де вже був призначений

Деактивація не видаляє історичні дані — це безпечний спосіб прибрати застарілі підрозділи.

Локації

Сторінка НалаштуванняЛокації (/app/settings/locations) — довідник місць, з якими регулярно працює ваша компанія. Доступна керівнику та менеджеру.

Дві секції на сторінці

  • Офіси компанії — власні локації (склади, філії, представництва). Використовуються у заявках типу Переміщення як точки А та Б.
  • Збережені адреси — часто використовувані зовнішні адреси (склади постачальників, відділення перевізників). З'являються як швидкий вибір у полях "Адреса А" та "Адреса Б" при створенні заявок на Отримання або Відправку.

Що можна робити

  • Додати нову локацію (назва, адреса, координати з OSM)
  • Редагувати або деактивувати існуючу
  • Перетягувати для зміни порядку у випадаючих списках форми

Тип заявки Переміщення доступний лише тоді, коли в компанії налаштовано хоча б одну локацію-офіс. Без локацій відповідна кнопка вимкнена.

Контакти

Сторінка НалаштуванняКонтакти (/app/settings/contacts) — довідник людей компанії: хто відповідає за видачу чи прийом вантажу у кожному офісі. Доступна керівнику та менеджеру.

Що зберігається

Ім'яІм'я контактної особи
ТелефонНомер для водія або менеджера
EmailНеобов'язково — для прямих сповіщень
Роль / посадаНаприклад, завідувач складу
Прив'язана локаціяНеобов'язково — контакт може належати конкретному офісу

Де використовуються

  • У формі заявки типу Переміщення — два випадаючі списки: "Контакт на А" та "Контакт на Б". Якщо контакт прив'язаний до локації, він автоматично фільтрується під обрану локацію.
  • У email-сповіщеннях — для інформування людини на точці, коли водій забрав або привіз вантаж.

Графік заявок

Сторінка Графік заявок (/app/schedule) — календар-вид на місяць для планування роботи. Доступна менеджеру та керівнику. Не плутайте з тижневим графіком водіїв у НалаштуванняГрафік.

Що показує

  • Сітка 7×N, де в кожній клітинці — кількість заявок на відповідний день.
  • Кольорова інтенсивність клітинок відображає навантаження: від світлого (мало заявок) до насиченого (багато заявок).
  • Клік по клітинці відкриває нижню шторку зі списком усіх заявок на цей день.

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

Зручно для планування наступного тижня, вирівнювання навантаження на водіїв та швидкого переходу до конкретної заявки за датою.

Блокування дат

Іноді створювати заявки на певний день не варто — наприклад, усі водії та транспорт у виїзді, державне свято чи інвентаризація. Для цього є сторінка НалаштуванняДоступність (/app/settings/availability). Доступна лише керівнику.

Як заблокувати день

  1. 1Відкрийте НалаштуванняДоступність та оберіть потрібну дату в перемикачі днів.
  2. 2Натисніть Заблокувати створення заявок. За бажанням вкажіть причину (наприклад, «всі водії та транспорт у виїзді») — її побачать ті, хто намагатиметься створити заявку на цей день.
  3. 3Щоб зняти блокування — натисніть Розблокувати.

Що це змінює

  • На заблокований день не можна створити нову заявку — форма повідомить про блокування та покаже причину.
  • Уже наявні заявки на цей день не зникають і виконуються як зазвичай — блокування стосується лише створення нових.
  • Налаштовувати можна дати приблизно на 90 днів уперед; минулі дати (до 30 днів) показані лише для перегляду.

Експорт даних

Сторінка НалаштуванняЕкспорт (/app/settings/export) дозволяє керівнику вивантажити дані компанії у форматі CSV з українськими заголовками. Доступні три типи звітів.

1. Заявки

Повний перелік заявок з усіма полями. Перед експортом можна задати фільтри: діапазон дат, статус, пріоритет. Підходить для детального аналізу та зовнішньої звітності.

2. Показники водіїв

Агрегована статистика по кожному водієві: кількість рейсів, сумарний пробіг, середній час виконання заявки. Зручно для оцінки навантаження та ефективності.

3. Журнал змін

Історія змін заявок: хто, коли та що змінював. Використовується для аудиту та розслідування спірних ситуацій.

Як експортувати

  1. 1Перейдіть на НалаштуванняЕкспорт.
  2. 2Оберіть тип звіту та, за потреби, налаштуйте фільтри.
  3. 3Натисніть Завантажити CSV — файл збережеться на ваш пристрій.

Журнал активності

Журнал активності — це наскрізна стрічка дій у компанії: усі зміни над командою, налаштуваннями та заявками з відмітками часу й автора. Доступний керівнику зі сторінки Команда — посилання Журнал активності (/app/settings/activity).

Що фіксується

Зміни команди та запрошень, ролей, відділів, локацій, контактів, транспорту, чек-листів закриття, груп звітів, блокувань дат і заявок — хто, коли і що саме змінив.

Фільтри та деталі

  • Фільтр за учасником — переглянути дії конкретної людини.
  • Фільтр за типом дії та діапазоном дат.
  • Кнопка Показати зміни розгортає точну різницю — які саме поля та значення змінилися.

Журнал активності — це перегляд на екрані. Щоб вивантажити історію змін заявок у файл, скористайтеся розділом Експорт даних Журнал змін (CSV).

Сповіщення

Система надсилає сповіщення про ключові події трьома каналами — email, Telegram (якщо користувач прив'язав свій чат у НалаштуванняTelegram) та SMS (якщо у профілі вказано номер телефону). Нижче показано, хто отримує сповіщення для кожної події:

Журнал сповіщень доступний усім користувачам: кожен бачить власні отримані email-повідомлення на сторінці Сповіщення. Керівник додатково бачить усі сповіщення компанії. Які саме листи надходять — керуйте на сторінці НалаштуванняСповіщення.

ПодіяІніціаторМенеджерВодій
Створення заявки----
Термінова заявка----
Зміна статусу----
Призначення водія----
Зняття з рейсу----
Новий коментар--

Telegram-бот та кнопка «Деталі»

У кожному повідомленні бота є кнопка ℹ️ Деталі (або команда /r НОМЕР). Натисніть — бот відповість повною карткою заявки з усіма полями: тип, пріоритет, адреси, вантаж, час, коментарі, статус.

Інтерактивні вкладення у Telegram

Раніше бот автоматично надсилав усі вкладення до заявки списком — це засмічувало чат, особливо коли файлів багато. Тепер під карткою деталей з'являється інлайн-клавіатура з однією кнопкою на кожне вкладення (до 8 файлів).

  • Тапніть на кнопку з назвою файлу — бот надішле саме цей файл: зображення у чат як прев'ю, PDF чи документ — як вкладення.
  • Остання кнопка — 🌐 Відкрити заявку з посиланням на веб-застосунок.
  • Якщо вкладень більше 8, остання кнопка стає +N ще у браузері — клацніть, щоб побачити всі файли.
  • Кожна кнопка генерує свіже підписане посилання в момент натискання — без проблем із простроченими URL.

Для комірника у сповіщенні про прибуття водія є окрема кнопка 📥 Прийняти на склад, а для водія — в assigned-повідомленні — ▶️ Розпочати, 📦 Забрав вантаж, ✅ Доставлено залежно від стадії.

Telegram-бот

Telegram-бот Rapid Ant надсилає сповіщення, приймає дії по заявках кнопками та відповідає на команди. Розділ Сповіщення вище описує самі сповіщення; тут — як підключити бота й що він уміє.

Підключення акаунта

  1. 1Відкрийте НалаштуванняTelegram (/app/settings/telegram).
  2. 2Скопіюйте персональне посилання й відкрийте його — бот зв'яже ваш чат з обліковим записом.
  3. 3Після підключення сповіщення приходитимуть і на email, і в Telegram.
  4. 4Відв'язати чат можна кнопкою на тій самій сторінці або командою /unlink у боті.

Команди бота

Набір команд залежить від ролі. Спільні для всіх:

  • /my — мої активні заявки.
  • /r НОМЕР — деталі заявки за номером.
  • /pause та /resume — призупинити чи знову ввімкнути сповіщення.
  • /help — довідка; /unlink — від'єднати Telegram.

Додаткові команди за ролями:

  • Водій/shift: підтвердити зміну (формат HH:MM-HH:MM або off).
  • Менеджер і керівник /drivers: водії на сьогодні.
  • Керівник/ai: AI-помічник (див. нижче).

AI-помічник (/ai)

Команда /ai доступна керівнику — це запитання природною мовою про дані компанії. Бот сам добирає потрібні дані й відповідає текстом.

/ai скільки активних заявок сьогодні? /ai хто з водіїв вільний? /ai покажи заявку REQ-20260423-003

Кожен запит обробляється окремо — бот не пам'ятає попередніх повідомлень. Керівник може й продиктувати запитання голосовим повідомленням.

Канали звітів (групи)

Окрім особистих чатів, компанія може підключити групу Telegram як канал звітів — туди надходитимуть дайджести й звіти замість особистих повідомлень. На сторінці Налаштування Telegram натисніть Підключити групу, додайте бота в потрібну групу та виконайте підказану команду. Груп можна підключити кілька.

Оновлення в реальному часі

Усі списки заявок оновлюються миттєво без перезавантаження сторінки. Коли хтось із вашої команди:

  • Створює нову заявку — вона з'являється у списку менеджера миттєво
  • Змінює статус заявки — оновлення видно всім, хто переглядає заявки
  • Призначає водія — водій одразу бачить нову заявку у своєму списку рейсів
  • Змінює порядок маршруту — послідовність оновлюється для водія в реальному часі

Для роботи оновлень у реальному часі не потрібно нічого налаштовувати. Функціонал працює автоматично для всіх авторизованих користувачів.

Поради та підказки

Мобільна версія

Rapid Ant повністю адаптований для мобільних пристроїв. Використовуйте нижню навігаційну панель для швидкого доступу до основних розділів. Додаткові сторінки доступні через кнопку "Ще".

Ефективний пошук

Пошук працює за номером заявки (наприклад, RA-00042), адресою або контактною особою. Комбінуйте пошук з фільтрами для швидкого знаходження потрібної заявки.

Пріоритет впливає на порядок

Заявки з пріоритетом Терміново автоматично потрапляють на початок черги. Використовуйте терміновий пріоритет лише для дійсно невідкладних перевезень.

Швидкі дії

На сторінці керування натисніть на заявку, щоб відкрити детальний перегляд з усіма діями: призначення, зміна статусу, редагування. Для швидкої навігації використовуйте номер заявки у пошуку.

Збереження контексту

Обрані фільтри зберігаються при навігації між сторінками. Повернувшись на список заявок, ви побачите ті самі фільтри, що й раніше.