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

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

Условие отправки складывается из нескольких признаков

ПризнакЗачем нуженПри неизвестном значении
Действующая поездкаСвязывает точку с этим заказомНе отправлять обещание
Актуальное назначениеИсключает прежнего курьераПовторить проверку состояния
Свежая позицияНе принимать старую точку за движение сейчасПоказать отсутствие данных
Заказ ещё ожидает выдачиИсключает отменённую или завершённую попыткуПрекратить обработку
Условие приближения подтвержденоСнижает случайные срабатыванияДождаться следующих допустимых данных

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

Одна попытка доставки имеет собственный факт уведомления

Условная идентичность уведомления:
delivery_attempt: <тестовая попытка>
notification_kind: approaching
rule_revision: <версия правила>
state: pending / sent / uncertain
Повтор события использует тот же результат.

В PostgreSQL 18 уникальное ограничение может охватывать комбинацию столбцов. Источник проверен 13 октября 2026 года. Оно помогает защитить выбранную идентичность записи уведомления от дубля. Состав ключа задаёт продукт: новая версия алгоритма не должна автоматически разрешать ещё одно сообщение тому же клиенту в той же попытке.

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

Перенос заказа создаёт изменение попытки или её состояния по вашей модели. Старое отложенное задание перед отправкой перечитывает актуальные данные. Если прежняя поездка закрыта, оно прекращает работу. Недостаточно удалить точку из карты: очередь уведомлений могла сохранить свой снимок заказа и отправить сообщение позднее.

Проверка включает проезд мимо и отмену

  1. Подать точку рядом, не связанную с нужной попыткой.
  2. Воспроизвести колебания у границы зоны.
  3. Повторить одно событие и получить один факт отправки.
  4. Отменить попытку до выполнения отложенного задания.
  5. Имитировать неизвестный результат провайдера.

При смене адреса сброс старого признака приближения должен следовать новой подтверждённой ревизии назначения. Поздняя точка прежней поездки не получает права запустить уведомление по новому адресу. Сопоставьте идентичности поездки и заказа до вычисления расстояния, а не только при построении текста сообщения.

Храните минимум диагностических сведений: идентичности тестовых событий, возраст позиции, версию правила и исход отправки. Полный путь курьера и точный домашний адрес не нужны в публичном отчёте. Для ограниченного отката отключается новое правило отправки, но сохраняются уже подтверждённые факты. Результат приёмки — уместное сообщение по актуальной поездке без повторов на каждом скачке координат.

Проверенные источники