# ADR-0022. Автосообщения

- Статус: принято; реализуется на этапе 7 — 7g-1 (приветствие, первая покупка, новый уровень; включение по
  программам), 7g-2 (уведомление о списании со ссылкой «Не вы?»), 7g-3 (очередь сообщений в кабинете, ADR-0020),
  7h-1 (поздравление с днём рождения), 7h-2 («Давно не были»), 7h-3 («Баллы скоро сгорят»)
- Дата: 2026-10-31

## Контекст

Шаблоны автосообщений (ADR-0020, 7c-2) и очередь сообщений участникам с правилами отправки (7c-1) уже есть, но
сообщения по темам никто не ставит в очередь. Пункт 7.4 roadmap — триггеры: приветствие, первая покупка, реактивация,
день рождения, скорое сгорание, смена уровня, уведомление о списании. Сообщения уходят через аккаунты мерчанта у
провайдеров (ADR-0020) и стоят ему денег: какие из них отправлять, решает мерчант.

## Решение

### Модуль и включение

- Модуль `triggers` слушает события других модулей и ставит сообщения в очередь (`MemberMessages::queue`) с текстом
  шаблона темы (`MessageTemplates::render`). Он пользуется контрактами сообщений, участников, чеков, уровней, бонусов,
  правил, леджера и программ; от него зависят кабинет и кабинет покупателя, который обслуживает страницу ссылки
  «Не вы?».
- Включение — по программе и теме (`AutoMessages`, таблица `auto_messages`). Пока тема не включена, её сообщения не
  ставятся в очередь. По умолчанию всё выключено: SMS оплачивает мерчант, и решает он сам. Включить тему — как
  опубликовать её текст: `campaigns.publish` со свежим подтверждением (владельцы, администраторы, маркетологи; не через
  доступ поддержки). Выключить — защитное действие: `messages.pause`, в том числе у приостановленного мерчанта и через
  полный доступ поддержки. Тему, которую платформа ещё не отправляет, включить нельзя: её текст можно подготовить
  заранее.
- Выключенная тема не уходит и из очереди: сообщение, которое ждало конца тихих часов или повтора, при отправке
  пропускается с причиной `switched_off`. Отправка спрашивает модуль сообщений через его контракт
  `AutoMessageSwitches`, который привязывает модуль `triggers` (без него уходит всё), — это правило момента отправки,
  как и остальные (ADR-0020); гонки с сообщением, которое уходит в эту секунду, нет. Выключатели касаются только тем,
  которые платформа отправляет сама (`AutoMessages::TOPICS`); сообщения других тем уходят, как решил тот, кто их
  поставил.
- Кабинет: страница «Шаблоны» стала «Автосообщения» — у каждой темы каждой рабочей программы колонка «Отправка»
  («Включена», «Выключена», «Появится позже») и кнопки «Включить» и «Выключить». Окно включения говорит, что сообщение
  будет уходить с этой минуты, а не задним числом, и за счёт мерчанта; показывает текст так, как его прочтёт участник,
  и сколько SMS он займёт; для приветствия в программе, где кассир регистрирует без кода, — что оно уйдёт на номер,
  который тот ввёл. Где не подключены ни SMS, ни почта, это сказано на странице и в окне. Журнал аудита:
  `auto-messages.enable` и `auto-messages.disable` с программой и темой. «Зафиксировать уровень» в карточке участника и
  `tier:fix` Management API предупреждают о поздравлении.

### Что и когда уходит (7g-1)

- **Приветствие** (`welcome`, служебное) — участнику, который вступил: на кассе, на сайте, в приложении или в
  кабинете покупателя; участнику, загруженному из другой системы (канал `import`), — нет. Ключ — `welcome:<участник>`.
- **Первая покупка** (`first_purchase`, служебное) — после первого подтверждённого чека с начисленными баллами: ни
  один другой чек участника и объединённых в него дублей (ADR-0019), который не отменён и не аннулирован, баллов не
  начислял (`ReceiptStats::isFirstEarning`; возвращённый чек покупкой остаётся). Чек без начисления — не первая
  покупка: первой станет следующая с начислением; программа только со штампами такого сообщения не шлёт. Это не то же
  самое, что условие акции «первая покупка» (любой чек, без возвращённых целиком): сообщение — о первых баллах. Ключ —
  `first_purchase:<участник>`, второго такого сообщения у участника не будет. Не уходит участнику, загруженному из
  другой системы, и тому, кто вступил меньше часа назад, когда включено приветствие (`JUST_JOINED_MINUTES`): новичок на
  кассе получает одно сообщение, а не код, приветствие и спасибо подряд. Чек, который офлайн-касса прислала на
  объединённого дубля, благодарит того, у кого теперь его баллы.
- **Новый уровень** (`tier_up`, служебное) — когда покупки подняли уровень или сотрудник поставил уровень выше
  прежнего (по порядку уровней в правилах). Понижение и уровень, которого правила не знают, — без сообщения. Каждое
  повышение — своё сообщение: ключ называет новый уровень и момент смены, и участник, вернувшийся на уровень, получит
  поздравление снова. Объединение дублей меняет уровень выжившего одним событием (`TierChanged`) — от его уровня к
  итоговому, — поэтому поздравление одно и с тем уровнем, который у него теперь. Пересмотр уровней (`tiers:review`)
  держит участника раньше уровня, как объединение и обезличивание: постановка сообщения держит участника тоже. Уровень
  анонимизированного участника остаётся и пересматривается, как прежде, без удержания: сообщение такому участнику не
  ставится.
- Стандартные тексты занимают одну SMS при любом названии программы и не называют баллов на счёте: баллы покупки
  обычно становятся доступны через несколько дней, и «На счёте: 0» после покупки сбивало бы с толку.
- Переменные: название программы, имя участника, баллы на счёте (`{balance}` — доступные, как «На счёте» на карте, без
  ожидающих начисления), баллы события (`{points}`), название уровня (`{tier}`). Числа — как в SMS с кодами: «1 500»,
  «12,5». Пока у программы нет опубликованных правил, баллов на счёте — 0. Невидимые символы в значениях (мягкий
  перенос, вставленный с именем) убираются — и в теме и подписи письма: сообщение их не принимает. Анонимизированному или объединённому участнику
  сообщение не ставится.
- Уйдёт ли сообщение и когда, решают правила отправки в момент отправки, как для любого сообщения участнику: тихие
  часы, состояние участника и мерчанта, пауза, выключатель темы.

### В транзакции события

- Сообщение ставится в той же транзакции, что и событие: подтвердился чек — есть и сообщение, откатился — нет и
  сообщения. Постановка идёт в своей точке сохранения: если сообщение поставить не удалось, ошибка уходит в отчёт об
  ошибках и откатывается только она, а чек, вступление или смена уровня проходят — покупка не срывается из-за SMS.
- Взаимная блокировка, ошибка сериализации и потеря соединения обрывают всю транзакцию (Laravel не откатывает точку
  сохранения после конфликта сессий), как и ошибка до точки сохранения, которую кто-то заглушил (база не принимает
  больше ни одной команды): такая ошибка не глушится, и событие завершается ошибкой, как без сообщения, — касса
  повторит чек, задача — свою попытку.

### Уведомление о списании и ссылка «Не вы?» (7g-2)

Закрывает последний пункт 4.7 roadmap (контроль C-15 исследования): участник узнаёт о каждой оплате баллами и одной
кнопкой останавливает того, кто тратит его баллы.

- **Уведомление о списании** (`redemption`, предупреждение) — после каждого подтверждённого чека, которым оплатили
  покупку баллами, тому, у кого теперь баллы (выжившему, если дубль объединили). Ручное списание сотрудником, сгорание
  и сторно уведомлений не шлют. Ключ — `redemption:<чек>`: у каждого чека своё уведомление. Предупреждение уходит
  сразу, в любое время суток и во время паузы мерчанта (ADR-0020). Стандартный текст «Списано баллов: {points}. Не вы?
  {link}» занимает одну SMS при баллах до 5 знаков и ссылке до 40 — «Не вы?», как спрашивают банки.
- Пока платформа остановила сообщения мерчанта (7d-3), предупреждение уходит стандартным текстом, а не текстом
  мерчанта (`MessageTemplates::render`): оно проходит и мимо остановки, и мимо тихих часов, и своим текстом мерчант
  иначе слал бы через него что угодно. Консоль и письмо владельцам об остановке так и говорят. Версия текста без
  ссылки, написанная до 7g-2, показывается в кабинете как «Стандартный» — без даты.
- **Ссылка «Не вы?»** (`{link}`) — обязательная переменная этой темы (`MessageTopic::hasLink()`): текст без неё не
  публикуется (`link_required`). Версия, написанная раньше, не уходит: вместо неё действует стандартный текст
  (`MessageTemplates::current`), а история её хранит. Ссылка — страница `/r/<токен>` на хосте кабинета покупателя.
  Токен — 16 букв и цифр (95 бит): короткий, чтобы SMS вмещала его, и недосягаемый для перебора. Хранится только
  SHA-256 токена — в таблице `redemption_notices`, вместе с чеком, точкой, кассой, временем покупки и баллами. Хэш —
  первичный ключ: он уникален на всей платформе, как случайный секрет, и ничего не раскрывает (DatabaseSchemaTest
  разрешает его по имени). Мерчант уведомления находится до того, как известен, узкой функцией SECURITY DEFINER
  `redemption_notice_tenant()`. Строка пишется в той же точке сохранения, что и сообщение: нет сообщения — нет и
  строки. Ссылка действует 30 дней (`RedemptionNotices::DAYS`); `redemption-notices:prune` (ежедневно, системная
  роль) потом удаляет её строку, а оспоренную — через 13 месяцев после того, как участник её оспорил (столько же по
  умолчанию хранится журнал сообщений): это запись о том, что он сказал.
- Страницу обслуживает модуль кабинета покупателя (контракт `RedemptionNoticeAddress`), как и страницу «Отписаться»
  (ADR-0021), поэтому она работает и у мерчанта без кабинета покупателя. Где у платформы нет такой страницы (не задан
  хост кабинета) или её адрес со ссылкой длиннее 60 знаков (сообщение обрезало бы его), уведомление о списании включить
  нельзя, а уже поставленные в очередь не уходят (`switched_off`). Предпросмотр в кабинете показывает ссылку с
  настоящим адресом (`RedemptionNotices::sampleLink`), так что число SMS посчитано верно.
- **Страница** при открытии только спрашивает: телефоны и мессенджеры сами открывают ссылки из сообщений, чтобы
  показать, куда они ведут. Она показывает программу, сколько баллов списано, когда (по часовому поясу точки) и где;
  сначала говорит, что делать ничего не нужно, если баллы тратил сам покупатель или с его согласия, и что вернуть
  баллы и разморозить карту может только магазин; что здесь не просят кодов, паролей и данных карт. Кнопка «Это не я —
  заморозить карту» отправляет форму без сессии и cookie: всё решает токен в адресе, а форма с чужого сайта его не
  знает. Одна транзакция держит строку уведомления первой, чтобы два запроса одной ссылки сработали один раз, и:
  - замораживает участника — только активного (`Members::freezeIfActive`): замороженный или заблокированный остаётся
    как есть, ссылка ничего не ослабляет. Причина — «Участник сообщил по ссылке «Не вы?», что не оплачивал баллами чек
    № …»; карточка участника в кабинете теперь показывает причину заморозки или блокировки;
  - завершает сеансы участника в кабинете покупателя и в плоскости участника (сайты, приложения, виджеты): кто тратил
    баллы с чужого сеанса — кодом для кассы из кабинета или на сайте, — должен войти заново. В кабинет покупателя
    входят по коду из SMS на телефон участника; сайт мерчанта откроет новый сеанс по своему входу. Страница говорит
    «Вы вышли из кабинета покупателя на всех устройствах», только если участник был в нём;
  - пишет владельцам мерчанта (`TeamNotices::redemptionDisowned`, `DisownedRedemption`): программа, баллы, номер и
    время чека, точка и касса, что стало с участником (заморожен сейчас, был заморожен или заблокирован), что сеансы
    завершены, что делать — словами кабинета («Действия» → «Скорректировать баллы»; «Снять заморозку или блокировку» —
    кроме заблокированного: блокировку мерчант ставил сам) —, что SMS могла уйти на чужой номер, и ссылка на карточку
    участника в кабинете (`PanelGate::memberUrl`). Имени и телефона в письме нет — они в карточке.
- Открытая повторно ссылка говорит «Вы уже сообщили об этом списании» и ничего не меняет, даже если мерчант уже
  разморозил карту. Истёкшая ссылка, ссылка другого мерчанта и ссылка участника, данные которого удалены, — «Ссылка не
  работает» (404). У закрытого мерчанта и архивной программы ссылка работает: она только защищает. Лимит — 30
  запросов в минуту на ссылку (`portal.redemption_per_minute`); запросы неизвестных ссылок считаются по адресу, как
  запросы кабинета покупателя. Политика страницы — `security.headers:redemption`: ничего не загружает, форма уходит
  только на свой хост, Referer не отправляется.
- Баллы не возвращаются сами: что делать со списанием, решает мерчант — вернуть баллы ручной корректировкой и снять
  заморозку.

### Поздравление с днём рождения (7h-1)

Решение владельца (2026-11-02): поздравление уходит вместе с баллами ко дню рождения, а не само по себе.

- **День рождения** (`birthday`, реклама) — когда программа начисляет участнику баллы ко дню рождения
  (`bonuses:birthdays` раз в час: в сам день или за `daysBefore` дней до него, участнику с нужным стажем, раз в год),
  в той же транзакции, что и начисление (`BonusGranted` вида `birthday`), с числом подаренных баллов (`{points}`).
  Ключ — `birthday:<начисление>`: одно поздравление на день рождения. Если программа не начисляет баллов ко дню
  рождения, поздравление не уходит — ему нечего сообщить. Баллы других видов (приветственные, за друга) поздравления
  не ставят.
- Окно включения показывает текст с числом баллов по опубликованным правилам и говорит, сколько баллов и когда их
  начисляют, что это реклама и уйдёт утром, что поздравление следует за правилами; без баллов ко дню рождения — что
  поздравление не уйдёт, пока их не включат в «Бонусах» на странице «Правила программы» и не опубликуют правила.
- Баллы начисляются вскоре после полуночи по часовому поясу программы: поздравление ждёт конца тихих часов, как любая
  реклама, и уходит только тем, кто согласился её получать (в SMS или письмах), в пределах лимитов рекламы (ADR-0020).
- Стандартный текст «Ко дню рождения дарим баллов: {points}. Ждём вас!» и тема письма «подарок ко дню рождения» никого
  не поздравляют заранее: баллы часто приходят за несколько дней до праздника, а заранее поздравлять многие считают
  плохой приметой. Где баллы приходят в сам день, окно включения подсказывает написать «С днём рождения!» своим текстом.
- Начисление баллов ко дню рождения теперь держит участника первым (`Members::lockPresent`), как всё, что меняет его
  баллы: поздравление, которое держит его тоже, берёт блокировки в том же порядке, что и объединение. Участник,
  которого заблокировали, обезличили или объединили с другим после того, как начисление нашло дни рождения, но до его
  очереди, баллов не получает, а остальные получают (раньше объединение в эту минуту обрывало весь запуск); блокировку
  в ту же секунду удержание не ждёт — такое поздравление пропустят при отправке. Повторные ежечасные запуски одним
  запросом проходят мимо тех, кому баллы этого года уже начислены, никого не удерживая. Поздравление называет баллы
  по правилам, по которым их начислили (`BonusGranted::$effectiveAt`), даже если новые правила вышли в ту же минуту.

### «Давно не были» (7h-2)

Решение владельца (2026-11-02): мерчант отмечает, через сколько дней без покупок звать участника обратно, — 30, 60
и/или 90.

- **Давно не были** (`reactivation`, реклама) — участнику, у которого со дня последней покупки прошло столько дней,
  сколько отметил мерчант (`AutoMessages::DAYS`: 30, 60, 90; пока не выбрал — 30, `DEFAULT_DAYS`): по сообщению за
  каждый отмеченный срок, пока участник снова не купит. Последняя покупка — последний действующий чек (подтверждён,
  возвращён частично или целиком; не резерв и не отменённый), участника или объединённых в него дублей
  (`ReceiptStats::lastPurchase`), а её день — день часового пояса программы. Тому, кто ни разу не покупал, не уходит.
  Ключ — `reactivation:<участник>:<дней>:<момент последней покупки>`: одно сообщение на срок и последнюю покупку; новая
  покупка начинает отсчёт заново.
- Решение без владельца: тем, у кого отмеченный срок прошёл до включения темы, сообщение не уходит — при сроке 30 дней
  участник, который не покупает уже 45 дней, его не получит, а при отмеченных 30 и 60 получит на 60-й день. Разослать
  всем, кто давно не покупал, — это разовая рассылка за счёт мерчанта, а не автосообщение; окно включения говорит об
  этом прямо.
- По расписанию (`auto-messages:queue`, раз в час): у каждой активной программы раз в её день, с 10:00 по её часовому
  поясу (`AutoMessages::DAILY_HOUR`: утро, тихие часы платформы кончились), проверка находит тех, чья последняя покупка
  была ровно столько дней назад. Кандидаты — участники, названные в чеках программы за тот день и без своих чеков позже
  (`ReceiptStats::lastPurchasedWithin`: сначала покупки дня по индексу покупок программы, потом более поздние — по
  индексу покупок участника). Каждого держат (`Members::lockPresent`; объединённого — того, в кого его объединили, и
  объединённого в эту же минуту тоже), перечитывают его последнюю покупку вместе с дублями и ставят сообщение. Перед
  каждым участником проверка спрашивает, включена ли тема: выключенная её останавливает.
- День, через который проверка прошла, записан (`auto_messages.scanned_on`): повторные запуски в тот же день ничего не
  делают. Включение темы и смена сроков записывают вчерашний день программы: с сегодняшнего дня, ни одного дня до них;
  смена сроков — в тот же день по новым срокам (кто уже получил сообщение по старым, снова его не получит: держит
  ключ), включение после последнего запуска дня — на следующее утро за оба дня. День отмечается, только если тема
  осталась такой, какой проверка её прочла (`AutoMessageService::scanned` сверяет сроки и отметку): сроки, сменённые во
  время проверки, оставляют день открытым, и следующий запуск проверяет его по новым. Пропущенный день (планировщик
  стоял) следующая проверка добирает, но не дальше двух дней назад (`DailyAutoMessages::CATCH_UP_DAYS`). Закрытому
  мерчанту и архивной программе — ничего.
- Ошибка у одного участника уходит в отчёт об ошибках, остальные получают свои сообщения; день не отмечается и
  проверяется снова следующим запуском (поставленные сообщения держит ключ), а команда завершается с ошибкой — это видно
  в «Состоянии системы». Участник, на котором проверка ошибается каждый раз, держит день открытым до трёх дней, и каждый
  запуск повторяет её целиком.
- При отправке модуль сообщений спрашивает и, по-прежнему ли сообщение нужно (`AutoMessageSwitches::stillDue`): если
  участник купил после той покупки, о которой оно, — пока сообщение ждало конца тихих часов, повтора или утра после
  включения вечером, — или мерчант убрал этот срок, оно пропускается с причиной `no_longer_due` («Очередь» говорит,
  почему). Покупка в ту же секунду, что и постановка сообщения, при отправке тоже видна.
- Стандартный текст «Давно вас не видели! Заходите снова — мы вас ждём.» не называет баллов: многие из тех, кто
  перестал приходить, свои баллы потратили, а «баллов: 0» никого не зовёт. Окно включения подсказывает добавить
  «Баллов на счёте: {balance}» в свой текст и предупреждает, что те, у кого баллов нет, прочтут «0».
- Кабинет: тема называется «Давно не были» (а не «Возвращение», которое легко прочесть как возврат товара). В окне
  «Включить» — сначала кому и когда уходит, потом что тем, у кого срок уже прошёл, не уйдёт, текст, что это реклама и
  уйдёт не позже лимита дня, что рекламные SMS обычно дороже служебных, совет про баллы; «Через сколько дней без
  покупок» (30, 60, 90; отмечено выбранное, сначала 30) с советом выбрать срок длиннее обычного промежутка между
  покупками. У включённой темы кнопка «Сроки» (`campaigns.publish`: больше сроков — больше сообщений). Колонка
  «Сообщение» называет сроки программы. Форма текста рекламной темы напоминает: обещая подарок или бонус за покупку,
  укажите срок акции и где прочитать её условия (38-ФЗ, ст. 9). Журнал аудита: `auto-messages.enable` со сроками и
  `auto-messages.days`.
- Уйдёт ли сообщение, решают правила рекламы в момент отправки (согласие, тихие часы, лимиты рекламы): в день, когда
  участник получил другую рекламу (поздравление с днём рождения), «Давно не были» пропустят по дневному лимиту, и позже
  оно не уйдёт.
- Миграция таблицы, которую читает каждый подтверждённый чек, ждёт её блокировку не дольше 5 секунд и сдаётся, а не
  держит чеки в очереди за долгим читателем.

### «Баллы скоро сгорят» (7h-3)

Решения владельца (2026-10-15 и 2026-11-02): это служебное сообщение — только факты, без рекламы; за 3, 7 или 14 дней
(выбирает мерчант, сначала 7) до сгорания, с ближайшей датой и числом баллов, которые сгорят в этот день, не чаще раза
в неделю одному участнику.

- **Баллы скоро сгорят** (`expiring`, служебное) — участнику, у которого ближайшие баллы программы (её основного вида,
  по опубликованным правилам; штампы и другие виды — нет) сгорают в пределах выбранного срока: сегодня или в любой из
  следующих дней до конца дня «сегодня + срок». День — день часового пояса программы, на который приходится ближайший
  момент сгорания тратимых баллов (`LedgerStats::nextExpiration`, тот же, что называет баланс); сумма — все тратимые
  баллы участника, сгорающие от этого же «сейчас» до конца этого дня (`LedgerStats::expiringOf`): партии по правилам
  сгорают в конце дня, но начисленные через API — в любой момент, и сумма учитывает их все. Стандартный текст «08.10.2026 сгорят баллы: 300.» поэтому не обещает «до
  конца дня» и всегда занимает одну SMS.
- Участнику с замороженной или заблокированной картой — нет: тратить баллы он не может; карту заморозили, пока
  сообщение ждало отправки, — оно не уйдёт. Объединённого ведут к тому, к кому перешли его баллы.
- Не чаще раза в неделю: если такое сообщение участнику или дублям, объединённым в него, ещё ждёт отправки (сколько бы
  ни ждало) или в день проверки либо за 7 дней до него ушло или окончательно не ушло, новое не ставится
  (`MemberMessages::queuedSince`, его спрашивают раньше, чем читают баллы); следующее уходит не раньше чем через 8
  дней. Не считаются пропущенные по причинам, которые проходят или не касаются участника (`QueuedMessage::PASSING`:
  тему выключили, пауза, повод пропал, дневной лимит рекламы, участника объединили, пока сообщение ждало), и не взятые
  ни одним каналом, кроме отказа провайдера принять номер участника (`QueuedMessage::LASTING_FAILURES`): такое
  предупреждение уходит снова на следующий день. «Ушло» считается от того, когда сообщение ушло или окончательно не
  ушло (`finished_at`), а не от того, когда встало в очередь. Ключ — `expiring:<участник>:<день сгорания>:<день проверки>:<сумма>`:
  в один день проверки — одно сообщение. При сроке 3 и 7 дней о дате приходит одно предупреждение, при сроке 14 дней —
  ещё одно, за 6 дней до неё, пока она ближайшая и баллы не потрачены. Баллы, которые сгорят позже в ту же неделю,
  отдельного сообщения могут не получить; у того, кто не тратит баллы, сгорающие каждую неделю, сообщения будут
  приходить примерно раз в неделю — так решил владелец, окно включения говорит об этом прямо.
- Проверка — та же ежедневная (`auto-messages:queue`, с 10:00 по часовому поясу программы, раз в день). Она смотрит
  вперёд, поэтому пропущенный день добирать не нужно; включение темы или увеличение срока сразу предупреждает всех, у
  кого баллы сгорают в новом окне (окно включения и «За сколько дней» предупреждают, что это может быть много SMS).
  Пока такое сообщение не могло бы уйти вовсе — пауза мерчанта или остановка его сообщений платформой, нет работающего
  канала (`MemberMessages::openRoutes`: SMS-канал, которому провайдер отказал из-за пустого счёта, не в счёт, пока через
  него снова не пройдёт код, сообщение или проверка) —, проверка ждёт и день остаётся открытым: иначе каждый день на
  каждого кандидата появлялась бы пропущенная или неудавшаяся запись. Когда сообщения снова могут уйти, ближайший запуск
  предупреждает тех, у кого баллы сгорают в окне. Участнику, до которого не дойдёт ни один работающий канал (для SMS
  нужен номер, для письма — адрес), предупреждение не готовится: с одной почтой у мерчанта его получат только те, у кого
  есть адрес, остальные — когда заработают SMS. Кандидаты — участники, чьи ближайшие тратимые баллы сгорают от сейчас до конца
  окна, каждый один раз, в момент ближайшего сгорания, по порядку момента и участника (`LedgerStats::expiringWithin`:
  индекс `point_lots_expiring_index` по виду баллов, моменту и участнику, а партию участника, у которого есть
  сгорающие раньше, отсеивает индекс его партий): каждая порция читает свои партии, сколько бы их ни сгорало в один
  момент, и память проверки не растёт с числом участников.
- При отправке модуль сообщений снова спрашивает, нужно ли сообщение (`AutoMessageSwitches::stillDue`): если ближайший
  день сгорания другой или сумма этого дня изменилась (баллы потратили, они сгорели, покупка перенесла срок
  «сгорающих без покупок» или их стало больше) или карту заморозили — пропуск `no_longer_due`, а на следующий день —
  новое предупреждение с верными цифрами.
- Кабинет: в окне «Включить» — «За сколько дней предупреждать» (3, 7 или 14 дней, одно значение), у включённой темы —
  кнопка «За сколько дней»; колонка «Сообщение» называет срок. Окно включения говорит, кому и когда уходит и что из
  этого следует, что в день включения сообщение сразу получат все, у кого баллы сгорают в пределах срока, как сгорают
  баллы за покупки по правилам программы (через N дней, в один день года, через N дней без покупок или не сгорают),
  что подарочные баллы со сроком не длиннее выбранного сообщение назовёт сразу после начисления, и что это служебное
  сообщение — без рекламы и призывов («Успейте!», «Ждём вас»), а изменённый текст может потребовать нового
  согласования шаблона у провайдера. Сроки хранятся там же, где сроки «Давно не были» (`auto_messages.days`,
  проверка: ровно одно из 3, 7, 14; `AutoMessages::ONE_OF_DAYS`).
- Для юриста (не решено): черновики документов программы, которые платформа предлагает мерчанту, просят согласие на
  «рекламные и информационные сообщения» и не упоминают в правилах служебных уведомлений о баллах; вместе с
  требованием предварительного согласия абонента на рассылку (ст. 44.1 ФЗ «О связи») это стоит проверить до того, как
  мерчанты включат служебные автосообщения массово.

### Дальше

- ✅ 7g-3 — очередь сообщений в кабинете: что ждёт отправки, что пропущено и почему, и сообщения каждого участника с
  его карточки (ADR-0020, «Очередь сообщений в кабинете»).
- ✅ 7h-1 — поздравление с днём рождения.
- ✅ 7h-2 — «Давно не были».
- ✅ 7h-3 — «Баллы скоро сгорят». Все темы автосообщений теперь в `AutoMessages::TOPICS`: выключатель решает отправку
  каждой; «Появится позже» остаётся только у уведомления о списании там, где у платформы нет страницы его ссылки.
- Позже: пробная отправка на свой телефон, сколько SMS в месяц уходит по теме, переменная ожидающих баллов; для
  уведомления о списании — список оспоренных оплат в кабинете, письмо и администраторам, порог в баллах (чтобы не
  тратить SMS на мелкие оплаты), контакты магазина на странице ссылки.

## Последствия

- Мерчант включает автосообщения сам, на одной странице с их текстами, видит текст и число SMS до включения;
  включённое уходит каждому участнику программы за его счёт, выключенное перестаёт уходить сразу.
- Подтверждение чека, вступление и смена уровня делают несколько запросов к базе больше (точка сохранения, выключатель),
  и около десятка — когда тема включена (шаблон, баланс, правила, очередь); отправка каждого сообщения — на один больше.
- Ежечасная задача читает выключатели каждой активной программы (запрос на тему), а в день программы — её чеки за дни,
  которым пора, и партии баллов, сгорающие в окне, и около десятка запросов на каждого найденного участника; отправка
  сообщения «Давно не были» — ещё два запроса (последняя покупка и сроки), «Баллы скоро сгорят» — ещё пять (участник,
  программа, правила, ближайшее сгорание и сумма дня); пока день «Баллы скоро сгорят» не проверен, каждый запуск ещё
  спрашивает, могут ли сообщения уйти (настройки и каналы).
- «Баллы скоро сгорят» у постоянного покупателя, который не тратит баллы, а они сгорают каждую неделю, уходит примерно
  раз в неделю (не чаще раза в 8 дней): так решил владелец; порог в баллах (не предупреждать о мелочи) и сумма за неделю вместо дня — позже, по
  запросу.
- Приветствие получает и участник, которого кассир зарегистрировал без кода, где программа так настроена
  (`confirmsPhone`): сообщение уйдёт на номер, который назвал кассир, — окно включения об этом говорит.
- Новичок, который вступил и сразу купил, при включённом приветствии благодарности за покупку не получит: если мерчанту
  важнее сообщение с баллами, он выключает приветствие.
- Включённое уведомление о списании — SMS после каждой покупки, оплаченной баллами, за счёт мерчанта; окно включения
  об этом говорит. Участник, который подтвердил списание кодом из SMS, получит и код, и уведомление.
- Ссылку может нажать и тот, кому SMS ушла по ошибке (номер, который ввёл кассир без кода). Это только защищает:
  участник замораживается, мерчант разбирается и снимает заморозку; окно включения в такой программе и письмо
  владельцам об этом предупреждают.
- SMS со ссылками провайдеры могут проверять строже: подпись отправителя и тексты со ссылками стоит согласовать с
  провайдером до включения.
