# Changelog

Формат — [Keep a Changelog](https://keepachangelog.com/ru/1.1.0/). Версии появятся к пилоту.

## [Unreleased]

### Этап 7h-3. «Баллы скоро сгорят»

- На странице «Автосообщения» можно включить «Баллы скоро сгорят» (ADR-0022): за 3, 7 или 14 дней до того, как у
  участника сгорят баллы (срок мерчант выбирает при включении и меняет кнопкой «За сколько дней», сначала 7), уходит
  сообщение с ближайшей датой сгорания и числом баллов, которые сгорят в этот день. Одному участнику — не чаще раза в
  7 дней (следующее — не раньше чем через 8 дней), поэтому при сроке 3 или 7 дней о дате приходит одно сообщение, а
  при сроке 14 дней — ещё одно, за 6 дней до неё. Участникам с замороженной или заблокированной картой оно не уходит.
- Это служебное сообщение: оно уходит и тем, кто не соглашался на рекламу, поэтому в стандартном тексте только факты —
  «08.10.2026 сгорят баллы: 300.» Окно включения напоминает, чего в нём писать нельзя, говорит, как сгорают баллы по
  правилам программы, и что в день включения сообщение сразу получат все, у кого баллы сгорают в выбранный срок.
- Каждый день в 10:00 по часовому поясу программы платформа находит, кому пора. Если участник потратит эти баллы до
  отправки или их станет больше, сообщение не уйдёт (в «Очереди» сказано почему), а на следующий день придёт новое с
  верными цифрами; так же повторится предупреждение, которое пропустили из-за выключения или не отправили из-за
  ошибки провайдера (если провайдер не принимает номер участника — только через неделю).
- Пока сообщения на паузе, нет работающего канала или на счёте у SMS-провайдера кончились деньги, предупреждения не
  готовятся: когда сообщения снова пойдут, их получат те, у кого баллы сгорают в выбранный срок. Участнику, до которого
  сейчас не дойти (для SMS нужен номер, для письма — адрес), предупреждение тоже не готовится.
- Теперь все автосообщения можно включить; пометка «Появится позже» остаётся только у уведомления о списании там, где у
  платформы нет страницы его ссылки.

### Этап 7h-2. «Давно не были»

- На странице «Автосообщения» можно включить «Давно не были» (ADR-0022; раньше тема называлась «Возвращение»):
  сообщение уходит участнику, который не покупал 30, 60 и/или 90 дней — сроки мерчант отмечает при включении и меняет
  кнопкой «Сроки», — считая от его последней покупки, по сообщению за каждый срок, пока он снова не купит. Тем, кто ни
  разу не покупал, не уходит. Покупки объединённых дублей считаются покупками участника.
- Каждый день в 10:00 по часовому поясу программы платформа находит, кому пора (ежечасная задача
  `auto-messages:queue`), а в день включения после 10:00 — в течение часа. Тем, у кого срок прошёл до включения,
  сообщение не уходит — окно включения говорит это прямо, с примером. День, который задача пропустила, она добирает на
  следующий, не дальше двух дней назад. Новые сроки действуют в тот же день; второе сообщение за один срок участник не
  получит.
- Если участник купил, пока сообщение ждало отправки (конца тихих часов, повтора), или мерчант убрал этот срок,
  сообщение не уходит; в «Очереди» сказано почему.
- Это реклама: уходит только тем, кто согласился её получать, в пределах лимитов рекламы и не в тихие часы. Окна
  включения рекламных автосообщений предупреждают, что рекламные SMS у операторов обычно дороже служебных, а форма их
  текста — что, обещая подарок или бонус за покупку, нужно указать срок акции и где прочитать её условия.
- Стандартный текст — «Давно вас не видели! Заходите снова — мы вас ждём.»: без числа баллов, потому что у многих
  ушедших баллов не осталось. Окно включения подсказывает, как добавить баллы на счёте в свой текст, и советует выбрать
  срок длиннее обычного промежутка между покупками.
- В журнале аудита — включение со сроками и «Изменить сроки автосообщения».

### Этап 7h-1. Поздравление с днём рождения

- На странице «Автосообщения» можно включить «День рождения» (ADR-0022): раз в год поздравление уходит вместе с баллами
  ко дню рождения, которые начисляет программа, — в сам день рождения или заранее, как задано в правилах, — и в нём
  сказано, сколько баллов подарено. Если программа не начисляет баллов ко дню рождения, поздравление не уходит.
- Окно включения показывает текст с настоящим числом баллов и говорит, сколько баллов и когда начисляют сейчас, что
  это реклама (уходит только тем, кто согласился её получать, утром после тихих часов, в пределах лимитов рекламы) и
  что поздравление следует за правилами; если баллов ко дню рождения нет — что поздравление не уйдёт, пока их не
  включат в «Бонусах» и не опубликуют правила.
- Стандартный текст — «Ко дню рождения дарим баллов: 300. Ждём вас!», тема письма — «подарок ко дню рождения»: баллы
  часто приходят за несколько дней до праздника, а поздравлять заранее многие считают плохой приметой. Если баллы
  приходят в сам день, окно подсказывает, что «С днём рождения!» можно написать своим текстом.
- У рекламных автосообщений в «Автосообщениях» сказано, что они уходят тем, кто согласился получать рекламу в SMS или
  письмах.
- Начисление баллов ко дню рождения теперь заново проверяет каждого участника, как всё, что меняет его баллы: тот,
  кого заблокировали, обезличили или объединили с другим, пока до него не дошла очередь, баллов не получает, а
  остальные получают — раньше объединение в эту минуту прерывало начисление всем до следующего часа. Повторные
  ежечасные запуски проходят мимо тех, кому баллы этого года уже начислены.

### Этап 7g-3. Очередь сообщений в кабинете

- В разделе «Сообщения» кабинета мерчанта — страница «Очередь» (ADR-0020): все автосообщения клиентам за 13 месяцев,
  новые сверху (коды подтверждения — по-прежнему в «Журнале»). У каждого — когда поставлено, что за сообщение, кому (со
  ссылкой на карточку), итог и почему: ждёт — чего (конца тихих часов, повтора после неудачной попытки, остановленной
  платформой отправки) и до какого времени, или уже отправляется; отправлено — SMS или письмом, а SMS — доставлено ли;
  пропущено — почему, как было в момент отправки (клиент был заблокирован, шла пауза, автосообщение выключили, у
  клиента не было телефона, а письмо отправить было нельзя, и другие причины); не отправлено — почему (не было рабочего
  канала, номер не принимает сообщения, провайдер не ответил и после повторов). Фильтры — период, итог и сообщение.
- Над таблицей — что ждёт отправки сейчас (сколько, из них — конца тихих часов и повтора) и что останавливает
  сообщения: пауза мерчанта, остановка платформы для мерчанта или для всех, ни одного подключённого канала.
- В карточке участника — кнопка «Сообщения»: автосообщения этому участнику и дублям, объединённым с ним, с итогом и
  причиной. Пропущенное правилами отправки в «Журнал» не попадает — теперь видно, почему клиент его не получил.
- Видят все, кто видит участников; каждая показанная страница очереди и открытие сообщений участника записываются в
  журнал аудита («Очередь сообщений клиентам», «Сообщения участнику»).
- Очередь помнит, чего ждёт отложенное сообщение и что его уже отправляют (`member_messages.waits_for`); миграция не
  останавливает приём чеков: проверка добавляется без блокировки таблицы, индексы строятся параллельно.

### Этап 7g-2. Уведомление о списании со ссылкой «Не вы?»

- На странице «Автосообщения» можно включить «Списание баллов» (ADR-0022): после каждой покупки, оплаченной баллами,
  покупатель получает предупреждение — сразу, в любое время суток и во время паузы сообщений. Стандартный текст
  «Списано баллов: 300. Не вы? ‹ссылка›» обычно занимает одну SMS. Окно включения показывает текст со ссылкой
  настоящего адреса и честное число SMS; говорит, что SMS уходит после каждой оплаты баллами за счёт мерчанта, что
  подтвердивший оплату кодом получит две SMS и что делает ссылка; в программе, где кассир регистрирует без кода, — что
  SMS может уйти на чужой номер.
- В тексте уведомления обязательна переменная `{link}`: без неё текст не сохранится. Вместо текста, написанного раньше
  без ссылки, уходит стандартный. Пока платформа остановила сообщения мерчанта, уведомление уходит стандартным текстом.
- Ссылка ведёт на страницу на хосте кабинета покупателя и действует 30 дней. Страница сначала только спрашивает:
  показывает, сколько баллов списано, когда и где (телефоны и мессенджеры сами открывают ссылки, и открытие ничего не
  меняет), говорит, что если баллы тратили вы — ничего делать не нужно, а вернуть баллы может только магазин. Кнопка
  «Это не я — заморозить карту» замораживает участника — тратить баллы нельзя, копить можно; уже замороженный или
  заблокированный участник не меняется. Она же завершает сеансы покупателя в кабинете покупателя и на сайтах и
  отправляет владельцам письмо: программа, баллы, номер и время чека, точка и касса, что стало с участником, что
  делать в кабинете и ссылка на карточку участника. Повторное нажатие ничего не меняет.
- В карточке участника видна причина заморозки или блокировки — и та, что написал сотрудник, и «Участник сообщил по
  ссылке «Не вы?», что не оплачивал баллами чек № …».
- Устаревшие ссылки удаляет ежедневная задача `redemption-notices:prune`; оспоренные хранятся 13 месяцев.

### Этап 7g-1. Автосообщения: приветствие, первая покупка, новый уровень

- Страница «Шаблоны» в кабинете мерчанта стала «Автосообщения» (ADR-0022): у каждого сообщения каждой программы —
  «Отправка» («Включена», «Выключена», «Появится позже») и кнопки «Включить» и «Выключить». Пока сообщение не
  включено, оно не уходит; по умолчанию все выключены. Включают владельцы, администраторы и маркетологи с
  подтверждением входа, как публикуют тексты; окно включения показывает текст, как его прочтёт участник, и сколько SMS
  он займёт. Выключить может и тот, кто ставит сообщения на паузу, — и у приостановленного мерчанта; выключенное не
  уходит и из очереди (например, ждавшее конца тихих часов). Без подключённых SMS и почты страница предупреждает, что
  сообщения не уйдут. Журнал аудита: `auto-messages.enable` и `auto-messages.disable`.
- Приветствие — участнику, который вступил на кассе, на сайте, в приложении или в кабинете покупателя (не
  загруженному из другой системы).
- Спасибо за первую покупку — один раз, после первого чека, за который начислены баллы. Покупки дубля, объединённого с
  участником, считаются его покупками. Новичку, который вступил меньше часа назад, при включённом приветствии спасибо
  не уходит: одно сообщение вместо двух подряд.
- Поздравление с новым уровнем — когда покупки подняли уровень или сотрудник поставил уровень выше; при понижении
  сообщения нет. Объединение дублей меняет уровень одним событием, к итоговому уровню (и в вебхуках тоже), поэтому
  поздравление одно.
- Стандартные тексты короче и без «На счёте»: «Добро пожаловать в программу лояльности! Спасибо, что вы с нами.»,
  «Спасибо за первую покупку! Начислено баллов: {points}.», «Поздравляем! Ваш новый уровень — {tier}.» — баллы покупки
  обычно становятся доступны через несколько дней. В свой текст можно подставить название программы, имя участника,
  баллы на счёте (доступные), баллы события и название уровня; числа — как в SMS с кодами («1 500», «12,5»);
  невидимые символы из имён и названий убираются.
- Сообщение ставится в очередь вместе с событием, а уходит по правилам отправки (тихие часы, пауза). Если сообщение
  не удалось поставить в очередь, покупка всё равно проходит; если база оборвала всю транзакцию (взаимная блокировка,
  потеря соединения), покупка завершается ошибкой, и касса её повторит.

### Этап 7f-4. Цвет карты в кабинете покупателя

- Мерчант выбирает цвет карты программы в «Кабинете покупателя» → «Цвет карты» (ADR-0021; журнал `portals.colour`):
  например, цвет логотипа. «Вернуть цвет платформы» возвращает прежний вид. В таблице кабинетов видно, какой цвет у
  каждого.
- В этом цвете — значок кабинета на экране телефона и строка браузера. Карта на значке белая на тёмном цвете и почти
  чёрная на светлом, чтобы её было видно. Значок, который покупатель уже поставил на экран телефона, может остаться
  прежним: iPhone его не обновляет, Android обновит позже.
- Кнопки, цифры и ссылки кабинета — в оттенке выбранного цвета, который читается: в светлой теме телефона слишком
  светлый цвет темнеет, в тёмной слишком тёмный светлеет (контраст не меньше 4,5 — уровень AA), текст на кнопках —
  белый или почти чёрный, что читается лучше. Цвет, который читается и так, остаётся как есть; бледный цвет остаётся
  приглушённым, яркий — ярким. Цвет платформы, выбранный вручную, — то же, что цвет платформы по умолчанию.
- Браузер хранит значки и оттенки нового цвета навсегда, а после смены цвета берёт новые: адрес называет цвет.

### Этап 7f-3. Профиль и подписки в приложении кабинета

- В кабинете покупателя (ADR-0021) — вкладка «Профиль»: имя и фамилия; день рождения — один раз, с вопросом, та ли
  это дата (исправить его потом может магазин); e-mail — новый адрес подтверждается кодом из письма, его можно
  изменить или убрать, а адрес, который указал магазин, профиль показывает неподтверждённым: подтвердить его — ввести
  ещё раз и получить письмо с кодом.
- Подписки: согласия на рекламу, которые публикует программа, — флажком, с текстом документа тут же; отписка — сразу.
  Если документ обновился, пока профиль открыт, профиль показывает новую версию и просит отметить её снова; согласие к
  прежней редакции отмечено с припиской. Правила программы и согласие на обработку данных можно прочитать в «Документах
  программы».
- Профиль объясняет, что не так: какое поле проверить, сколько попыток ввода кода осталось, когда можно получить новое
  письмо, что адрес уже у другого участника, что нет связи; кончился сеанс — просит войти заново.
- Страница «Отписаться» из рекламного письма ведёт в профиль кабинета программы, где подписку можно вернуть (участнику,
  который может войти в кабинет).

### Этап 7f-2. Вступление в программу в приложении кабинета

- Номер, которого нет в программе, после кода регистрации видит анкету (ADR-0021): имя, фамилия, дата рождения и код
  друга — по желанию; правила программы и согласие на обработку персональных данных — обязательно, реклама по SMS и
  письмами — по желанию, и каждый документ можно прочитать тут же. После «Вступить» сразу открывается карта участника.
- Возраст: по умолчанию в кабинете вступают с 14 лет, мерчант может поставить 18 — при открытии кабинета или в
  «Кабинете покупателя» → «Возраст для вступления» (журнал `portals.age`). Анкета просит отметить «Мне есть 14 лет»
  (или 18), не принимает дату рождения младше (по дню часового пояса программы) и переспрашивает, если мерчант изменил
  возраст, пока она была открыта. Подтверждённый возраст хранится в доказательствах согласий. На кассе правило не
  действует: человека видит кассир.
- Анкета объясняет, что не так: какое поле проверить (оно отмечено), что кода друга нет, что документы обновились
  (сообщение над анкетой, введённое остаётся), что номер уже вступил на кассе или код больше не действует (с кнопкой
  за новым кодом — введённое для того же номера остаётся), что нет связи.
- Кабинет мерчанта: в колонке «Вступление» — «Разрешено с 14 лет» или «с 18 лет».

### Этап 7f-1. Приложение кабинета покупателя и веб-карта

- Кабинет покупателя (ADR-0021) — теперь приложение: вход по номеру телефона и коду из сообщения (с проверкой «Я не
  робот», где у кабинета есть ключ SmartCaptcha), карта — код для кассы с QR на две минуты, баллы, уровень и сколько
  до следующего, штампы, код для друзей, — история баллов, «Выйти» и «Выйти на всех устройствах». Карту показывают те
  же виджеты, что у сайтов мерчантов.
- Веб-карта вместо Apple Wallet: кабинет ставится на главный экран телефона как приложение — с названием программы,
  значком карты и своим окном; Android предлагает «Добавить», а на iPhone карта подсказывает, как добавить её через
  «Поделиться». Без интернета страница открывается и просит назвать кассиру номер телефона.
- На устройстве не остаётся ничего о покупателе: service worker хранит только файлы приложения — и отдаёт только
  те, что совпадают с отпечатками сборки, — а вход и выход открывают страницу заново.
- Коробка «Я не робот» работает на своём хосте (`PORTAL_CAPTCHA_DOMAIN`, обязателен вместе с ключами SmartCaptcha):
  чужой скрипт капчи не видит ни сеансов, ни страниц кабинетов.
- Адрес кабинета теперь со слешем — `https://<хост>/p/<имя>/` (адрес без слеша ведёт туда же): так приложение одной
  программы на телефоне не захватывает кабинет другой с похожим именем.
- У каждого кабинета своя cookie входа с приставкой `__Host-`: соседний хост того же домена не подложит её и не войдёт
  за покупателя в чужую запись. Браузеры, вошедшие до этого, входят заново.
- Номер, которого нет в программе, пока слышит, что вступить можно на кассе: вступление в приложении — следующая часть.
- Для разработки: `php artisan db:seed --class=LocalPortalSeeder` — кабинет демо-кофейни без каналов, код входа
  пишется в журнал приложения.

### Этап 7e-4. Ссылка «Отписаться» и реклама письмами

- Реклама теперь уходит и письмом через почту мерчанта (ADR-0020), но только на адрес, который покупатель подтвердил
  сам, с его согласия на рекламные письма и всегда со ссылкой «Отписаться». Порядок — как у служебных сообщений:
  сначала письмом, а если мерчант выбрал в «Настройках» сначала SMS — сначала по SMS.
- Ссылка «Отписаться» (ADR-0021) открывает страницу на хосте кабинета покупателя: она спрашивает и одной кнопкой
  отзывает согласие на рекламные письма — без входа и кода; служебные письма и реклама по SMS остаются. Почтовые
  сервисы получают ту же ссылку в заголовках письма и отписывают своей кнопкой в один клик (RFC 8058). Ссылка
  подписана ключом приложения: для чужого письма её не подделать.
- Кабинет мерчанта: в карточке участника отзыв согласия по ссылке записан как «ссылка «Отписаться» в письме»;
  «Почта» и «Настройки» рассказывают, когда реклама уходит письмом.

### Этап 7e-3b. Покупатель указывает e-mail с подтверждением

- API участника (ADR-0021): покупатель указывает e-mail, получает письмо с кодом через почту мерчанта и подтверждает
  адрес кодом; может и убрать адрес. Код действует 15 минут, на него 5 попыток. Повторный запрос на тот же адрес в
  течение минуты возвращает то же письмо, а не отправляет новое. Писем — 3 в час и 10 в сутки на покупателя, 3 в сутки
  от покупателя на один ящик, 5 в сутки на ящик от всех и 3000 в сутки у мерчанта; варианты одного ящика (`+метка`,
  точки в Gmail) считаются вместе. Что адрес уже у другого участника, узнаёт только тот, кто ввёл код.
- Имя и день рождения в API участника теперь отдаются с e-mail (скрытым наполовину) и признаком «подтверждён»
  (`masked_email`, `email_confirmed`); у участника в Management API — тоже `email_confirmed`.
- Кабинет мерчанта: в карточке участника видно, что клиент подтвердил адрес; в журнале сообщений — письма с кодом
  («Код: подтверждение e-mail»). Неудачные письма с кодом через сервер мерчанта не тревожат «Состояние системы».
- Клиенты в PHP и TypeScript SDK получили новые методы и поля; виджеты пересобраны.

### Этап 7e-3a. Покупатель сам меняет согласия, имя и день рождения

- API участника (ADR-0018, ADR-0021): покупатель видит свои согласия с текстами документов, даёт согласие на рекламу (к
  той версии, которую видел) или отзывает его, меняет имя и фамилию и указывает день рождения, пока он не известен.
  Правила программы и согласие на обработку данных так не отозвать — без них участия нет. Согласие записывается с
  каналом «кабинет покупателя» или «сайт» — смотря кто открыл сеанс.
- День рождения, указанный покупателем позже регистрации, приносит бонус на день рождения не сразу, а когда известен
  столько, сколько программа требует участия; в акциях дня рождения он, как и указанный при вступлении в кабинете,
  учитывается через 30 дней: «день рождения на сегодня» ни бонуса, ни скидки сразу не приносит. Известный день рождения
  исправляет сотрудник в карточке участника («Исправить день рождения», с причиной в журнале аудита).
- Новые скоупы сеанса участника `consents` и `details`: кабинет покупателя даёт их своей странице, сайт мерчанта — только
  с учётными данными, которым доступны участники (`members`). Клиенты участника в PHP и TypeScript SDK получили новые
  методы; виджеты пересобраны.

### Этап 7e-2. Кабинет покупателя: вступление в программу и «Выйти везде»

- Новый покупатель вступает в программу прямо в кабинете (ADR-0021): незнакомый номер получает код регистрации — ответ
  тот же, что у кода входа, так что по нему не узнать, участник ли номер, — затем принимает правила программы и согласие
  на обработку персональных данных (реклама по SMS и письмами — по желанию), может назвать имя, день рождения и код
  пригласившего друга и сразу входит. Согласие записывается к той версии документа, которую покупатель видел: если
  мерчант тем временем опубликовал новую, вступление попросит прочитать её. Канал вступления и согласий — «кабинет
  покупателя».
- Мерчант решает, можно ли вступать в кабинете: переключатель при открытии кабинета и «Разрешить / Запретить вступление»
  (по умолчанию можно; запретить может и приостановленный мерчант — это только защищает). Вступление работает, когда
  опубликованы правила программы и согласие на обработку данных, — иначе кабинет мерчанта подсказывает, чего не хватает,
  а незнакомый номер получает отказ без SMS.
- Коды кабинета покупателя: пауза перед повторным кодом одна для кода входа и кода регистрации (по разнице пауз нельзя
  узнать, участник ли номер), а код регистрации кабинета не годится для регистрации на кассе.
- «Выйти везде» в кабинете покупателя завершает все его входы. Карточка участника показывает, на скольких устройствах
  открыт кабинет, и даёт «Выйти из кабинета покупателя везде» (потерянный телефон) — с правом блокировки карт, и у
  приостановленного мерчанта тоже.

### Этап 7e-1. Кабинет покупателя: адрес и вход по коду

- Кабинет мерчанта, «Программа» → «Кабинет покупателя» (ADR-0021): мерчант открывает кабинет программы по короткому
  имени — адрес на хосте платформы `/p/<имя>`, имя предлагается из названия программы, — меняет адрес и закрывает
  кабинет (покупатели выходят; закрыть может и приостановленный мерчант — новое защитное право `portal.close`); ссылка
  и QR-код для чека и кассы.
- Вход покупателя по коду из SMS через каналы мерчанта: перед кодом — проверка «я не робот» (Yandex SmartCaptcha; без
  ключей в рабочем окружении коды не уходят, «Состояние системы» предупреждает), код только участнику программы. Вход
  держится до выхода, но не дольше года (решение владельца); выход — сразу; блокировка участника, смена телефона,
  обезличивание и объединение завершают вход сразу.
- Коды кабинета не тратят коды касс: свои лимиты на номер и адрес, не больше половины лимита мерчанта на день и месяц,
  своя остановка при низкой доле подтверждённых кодов — коды касс при этом уходят, а остановка мерчанта считает только
  их.
- Сеанс кабинета выдаёт странице кабинета короткие сеансы плоскости участника; плоскость участника принимает запросы
  страницы своего хоста по заголовку `Sec-Fetch-Site`. Страница кабинета пока показывает название программы — приложение
  кабинета следующей частью.

### Этап 7d-3. Переключатели консоли

- Консоль, «Мерчанты» → «Сообщения и коды» (ADR-0020): видно, идут ли сообщения мерчанта (его пауза, остановка
  платформой), его правила, коды за сутки и месяц против лимитов и пределов. Администратор останавливает рекламу и
  служебные сообщения мерчанта — как пауза, но снять её может только платформа; владельцы получают письмо об остановке и
  о снятии. Мерчант видит остановку на «Настройках».
- Там же — свои пределы кодов для мерчанта (до 1 000 000 в сутки и 30 000 000 в месяц; пусто — общие пределы платформы).
- «Состояние системы»: «Остановить все сообщения» — отправка сообщений клиентам встаёт целиком, очередь ждёт и потом уходит
  по своим правилам; коды подтверждения уходят. Проверка «Сообщения участникам» показывает остановку, а не просрочку.
- Все изменения — с причиной в журнале платформы; у изменений одного мерчанта — копия без причины в его журнале.

### Этап 7d-2. Пауза и настройки сообщений

- Кабинет мерчанта, «Сообщения» → «Настройки» (ADR-0020): пауза рекламы и служебных сообщений — предупреждения
  («Списание баллов») и коды подтверждения уходят всегда, а подошедшие к отправке за время паузы пропускаются и после
  неё не уходят. Поставить на паузу может владелец, администратор и маркетолог — и у приостановленного мерчанта: новое
  право `messages.pause`. Снять с паузы — публикация (`campaigns.publish`, со свежим подтверждением).
- Правила отправки мерчанта — только строже платформенных: тихие часы до 3 часов раньше и позже (у платформы 21:00–9:00),
  реклама одному клиенту 1–3 раза за 7 дней (у платформы 3), служебные сообщения сначала письмом или сначала по SMS.
  «Шаблоны» и «Почта» показывают правила мерчанта.
- Когда коды подтверждения за сутки или месяц доходят до 80 % лимита, владельцы получают письмо (раз за период), а
  «Каналы» показывают состояние жёлтым.

### Вход по паролю, второй фактор — по желанию

- Во всех кабинетах и в консоли вход по e-mail и паролю (решение владельца, поправка ADR-0013). «2FA-приложение»
  включают и отключают в профиле по желанию; у кого оно включено, после пароля спрашиваем код, как раньше. Страницы
  обязательного подключения больше нет. Сбросить 2FA в консоли можно только у записи, у которой она включена.
- Важные действия (выпуск ключей, данные провайдеров, выгрузки, команда, полный номер телефона, изменения в консоли)
  подтверждаются раз в 10 минут: кодом — у кого второй фактор подключён, паролем — у кого нет. Пароль никогда не
  заменяет код подключённого второго фактора. Подтверждения паролем ограничены вместе с кодами (5 за 15 минут, 20
  неудач в сутки), неверный пароль — в журнале безопасности.
- Против подбора пароля из многих адресов — не больше 30 попыток в час на e-mail; браузер, где с этим e-mail уже
  входили, этот лимит не задевает, поэтому злоумышленник не может запереть сотрудника. Сообщение о лимите — в минутах.
- Пароль в открытом сеансе (смена пароля в профиле, включение и отключение 2FA) проверяется под тем же лимитом, что и
  подтверждения, неверный — в журнале безопасности («Неверный код или пароль при подтверждении действия»). Введённые
  пароль и код подтверждения не остаются на странице.
- Доступ поддержки действует в сеансе, где оператор подтвердил себя (кодом или паролем) после его открытия.
- Записанный риск: без второго фактора у операторов платформы украденный пароль открывает консоль.

### Этап 7d-1. Журнал сообщений

- Кабинет мерчанта, «Сообщения» → «Журнал» (ADR-0020): коды, проверочные сообщения и сообщения клиентам за 13 месяцев —
  когда, что, кому (номер или адрес скрыты наполовину), через какой канал, итог («Доставлено», «Не доставлено»,
  «Отправлено», «Не отправлено» с причиной) и стоимость; «Подробнее» показывает каналы по порядку — кто принял, кто
  отказал и почему.
- Фильтры по периоду, виду и итогу; поиск по номеру телефона или e-mail целиком (по слепому индексу), когда поле
  поиска покинуто, — недописанный номер не ищется. Поиски, которые ничего не нашли, ограничены: 20 за 10 минут на
  человека в журнале мерчанта. У неотправленного сообщения видно, через какой канал его пробовали отправить; два
  аккаунта одного провайдера различаются по скрытому логину. Каждая попытка отправки — своя строка: письмо, которое не
  прошло, и SMS, ушедшее вместо него, — две строки.
- Видят все, кто видит клиентов; каждая показанная страница пишется в журнал аудита (`messages.index`), каждый поиск
  по номеру или адресу — отдельной записью (`messages.lookup`: как искали и нашлось ли, без самого номера или адреса);
  новые SDK.
- Фильтр периода — общий для журналов кабинета (`Kit\Tables\DayPeriod`), журнал аудита перешёл на него.

### Этап 7c-4b. Письма участникам

- Сообщения участникам уходят письмом через почтовый ящик мерчанта (ADR-0020): служебные (приветствие, первая покупка,
  новый уровень, «баллы скоро сгорят») — сначала письмом (платформа не берёт за письма денег), потом по SMS; сообщение
  о списании баллов — сначала по SMS, потом письмом; реклама — пока только по SMS, до ссылки «Отписаться» в письмах.
  Без подключённой почты всё уходит по SMS, как раньше. Сами автосообщения появятся в этапах 7g–7h.
- Если письмо не прошло (адрес не принимает почту, письмо отклонено, сервер не ответил), служебное сообщение уходит по
  SMS; если не прошло SMS, сообщение о списании уходит письмом. Каждый испробованный маршрут — строка журнала сообщений.
  Маршрут, отказавший окончательно (например, адрес не принимает почту), в следующих попытках того же сообщения не
  пробуется. Отказ из-за ящика, который исправит только мерчант, останавливает письма до исправления.
- Сервер, который отказал мерчанту в логине слишком много раз подряд, не получает и писем, пока не пройдёт пауза, а
  отказ в логине при письме считается в ту же паузу. Сервер, который не ответил или отвечал дольше 5 секунд, в этом
  запуске отправителя больше не ждут: медленная почта одного мерчанта не задерживает сообщения других.
- Адрес участника и пароль ящика расшифровываются только в момент отправки письма.
- Письмо — от адреса и имени ящика, с темой «Программа: о чём сообщение» (название программы — до 60 знаков, как в
  шаблонах) и строкой о том, почему участник его получил; автоответчики на такие письма не отвечают. Дошло ли письмо,
  платформа не спрашивает: почтовый сервер об этом не сообщает.
- Кабинет, «Почта»: раздел «Какие сообщения уходят письмом».

### Этап 7c-4a. Почта мерчанта

- Кабинет мерчанта, «Сообщения» → «Почта»: мерчант подключает свой почтовый ящик — сервер исходящей почты (SMTP), порт,
  шифрование, логин и пароль (пароль приложения), адрес и имя отправителя; через него клиенты будут получать письма с
  его адреса (ADR-0020). Сначала платформа спрашивает сервер, подходит ли вход и принимает ли он адрес отправителя, —
  то, что он не принял, не сохраняется. Есть «Проверить», «Проверочное письмо», смена отправителя, выключение и
  удаление; меняют владельцы и администраторы со свежим вторым фактором; журнал аудита — `email-channel.*` (новые SDK).
- Платформа подключается к серверу только по имени и только к его публичным адресам, на портах 465, 587, 25 и 2525,
  только с шифрованием (TLS 1.2 и новее, сертификат по имени сервера) и только с входом, одной попыткой; весь
  разговор — не дольше 15 секунд, даже если сервер отвечает по байту. Сервер, порт, шифрование и логин меняются только
  вместе с заново введённым паролем.
- Временные сбои (сервер не достигнут, тайм-аут, DNS не ответил) записываются как «не ответил, попробуйте позже», а не
  как отказ, который исправит только мерчант. Результат проверки не записывается поверх ящика, переподключённого за это
  время.
- Страница показывает, есть ли у домена отправителя записи SPF и DMARC (у поддомена — и DMARC родительского домена):
  без них письма чаще попадают в спам.
- Подключение, смена отправителя, проверки и проверочные сообщения почты и SMS считаются в общие часовые лимиты
  мерчанта. После 3 неверных логинов мерчанта за 10 минут на одном сервере или у провайдера этот мерчант туда не ходит до
  конца этих минут, после 10 от кого угодно — никто: один мерчант больше не закрывает провайдера для остальных.
- Журнал сообщений хранит маску адреса получателя до 100 знаков. Письма участникам — следующая часть (7c-4b).

### Этап 7c-3. Статусы доставки

- Платформа узнаёт у провайдера, дошло ли сообщение участнику до телефона (ADR-0020): `messages:check-delivery` раз в
  минуту спрашивает SMSC и SMS Aero через 1, 5 и 30 минут, 2, 12 и 24 часа после отправки — доставлено, не доставлено
  (почему: истёк срок, номер недоступен, неверный номер, отклонено, нет денег) или, если провайдер так и не ответил,
  неизвестно. Настраивать у провайдера ничего не нужно. Мерчанты идут по очереди, провайдера, который не ответил, в
  этом запуске больше не ждут.
- SMSC получает номер участника, только пока он тот же, на который ушло сообщение; SMS Aero ищет по id. Аккаунт, который
  отказывает из-за логина, отправителя, доступа или нечитаемых данных, не спрашивают; закрытого мерчанта — тоже. Отказ
  из-за аккаунта запоминается, только если мерчант за это время не сменил данные для входа (так же теперь при отправке
  кодов и сообщений). Коды и проверочные SMS не отслеживаются.
- `messages:send` и `messages:check-delivery` работают в фоне и не задерживают другие задачи планировщика.
- Статус хранится в журнале сообщений и виден у сообщения участнику; страница журнала — следующий этап.

### Этап 7c-2. Шаблоны сообщений

- Темы автоматических сообщений участникам — приветствие, первая покупка, новый уровень, списание баллов, день
  рождения, возвращение, «баллы скоро сгорят» — со своим назначением (служебное, предупреждение, реклама) и переменными
  (`{program}`, `{first_name}`, `{balance}`, `{points}`, `{tier}`, `{date}`); у каждой темы есть стандартный текст
  платформы (ADR-0020).
- Кабинет мерчанта, «Сообщения» → «Шаблоны»: свои тексты по программам, с тем, как их прочтёт участник, и числом SMS
  (с примерами и с самыми длинными значениями); возврат к стандартному тексту и история версий. Меняют владельцы,
  администраторы и маркетологи — право публикации акций, со свежим вторым фактором; журнал аудита —
  `message-templates.publish` (новые SDK). Сами сообщения начнут уходить с автосообщениями.
- Текст проверяется: только переменные своей темы и что-то помимо них, до 300 знаков, без служебных и невидимых
  символов, и с самыми длинными значениями переменных он помещается в сообщение. Очередь сообщений участникам теперь
  тоже не принимает служебные символы C1 и невидимые символы форматирования.

### Этап 7c-1. Сообщения участникам: очередь и правила отправки

- Модули платформы ставят сообщения участникам в очередь (`MemberMessages`, ADR-0020): один ключ мерчанта — одно
  сообщение, текст хранится зашифрованным только до отправки и пишется, пока участник удержан. Отправляет их
  `messages:send` раз в минуту (один отправитель на все серверы) SMS через каналы мерчанта, с переходом на следующий
  канал и повтором через 5, 30 и 120 минут, если провайдер не ответил; каждая попытка — строка журнала сообщений.
- Мерчанты идут по очереди, предупреждения мерчанта — раньше его остальных сообщений; запуск длится не дольше
  50 секунд, и провайдера, который не ответил, в этом запуске больше не ждут. Принятое провайдером второй раз не уходит,
  даже если платформа не смогла это записать.
- Правила проверяются в момент отправки: реклама — только с согласием на рекламу по SMS, не больше одного сообщения в
  день и трёх за семь дней (дни — по часовому поясу программы); реклама и сервисные сообщения не уходят с 21:00 до
  9:00 по часовому поясу программы; предупреждения уходят сразу. Участники закрытого мерчанта, обезличенный,
  объединённый и неизвестный участник не получают ничего, заблокированный и участник архивной программы — только
  предупреждения; SMS — только на мобильные номера России.
- Обезличивание стирает тексты ждущих сообщений. Сообщения и журнал сообщений хранятся 13 месяцев
  (`messages:prune`). «Состояние системы» — новая проверка `communications.messages` (сообщения ждут отправки больше
  10 минут). Интерфейса пока нет: шаблоны и страница «Сообщения» — следующие части.

### Этап 7b. Защита от накрутки SMS

- У мерчанта — лимиты кодов подтверждения на сутки и месяц (по московскому времени; по умолчанию 500 и 15 000, в
  пределах платформы): кабинет, «Каналы» → «Изменить лимиты», там же — сколько кодов ушло сегодня и в этом месяце. Код
  считается в лимитах до отправки, поэтому одновременные запросы не превышают лимит; код, который каналы точно
  отклонили, в счёт не идёт, а код без ответа провайдера — идёт. Исчерпан лимит — 429 `verification_suspended` с
  `reason` `monthly_limit` или `daily_limit` и `retry_after` (и заголовком `Retry-After`).
- Автостоп при низкой доле подтверждённых кодов теперь хранится в базе, смотрит только на коды после прошлой остановки
  и растёт: 15 минут, час, 6 часов, сутки; мерчант видит остановку на «Каналах» и может возобновить отправку. Об
  остановке и исчерпании лимита владельцы получают письмо. В песочнице лимиты мерчанта и автостоп не действуют.
- Лимит адреса считает адреса IPv6 сетью /64. Неподтверждённые коды старше 30 дней удаляются (`verification:prune`).
- Работа «после отката» (счётчики лимитов кассы и адреса, отметки, письма) выполняется один раз и после того, как
  Laravel забыл откаченную транзакцию: раньше счётчик кассы при отказе запроса с кэшем в базе мог засчитаться дважды.
- Веб-касса объясняет, почему коды остановлены. Новые действия аудита `code-limits.update` и `code-limits.resume`
  (новые SDK).

### Этап 7a-2. Страница «Каналы» в кабинете мерчанта

- Кабинет мерчанта, раздел «Сообщения» → «Каналы» (ADR-0020): аккаунты мерчанта у SMSC.ru и SMS Aero — подключение с
  проверкой у провайдера, проверка аккаунта и баланс, проверочное SMS, отправитель, коды в Telegram, название, порядок,
  отключение, удаление, новые данные для входа. Видят все в мерчанте (без данных для входа), меняют владельцы и
  администраторы — новое право `channels.manage` со вторым фактором, не через доступ поддержки. Журнал аудита —
  `channels.*` (новые действия в `AuditAction`, новые SDK).
- Если провайдер за 10 минут отклонил 10 логинов, кто бы их ни прислал, запросы с логином к нему ждут до конца этих
  минут: провайдер иначе заблокирует адрес платформы для всех. «Проверить» не снимает отказ в имени отправителя —
  его снимает новое имя или проверочное SMS. После удаления канала остальные сдвигаются вверх.
- «Готовность к запуску» требует работающий канал для программы, касса которой подтверждает кодом телефон нового
  клиента или оплату баллами, и говорит, что сделать.
- «Состояние системы» в консоли: коды, которые за час не ушли из-за сбоев провайдеров, — предупреждение с трёх
  (`communications.codes`).

### Этап 7a-1b. Регистрация на кассе без кода

- У программы — настройка «Регистрация на кассе» (кабинет, «Программы»): по умолчанию веб-касса подтверждает телефон
  нового участника кодом; мерчант без SMS-аккаунта может разрешить регистрацию без кода. Переключает тот, кто
  управляет веб-кассой (`till.manage`: свежий второй фактор, не через доступ поддержки); выбор записывается в журнал
  аудита (`programs.update`).
- Без кода касса просит сверить номер с клиентом, записывает только обязательные согласия (без рекламных и без кода
  приглашения) и называет кассира; Runtime API для кассы вида `web_cashier` требует того же. Касса перечитывает
  настройку, открывая каждую регистрацию. В доказательство согласия теперь записываются и ключ, и устройство кассы.

### Этап 7a-1. Коды через каналы мерчанта

- Коды подтверждения уходят через аккаунты мерчанта у SMS-провайдеров — SMSC.ru и SMS Aero (ADR-0020, модуль
  `communications`): включённые каналы по порядку, следующий принимает код, если провайдер отказал, — всё за 8 секунд.
  Канал может сначала отправлять код в Telegram; если участник просит код ещё раз, он уходит по SMS. Канал с неверными
  данными для входа, отправителем или доступом коды больше не пробуют, пока мерчант их не поправит. Данные для входа
  проверяются у провайдера до сохранения и хранятся запечатанными, наружу — только маскированный логин. Журнал
  сообщений хранит, кому, когда и через какой канал ушёл код и что ответил каждый провайдер, без текста и номера.
- Runtime API: без включённого канала — 409 `code_delivery_unavailable` (лимиты не тратятся), если все каналы
  отказали — 409 `code_delivery_failed`, коды — только на мобильные номера России (422 `mobile_phone_required`);
  `channel` ответа — `messenger` для кода в Telegram (новые SDK). Неудачный код считается в лимитах, а коды одного
  номера — по очереди. Код для списания называет число баллов в точности типа баллов программы.
- Веб-касса говорит, куда ушёл код (SMS или Telegram), и объясняет новые отказы. Без каналов код пишется в журнал
  приложения только при разработке и в тестах.

### Этап 6l-3. «Объединить дубли» в кабинете мерчанта

- В «Действиях» карточки участника — «Объединить с дублем» (ADR-0019): дубль находят по телефону, номеру карты или
  внешнему идентификатору, страница показывает баллы и штампы обоих, карты, уровни, промокоды и бонусы, которые
  перейдут или перестанут работать, или почему объединить нельзя, и предупреждает, если телефон, почта или дата
  рождения есть только у дубля (они удалятся). Объединяет владелец или администратор
  (`members.merge`: второй фактор, не через доступ поддержки) с причиной и словом «объединить»; журнал аудита
  (`members.merge`) называет обе записи и причину.
- Карточка объединённого участника показывает основную запись и ссылку на неё. Новое действие аудита
  `members.merge` — в `AuditAction` Management API (новые SDK).

### Этап 6l-2. API после объединения участников

- Runtime API отвечает на запросы с id объединённого участника — поиск, баланс, история, покупки, коды, баллы за
  действия, расчёт и проведение чека — 409 `member_merged` с `survivor_id`, id записи, у которой теперь всё (ADR-0019).
  Веб-касса сама показывает эту запись вместо объединённой и просит повторить действие. Офлайн-чек с id дубля
  по-прежнему принимается и начисляет основной записи, даже если объединение идёт в тот же момент.
- Сеанс виджетов объединённого участника не работает (401 `unauthenticated`), новый ему не открывается (409
  `member_merged`); внешний id мерчанта находит основную запись.
- Management API показывает объединённого участника (`merged`, `merged_into_id`) и его историю, а корректировки баллов,
  фиксацию уровня, смену статуса и обезличивание отклоняет (409 `member_merged`); персональный промокод ему не
  выдаётся (422 `invalid_promo_code`). Код `member_merged` — в каталогах ошибок обоих API (новые SDK).

### Этап 6l-1. Объединение участников в модулях

- `MemberMerges` (модуль `support`, ADR-0019) объединяет дубль участника с основной записью одной транзакцией: баллы
  переходят со своими сроками (перенос 6k), карты и внешний идентификатор — тоже, покупки для уровней и использования
  акций и промокодов суммируются, остаётся высший уровень, бонусные награды — по одной каждого вида на человека,
  персональные промокоды дубля отключаются, его контакты и коды для кассы удаляются, а согласия отзываются. Дубль
  остаётся объединённым навсегда (`merged`): его не найти ни по телефону, ни по карте, для него ничего не делается
  (`member_merged`). `preview` показывает, что объединение сделает и что ему мешает: незавершённые покупки, заморозка,
  блокировка, обезличивание, внешние идентификаторы у обоих.
- Чеки дубля после объединения действуют на основную запись: возврат, отмена и подтверждение (баллы, уровень, лимиты
  акций, бонусы); чек из офлайн-пакета с id дубля начисляет ей. Покупки дубля — покупки основной записи: касса находит
  их среди её покупок для возврата, условия «первая покупка» и счётчик покупок учитывают их; лимиты баллов за действия
  и наград за приглашения считают и награды дубля.
- Обезличивание основной записи стирает и имена её дублей. Новый вебхук `member.merged`; статус `merged` и
  `merged_into_id` — в схемах участника Runtime и Management API (новые SDK).

### Этап 6k. Перенос участника в леджере

- `Ledger::transferMember` переносит всё, что есть у дубля участника, к основной записи (ADR-0019): партии баллов
  меняют владельца и сохраняют сроки активации и сгорания, скользящий срок и журнал движений — порядок списания общий,
  а возврат покупки дубля возвращает баллы в те же партии; балансы переходят транзакциями «Перенос баллов» через
  клиринговый счёт. Долг дубля переходит тоже: доступные баллы основной записи покрывают, что могут, остальное
  остаётся долгом; баллы, пришедшие к основной записи с долгом, сначала гасят его. Во всех типах баллов программы,
  штампы тоже; просроченные резервы дубля перенос снимает сам.
- Объединённый участник не получает новых баллов, резервов и корректировок (`member_merged` с `survivor_id`), в том
  числе в типах баллов, созданных позже, а повтор по ключу того, что он получил до объединения, возвращает результат.
  Отмена начислений, возврат оплаченного баллами и обслуживание партий его прошлого идут у основной записи, в том числе
  по цепочке объединений (не длиннее 8). Участник с активным резервом не переносится (`member_has_active_holds`);
  повтор переноса возвращает его результат.
- Гарантии базы: партия меняет владельца только на записанного преемника, объединённому партию не создать, его счета
  после отметки не меняются; ночная сверка проверяет объединённых участников и клиринг каждого переноса. Новые
  значения проверок в таблицах леджера добавляются без долгой блокировки таблиц.
- История баллов в кабинете и в виджете участника называет операцию «Перенос баллов» (новая сборка виджетов).

### Этап 6j-3. Виджеты участника

- Веб-компоненты для сайта мерчанта: `<loyal-member-card>` (баллы, которые можно потратить, ещё не доступные, в резерве
  и ближайшее сгорание, уровень и путь до следующего, штампы, код для друзей), `<loyal-points-history>` (история баллов
  с подгрузкой) и `<loyal-presentation-code>` (код для кассы и его QR-код с обратным отсчётом). Страница даёт им
  функцию `tokenProvider`, которая берёт сеанс участника у бэкенда сайта; виджеты с одной функцией делят сеанс,
  заменяют истёкший сами, а когда сеанса нет — сообщают событием `loyal-session-expired`. `endSession()` (участник
  вышел) сразу убирает его данные из всех виджетов с той же функцией и закрывает сеанс, ничего от него больше не
  используется; `refresh()` показывает данные заново. Адрес API — сайт скрипта или свойство `api` (не атрибут: чужая
  разметка на странице не направит сеанс участника на свой адрес).
- Замороженному участнику карта показывает баллы на счёте и предупреждение, а не «Можно потратить»; штампы — до
  следующей бесплатной единицы и сколько бесплатных уже можно получить; код для кассы виджет показывает две минуты от
  запроса по времени устройства, так что неверные часы телефона его не продлевают.
- Оформление переменными `--loyal-*` и частями `::part()`, любой текст заменяется своим (свойство `texts`, например
  «бонусы» вместо «баллов»). Виджеты рисуются в Shadow DOM только текстовыми узлами, QR-код — картинкой; строгой
  политике CSP страницы хватает `script-src` и `connect-src` с адресом платформы и `img-src data:`.
- Скрипт — один модуль на версию: `/embed/v1/<версия>/loyal-widgets.js` с integrity (SRI) из `build.json`.
  Опубликованная версия не меняется и не удаляется: сборки хранятся в git, `composer widgets:build` добавляет новую,
  `composer widgets:test` (и CI) проверяет, что сборка исходников закоммичена. Веб-серверу нужны заголовки CORS на
  `/embed/` (настройки nginx и Apache — в руководстве).
- Руководство для партнёров `docs/api/widgets.md`; раздел «Виджеты» кабинета партнёра — код для страницы с текущей
  версией и integrity, шаги встраивания, CSP и оформление.
- Локальное демо: `php artisan db:seed --class=LocalWidgetsSeeder` и страница `/widgets-demo` (только окружение
  `local`) — сайт на `127.0.0.1` или `[::1]` с виджетами, которые говорят с API на `localhost`.

### Этап 6j-2. Клиент участника в SDK

- `MemberClient` в PHP и TypeScript SDK — клиент API участника: профиль с баллами, уровнем и штампами, история баллов
  (с перебором страниц), код для кассы с QR-картинкой, закрытие сеанса. Создаётся с сеансом `lms_…`, который открыл
  бэкенд сайта (`issueMemberSession`), и необязательным поставщиком сеансов: когда сервер отвергает сеанс (истёк,
  закрыт, отозван ключ сайта), клиент один раз берёт новый и повторяет запрос; после `endSession()` следующий вызов
  тоже берёт новый сеанс. Уже закрытый сеанс при `endSession()` — не ошибка.
- Вне браузера (на сервере, в тестах, в React Native) клиент участника отправляет сайт сеанса заголовком `Origin`
  (параметр `origin` обязателен), в браузере его ставит сам браузер; клиент участника работает в браузере без
  `dangerouslyAllowBrowser`. `endSession()` закрывает именно тот сеанс, который держит клиент, что бы ни делали
  параллельные вызовы.
- Контракт SDK: `DELETE` безопасен для повтора; заголовок `Origin` — управляемый (вызывающий не может его задать).
  Новые эталонные векторы 23–27 проходят оба SDK; сгенерированы операции и типы API участника, константа
  `ProblemCode::ORIGIN_MISMATCH`, версия `MEMBER_API`.
- Сквозной тест: SDK партнёра открывает сеанс, клиент участника читает профиль и историю, выпускает код, выходит и
  берёт новый сеанс у поставщика.

### Этап 6j-1. Сеансы участника и API участника

- Новый скоуп Management API `widgets`: `POST /member-sessions` открывает участнику сеанс для виджетов на сайте
  мерчанта — токен `lms_…` (в песочнице `lms_test_…`) на одного участника (по `member_id` или `external_id`), один
  сайт (`origin`, только https, кроме локальной разработки; кириллический домен — в punycode) и 1–60 минут (по
  умолчанию 15). Скоупы сеанса: `profile`, `history` (по умолчанию) и `presentation_code` — его дают только учётные
  данные, у которых есть и `members`: касса списывает баллы по коду участника без SMS. Сеанс работает, пока действуют
  ключ или клиент, которые его открыли: их отзыв останавливает и сеансы. Программа — только активная, заблокированному
  участнику — 409 `member_blocked`. `POST /member-sessions:revoke` закрывает все сеансы участника. Оба работают и у
  приостановленного мерчанта; журнал аудита называет участника и сеанс.
- Новый API участника `/api/member/v1` (`docs/api/member-v1.yaml`): профиль с баллами, уровнем и штампами, история
  баллов, код для кассы с QR-картинкой и закрытие своего сеанса. Запрос принимается только со страницы сайта сеанса
  (заголовок `Origin`, иначе 403 `origin_mismatch`); заблокированный или обезличенный участник получает 401 (закрыть
  сеанс можно всегда). Лимит — 60 запросов в минуту на участника со всеми его сеансами и 6000 на мерчанта. Истёкшие
  сеансы удаляются через сутки (`member-sessions:prune`).
- CORS: Runtime API и API участника отвечают страницам любых сайтов без cookie и открывают им заголовки повторов,
  лимитов и окружения; Management API отвечает браузерам других сайтов без CORS-заголовков, и страница не прочитает
  ответ (раньше действовали настройки фреймворка для всех `api/*`).
- В кабинетах право «Виджеты участника»; разработчик партнёра его не выдаёт: сеанс показывает профиль и историю баллов
  участника. ADR-0018.

### Этап 6i-4b. Консоль приглашает владельца партнёра; «Виджеты»

- В «Партнёрах» консоли — «Пригласить владельца»: администраторы платформы (`partners.manage`, со вторым фактором)
  приглашают письмом владельца работающего партнёра, по одному приглашению за раз (новое отменяет ждущее).
  Приглашение принимается в кабинете партнёра; если человек уже в команде партнёра, его роль меняется на «Владелец».
  Действующие владельцы партнёра получают письмо с замаскированным адресом; уведомление в консоли говорит, скольким
  оно ушло. «Отозвать приглашение владельца» — тоже `partners.manage`, работает и у приостановленного партнёра.
- Домен: `Invitations::invitePartnerOwner`, `pendingPartnerOwner`, `revokePartnerOwnerInvitation`,
  `PartnerMemberships::addOwnerByPlatform`, `TeamNotices::partnerOwnerInvited` (адрес берётся из приглашения); у
  приглашений в команду партнёра — отметка «от платформы», только владельцу (миграция).
- Журнал аудита: `partners.invite-owner` и `partners.owner-invitation-revoke` с партнёром и приглашением, без адреса,
  — у платформы и копией у партнёра.
- В кабинете партнёра — раздел «Виджеты»: заготовка с рассказом о будущих виджетах участника (этап 6j).

### Этап 6i-4a. Партнёр передаёт мерчанта первому владельцу

- В «Мерчантах» кабинета партнёра — «Пригласить владельца»: владельцы и администраторы партнёра (новое право
  `merchants.invite_owners`, со вторым фактором) приглашают письмом первого владельца работающего мерчанта, пока у
  мерчанта нет владельца с работающей учётной записью. Принявший становится владельцем кабинета мерчанта (если он уже в
  команде мерчанта — в своём же членстве); дальше команду собирает он сам. Если владелец уже есть — «У мерчанта уже
  есть владелец». Новое приглашение партнёра отменяет прежнее, ещё не принятое; сотрудник партнёра, которому команда
  мерчанта закрыла доступ, мерчанта не передаёт.
- «Отозвать приглашение владельца» — право `invitations.revoke`: только защищает, поэтому работает и у
  приостановленного партнёра. Окна приглашения и отзыва называют ждущее приглашение.
- Домен: `Invitations::inviteMerchantOwner`, `pendingMerchantOwner`, `revokeMerchantOwnerInvitation`,
  `TenantMemberships::addFirstOwner` и `hasOwner` (двух «первых» владельцев одновременно не бывает, передача одна за
  раз), у приглашений мерчанта — партнёр, который пригласил, только владельцу (миграция).
- Журнал аудита: `merchants.invite-owner` и `merchants.owner-invitation-revoke` с мерчантом и приглашением, без
  адреса, — у партнёра и копией у мерчанта, не больше 30 в час от человека.

### Этап 6i-3b. Ключ кассы через API — только с правом «Участники»

- Management API выпускает ключ кассы (`POST /terminals/{terminal}/api-keys`) только учётным данным со скоупами
  `organization` и `members`; без `members` — 403 `scope_missing`. Касса находит участников по телефону и тратит их
  баллы, поэтому выпустить её ключ может лишь тот, кто сам видит участников. Так клиент разработчика партнёра больше
  не обходит запрет на данные участников. Отзыв ключа кассы по-прежнему требует только `organization`.
- В кабинетах право «Организация» называется «Организация: точки и кассы», а формы выпуска ключей подсказывают, что
  ключи касс выпускает ключ с правами «Организация» и «Участники».

### Этап 6i-3. Кабинет партнёра: ключи доступа к Management API

- «Ключи доступа» партнёра: его OAuth-клиенты с публичным идентификатором, правами, тем, кто выпустил, временем
  последнего токена и состоянием, без секретов. Владельцы, администраторы и разработчики выпускают ключ со вторым
  фактором — секрет показывается один раз; у роли свой потолок прав ключа: разработчик не даёт права на участников и
  журнал аудита (`PartnerCredentials` с потолком роли). Отзыв — право `credentials.revoke`, со вторым фактором; оно
  только защищает, поэтому работает и у приостановленного партнёра.
- «Команда» партнёра: закрывая доступ сотруднику, можно сразу отозвать действующие ключи, которые он выпустил, — в той
  же транзакции.
- Журнал аудита: `oauth-clients.store` (права и `client_id`, без названия) и `oauth-clients.revoke` из кабинета
  партнёра.

### Этап 6i-2b. Отзыв приглашений — защитное действие

- Ждущее приглашение в команду можно отозвать и у приостановленного мерчанта или партнёра: новые права
  `invitations.revoke` (владельцы и администраторы) и `invitations.revoke_owners` (приглашение владельца — владельцы)
  не считаются записью, как отзыв ключей. Пригласить, сменить роль или закрыть доступ у приостановленного по-прежнему
  нельзя; сотрудники партнёра приглашения в команды мерчантов не отзывают.

### Этап 6i-2. Кабинет партнёра: команда и приглашения

- «Команда» партнёра: сотрудники (и с закрытым доступом) и ждущие приглашения. Владельцы и администраторы приглашают
  людей письмом, меняют роли, закрывают и открывают доступ, отзывают приглашения — со вторым фактором; владельцев
  назначают и трогают только владельцы, свою запись никто не меняет.
- Приглашения в команду партнёра (`Invitations::inviteToPartner`, `pendingInPartner`, `revokePartnerInvitation`):
  письмо на русском с названием партнёра и ролью, страница приглашения в кабинете партнёра, принятие от имени
  пригласившего; в команду приостановленного партнёра не приглашают и не вступают.
- Журнал аудита партнёра: `team.*` (роль и id, без адреса) и `invitations.accept`.

### Этап 6i-1. Кабинет партнёра: мерчанты и журнал

- Кабинет партнёра `/partner/{id партнёра}` для команды партнёра (с обязательным вторым фактором и «Забыли пароль?»,
  как остальные кабинеты); у приостановленного партнёра — только чтение.
- «Мерчанты»: все мерчанты партнёра с поиском по названию, идентификатору или идентификатору у партнёра и фильтром по
  статусу; «Добавить мерчанта» — владельцы и администраторы партнёра (идентификатор у партнёра уникален); «Открыть
  кабинет» — в кабинет мерчанта по роли сотрудника (разработчику — только в кабинеты своих команд мерчантов).
- «Журнал аудита» партнёра: что сделано с партнёром вне его мерчантов; по имени — только люди партнёра.
- В кабинете мерчанта у сотрудника партнёра — ссылка «Кабинет партнёра» в меню пользователя.

### Этап 6m-2. Кабинет мерчанта: баллы за действия

- Раздел «Баллы за действия» в «Программе лояльности»: действия программы с баллами, лимитом участника, бюджетом
  (сколько из него уже начислено), сроком жизни баллов и статусом; «Другая программа» — переключение программ.
- Создать действие, изменить его условия и возобновить — право публиковать акции (`campaigns.publish`: владелец,
  администратор, маркетолог) со вторым фактором, не через доступ поддержки: это запускает или меняет выплату баллов.
  Отправить в архив — `campaigns.manage`.
- Новое право `activities.pause` — приостановить действие (владелец, администратор, маркетолог, полный доступ
  поддержки). Оно только защищает, поэтому остаётся и у приостановленного мерчанта.
- Условия сохраняются только поверх тех, с которыми открылась форма: если их изменили, пока форма была открыта, правка
  не проходит. Ошибки полей называют границы в единицах типа баллов. Подзаголовок говорит, почему нельзя создать
  действие (нет рабочего типа баллов, уже 100 действий) и что правила ещё не опубликованы.
- Карточка участника: блок «Баллы за действия» — последние 20 начислений, у отменённых — когда и сколько списано.
  История баллов: основание «Баллы за действие «название»».
- Журнал аудита: `activities.store`, `activities.update`, `activities.pause`, `activities.activate`,
  `activities.archive` — код, тип баллов и условия, без названия. В записи об отказе на страницах действий, акций и
  правил — только id программы мерчанта, а не текст из адреса.

### Этап 6m-1. Баллы за действия: домен и API

- Новый модуль `activities` (ADR-0017): действия программы — код, который присылает сайт, тип баллов, баллы одного
  начисления, срок их жизни, лимит участника «N раз за день, неделю, месяц, год или всё время» (часовой пояс программы)
  и необязательный бюджет баллов. Условия меняются сразу, без публикации правил; каждое начисление хранит свои.
- Runtime API: `GET /api/v1/activities` — действия, которые начисляют баллы сейчас; `POST
  /api/v1/members/{member}/activities` — сообщить о действии участника с `event_id` события в системе мерчанта
  (одно событие — одно начисление); `POST /api/v1/activity-rewards/{reward}:cancel` — забрать баллы, если отзыв не
  прошёл модерацию: потраченные — по политике программы для возвратов, в бюджет возвращается то, что забрано, а
  отменённое начисление остаётся в лимите участника. Начисление идёт через леджер, по одному на действие: лимит, бюджет
  и повтор события не обходятся одновременными запросами; обезличивание участника ждёт начисления.
- Новый скоуп ключа `activities` — только для ключей сайта, приложения и интеграций (`ApiScope::SERVER_TERMINALS`),
  не для касс; в кабинете — право «Баллы за действия» при выпуске ключа.
- Management API: действия программы — список, создание, просмотр, замена условий, приостановка, возобновление и
  архив; изменения — в журнале аудита (`activities.*`). Приостановить действие может и приостановленный мерчант.
- Вебхуки `activity.rewarded` и `activity.reversed`; в истории баллов участника — основание «Баллы за действие».
- Коды ошибок: `activity_not_found`, `activity_inactive`, `activity_already_reported`, `activity_limit_reached`,
  `activity_budget_exhausted`, `activity_reward_not_found`, `member_blocked`, `activity_exists`,
  `activity_state_conflict`, `invalid_activity`. SDK перегенерированы.

### Этап 6h-3b. Кабинет мерчанта: каталог

- «Категории» и «Товары» в разделе «Программа лояльности»: строки с ограничениями (не участвует, без начисления,
  без оплаты баллами, без акций; у товара — минимальная цена), поиск товара по артикулу или названию, товары
  категории из её строки. Право `catalog.manage` (владелец, администратор, маркетолог) — добавить строку и изменить
  её в форме.
- Загрузка из файла CSV, как его сохраняет таблица: UTF-8, UTF-16 («Текст Юникод») или Windows-1251, разделитель
  «;», «,» или табуляция, заголовки по-русски или по-английски — все столбцы, чтобы пропущенный не снял ограничение.
  Файл загружается целиком или не загружается вовсе: до 20 ошибок названы по строкам в уведомлении, которое
  остаётся до закрытия. Файл таблицы (.xls, .xlsx), файл с испорченными символами и артикул, ставший числом
  4,6E+12, — ошибка с советом. До 20 000 строк и 5 МБ, 20 загрузок в час; есть образец файла. Загрузки Livewire —
  только вошедшему сотруднику: файл до 5 МБ, 10 в минуту и 200 в сутки на человека.
- Журнал аудита: `catalog-categories.upsert`, `catalog-products.upsert` — коды и ограничения, без названий; у файла —
  число записанных строк и SHA-256 файла.
- Защищённое действие может закрывать форму при отказе (`GuardedAction::refusalClosesForm()`).

### Этап 6h-3a. Каталог в Management API

- `PUT /catalog/categories` и `PUT /catalog/products` — категории и товары пачкой до 1000 штук по коду и артикулу
  (с ограничениями лояльности: не участвует, без начисления, без оплаты баллами, без акций, минимальная цена
  единицы для оплаты баллами); `GET /catalog/categories` и `GET /catalog/products` — страницы по коду и артикулу,
  товары с фильтром по категории и поиском по артикулу или названию. Скоуп `programs`, изменения — в журнале
  аудита, приостановленный мерчант только читает. SDK обновлены.
- Категория, указанная родителем самой себе, отклоняется ответом `invalid_catalog_data`, а не ошибкой базы.

### Этап 6h-2b. Защитные действия приостановленного мерчанта

- Приостановленный мерчант, чьи кассы продолжают работать, может отключить промокод или партию промокодов (если
  они утекли) — в кабинете и в Management API (`promo-codes.disable`, `promo-code-batches.disable`) — и заблокировать
  потерянную карту участника в кабинете, как отзыв ключей. Остальное у него по-прежнему только читается; доступ
  поддержки к приостановленному мерчанту, как и раньше, только читает.
- Новые права ролей: `promo_codes.disable` (владелец, администратор, маркетолог, полный доступ поддержки) и
  `members.block_cards` (владелец, администратор, поддержка, полный доступ поддержки); блокировка карты и отключение
  промокодов теперь идут по ним.

### Этап 6h-2. Кабинет мерчанта: промокоды

- «Промокоды» акции (ссылка у каждой акции в «Акциях»): общие и персональные коды, новые сверху, с применениями,
  лимитом на участника, сроком и статусом; любой код акции, и из партии, находится по всему тексту. Право
  `promo_codes.manage` — создать общий код (лимиты, срок в поясе программы) и отключить код.
- «Партии промокодов»: выпуск партии одноразовых кодов (до 100 000, начало кода, длина, срок), сколько кодов
  применено и отключено, отключение всех ещё действующих кодов партии. Выгрузка кодов партии файлом CSV — право
  `promo_codes.export`, со свежим вторым фактором, не через доступ поддержки; выгрузка записывается в журнал.
- Карточка участника: «Выдать промокод» — одноразовый код акции, которая работает только по промокоду; сработает
  только у этого участника. Код показывается сотруднику, в журнал попадают участник, акция и id кода, без самого кода.
- Публикация и запуск акций — отдельное право `campaigns.publish` (владелец, администратор, маркетолог) со свежим
  вторым фактором, как публикация правил; доступ поддержки готовит черновики акций, но не публикует и не запускает их.
- Management API: `POST /promo-code-batches/{batch}:disable` отключает ещё действующие коды партии; персональный
  промокод выдаётся только участнику программы акции и не обезличенному (иначе `invalid_promo_code`); начало кодов
  партии — с буквы или цифры (код, начатый с «-», не срабатывал на кассе); партия выпускается целиком или не
  выпускается, у акции — не больше 1 000 000 выпущенных кодов; в новых кодах нет буквы E (таблицы читали коды вида
  222E22 как числа). SDK обновлены.
- Журнал аудита: `promo-codes.store`, `promo-code-batches.store`, `promo-code-batches.show`, `promo-codes.disable`,
  `promo-code-batches.disable`, `personal-promo-codes.store`.

### Этап 6h-1. Кабинет мерчанта: конструктор акций

- «Акции» в разделе «Программа лояльности»: акции программы со статусом, опубликованной версией, отметкой о
  неопубликованных изменениях и расходом бюджета. Право `campaigns.manage` (владелец, администратор, маркетолог) —
  создать акцию и изменить черновик в конструкторе, опубликовать черновик новой версией, запустить, приостановить,
  отправить в архив; JSON черновика видят все, кто видит настройки.
- Конструктор: скидка в процентах или рублях (на чек или за единицу), специальная цена, дополнительные баллы
  процентом, количеством или умножением; товары — все, по артикулам или по категориям каталога; условия чека — сумма
  от, артикулы или категории в чеке, уровень участника, первая покупка (для участников), дни около дня рождения;
  период, дни недели и окно времени — в часовом поясе программы, каким бы ни был пояс кабинета; точки и каналы продаж;
  лимит на участника за день, неделю, месяц или всё время; бюджет; приоритет, только для участников, только по
  промокоду, несовместимость с другими акциями.
- Товары и условия, заданные через Management API иначе, сохраняются как есть; форма, сохранённая без изменений, не
  меняет черновик. Меняется и публикуется только тот черновик, который был показан: изменённый за это время (в кабинете
  или через API) — нет, отказ попадает в журнал. Акции архивной программы только читаются.
- Журнал аудита: `campaigns.store`, `campaigns.update`, `campaigns.publish`, `campaigns.activate`, `campaigns.pause`,
  `campaigns.archive` — выбор акции без её названий.

### Этап 6g-4. Кабинет мерчанта: «Сводка»

- «Сводка» — как программа поработала за последние 7, 30 или 90 дней (дни — по часовому поясу программы): участники
  и новые за период; покупки участников, их доля и сумма, средний чек; баллы из учёта баллов — начислено (за покупки и
  бонусы), оплачено баллами, сгорело, отменено и возвращено при возвратах, корректировки вручную — и баллы на счетах
  участников сейчас, с оценкой в рублях по номиналу балла; таблица по дням. Видна всем ролям мерчанта, цифры
  обновляются раз в 5 минут. Цифры баллов сходятся с балансами участников: движение за период равно изменению
  балансов (баллы, сгоревшие сразу при возврате в истёкшую партию, — в «Сгорело», не забранные при отмене начисления —
  отдельно). Возвраты из суммы покупок не вычитаются.
- Консоль платформы: «Подробнее» мерчанта показывает участников его программ и чеки за 30 дней.
- Лимиты корректировок роли «Поддержка» — 5 000 баллов за раз и 20 000 за день, как решено при утверждении этапа 6
  (6g-3 по ошибке поставил 1 000 и 5 000).
- Новые контракты: `Members::count`, `Members::joinedByDay`, `ReceiptStats::summary`, `ReceiptStats::count`,
  `LedgerStats` (`totals`, `liability`); окно отчёта `Kernel\Time\ReportWindow`; индексы чеков по программе и времени
  покупки и операций леджера по типу баллов и дате операции.

### Этап 6g-3. Кабинет мерчанта: ручные корректировки баллов

- «Скорректировать баллы» в карточке участника (право `members.adjust_points`): начислить или списать баллы с причиной
  из списка — не начислили за покупку, компенсация клиенту, поощрение, исправление ошибки, другое — и комментарием,
  который для «Другое» обязателен (телефоны, адреса почты и номера карт в нём не принимаются). Начисленные вручную
  баллы сгорают по правилам программы, как заработанные; списать можно не больше, чем у участника есть.
- Лимиты по ролям (`cabinet.adjustment_limits`): роль «Поддержка» и оператор с доступом поддержки — не больше 5 000
  баллов за раз и 20 000 за день программы (начисления и списания вместе); владелец и администратор — без лимитов. Две
  корректировки одного сотрудника одновременно не проскочат под дневной лимит. Любой роли — не больше 120
  корректировок в час.
- Повторная отправка той же формы не проводит корректировку второй раз и говорит, что она уже проведена; та же форма с
  другими данными отклоняется.
- «История баллов» показывает причины корректировок по-русски и комментарии сотрудников. Комментарий не попадает в
  журнал аудита (`members.adjust` получает сумму, причину и был ли комментарий) и стирается, если участника обезличат;
  корректировка и обезличивание одного участника больше не могут разойтись при одновременных запросах. Так же
  фиксация уровня: уровень обезличенного участника вручную больше не фиксируется (Management API отвечает
  `member_not_found`), а причина фиксации не переживёт обезличивание, даже если запросы пришли одновременно.
- Новый модуль `support` (`ManualAdjustments`, таблица `support_adjustments`), `Members::lockPresent`; внутренние коды
  `adjustment_limit_exceeded` и `invalid_adjustment`.
- Management API: код причины корректировки — от 2 символов, как его хранит леджер (`^[a-z][a-z0-9_]{1,39}$`); причина
  из одной буквы теперь отклоняется как ошибка запроса (`validation_failed`), а не леджером. SDK обновлены.

### Этап 6g-2. Кабинет мерчанта: действия с участником

- Меню «Действия» в карточке участника: зафиксировать уровень до конца выбранного дня (уровень не меняется сам ни
  вверх, ни вниз), заморозить (копит, но не тратит; и из блокировки сразу), заблокировать (не копит, не тратит, бонусы не
  приходят), снять заморозку или блокировку — с причиной; выдать карту по номеру и заблокировать карту по последним
  цифрам — право `members.manage`; обезличить навсегда — право `members.anonymize`, со свежим вторым фактором и вводом
  слова «обезличить», не больше 30 раз в час, доступу поддержки недоступно.
- «Добавить карты» на странице «Участники»: номера напечатанных карт заносятся в программу (до 1000 за раз, по одному в
  строке, через запятую или табуляцию; не больше 20 раз в час), и кассы могут выдавать их участникам при регистрации.
  Карту, номера которой программа ещё не знает, из карточки выдают только с отметкой «карты ещё нет в программе»: так
  опечатка не становится новой картой.
- Обезличенный участник не хранит ни причины, которую кто-то ввёл, ни реферального кода; причина фиксации уровня
  стирается тоже (новое событие `MemberAnonymized`). Обезличивание, смена статуса и выдача карты больше не могут
  разойтись при одновременных запросах. Смена статуса требует причину от 1 до 200 символов и в самом контракте.
- Журнал аудита: `members.fix-tier`, `members.freeze`, `members.block`, `members.activate`, `members.anonymize` (с
  причиной), `cards.assign`, `cards.block`, `cards.issue` — без номеров карт (новые действия в спецификации Management
  API, SDK обновлены).
- Карточка показывает, до какого дня уровень зафиксирован вручную.
- Контракт участников: `Members::giveCard`, `Members::blockMemberCard`, у `LoyaltyCard` появился id; внутренний код
  `card_not_issued`.

### Этап 6g-1. Кабинет мерчанта: участники

- «Участники»: участники программы, самые новые первыми, с поиском по началу фамилии или имени (можно фамилию и имя
  вместе в любом порядке, имя из двух слов целиком; ё — как е) и фильтром по статусу; телефоны — только маской. Каждая
  страница списка пишется в журнал аудита (`members.index`) без текста поиска. «Найти участника» находит одного целиком
  по телефону, номеру карты или внешнему идентификатору и открывает его карточку; журнал получает найденного участника
  и способ поиска, но не то, что ввели. Поисков без результата — не больше 20 за 10 минут на человека: так нельзя
  подобрать цифры, которые скрывает маска телефона.
- Карточка участника: данные (телефон и e-mail маской), баллы (на счёте, можно потратить, ещё не доступны, в резерве,
  ближайшее сгорание), уровень и сколько осталось до следующего, штампы, согласия по видам, бонусы, карты (последние
  цифры); отдельно — покупки участника и история баллов с операциями по-русски. Открытие карточки, покупок и истории
  пишется в журнал аудита (`members.show`, `members.receipts`, `members.history`, методом `GET`), как просмотры
  Management API; тот же просмотр в течение минуты — одна запись.
- «Показать телефон» — право `members.reveal_contacts` со свежим вторым фактором, не больше 30 раз в час; номер
  показан один раз и не попадает ни в состояние страницы, ни в сессию, ни в журнал (`members.reveal-phone`). Доступу
  поддержки недоступно.
- Новые действия журнала `members.index`, `members.receipts` и `members.reveal-phone` (спецификация Management API, SDK
  обновлены).
- Участники получили ключи поиска по фамилии и имени (генерируемые колонки) и индексы для списков: под RLS индекс
  работает только с leakproof-условиями, а `lower()` и `LIKE` такими не считаются.
- Кабинеты: поиск любой таблицы остаётся текстом, что бы ни прислал браузер (раньше список в поиске таблицы без поиска
  ронял страницу); отказ «слишком часто» пишется в журнал раз в 15 минут.
- `Members::findByExternalId` не находит никого по id с NUL или битым UTF-8: раньше такой id (например,
  `?external_id=%00` в Management API) ронял запрос ошибкой базы.

### Этап 6f-6b-3b. Веб-касса: камера

- Кнопка «Камера» рядом с «Найти»: камера планшета читает карту участника или QR-код его приложения (`loyal:` и код)
  там, где браузер читает коды с камеры (`BarcodeDetector`: Chrome на Android, ChromeOS, macOS); прочитанное — скан
  (без отметки ручного ввода), дальше — обычный поиск участника или, без связи, запись покупки. В Safari и браузерах
  iPhone и iPad, в Firefox, в Chrome на Windows и Linux кнопки нет: остаются сканер-клавиатура и ручной ввод.
- Камера ищет покупателя у кассы: прежний участник и расчёт уходят с экрана, запись без связи ждёт прочтения. Камера
  гаснет в сам момент, когда код прочитан, кассир отменил, касса обратилась к серверу, сменился экран или страница
  скрыта; изображение не покидает планшет. Отказ камеры (нет доступа, нет камеры, браузер не читает коды) касса
  объясняет и возвращает ручной ввод.
- `media-src` страницы кассы — только `'self'` (изображению камеры через `srcObject` CSP не нужна).
- Веб-касса (этап 6f, ADR-0016) завершена.

### Этап 6f-6b-3a. Веб-касса: работа без связи

- Без связи (нет ответа сервера, прокси ответил 502–504, браузер говорит, что сети нет) веб-касса записывает покупку
  участника — только начисление, без скидок; участник — тот, кого называет поле участника, или найденный до обрыва
  связи — в очередь на устройстве и отправляет её пакетами (`receipts:batch`), когда связь вернётся. Повторная
  отправка не создаёт дублей: каждый чек сохраняет номер, а ответ «уже зарегистрирован» касса сверяет с чеком на
  сервере (чек под унаследованным номером уходит под своим, если под тем номером другая покупка; если касса не может
  решить сама, кассир видит, что прошёл чек без ответа). Отказ части пакета отказывает только названным чекам.
  Конфликты и отказы видны в очереди до решения кассира; чеки старше 72 часов удаляются на любом экране.
- Чек и возврат в пути или без ответа и закреплённые номера переживают перезагрузку страницы: чек, который только
  начислял баллы, встаёт в очередь под своим номером и уходит после проверки кассиром («Отправить проверенные»;
  убранный чек закрепляет свой номер за следующим); чек со списанием или скидкой и возврат оставляют номер
  закреплённым.
- Оболочка кассы отвечает `till_device_revoked` с `Clear-Site-Data: "storage"` только устройству, которое не заработает
  никогда (отозвано, 180 дней без использования); `till_device_required` (не привязан, касса сейчас не работает)
  хранилище браузера не трогает — чеки уйдут, когда касса снова заработает, а новую привязку касса делает только с
  согласия кассира.
- Офлайн-пакет запоминает устройство веб-кассы и стирает телефоны и карты участников после обработки (и у пакетов,
  обработанных раньше). Ошибка одного чека не останавливает пакет; пакет, на котором задание сдалось, завершается без
  потерь: в результатах только зарегистрированные чеки, остальные касса отправит снова (так теперь описывает и
  спецификация Runtime API). Новая задача `receipts:finish-batches` (раз в пять минут) снова передаёт заданию пакеты,
  которые никто не обработал, и завершает их через сутки; новая проверка «Состояния системы» — `processing.batches`.
- Исправлено: отпечаток запроса у ключа идемпотентности — HMAC, а не простой хэш (тело может содержать телефон;
  повторы переживают ротацию `APP_KEY`); Runtime API принимает только существующие дату и время чека и возврата
  (смещение до ±14:00), и спецификация описывает момент так же.

### Этап 6f-6b-2. Веб-касса: возвраты и итоги смены

- Возврат покупки на веб-кассе (ADR-0016): кассир находит участника, открывает «Возврат покупки», выбирает покупку из
  списка и возвращает её целиком или частью — на сумму возвращаемых товаров (для покупки из одной строки). Касса
  спрашивает подтверждение со стоимостью товаров и суммой, которую вернуть клиенту деньгами (без того, что было
  оплачено баллами), и говорит, сколько начисленных баллов списано и сколько баллов вернулось клиенту. Возврат без
  ответа сервера не проводится дважды: он повторяется тем же запросом, переживает блокировку и смену ключа, а его номер
  закрепляется за чеком до выяснения; если под ним прошёл прежний возврат, касса говорит об этом.
- Итоги смены: кнопка «Итоги смены» и итоги после закрытия смены — чеки и их сумма, сколько чеков с участником,
  начислено и оплачено баллами, возвраты. Оболочка кассы: `GET /till/shifts/current`; закрытие смены отдаёт её итоги.
  Итогов заблокированной смены оболочка не отдаёт: они ждут PIN-кода кассира.
- Runtime API: `GET /api/v1/members/{member}/receipts` (скоупы `receipts` и `balances`) — покупки участника, новые
  сверху, курсорная пагинация; строка чека несёт `quantity`; тело возврата принимает `cashier`; на номер возврата,
  который у чека уже есть, API отвечает этим возвратом; у истории баллов описан ответ 400 `invalid_cursor`; имя кассира
  в чеках, возвратах, офлайн-чеках и регистрациях не принимает управляющих символов (422). Спецификация, SDK и
  эталонные векторы обновлены. Повторы с тем же ключом идемпотентности ещё 48 часов после обновления отдают
  сохранённые ответы — в строках чеков в них нет `quantity`.
- Чек, зарегистрированный онлайн ключом смены веб-кассы, запоминает её устройство, а возврат — кассу, устройство и
  кассира (миграции без простоя: ссылки добавляются непроверенными и проверяются отдельно, индексы строятся без
  блокировки записи, `concurrently`). Новый контракт `Processing\Contracts\ReceiptStats` — итоги чеков и возвратов
  устройства за период.

### Этап 6f-6b-1. Веб-касса: списание баллов и регистрация участника

- Списание баллов на веб-кассе (ADR-0016): касса показывает, сколько баллов можно списать, и списывает введённое
  число или все доступные; где программа требует подтверждения, отправляет клиенту код в SMS на ровно эти баллы и
  проводит чек после того, как кассир введёт код. По отсканированному коду из приложения SMS не нужна там, где программа
  требует код только для слабых идентификаторов (так по умолчанию); истёкший код касса просит отсканировать снова.
  Запрос кода без ответа повторяется под тем же ключом, без второго SMS.
- Регистрация участника у прилавка: по телефону, который не нашёлся, или кнопкой «Новый участник». Касса показывает
  тексты документов программы, без правил и согласия на обработку персональных данных не регистрирует, подтверждает
  телефон кодом из SMS и записывает кассира; если участник с этим телефоном уже есть, продолжает покупку с ним. Перед
  регистрацией касса сверяет редакции документов. Runtime API требует от веб-кассы подтверждённый код и принятые
  правила программы (422 `validation_failed` без них).
- Runtime API: `GET /api/v1/consent-documents` (скоуп `members`) — действующие документы программы с текстами, чтобы
  показать их до регистрации (спецификация и SDK обновлены).
- После отказа следующая попытка строит запрос заново, но номер, под которым шла попытка без ответа, закреплён до
  выяснения: следующий запрос идёт под ним с новым ключом, и поздно записанная попытка не даст второго чека. Другая
  сумма после отказа отменяет расчёт. Касса предупреждает, если чек прошёл не так, как был рассчитан.

### Этап 6f-6a. Веб-касса: приложение

- Приложение веб-кассы (ADR-0016) в `frontend/till`: TypeScript без зависимостей, собирается компилятором из SDK
  (`composer till:build`) в папку сборки `public/till-app/<версия>`; `composer check` и задание CI `till-app` собирают
  его и запускают его тесты. Касса привязывается по ссылке или QR-коду из кабинета (код сразу уходит из адреса; браузер,
  который уже касса, сначала спрашивает) или вводом кода. Кассир выбирает себя и вводит PIN-код кнопками на экране или
  с клавиатуры: открывает смену или продолжает её после перезагрузки. Смену блокирует кнопка или 10 минут без действий
  (и после сна планшета), разблокирует PIN-код, закрывает кнопка с подтверждением.
- Работа с участниками и чеками — через Runtime API и SDK с ключом смены, который живёт только в памяти страницы, и
  только в одной вкладке браузера: поиск участника по телефону, карте или коду из приложения (сканер-клавиатура
  распознаётся по скорости и числу нажатий), расчёт и проведение покупки на сумму с начислением баллов. Номер чека —
  из устройства, секунды и случайных бит, ключ идемпотентности — из кассы, бизнес-дня и номера.
- Чек без ответа сервера не проводится дважды: касса повторяет ровно тот же запрос, держит такой чек на экране при
  блокировке, закрытии смены и смене ключа и находит по номеру чек, который уже прошёл.
- Отказы — понятным текстом на русском; если устройство отозвали, смену закрыли в кабинете или ключ перестал
  действовать, касса показывает актуальный экран. Service worker (`/till/sw.js`) держит страницу и файлы сборки:
  страница кассы открывается и без сети (работа без сети — в 6f-6b), а новая сборка доходит до кассы сразу. По адресу
  без HTTPS (кроме самой машины) касса сразу говорит, что не работает.
- `LocalTillSeeder` — демо-касса для локальной проверки: программа, точка с веб-кассой, кассир, участник с баллами и
  ссылка привязки.
- Дальше (6f-6b): списание баллов с кодом, регистрация участника, возвраты, итоги смены, офлайн-очередь, камера.

### Этап 6f-5. Веб-касса: кабинет

- Кабинет мерчанта, группа «Веб-касса» (ADR-0016): «Устройства» — привязанные браузеры веб-касс с программой, тем, кто
  привязал, последним обращением и открытой сменой (отозванные больше 30 дней назад не показываются); «Кассиры»;
  «Смены» — все открытые и закрытые за 30 дней (не больше 500). Видят все в мерчанте, меняет право `till.manage` со
  вторым фактором; устройство отзывает право `keys.revoke`, в том числе у приостановленного мерчанта.
- Код привязки показывается один раз — со ссылкой на страницу кассы (`/till#code=…`, со своим хостом кассы — на нём) и
  QR-кодом этой ссылки — и не попадает в состояние страницы, сеанс и журнал. «Сделать этот браузер кассой»: кабинет
  завершает сеанс менеджера в этом браузере (`device_paired`) и открывает кассу с кодом. Ссылка, QR-код и «этот браузер»
  заработали с приложением кассы (6f-6a).
- Кассиры: добавить (имя, PIN-код из 4–8 цифр, точка или все точки), переименовать, сменить PIN-код (снимает
  блокировку), отключить (закрывает его смены), включить. Смену можно закрыть из кабинета вместе с её ключом
  (`Shifts::closeShift`, под блокировкой устройства, причина `closed_in_cabinet`); `Shifts::ofTenant` — список смен
  мерчанта.
- Журнал аудита: действия `till-devices.pair`, `till-devices.revoke`, `till-cashiers.store`, `.rename`, `.pin`,
  `.disable`, `.enable`, `till-shifts.close` (спецификация и SDK обновлены); ни кода привязки, ни PIN-кода, ни имени
  кассира в журнале. Шаг «Готовности к запуску» называет и устройства веб-кассы, а у мерчанта только с веб-кассами
  ведёт на «Устройства». Библиотека QR-кодов `chillerlan/php-qrcode` (уже стояла с Filament) объявлена напрямую.

### Этап 6f-4. Веб-касса: оболочка `/till`

- Оболочка кассы (ADR-0016) в группе `web`: страница приложения со строгой CSP (только свой хост, ничего встроенного,
  камера — только своему хосту), манифест веб-приложения, привязка браузера `POST /till/pair` (10 попыток в минуту с
  адреса), данные устройства `GET /till/device`, смены `POST /till/shifts` и `…/current:lock`, `:unlock`, `:close`
  (60 запросов в минуту с устройства). Ключ смены приходит только в ответах на PIN и в кэш не попадает. Ошибки
  точек входа — problem+json, что бы ни просил запрос; PIN-код и код привязки не сохраняются в сеансе даже при ошибке
  формы.
- Привязка ставит cookie устройства, завершает сеанс сотрудника на хосте оболочки (`device_paired`) и отзывает прежнее
  устройство браузера вместе с его сменой (`till.unpair` в журнале его мерчанта). Каждый ответ устройству ставит cookie
  заново: она живёт 180 дней с последнего использования.
- Журнал аудита: канал `web_till`, действия `till.pair`, `till.unpair`, `till.shifts.open`, `.lock`, `.unlock`,
  `.close` — с отказами (не больше 30 за 15 минут с устройства), без PIN-кода и кода привязки. Спецификация
  Management API и SDK обновлены (`AuditEntry.channel`, `AuditAction`); новое ограничение канала добавляется без
  долгой блокировки журнала.
- `TILL_DOMAIN` — необязательный свой хост оболочки кассы; без него оболочка не отвечает на хосте консоли. Внутренние
  коды ошибок: `till_device_required`, `till_pairing_invalid`.
- Заголовки безопасности кабинетов и кассы теперь стоят и на отказах аутентификации и лимитов. Токены и ключи с
  переводом строки в конце больше не проходят проверку формата.

### Этап 6f-3. Веб-касса: кассиры и смены

- Модуль `till` (ADR-0016). Кассиры (`Cashiers`): имя и PIN-код мерчанта, для всех точек или одной; хранится только
  хеш PIN-кода. PIN — от 4 до 8 цифр, не одна и та же цифра и не цифры по порядку; имена у мерчанта не повторяются.
  Кассира переименовывают, меняют ему PIN (это снимает блокировку), отключают — его открытые смены закрываются вместе с
  ключами — и включают.
- Смены (`Shifts`): PIN кассира открывает смену на привязанном устройстве и даёт устройству ключ смены на 12 часов; на
  устройстве одна открытая смена — новая закрывает прежнюю и её ключ. Блокировка отзывает ключ, разблокировка PIN-кодом
  кассира смены даёт новый, закрытие отзывает ключ, отзыв устройства закрывает его смену. Кассир с указанной точкой
  работает только на её устройствах. Смены открываются и у приостановленного мерчанта; если программа в архиве или
  устройство только что перестало работать, ключ не выдаётся (`till_unavailable`).
- Неверные PIN-коды: пять подряд блокируют кассира на 15 минут (верный PIN сбрасывает счёт); после 20 неверных в окне
  15 минут на одном устройстве, у каких бы кассиров их ни пробовали, ввод на нём останавливается до конца окна.
  Счётчики фиксируются до отказа, поэтому смену открывают и разблокируют только вне транзакции вызывающего. Всё, что
  меняет смену устройства, и отзыв устройства идут под блокировкой устройства, в одном порядке блокировок.
- Access: отзыв устройства — в транзакции под его блокировкой, с событием `TerminalDeviceRevoked`; отзыв ключа
  оставляет отметку, поэтому и внутри транзакции ключ перестаёт работать сразу, а не через минуту кэша.
- Коды ошибок кассы (`invalid_cashier`, `cashier_not_found`, `wrong_pin`, `cashier_locked`, `pin_attempts_exceeded`,
  `till_shift_required`, `till_unavailable`) — внутренние: на них будут отвечать кабинет и оболочка кассы, а не API.

### Этап 6f-2. Веб-касса: устройства и ключи смен

- **Исправлено:** кэш проверки ключей касс хранил объекты, а кэш в базе и в Redis по настройке
  `cache.serializable_classes` объекты не восстанавливает — проверка ключа из кэша (каждый запрос в течение минуты
  после первого) давала бы 401. Теперь в кэше только простые значения, а тесты кэшируют с сериализацией, как рабочие
  хранилища (`CACHE_ARRAY_SERIALIZE`), и такая ошибка больше не пройдёт незамеченной.
- Устройства веб-кассы (ADR-0016): контракт `TerminalDevices` — одноразовый код привязки для веб-кассы и программы
  (`XXXXX-XXXXX`, 10 минут, хранится только HMAC; вводится строчными, с пробелами, с «O», «I», «L» и похожими
  кириллическими буквами), привязка браузера по коду с токеном `ltd_<префикс>.<секрет>` для HttpOnly-cookie
  `__Host-loyal_till` (на локальном http — `loyal_till`; фреймворк её не шифрует, ставит её оболочка кассы в 6f-4),
  проверка токена, отзыв, список устройств. Код гасится один раз даже при одновременных попытках и только пока
  веб-касса работает, программа активна и мерчант открыт (приостановленный — тоже). Отзыв действует сразу и
  останавливает ключи смен устройства; устройство, которое не видели 180 дней, не работает.
- Ключи смен: ключ Runtime API с `purpose = till_shift` на кассу и программу устройства, со сроком не больше 12 часов;
  `api.key` принимает его только вместе с cookie того же устройства (иначе 401): ключ, унесённый скриптом со
  страницы, без cookie не работает. Ключ выпускается под блокировкой устройства, его назначение и устройство
  неизменяемы. У веб-кассы нет своего ключа: обычный ключ для неё не выпускается (кабинет, Management API, команда), а
  выпущенные раньше отозваны миграцией и не проходят проверку. «Ключи касс» и консоль ключей смен не показывают; «Готовность к запуску»
  считает и работающее устройство веб-кассы.
- Access: `ApiKeyPurpose`, `DeviceCookie`, `api_key_candidates` отдаёт назначение, устройство и вид кассы ключа; ключ
  кэша ключей — версия 3.

### Этап 6f-1. Веб-касса: подготовка Runtime API

- Runtime API: выпуск кода участника для приложения (`POST /members/{id}/presentation-codes`) требует нового скоупа
  `presentation_codes` вместо `members`. Участник показывает такой код на кассе, и при настройке программы по умолчанию
  касса списывает баллы без кода подтверждения; раньше касса с ключом `members` могла выпустить код любому участнику и
  списать его баллы без SMS. Скоуп получают только ключи касс вида «Интернет-магазин», «Мобильное приложение» и
  «Интеграция» и никогда вместе с `receipts`; иначе выпуск ключа отклоняется (422 `invalid_api_key_settings`). Миграция
  дала скоуп ключам с `members` и без `receipts` только у касс этих трёх видов — остальные его теряют: если приложение
  мерчанта выпускало коды с ключом кассы или с ключом, который проводит чеки, ему нужен отдельный ключ кассы вида
  «Мобильное приложение». Ключ кэша сменил версию: если миграции выполняются до переключения на новый код, право
  действует сразу (ADR-0009).
- Новые ключи касс (кабинет, Management API, `api-keys:issue`) по умолчанию получают `receipts`, `members`,
  `balances`; `presentation_codes` — только если его выбрать в кабинете или назвать в API и команде. В кабинете у права
  «Коды участника для приложения» — предупреждение, а для кассы или веб-кассы и вместе с правом «Чеки» форма его не
  примет.
- Runtime API: касса, приславшая за 10 минут 20 разных кодов участника, которые ни к кому не подошли
  (`PROCESSING_PRESENTATION_CODE_MISSES`), до конца этих 10 минут получает на любой код 429
  `presentation_code_throttled`: код из 8 цифр платит без кода подтверждения, и подбирать его нельзя. Подошедшие коды и
  повтор того же кода (пересчёт корзины с истёкшим кодом) не считаются; телефоны, карты и другие кассы работают как
  обычно. Офлайн-пакет больше не принимает участника по коду приложения (422): к загрузке код всё равно истёк.
- Runtime API: `GET /receipts?number=&business_date=` — чек этой кассы и программы ключа по номеру и бизнес-дате
  (возврат по бумажному чеку, проверка после обрыва связи); ответ — список из найденного чека или пустой.
- Runtime API: номер чека с управляющими символами (в том числе NUL) и бизнес-дата раньше 2000 года отклоняются с 422
  при регистрации, возврате, офлайн-пакете и поиске; раньше NUL в номере и нулевой год давали ошибку 500. Операции с
  `Idempotency-Key` описывают в спецификации ответы 400 `idempotency_key_required` и 422 `idempotency_key_reused`;
  архитектурный тест сверяет скоуп и ключ идемпотентности каждого маршрута со спецификацией.
- Коды подтверждения: запрошенные ключом кассы считаются в лимит кассы — 30 в час на коды для регистрации и для
  списания вместе (`VERIFICATION_TERMINAL_HOURLY_LIMIT`), а не адреса: сервер мерчанта, который запрашивает коды для
  всех своих касс с одного адреса, больше не упирается в лимит 20 в час на адрес. Лимит адреса остаётся для будущих
  запросов без кассы (виджеты участника).
- SDK пересобраны: `findReceipts`, скоуп `presentation_codes` в `RuntimeKeyInput`, `OfflineMemberIdentifier` для
  участника офлайн-чека.

### Кабинеты: правки после показа

- Страницы ошибок на русском (403, 404, 419, 500, 503). На 403 — кнопка «Выйти»: тот, кто вошёл не под той учётной
  записью (например, владелец мерчанта в консоли), выходит и входит снова; раньше была английская страница Laravel.
- Документ согласия публикуется кнопкой «Опубликовать» (было «Отправить»); в полях артикулов и кодов категорий карт
  штампов — подсказки «Новый артикул» и «Новый код категории» (было «Новый тег»).
- Скрытые подписи полей, которые зачитывают программы экранного доступа, — на русском (были английские имена полей).

### Этап 6e-6. Кабинет мерчанта: шаблоны и готовность к запуску

- «Программа по шаблону» на странице «Программы» (ADR-0014): «Баллы за покупки», «Уровни и бонусы» или «Кофейня со
  штампами» — программа, её типы баллов и черновик правил создаются сразу, одной транзакцией; правила остаются
  черновиком до проверки и публикации. В журнал аудита попадает `programs.store` с шаблоном.
- Первая версия документа согласия начинается с шаблона текста (правила программы, согласие на обработку персональных
  данных, согласия на рекламу по каналам) с местами для данных организатора в квадратных скобках; пока такое место не
  заполнено, документ не публикуется. Следующие версии начинаются с действующего текста.
- «Готовность к запуску» на «Обзоре»: юрлицо, программа, работающая касса, а для каждой программы — опубликованные
  правила и документы и ключ работающей кассы с правом «Чеки» — со ссылками на страницы, где это делается.
- Access: `ApiKeys::working()` — только рабочие ключи (не отозванные и не истёкшие), без истории всех ключей.
  **Этап 6e завершён.**

### Этап 6e-5. Кабинет мерчанта: карты штампов

- «Карты штампов» на странице «Правила программы» (ADR-0014): до пяти карт — название, код, тип баллов для штампов
  (без дробной части, свой у каждой карты, не тип баллов программы), сколько штампов нужно для награды, доступность и
  сгорание штампов, а товары, которые приносят штампы, — список артикулов или категории каталога; условие, заданное
  через API иначе, остаётся как есть. Меняют те, у кого `programs.manage`, остальное в черновике не трогается. Если
  возвраты допускают минус, тип карты должен его разрешать; форма базовых правил отклоняет такую политику, если тип
  хотя бы одной карты его не разрешает. В журнал аудита попадает выбор формы без названий карт.
- Кабинеты: `Kit\Forms\ItemsRepeater` не падает на подделанных строках (раньше — ошибка 500): состояние не массивом
  отклоняет, строку не массивом превращает в пустую, строки с ключами, по которым Filament не дошёл бы до их полей,
  отклоняет. Названия уровней и карт, артикулы и коды категорий — без управляющих символов.
- Management API: условия акций (`condition`, `target`) и карт штампов читаются из тела запроса как есть — общие
  обработчики запросов обрезали пробелы в строках условий и превращали `{"var": ""}` (текущий элемент в `some`, `all`,
  `none`) в `{"var": null}`, и такое условие отклонялось. Правила и акции с нулевым символом в тексте отвечают 422
  `invalid_program_rules` / `invalid_campaign`, а не 500.
- Журналы и аудит: маскировка персональных данных больше не портит UUID, в цифрах которого случайно видны номер
  телефона или номер карты (`SensitiveDataRedactor` оставляет идентификаторы целыми).

### Этап 6e-4. Кабинет мерчанта: уровни и бонусы

- «Уровни» и «Бонусы» на странице «Правила программы» (ADR-0014): каждая форма меняет свою часть черновика, остальное
  оставляет как есть; меняют те же, у кого `programs.manage`, у любого черновика работающей программы — и тот, что
  больше не проходит проверку, можно починить через них. Уровни — таблицей снизу вверх (код, название, сумма и число
  покупок, процент начисления), окно подсчёта покупок (последние N дней или календарный год) и срок сохранения уровня.
  Бонусы — приветственные (сразу или за первую покупку), ко дню рождения и «Приведи друга», у каждого своя доступность
  и сгорание, в баллах программы с точностью её типа баллов; пока бонусы есть, тип баллов с другой точностью выбрать
  нельзя (бонусы хранятся в минимальных единицах). Всё, что отклонил бы домен, форма показывает у поля, ошибку уровня —
  один раз; неизменённая форма не меняет черновик. В журнал аудита попадает выбор формы (у уровней — без названий).
- Кабинет: изменение части черновика (и базовых правил) строится из черновика, прочитанного вместе с отпечатком, и
  отклоняется, если отпечаток не совпал с запомненным формой (ADR-0007), — так правка одной части не откатывает другие.
  `Kit\Forms\ItemsRepeater` — таблица строк, которой подделанное состояние не массивом не роняет страницу.
- Правила (ADR-0007): коды уровней, карт штампов, групп акций и каналов продаж, время в расписании, дата сгорания и
  тип баллов карты штампов с переводом строки в конце больше не принимаются: Management API отвечает 422
  `invalid_program_rules` (правила) или `invalid_campaign` (акции), а не сохраняет такое значение.

### Этап 6e-3. Кабинет мерчанта: правила программы

- «Правила программы» в кабинете мерчанта (ADR-0014): состояние (опубликованная версия, готов ли и отличается ли
  черновик, программа в архиве), черновик строками «что — как», форма базовых правил (тип баллов, начисление,
  доступность и сгорание, оплата баллами, возвраты) с ошибками у полей и публикация со вторым фактором после списка
  изменений, в котором не бывает пустоты. Черновик меняют те, у кого `programs.manage` (владельцы, администраторы,
  маркетологи, владельцы и администраторы партнёра, оператор с полным доступом поддержки); публикуют владельцы и
  администраторы, в том числе партнёра (`rules.publish`; не доступ поддержки и не приостановленный мерчант). «Версии» —
  опубликованные версии с их правилами; со страницы «Программы» — ссылка на правила программы. В журнал аудита
  попадают выбор формы и id опубликованного снапшота.
- Правила (ADR-0007): `ProgramRules::status()` читает черновик, его вид при публикации, опубликованную версию и
  отпечаток черновика одним вызовом; `configure()` и `publish()` с `basedOnDraft` отклоняют черновик, изменённый тем
  временем (`RulesDraftOutdated`, `rules_draft_outdated` — только для кабинета).
- Management API: политика возвратов `allow_negative` требует, чтобы тип баллов программы и типы баллов карт штампов
  разрешали минус на балансе, иначе запись черновика и публикация отвечают 422 `invalid_program_rules` (раньше такой
  черновик публиковался, а возврат на кассе не проходил); описание поля и операции в схеме, SDK обновлены.
- Кабинеты: страница, которая держит прочитанное в течение запроса, после изменения читает его заново
  (`GuardedAction::FORGET_LOADED`, им пользуются и страницы с постраничной выдачей); `Kit\Forms\Decimals` пишет
  числа с разрядами («30 000»).

### Этап 6e-2. Кабинет мерчанта: документы согласий

- «Документы согласий» в кабинете мерчанта (ADR-0014): действующая версия каждого вида документа каждой работающей
  программы, её текст (с переносами строк) и история версий с текстами. Новую версию публикуют те, у кого
  `consents.publish` (владельцы и администраторы, владельцы и администраторы партнёра; не доступ поддержки и не
  приостановленный мерчант), со вторым фактором и отметкой «Текст проверен»; форма начинает с действующей версии и
  отклоняется, если, пока она была открыта, вышла новая. В журнал аудита попадают программа, вид документа и id
  версии, но не текст.
- Согласия: `Consents::documents` (все версии вида, новые сверху) и `Consents::body` (текст версии);
  `Consents::MAX_TITLE` и `MAX_BODY` проверяются при публикации, заголовок и текст — UTF-8 без управляющих символов
  (кроме табуляции и переносов строк в тексте); `PublishDocument::$basedOnVersion` и `ConsentDocumentOutdated`
  (`consent_document_outdated`, только для кабинета). Действующий документ читается без текста.
- Management API: заголовок документа согласия — до 200 символов, как в базе (раньше 201–300 символов давали 500);
  управляющие символы отклоняются; в схеме `ConsentDocumentInput` — `maxLength` заголовка и текста. Описание
  публикации поправлено: регистрации нужен только `personal_data`.
- Кабинеты: предел запроса Livewire — 4 МБ, чтобы длинный документ на кириллице поместился в запрос.

### Этап 6e-1. Кабинет мерчанта: программы и типы баллов

- «Программы» в кабинете мерчанта (ADR-0014, раздел «Программа лояльности»): список с часовым поясом, валютой и
  числом типов баллов, добавление (часовой пояс по умолчанию — мерчанта) и переименование, архивной программы тоже.
- «Типы баллов»: список по программам и добавление в работающую программу с кодом, точностью, стоимостью балла в
  рублях и разрешением минуса на балансе; переименование. Ошибки, которые отклонил бы домен, форма показывает у поля.
- Видят все в мерчанте, меняют те, у кого `programs.manage` (владельцы, администраторы, маркетологи, владельцы и
  администраторы партнёра, оператор с полным доступом поддержки); у приостановленного мерчанта — только чтение. В
  журнал аудита попадают id и выбор, но не названия.
- Программы и леджер: `Programs::rename` и `PointTypes::rename` с проверками создания; контракт `PointTypes` называет
  свои границы (`CODE_PATTERN`, `MAX_PRECISION`, `MAX_VALUE_MINOR`), и код с переводом строки в конце больше не
  принимается.
- Кабинеты: `Kit\Forms\Decimals` читает деньги и доли из текста формы без дробных чисел (пробел — только между
  группами по три цифры); часовой пояс мерчанта и список работающих программ для форм — общие помощники
  (`TimeZones::ofMerchant`, `ProgramChoices::active`).
- Схема `AuditAction` (`programs.update`, `point-types.update`) и SDK обновлены.

### Этап 6d-6. Консоль платформы: учётные записи

- «Учётные записи» в консоли (ADR-0013, ADR-0015): любая учётная запись сотрудника — оператора, сотрудника мерчанта
  или партнёра — находится по e-mail или идентификатору. Показаны имя, маскированный e-mail, состояние, второй
  фактор, роль в консоли, команды и последний вход. Каждый поиск попадает в журнал платформы (`accounts.lookup`) —
  с найденной записью и без введённого адреса. Действия на странице работают только над записью, которую нашёл
  поиск.
- Отключить, включить, сбросить 2FA и отправить ссылку для смены пароля можно на обеих страницах — «Сотрудники
  платформы» и «Учётные записи» (`AccountActions`); каждое действие копируется, без ввода, в журналы команд
  человека.
- Обезличивание сотрудника из консоли (`AccountAdministration::anonymize`, `accounts.anonymize`), только в «Учётных
  записях»: с причиной и словом «обезличить»; не над собой, не над последним администратором платформы и не дважды.
  Обезличивание теперь отзывает ждущие приглашения на адрес человека во всех командах (у мерчантов — функцией базы
  `revoke_tenant_invitations_to`) и стирает адрес и в них.
- Сотрудники: выдача роли и изменения членства берут учётную запись первой и под её блокировкой проверяют, что она
  не обезличена; включение членства больше не может попасть во взаимоблокировку с обезличиванием.
- Схема `AuditAction` (`accounts.anonymize`, `accounts.lookup`) и SDK обновлены.
- Формы отключения и обезличивания предупреждают, если человек — единственный владелец команды с работающей
  учётной записью, и называют такие команды (`StaffAccess::teamsOwnedAlone`, функция базы
  `staff_sole_owner_tenants`).
- Кабинеты: меню строки таблицы сразу после изменения предлагает действия её нового состояния. `GuardedAction`
  забывает запомненную Filament видимость действий; раньше строка с тем же ключом до следующего запроса показывала
  действия прежнего состояния.

### Этап 6d-5. Консоль платформы: журнал платформы

- «Журнал платформы» в консоли (ADR-0015): всё, что сделано в консоли, и копии действий операторов в кабинетах
  мерчантов по доступу поддержки — новые сверху, с фильтрами по периоду, действию, месту и оператору; операторы
  названы, в подробностях — запрос, адрес и браузер.
- Журнал аудита: `AuditLog::ofPlatform` — записи без мерчанта и партнёра, читаются системной ролью; свои индексы
  записей платформы по времени, действию и оператору; `audit:export --platform`. Фильтр по человеку в журналах
  мерчанта и партнёра больше не находит записи операторов платформы, которых эти журналы не называют.
- Кабинеты: страница журнала общая для мерчанта и платформы (`Kit\Pages\AuditLogPage`).

### Этап 6d-4. Консоль платформы: состояние системы

- «Состояние системы» в консоли (ADR-0015): общий итог, свежесть расчёта, проверки модулей и последние запуски задач
  по расписанию. Страница обновляется сама каждые 30 секунд, но не продлевает сеанс: обновление проверяет его
  пассивно, требует второй фактор и ограничено по частоте.
- Ядро: реестр проверок (`HealthCheck`, `HealthChecks::register`); `platform:health` раз в минуту выполняет проверки и
  сохраняет результаты (`health_reports`), консоль только читает их; учёт запусков задач по событиям планировщика
  (`scheduled_runs`); пульс `platform:heartbeat` каждую минуту — для планировщика и с отставанием для каждой очереди
  (`queue.heartbeat_queues`).
- Проверки: планировщик, очереди, сбойные задания, задачи с ошибкой и пропущенные запуски, исходящие события (ждут и
  брошенные), отправка и недоставка вебхуков, сверка баллов, истёкшие резервы чеков; подсчёты ограничены 10 000.
  Индексы для подсчёта брошенных событий, недоставленных вебхуков (строятся без блокировки записи) и сбойных
  заданий.

### Этап 6d-3. Консоль платформы: доступ поддержки

- Доступ поддержки (ADR-0015): оператор открывает кабинет мерчанта под своим именем — с причиной, на время (30 минут
  по умолчанию, не больше 120), только чтение по умолчанию; изменения — только у администраторов и никогда
  чувствительные (ключи, вебхуки, команда, контакты участников и другое). Права — явный список режима
  (`SupportMode::permissions`), решаются на каждом запросе вместе с ролью оператора.
- Выдача заканчивается вместе с ролью оператора, учётной записью, её вторым фактором и мерчантом и не возвращается с
  ними; действует только в сеансе, где второй фактор подтверждён после её начала (или в том, из которого её
  открыли), — более ранний сеанс кабинетов завершается и ведёт на вход. Персональные данные в причине маскируются;
  историю выдач рабочие роли базы не удаляют, завершённая выдача остаётся завершённой.
- Консоль: «Открыть кабинет как поддержка» в «Мерчантах» (со вторым фактором) ведёт в кабинет мерчанта; «Доступ
  поддержки» — все действующие выдачи, своя завершается сразу, чужая — с полным доступом поддержки.
- Кабинет мерчанта: оператор с действующей выдачей входит в него; над страницами — плашка с режимом, временем
  окончания и кнопкой «Завершить доступ», которая ведёт на страницу «Доступ поддержки завершён» и тогда, когда выдача
  уже закончилась; «Обзор» называет режим поддержки.
- Журнал аудита: `support-access.start` — в журнале платформы (с режимом, минутами и причиной) и копией без
  введённого в журнале мерчанта, перед ним — `support-access.end` выдачи, которую новая заменила; `support-access.end`
  из консоли — так же. Всё, что оператор делает по выдаче, включая завершение с плашки, — в журнале мерчанта от
  «Сотрудника платформы» и копией в журнале платформы, с мерчантом и адресом оператора, без введённого.
- Модуль сотрудников: `SupportAccess` (таблица `support_access_grants`), `StaffAccess::merchant` учитывает выдачу;
  модуль мерчантов объявляет закрытие мерчанта событием `MerchantClosed`.

### Этап 6d-2. Консоль платформы: ключи партнёров и мерчантов

- «Ключи доступа партнёра» и «Ключи мерчанта» в консоли (ADR-0015):
  - OAuth-клиенты партнёра, ключи мерчанта и ключи его касс — с правами, сроком, последним использованием и тем, кто
    или что выпустило ключ, без секретов;
  - видят все операторы; отзывают работающий ключ администраторы со вторым фактором;
  - отзыв пишется в журнал платформы и копией в журнал владельца (`oauth-clients.revoke` с публичным `client_id`,
    `merchant-keys.revoke`, `api-keys.revoke`);
  - владельцам партнёра или мерчанта (у мерчанта партнёра без своих владельцев — владельцам партнёра) уходит письмо;
    консоль говорит, скольким.
- Консоль ключей не выпускает: это проверяет архитектурный тест.
- Модуль доступа:
  - `ManagementCredentials::clientsOf` и `revokeClientOf` (только клиент своего партнёра);
  - методы отзыва говорят, остановили ли они работающий ключ;
  - ключ кассы, выпущенный через Management API клиентом партнёра, помнит этот клиент (`issued_by_client_id`);
  - отзыв клиента оставляет в кэше проверки метку, и его токены перестают приниматься со следующего запроса, а не через
    минуту;
  - индекс токенов по клиенту.
- Модуль сотрудников: `TeamNotices` — письма владельцам команды о том, что платформа отозвала ключ; письмо, которое не
  удалось отправить, не мешает отзыву.

### Этап 6d-1. Консоль платформы: партнёры, мерчанты и статусы

- Статусы мерчантов действуют везде (ADR-0015):
  - приостановленный мерчант только читает: в Management API любое изменение получает 403 `merchant_suspended`
    (отказ пишется в журнал мерчанта), кроме отзыва ключа кассы, а кассы продолжают работать;
  - закрытый недоступен: кабинет — 404, Management API — 403 `merchant_not_accessible`, его ключи не принимаются;
  - ключи отключённых касс больше не проходят проверку Runtime API;
  - до проверки ключей касс смена статуса доходит в течение минуты, до Management API и кабинетов — сразу;
  - открытым считается только `active` и `suspended` (`MerchantData::isOpen()`), а не всё, кроме `closed`.
- «Партнёры» в консоли: поиск, добавление, переименование, приостановка с причиной и возобновление.
- «Мерчанты» в консоли:
  - поиск по названию, id и идентификатору у партнёра, фильтры по партнёру (или своим мерчантам платформы) и статусу,
    в том числе по ссылке;
  - добавление своего мерчанта или мерчанта партнёра, исправление названия, часового пояса и страны;
  - приостановка, снятие приостановки, закрытие и повторное открытие — каждое только из своего статуса;
  - число точек и касс.

  Видят все операторы, меняют администраторы со вторым фактором.
- Журнал аудита:
  - действия `partners.*` и `merchants.*` консоли пишутся в журнал платформы — с выбранными значениями и причиной, но
    без названий: у ИП это персональные данные;
  - изменения партнёра и мерчанта и новый мерчант партнёра копируются в их журналы, без введённого, адреса и браузера;
  - журналы мерчантов и партнёров, в том числе в `GET /audit-entries`, называют оператора платформы без id, адреса и
    браузера;
  - схема `AuditAction` и SDK обновлены.
- Модуль tenancy:
  - `Partners::search`, `findMany`, `rename`, `suspend`, `activate`;
  - `Merchants::search`, `createDirect`, `update`, `suspend`, `activate`, `close`, `reopen`, `countOfPartners`;
  - названия и идентификаторы у партнёра с управляющими символами не принимаются;
  - индексы `(created_at, id)`.
- Поддельный курсор страницы в Management API теперь получает 400 `invalid_cursor` вместо ошибки базы
  (`Cursor::timeAndId`). Это касается мерчантов партнёра, истории баллов участника, доставок вебхука и журнала аудита,
  в том числе курсора с годом 0000 или чужим часовым поясом.
- Фильтры таблиц кабинетов с фильтрами («Мерчанты» консоли, «Кассы» и журнал аудита мерчанта), пришедшие из запроса или
  ссылки, очищаются от всего, кроме строк (`Kit\Tables\FilterState`), а поиск остаётся строкой: поддельный запрос
  больше не роняет страницу.

### Этап 6c-4. Кабинет мерчанта: вебхуки

- «Вебхуки» (ADR-0014): владельцы и администраторы, в том числе партнёра, со вторым фактором добавляют вебхук на все
  события или на выбранные (адрес проверяется у поля той же проверкой, что в домене, — `WebhookEndpoints::checkUrl`),
  отключают его с причиной, включают и выпускают новый секрет подписи; секрет показывается один раз. «Доставки»
  вебхука — сначала новые, по 50 на страницу, с числом попыток, кодом ответа и ошибкой последней попытки; доставку
  можно поставить в очередь снова, кроме доставок отключённого вебхука. Остальным ролям страница не показывается (в
  адресе вебхука может быть секрет получателя), приостановленному мерчанту — тоже: управление вебхуками — запись.
- Журнал аудита: имена маршрутов Management API для вебхуков; в записях кабинета — id и типы событий, но не адрес и не
  причина. Адрес вебхука (`url`) журнал теперь скрывает и в записях Management API.
- Показ секрета один раз вынесен в `Kit\Pages\Concerns\RevealsSecretOnce` (его используют ключи и вебхуки).
- После изменения строки на странице с постраничным выводом (`PagesByCursor`) таблица сразу показывает новое
  состояние: `GuardedAction` забывает загруженную страницу записей.

### Этап 6c-3. Кабинет мерчанта: ключи

- «Ключи касс» и «Ключи мерчанта» (ADR-0014): список ключей с правами, сроком, тем, кто выпустил, и (у ключей касс)
  последним использованием, без секретов. Выпускают владельцы и администраторы, в том числе администраторы партнёра,
  со вторым фактором: ключ кассы — для работающей кассы и активной программы, ключ мерчанта — с любыми правами на
  данные мерчанта, кроме прав партнёра на мерчантов; последний день работы — до пяти лет вперёд. Новый ключ
  показывается один раз и не остаётся ни в состоянии страницы, ни в сессии, ни в журнале.
- Новое право `keys.revoke` (у владельцев и администраторов): отзыв ключа остаётся и у приостановленного мерчанта,
  у которого остальное только для чтения, — утёкший ключ можно остановить.
- «Закрыть доступ» в «Команде» — участнику и сотруднику партнёра — показывает действующие ключи, которые выпустил этот
  человек (и ключи касс, выпущенные через API его ключом мерчанта), и может отозвать их в той же транзакции.
- Модуль доступа: кто выпустил ключ кассы, ключ мерчанта и OAuth-клиента (`issued_by_user_id`) и каким ключом
  мерчанта выпущен ключ кассы через Management API (`issued_by_merchant_key_id`), оба неизменяемые; `ApiKeys::ofTenant`,
  `ApiKeys::issuedBy`, `ManagementCredentials::merchantKeys`, `merchantKeysIssuedBy` (`ApiKeyInfo`, `MerchantKeyInfo`).
- Журнал аудита: `merchant-keys.store`, `merchant-keys.revoke` в схеме `AuditAction`, SDK перегенерированы.
- Тесты кабинетов проверяют окно открытого действия встроенными проверками Filament (`assertMountedActionModalSee`):
  окно приходит отдельным фрагментом ответа, и проверка экранирования в окнах 6c-2 раньше в него не смотрела.

### Этап 6c-2. Кабинет мерчанта: организация

- «Точки», «Кассы», «Бренды», «Юрлица» (ADR-0014): владельцы и администраторы добавляют точки, меняют их (кроме кода)
  и закрывают навсегда — кассы закрытой точки отключаются, новые ей не добавить, а её кассы не включить; добавляют кассы
  всех видов (включая веб-кассу), отключают и включают их; добавляют бренды и юрлица. Остальные в мерчанте только
  смотрят; у приостановленного мерчанта — только просмотр.
- В контракте `Organization`: `updateLocation` (`LocationChanges`, все поля без умолчаний), `closeLocation`,
  `enableTerminal`, `allTerminals`, виды касс `TERMINAL_KINDS`; у `TerminalData` появилось название; ИНН, КПП и ОГРН с
  переводом строки в конце — 422, а не ошибка базы. Management API: добавить кассу в закрытую точку нельзя — 422
  `invalid_organization` (описано в спецификации).
- Отключённая касса не открывает новых чеков, но её ключи пока проходят проверку Runtime API (уже открытые чеки,
  регистрация участников, коды); отказ на входе — в 6d.
- Журнал аудита: действия `locations.update`, `locations.close`, `terminals.enable` в схеме `AuditAction`, SDK
  перегенерированы; в записи — только идентификаторы и выбранные значения, без названий, адресов и ИНН.
- `GuardsCabinetPage` по имени вызывает только публичную фабрику действия без аргументов и отклоняет действие таблицы с
  ключом не той формы: подделанное открытое действие (`resolveAction`, `getAction`, ключ-массив) больше не роняет
  страницу ошибкой 500 при следующем запросе.

### Этап 6c-1. Кабинет мерчанта: команда и журнал аудита

- «Команда» (ADR-0014): участники, сотрудники партнёра с доступом через партнёра и ждущие приглашения в одной
  таблице; пригласить, изменить роль, закрыть и открыть доступ, убрать отключённого из команды, отозвать приглашение,
  закрыть доступ сотруднику партнёра (копия записи — в журнал партнёра). Правила владельцев и «не над собой» — в
  домене; сотрудник партнёра команду видит, но не меняет. Новое в модуле сотрудников: `StaffAccess::partnerStaffOf`,
  `TenantMemberships::remove`.
- «Журнал аудита»: записи мерчанта сначала новые, с русскими названиями действий и именами людей, фильтры по периоду,
  действию, каналу и сотруднику, подробности записи. `AuditQuery` получил канал, исполнителя и порядок «сначала
  новые» (поправка к ADR-0010), индекс по исполнителю.
- Действия `team.invite`, `team.invitation-revoke`, `team.role-change`, `team.disable`, `team.enable`, `team.deny`,
  `team.remove` в схеме `AuditAction`; SDK перегенерированы.
- По итогам ревью: закрытый доступ сотрудника партнёра виден как «Закрыт сотруднику партнёра» и снимается только
  возвратом доступа через партнёра (не «Открыть доступ», которое превращало запрет в членство аналитика); каждое
  изменение членства сотрудника партнёра копируется в журнал партнёра, не больше 30 таких изменений в час от человека
  (`GuardedAction::perHour`); `TenantMemberships::remove` активного членства — 409 `membership_active`; операторы
  платформы в журнале мерчанта без имени, адреса и браузера; выбранный период виден над таблицей; индексы журнала
  (по исполнителю и по каналу) строятся без блокировки записи. Каждая страница кабинетов подключает
  `GuardsCabinetPage`: подделанный запрос к приватному методу страницы или к действию строки без строки больше не
  даёт ошибку 500.

### Этап 6b-4. Приглашения

- Приглашения в консоль и в команды мерчантов (ADR-0013): ссылка только письмом на приглашённый адрес, 72 часа и
  один раз, новое приглашение на тот же адрес заменяет прежнее; не больше 20 приглашений в час от одного человека;
  ответ пригласившему один и тот же, есть ли у адреса учётная запись. Адрес хранится зашифрованным и стирается после
  принятия или отзыва, старые приглашения удаляются через 30 дней (`identity:prune-invitations`). Приглашения
  мерчантов лежат под RLS (`tenant_invitations`, функция `tenant_invitation_candidates`).
- Страница приглашения в кабинетах (ADR-0014): ссылка обменивается на сессию, адрес страницы секрета не содержит;
  новый человек задаёт имя и пароль, существующая учётная запись принимает как есть; правила команды и права
  пригласившего проверяются при принятии; принятие — в журнале безопасности и в журнале аудита команды.
- Консоль: «Приглашения в консоль» — пригласить оператора, отозвать приглашение (`operators.invite`,
  `operators.invitation-revoke`, `invitations.accept` в схеме `AuditAction`, SDK перегенерированы). Письмо-приглашение
  на русском; название мерчанта в нём — текст, а не разметка (ссылку под чужим текстом через название не подсунуть).
- Внутренние коды ошибок `invalid_invitation`, `invitation_not_found`, `too_many_invitations`.
- По итогам ревью: администратор без права на владельцев не заменит приглашение владельца; оператор не меняет роль
  по ссылке, а снятие с роли отзывает его ждущие приглашения; закрытый мерчант не принимает; страница принимает
  только показанное приглашение; переход по ссылке работает и при `SameSite=Strict` и не сбрасывает CSRF-токен
  открытых страниц; одновременные приглашения одного адреса не падают с ошибкой сервера; в записи о принятии нет
  партнёра; текстовая часть письма без лишнего экранирования.

### Этап 6b-3. Почта сотрудникам и забытый пароль

- «Забыли пароль?» на странице входа каждого кабинета (ADR-0013, ADR-0014): один и тот же ответ для любого адреса,
  письмо отправляет зашифрованная задача очереди; ссылка — только на адрес самой записи, которая может входить в этот
  кабинет, не больше 3 в час на запись и 2 запросов в минуту с одного адреса; действует 60 минут и один раз, новая
  ссылка или смена пароля отменяют прежнюю. Ссылка подписана, называет запись по id и строится от `APP_URL` и
  `CONSOLE_DOMAIN`, а не от заголовка `Host`. Новый пароль — по политике платформы, все сеансы завершаются.
- Свои страницы запроса и смены пароля вместо страниц Filament: те различали известный и неизвестный адрес и
  сохраняли пароль в обход политики. Страница со ссылкой не отправляет свой адрес другим сайтам.
- Консоль: «Отправить ссылку для смены пароля» у сотрудника платформы (`accounts.password-reset-link` в журнале аудита
  и схеме `AuditAction`, SDK перегенерированы); после сброса 2FA человек получает письмо.
- Письма сотрудникам — уведомления на русском (`identity::mail`, строки шаблона Laravel в `lang/ru.json`), в очереди,
  зашифрованы, уходят после фиксации транзакции. В журнале безопасности — событие `password_reset_link_sent`; сброс
  пароля по ссылке пишется с адресом и браузером.
- Код ошибки `invalid_reset_link` (внутренний).
- По итогам ревью: ссылка применяется под блокировкой записи (дважды одной ссылкой пароль не сменить), отключение и
  обезличивание отменяют ссылку навсегда, отказ администратору больше не гасит ссылку, которую человек запросил сам;
  поля пароля очищаются и при ожидании из-за лимита; ссылка учитывает путь в `APP_URL`; вне разработки письма
  сотрудникам не отдаются драйверам `log` и `array`; текст ошибки упавшей задачи очереди хранится без личных данных
  (поправка к ADR-0008); «мин.» вместо «минут» в письме, своя концовка письма от администратора.

### Этап 6b-2. Защищённые действия кабинетов, аудит, сотрудники платформы

- Защищённые действия кабинетов (`GuardedAction`, ADR-0014): право проверяется при показе и при выполнении,
  отказ — в журнал аудита как 403 (не больше 10 за 15 минут от одного человека), в том числе на подделанный запрос,
  который Filament отклонил бы молча; изменение в консоли и чувствительное изменение в кабинете подтверждается кодом
  второго фактора, если он не вводился последние 10 минут; ошибка домена — уведомление с русским названием кода; в
  журнал — только объявленный ввод. Действие не открывается по ссылке, форма называет того, кого касается.
- Журнал аудита принимает действия кабинетов (поправка к ADR-0010): словарь `CabinetAction` в схеме `AuditAction`
  Management API, исполнители `user` и `platform_staff`, записи консоли — без мерчанта и партнёра, действия над
  людьми мерчанта или партнёра — копией без введённых данных и в их журналы. SDK перегенерированы.
- Консоль: «Сотрудники платформы» — роли, отзыв доступа к консоли, отключение и включение учётной записи, сброс 2FA
  с причиной. В модуле сотрудников — `AccountAdministration` (`accounts.manage`, не над собой, последний
  администратор остаётся, в том числе при `staff:disable`), `StaffAccess::teamsOf` и `deniedMerchantsOf`; блокировки
  берутся в одном порядке, права действующего оператора проверяются повторно под ними.
- Русские названия кодов ошибок (`cabinet::problems`, совпадают с каталогами API) и сообщения валидации
  (`lang/ru`); API по-прежнему отвечают на английском (поправка к ADR-0006).
- Фильтр логов скрывает пароли, коды восстановления, коды подтверждения (`mfaCode`, `verification_code`) и
  секреты форм и в camelCase (`currentPassword`), и по окончаниям `_password`, `_pin`, `_secret`, `_token`.
- Исправлен тест чека, который зависел от длительности прогона: время «из будущего» бралось при загрузке набора.

### Этап 6b-1. Кабинеты на Filament: каркас, вход с 2FA, сеансы

- Filament 5.9 (Livewire 4) и модуль `cabinet` (ADR-0014): консоль платформы `/console` и кабинет мерчанта
  `/merchant/{id}` поверх контрактов модулей; мерчант берётся из URL, доступ проверяется на каждом запросе страницы и
  каждом запросе Livewire, после чего запрос работает под RLS этого мерчанта; чужой мерчант — 404. Состояние Livewire
  сбрасывается в начале каждого запроса; обновление страницы, которой нет на этом хосте, и запрос с компонентами
  разных страниц отклоняются — иначе Livewire выполнил бы их без проверок или в контексте другой страницы.
- Консоль вне разработки — только на своём хосте (`CONSOLE_DOMAIN`), кабинеты — на хосте `APP_URL`.
- Кабинет мерчанта открыт членам его команды и сотрудникам активного партнёра с доступом к данным мерчантов, если
  команда мерчанта не запретила им доступ; в переключателе — мерчанты своих команд, затем мерчанты партнёров, без
  закрытых и запретивших. `StaffAccess::deniedMerchantsOf`.
- Вход во все кабинеты: обязательная двухфакторная аутентификация (приложение-аутентификатор и коды
  восстановления; код принимается ±30 секунд и один раз), лимиты платформы вместо лимита Filament на всех шагах, на
  шаге кода пароль проверяется только у той же учётной записи, без «Запомнить меня», неверный код — в журнале
  безопасности, вход со вторым фактором отмечает сеанс подтверждённым; события 2FA (включение, выключение,
  использование кода восстановления, неверный код в профиле) пишутся в журнал. Новые коды восстановления — только
  с повторным подключением приложения: Filament выпускал их по одному паролю.
- Профиль (имя, e-mail маской, смена пароля с политикой платформы — этот браузер остаётся в системе, остальные сеансы
  завершаются), «Мои сеансы» (завершить один или все, кроме текущего), «События безопасности» с постраничным выводом;
  время — в поясе кабинетов с его указанием.
- Заголовки безопасности страниц кабинетов (`security.headers`, по HTTPS — HSTS), ответы Livewire не превращаются в
  problem+json, аватары с инициалами и шрифт Filament вместо внешних сервисов.
- `Merchants::findMany`; `PanelGate` решает о тенантах; псевдонимы middleware в контракте `StaffSessions`;
  `LocalCabinetSeeder` — демо-записи для локальной разработки.

### Этап 6a. Сотрудники: учётные записи, членство, доступ

- Модуль `identity` (ADR-0013): учётные записи сотрудников вместо стандартных таблиц Laravel — e-mail зашифрован
  ключом ПДн, поиск по слепому индексу, наружу только маска; Argon2id; токены сброса пароля в кэше по id записи;
  remember-me нет.
- Членство на трёх уровнях: операторы платформы, команды партнёров, команды мерчантов (под RLS; до выбора мерчанта —
  функция `staff_tenant_memberships`). Фиксированные роли и права, утверждённые владельцем продукта; сотрудники
  партнёра работают у его мерчантов по своей роли, отключённое членство мерчанта запрещает и такой доступ.
- Правила команд в домене: изменения — с `team.manage`, владельцы — только с `team.manage_owners`, своё членство не
  меняет никто, владелец с работающей учётной записью остаётся всегда (и последний администратор платформы);
  сотрудники партнёра командой мерчанта не управляют; операторы платформы не состоят в командах.
- Политика паролей (12–128 символов, список распространённых паролей и раскладок, без частей e-mail и имени); смена
  пароля отменяет ссылку сброса, пересчёт хеша при входе не возвращает старый пароль.
- Лимиты попыток входа без блокировки записи: 5 в минуту на e-mail с адреса и 20 в минуту с адреса, попытка
  считается до проверки пароля (ключи — HMAC e-mail); второй фактор — 5 попыток за 15 минут и 20 неудач в сутки;
  неизвестная запись стоит той же проверки хеша, неудачная проверка длится не меньше 400 мс.
- Реестр сеансов `staff_sessions`: абсолютный срок 12 часов, простой 30 минут в консоли и 120 в кабинетах, опросы не
  продлевают сеанс, вход поверх открытого сеанса закрывает его; middleware `identity.session:<panel>`; журнал
  безопасности учётных записей (append-only); обезличивание сотрудника снимает его роли и удаляет сеансы.
- Команды `staff:create`, `staff:grant`, `staff:revoke`, `staff:disable`, `identity:prune-sessions` (ежедневно).
- Вне локальной разработки и тестов страницы с сессией не обслуживаются при небезопасных настройках (нужны
  шифрование данных сессии, cookie `Secure`, `HttpOnly`, `SameSite` lax/strict, имя `__Host-…`, выключенный
  `APP_DEBUG`); проверка идёт на запросе, поэтому команды и API от неё не зависят. Доверенные прокси задаются
  `TRUSTED_PROXIES`; неаутентифицированный запрос без страницы входа получает 401 вместо ошибки 500 (`route('login')`).
- Ошибки БД в логах без значений запроса (имён, хешей паролей, шифртекстов): параметры маскируются в тексте
  `QueryException`, редактор логов скрывает строку `DETAIL`, значения в тексте ошибки PostgreSQL и хеши паролей, а
  исключение в контексте записи превращается в текст без аргументов стека (ADR-0008). Вход, проверенный до смены
  пароля, получает уже завершённый сеанс.
- Архитектурные тесты: системное соединение — только в перечисленных файлах; внутренние коды ошибок —
  `Tests\Support\ProblemCodes::INTERNAL`, без устаревших записей.

### Этап 5.6 (часть 4). PHP и TypeScript SDK

- PHP SDK `loyal/sdk` (`sdk/php`, PHP 8.2+, без зависимостей во время выполнения; curl, адаптер PSR-18) и TypeScript SDK
  `@loyal/sdk` (`sdk/typescript`, ESM, Node 22+, без зависимостей; `typescript` 6.0.3 — единственная зависимость разработки)
  поверх сгенерированного кода: клиенты Runtime и Management API, ключи идемпотентности и безопасные повторы, токены
  партнёра с обновлением, выбор мерчанта, типизированные ошибки с кодами каталога, «мог ли вызов быть обработан» для
  всего вызова, перебор страниц, проверка подписи вебхуков, маскирование секретов, помощники для тестов и песочницы.
- Контракт поведения `sdk/README.md` и эталонные векторы `sdk/conformance` (HTTP и вебхуки) — общие для обоих SDK,
  векторы проверяются по спецификациям; тесты платформы для подписи вебхуков читают те же векторы.
- Сквозные тесты PHP SDK через приложение (`Tests\Support\Sdk\KernelTransport`): быстрый старт партнёра
  (`sdk/php/examples/quickstart.php`), касса, повтор по ключу, страницы, ошибки, песочница со списанием по коду `000000`,
  подпись настоящей доставки вебхука.
- `composer check` проверяет оба SDK; CI — PHP SDK на PHP 8.2 и TypeScript SDK; Deptrac и архитектурный тест не дают
  SDK зависеть от платформы.

### Этап 5.6 (часть 3). Песочница для интеграторов

- Песочница — отдельное развёртывание той же сборки с `LOYAL_SANDBOX=true` (ADR-0012): учётные данные с маркером
  `test_` (`lk_test_…`, `lc_test_…`, `lat_test_…`, `lm_test_…`), учётные данные другого окружения — 401
  `environment_mismatch`; в каждом ответе заголовок `Loyal-Environment: live|sandbox`.
- В песочнице ничего не уходит людям: контракты `RealWorldEffect` подменяются двойниками (сейчас — отправка кодов),
  тест проверяет каждый такой контракт; принимаются только тестовые телефоны +7 900 000-00-00 … 99-99 (код всегда
  `000000`) и e-mail зарезервированных доменов, иначе 422 `sandbox_test_data_required`.
- `.env.sandbox.example`, `docs/api/sandbox.md` для интеграторов, `docs/dev/sandbox.md`, тесты режима песочницы в
  `tests/Sandbox`.

### Этап 5.6 (часть 2). Генератор SDK

- Генератор `sdk/generator` в закрытом мире: из спецификаций — типы, методы и метаданные операций, коды ошибок для
  PHP и TypeScript SDK (ADR-0011); сгенерированный код коммитится, тест следит за его актуальностью.

### Этап 5.6 (часть 1). Каталог ошибок в спецификациях

- Корневой `x-problem-codes` в обеих спецификациях: каждый код ошибки со статусом и названием; `OpenApiContract`
  проверяет по нему каждый ответ problem+json в тестах, архитектурный тест — коды в исходниках. Описаны восемь кодов,
  которых не было в спецификациях (`verification_suspended`, `invalid_phone_number`, `card_unavailable`,
  `consent_document_unavailable`, `program_unavailable`, `point_type_unavailable`, `forbidden`, `internal_error`);
  `idempotency_key_reused` в Management API — 422, как и отдаётся.
- Операции Runtime API описывают 401, 403 и 429; расчёт чека и поиск участника помечены `x-safe-to-retry`.
  Версии спецификаций — 1.1.0.

### Этап 5d. Журнал аудита

- Модуль `audit` (ADR-0010): неизменяемый журнал действий (append-only для всех ролей), записи мерчанта под RLS
  его тенанта, действия партнёра вне мерчантов видит только системная роль; контракт `AuditLog` для кабинетов.
- Management API пишет в журнал каждое изменение (с кодом ответа и ошибки), отказы 403, выдачу токенов, чтение
  данных участников и выгрузку кодов промокодов; запрос сохраняется без ПДн и секретов, с обрезкой больших
  значений. Ошибка записи в журнал не ломает выполненное действие.
- Выгрузка: `GET /api/management/v1/audit-entries` (новый скоуп `audit`; курсор, период, операция) и команда
  `audit:export` (NDJSON) для оператора платформы.
- `SensitiveDataRedactor` скрывает также `client_secret`, имя, фамилию, отчество и дату рождения (ADR-0008).
- В спецификации Management API ошибка `invalid_cursor` описана как 400, как её и отдаёт API.
- После ревью: аутентификация Management API отделена от проверки скоупа (`management.scope`) и выбора мерчанта
  (`management.merchant`), которые идут после лимита, — отказы 403 расходуют лимит и не могут без конца писать в
  журнал; `Loyal-Merchant` на операциях партнёра вне мерчантов игнорируется, их записи остаются партнёру;
  исполнитель OAuth-клиента — публичный `client_id`; телефоны маскируются во всех формах, которые принимает
  платформа, и в числах, `external_id` участника скрывается; курсор с невозможным временем — 400; индексы для
  фильтра по операции; `created` у корректировок баллов и партий промокодов; список операций (`AuditAction`) в
  спецификации и архитектурный тест маршрутов Management API.

### Этап 5c (часть 2). Акции, промокоды и участники через Management API

- Акции программы: черновик, изменение, публикация версии, запуск, пауза, архив.
- Промокоды: общие, партии уникальных с выгрузкой кодов, персональные для участника, отключение.
- Участники для бэк-офиса: поиск, карточка (маскированные контакты), история баллов, корректировки с кодом
  причины (с `Idempotency-Key` повтор не создаёт второй корректировки), фиксация уровня, заморозка,
  блокировка, снятие ограничений, обезличивание, бонусы участника. Операции леджера записывают учётные
  данные как исполнителя (`api_client`).

### Этап 5c (часть 1). Провижининг через Management API

- Программы, типы баллов (контракты `Programs`, `PointTypes`), документы согласий, черновик правил программы
  целиком, публикация и список версий.
- Организационная структура (контракт `Organization`): бренды, юрлица, точки, кассы и их отключение; ключи
  Runtime API касс и их отзыв.
- Сквозной тест критерия этапа 5: партнёр создаёт мерчанта и проводит чек только через API.

### Этап 5b. Партнёры и основа Management API

- OAuth 2.0 client credentials для партнёров: `POST /api/management/v1/oauth/token` (Basic или поля тела,
  ошибки по RFC 6749), непрозрачные токены на час; выбор мерчанта заголовком `Loyal-Merchant` только
  среди мерчантов партнёра; ключи мерчантов `lm_...`; скоупы и лимиты; команды `partners:create`,
  `oauth-clients:issue`, `oauth-clients:revoke`, `merchant-keys:issue`, `oauth-tokens:prune`.
- Модуль `management` и спецификация `docs/api/management-v1.yaml`: мерчанты партнёра (создание с
  `external_id`, список, просмотр), каталог событий, эндпоинты вебхуков и их доставки.
- Контрактная проверка тестов и архитектурный тест маршрутов работают для обеих спецификаций.

### Этап 5a. Outbox и вебхуки

- Доменные события кассы (`ReceiptConfirmed`, `ReceiptCancelled`, `ReceiptVoided`, `ReceiptReturned`),
  уровней (`TierChanged`) и бонусов (`BonusGranted`, `BonusReversed`) — внутри транзакций изменений.
- Модуль `outbox`: интеграционные события в той же транзакции, каталог типов с версиями, relay
  `outbox:relay` (каждые 5 секунд) с отказом после 10 неудач, `outbox:prune`.
- Модуль `webhooks`: эндпоинты с подпиской на события и зашифрованным секретом, доставки с подписью
  Standard Webhooks, повторы до ~2,6 суток, отключение по `410 Gone`, журнал попыток, повторная отправка,
  ротация секрета, защита от SSRF; `webhooks:deliver`, `webhooks:add`.
- `docs/api/webhooks.md` — каталог событий, семантика доставки и проверка подписи;
  `docs/examples/webhook-receiver.php` — пример получателя, проверяемый тестами.
- Исправлено: леджер запоминал id системных счетов типа баллов сразу после их создания, ещё до коммита;
  если первая операция типа баллов откатывалась (например, из-за нехватки баллов), воркер продолжал
  ссылаться на несуществующие счета. Теперь id запоминаются после коммита (регрессионный тест). Ошибку
  нашёл тест инвариантов леджера, который теперь работает на замороженных часах и с большим числом сидов.

### Этап 3c (часть 4). Штампы — этап 3 завершён

- Карты штампов в правилах программы (`stamp_cards`, до 5): свой тип баллов леджера для штампов, товары —
  условием по строке, цель N, срок жизни штампов.
- Движок: полная карта делает бесплатными самые дешёвые единицы товаров карты после скидок акций (не ниже
  нижней границы строки), за остальные целые единицы начисляются штампы; `stamps` в результате расчёта,
  `stamps.rewarded` и `stamps.earned` в объяснении; золотой вектор 18 и property-тест инвариантов. В правилах
  векторов появилось `"stamp_cards": []`, в результатах — `"stamps": []`, прочее не изменилось.
- Касса: резерв штампов бесплатных единиц с чеком, проведение и начисление при подтверждении, возврат при
  отмене, аннулировании и возвратах; офлайн-чеки только копят штампы.
- Runtime API: `stamps` в чеке, возврате и профиле участника.

### Этап 3c (часть 3). Политики сгорания баллов

- `LifecycleRules`: сгорание через N дней после активации (как раньше), в календарную дату (день и месяц
  через 0–5 лет) и после N дней без покупок; формат `lifecycle` в правилах программы и у каждого бонуса —
  `activation_delay_days`, `expiration_policy`, `expiration_days`, `expiration_date`, `expiration_years`.
  В правилах золотых векторов изменился раздел `lifecycle`, результаты не изменились.
- Леджер: скользящие партии (`sliding_expiry`) и `extendExpiry` — подтверждённая покупка продлевает срок
  всех таких баллов участника; уже просроченные не возвращаются.
- Касса начисляет и возвращает в новую партию по политике программы и продлевает срок после покупки.

### Этап 3c (часть 2). Бонусы: welcome, «приведи друга», день рождения

- Бонусы в правилах программы (`bonuses`): welcome-бонус сразу или после первой покупки от минимальной
  суммы, «приведи друга» с наградами обоим и месячным лимитом, бонус ко дню рождения за N дней до даты
  участникам со стажем; у каждого — свои задержка активации и срок жизни.
- Модуль `bonuses`: награды с зафиксированными условиями, начисление через леджер, сторно при возврате
  чека целиком или аннулировании, `bonuses:birthdays` ежечасно.
- Участники: собственный реферальный код у каждого, регистрация по коду пригласившего
  (`invalid_referral_code`), событие `MemberEnrolled`, поиск именинников по индексу.
- Реестр активных программ для системных задач (`ProgramRegistry`).
- Движок: переменная условий `member.birthday_offset`; золотой вектор 17. В правилах всех векторов
  появилось `"bonuses"`, результаты не изменились.
- Runtime API: `referral_code` при регистрации и в профиле участника.

### Этап 3c (часть 1). Уровни участников

- Уровни в правилах программы: до 10 уровней с порогами по сумме оплат деньгами и числу чеков за
  скользящее окно или календарный год, свой процент начисления у каждого уровня, срок удержания.
- Движок начисляет по проценту уровня участника (без уровня — начального), множители акций умножают его;
  в объяснении `accrual.base` указан уровень; `member.tier` в условиях акций — действующий уровень.
  Золотой вектор 16; в правилах векторов 01–15 появилось `"tiers": null`, результаты не изменились.
- Модуль `tiers`: дневная статистика покупок, повышение сразу после подтверждённой покупки, мягкое
  понижение на ступень после срока удержания (`tiers:review` ежечасно), ручная фиксация уровня до даты.
- Касса сообщает подтверждённые покупки, возвраты и аннулирования; `members:lookup` и регистрация
  участника возвращают уровень и сколько не хватает до следующего (`tier` в схеме `Member`).
- Перенос в дорожной карте: объединение дублей участников — в этап 6 (6.6), режим скидок, кратных
  количеству, — к кассовым интеграциям (9.2).

### Этап 4d (часть 2). Производительность и нагрузочный тест

- Меньше запросов к БД: расчёт чека 10 → 6, регистрация 32 → 20, подтверждение 33 → 25.
- Баланс участника одним запросом; наступившие партии одним запросом; id системных счетов и собранные
  снапшоты правил запоминаются в долгоживущем воркере.
- С чеком хранятся точность баллов и сроки активации и сгорания начисления: подтверждению и просмотру
  не нужен снапшот правил.
- Сценарий k6 `tests/load/checkout.js`, команда `processing:load-fixtures`, `docs/dev/load-testing.md`.

### Этап 4d (часть 1). Спецификация Runtime API

- `docs/api/runtime-v1.yaml` — OpenAPI 3.1 для всех 16 операций Runtime API, схемы и каталог ошибок.
- Контрактные проверки: каждый ответ API и тело каждого успешного запроса в тестах сверяются со
  спецификацией; архитектурный тест сравнивает маршруты и операции.

### Этап 4c. Участники и балансы через API, подтверждение списания, офлайн-пакеты

- Runtime API участников: `members:lookup`, регистрация с подтверждением телефона, коды для приложения,
  баланс и история баллов.
- Подтверждение списания кодом (политика программы `redemption.confirmation`): отправка кода с привязкой
  к кассе и баллам, проверка отдельным вызовом, потребление при регистрации чека.
- Антифрод: пауза списания после смены телефона, суточный лимит чеков со списанием, ручной ввод требует
  кода.
- Офлайн-пакеты `receipts:batch` в отдельной очереди: только начисление по правилам момента покупки без
  скидочных акций, результат по каждому чеку.

### Этап 4b. Модель чека и кассовый протокол

- Модуль `processing`: чеки и строки со снапшотом правил и полным расчётом, естественный ключ кассы,
  фискальные признаки, неизменяемые данные покупки.
- Runtime API: `POST /api/v1/receipts:calculate`, `POST /api/v1/receipts` (резерв или сразу подтверждение),
  `:confirm`, `:cancel` (отмена резерва или аннулирование), возвраты, просмотр чека.
- Резерв берёт баллы (холд), бюджеты и лимиты акций и промокоды; подтверждение проводит холд и начисляет
  баллы с активацией и сгоранием; возвраты отдают накопительные доли эффектов строк; истечение резервов
  `receipts:expire-reservations`.
- Модуль `tenancy`: контракт `TerminalDirectory`; `access` использует контракты программ и касс.
- ADR-0009: кассовый протокол.

### Этап 4a. Фундамент Runtime API

- Модуль `access`: ключи касс с привязкой к программе (хранится только SHA-256 секрета, поиск по префиксу
  через узкую SECURITY DEFINER-функцию), скоупы, срок действия, отзыв; команды `api-keys:issue`,
  `api-keys:revoke`.
- Middleware `api.key` (аутентификация и контекст тенанта) и `api.idempotent` (идемпотентность в одной
  транзакции с работой запроса, повтор ответа, 422 при другом запросе с тем же ключом), очистка
  `idempotency:prune`.
- Лимиты запросов на ключ и тенант с ответом 429 в формате problem+json и заголовками `RateLimit-*`.
- Этап 3c (уровни и механики) перенесён после этапа 4: механики считаются от подтверждённых покупок.

### Этап 3b. Акции и промокоды

- Акции как данные: условия на строгом подмножестве JsonLogic с белым списком переменных, выбор строк,
  эффекты (скидка процентом, суммой на чек или единицу, спеццена, баллы процентом, фиксом, множитель),
  приоритеты, группы совмещения «первая» и «лучшая», эксклюзивность, расписание, каналы, точки,
  «только участникам», бюджеты и лимиты на участника.
- Жизненный цикл акций: черновик, неизменяемые версии, активация, пауза, архив; снапшот программы хранит
  ссылки на версии активных акций, несовместимые акции не попадают в правила.
- Учёт бюджетов и лимитов (`CampaignUsage`) с атомарным списанием при подтверждении и возвратом при отмене.
- Промокоды: общие, уникальные (массовая генерация), персональные; проверка с причинами отказа, резерв,
  подтверждение и освобождение по ссылке на чек.
- Движок: скидки акций в конвейере с нижними границами строк, баллы акций, применённые акции в результате,
  новые коды объяснения; 6 новых «золотых» векторов, property-тесты акций, команда `rules:benchmark`.
- Ядро: `Allocator::cappedLargestRemainder`; быстрый путь `IntMath` и `Allocator` на нативных целых
  (в 10 раз быстрее, результат совпадает с точной арифметикой).
- ADR-0007 уточнён: эффекты — закрытый набор типов вместо формул ExpressionLanguage.

### Этап 3a. Каталог, правила программы и расчёт чека

- Модуль `catalog`: идемпотентный импорт категорий и товаров по кодам мерчанта; ограниченные товары,
  исключения из начисления, списания и акций с наследованием от категорий-предков; минимальная цена единицы.
- Модуль `rules`: черновик правил программы и публикация в неизменяемые версии (`rule_snapshots`) с хэшем
  содержимого; выбор версии, действовавшей в момент покупки.
- Движок расчёта чека: лимиты списания (доля, остаток на единицу, МРЦ, минимальная сумма чека), начисление
  на оплаченное деньгами с одним округлением на чек, распределение по строкам, объяснение расчёта.
- «Золотые» векторы расчёта с ручным расчётом и property-тесты движка.
- Леджер: контракт `PointTypeDirectory`; ядро: `Row::nullableInt`.

### Этап 2. Участники, идентификация и согласия

- Модуль `members`: регистрация с согласиями, подтверждением телефона и картой в одной транзакции; поиск
  по телефону, карте, внешнему ID и одноразовому коду; смена телефона с подтверждением; статусы;
  обезличивание; выпуск, привязка и блокировка карт.
- Модуль `consents`: версии документов и неизменяемый журнал согласий с доказательствами.
- Модуль `verification`: коды подтверждения с лимитами, паузами повторной отправки, дневным лимитом тенанта,
  автоматической остановкой при SMS pumping и привязкой к контексту операции.
- Ядро: `PhoneNumber`, `EmailAddress`, шифрование ПДн (`PiiCipher`), слепой индекс (`BlindIndex`),
  команда `pii:generate-keys`; контракт `ProgramDirectory` модуля программ.

### Этап 1. Леджер баллов

- Модуль `programs`: программы лояльности с неизменяемыми часовым поясом и валютой.
- Модуль `ledger`: типы баллов, счета участника и системные счета, проводки двойной записи, партии со
  сроками активации и сгорания, резервы, журнал движений партий.
- Операции: начисление, резерв, полное и частичное проведение, отмена, восстановление после возврата,
  сторно начисления с политиками для потраченных баллов, долг и его погашение, ручные корректировки.
- Гарантии в PostgreSQL: сбалансированность транзакций, append-only, запрет отрицательного баланса,
  неизменяемые условия типа баллов, составные внешние ключи.
- Команды `ledger:activate-due`, `ledger:expire-due`, `ledger:release-expired-holds`, `ledger:reconcile`
  (по расписанию) и `ledger:benchmark`.
- Ядро: `Immutability`, `Row`, `SqlTime`, курсорная пагинация.
- Тесты: рандомизированная проверка инвариантов, параллельные списания, интеграционные тесты команд.

### Этап 0. Фундамент

- Окружение разработки: PHP 8.5 и PostgreSQL 17 в Laragon, скрипты `scripts/dev`.
- Laravel 13, модульный монолит (`internachi/modular`), модули `kernel` и `tenancy`.
- Качество: Pint со `strict_types`, Larastan уровня 8, Deptrac с картой зависимостей модулей, Pest 5 и
  архитектурные тесты.
- Роли PostgreSQL (`owner`, `app`, `system`), команда `db:bootstrap`, Row-Level Security на всех таблицах
  тенантов, составные внешние ключи внутри тенанта.
- Контекст тенанта: синхронизация с сессией PostgreSQL, передача в задачи очереди, сброс между запросами.
- Ошибки API в формате RFC 9457, `X-Request-Id`, маскирование ПДн в логах.
- `Money`, точная целочисленная арифметика и распределение сумм методом наибольшего остатка.
- Оргструктура тенанта: партнёры, тенанты, бренды, юрлица, точки продаж, кассы.
- GitLab CI: статический анализ и тесты на PHP 8.5 + PostgreSQL 17.
- Документация: дорожная карта, ADR 0001–0008, архитектура, инструкция по окружению.
