Разделите путь напоминания на отбор баллов, создание задания, передачу провайдеру и получение статуса доставки. Запись «cron завершён» подтверждает лишь завершение запуска, но не письмо или push конкретному клиенту. Возьмите тестовую партию с известным сроком и найдите её переходы на каждом этапе.
До повторной массовой отправки посмотрите, не были ли сообщения уже приняты провайдером. Иначе попытка «дослать пропущенное» создаст дубли. Доставка также зависит от доступности выбранного канала и разрешений пользователя; техническая задача не должна обходить эти ограничения.
Где закончился путь конкретной партии
| Последний подтверждённый этап | Что искать дальше |
|---|---|
| Партия не выбрана | Границы окна, часовой пояс, доступный остаток |
| Выбрана, задания нет | Ошибку записи или конфликт уникальности |
| Задание есть, отправки нет | Очередь, повтор, недоступный канал |
| Провайдер принял | Его отдельный статус доставки и отказа |
Названия состояний определите явно. «Принято» не равно «доставлено», а «доставлено» не доказывает прочтение человеком. Для разных каналов доступные подтверждения отличаются. Храните технические ссылки на попытки в пределах политики хранения, не записывая токены устройств и полный текст личных сообщений в общие журналы.
Остаток мог измениться до отправки
Условный сценарий: утром отобраны 50 баллов, сгорающих завтра; днём клиент потратил 40; вечером готовится сообщение. Уведомление о 50 баллах уже вводит в заблуждение. Перед передачей сверяйте актуальную доступную часть выбранных партий и срок. При нулевом остатке предусмотрите отмену задания. Для точности текста можно указывать момент расчёта и вести пользователя к актуальному балансу.
Условная последовательность:
отбор -> партии со сроком в согласованном окне
задание -> ключ получатель + окно + тип напоминания
передача -> повторная сверка остатка и канала
нулевой остаток -> отмена, не отправка
ответ провайдера -> принятие либо ошибка
обратный статус -> отдельное состояние доставкиСам ключ зависит от политики: одно сводное сообщение за окно или отдельное по партии. Если включить случайный ID запуска, каждый повтор станет новым напоминанием. Если ключ слишком широкий, следующее законное окно окажется заблокировано. Границы окна и часовой пояс фиксируются в контракте, включая пропущенный запуск и позднее восстановление.
Повтор расписания — нормальный тест надёжности
Google Cloud Scheduler заявляет доставку at least once и допускает повтор одного планового запуска; целевая обработка должна выдерживать повторение. Источник проверен 20 октября 2026 года. Это конкретный пример поведения планировщика. Не предполагается, что ваш cron использует этот сервис, но повторный запуск и ручное восстановление стоит испытать в любом варианте.
- Дважды запустить одно тестовое окно и сравнить число заданий.
- Изменить остаток после отбора, затем разрешить отправку.
- Оборвать ответ после принятия сообщения провайдером.
- Восстановить процесс и сверить статус до нового обращения.
- Проверить истёкшее окно: запоздалое обещание потратить баллы не отправляется.
Если провайдер не поддерживает ключ идемпотентности или поиск принятого сообщения, нельзя честно обещать строго однократную отправку при неопределённом ответе. Выберите управляемую политику повторов и показывайте неопределённость оператору. Возвращать задание в начало без анализа особенно опасно после сетевого тайм-аута.
Начните с контрольного счёта и таблицы четырёх этапов: так станет видно, чинить календарный отбор, очередь или канал. Для внешнего разбора достаточно обезличенных времён переходов, состояния остатка и кода отказа провайдера. Само отсутствие жалоб не подтверждает доставку, поэтому после исправления сверяйте выбранные, отменённые, переданные и отклонённые задания одного окна.