# ADR-0026. Отчёты

- Статус: принято; реализуется на этапе 8 — 8a (периоды и «Обзор программы»), 8b (обязательства и данные для
  МСФО 15, по юрлицам и расчёты между ними), впереди 8c (точки, кассиры и акции), 8d (выгрузки и отчёты по расписанию)
- Дата: 2026-11-10 (решение владельца продукта — 2026-11-10)

## Контекст

Этап 6 дал «Сводку» кабинета: последние 7, 30 или 90 дней, покупки участников, баллы одного типа, обязательства на
сейчас. Для пилота нужна основа этапа 8: операционные отчёты в кабинете мерчанта и через Management API, выгрузки и
данные для МСФО 15.

Решение владельца продукта (2026-11-10): сначала основа отчётов в объёме пилота, всё в PostgreSQL. ClickHouse, когорты,
RFM и контрольная группа — во второй фазе, как в исследовании (docs/research/report.md).

## Решение

### Где считаются отчёты

- Каждую цифру считает модуль, который хранит её данные, через свой контракт: покупки — `ReceiptStats` (processing),
  баллы — `LedgerStats` (ledger), участники — `Members`. Так отчёт сходится с чеками и счетами участников.
- Новый модуль `reports` собирает отчёт из этих контрактов (`Modules\Reports\Contracts\ProgramReports`). Его зовут и
  кабинет, и Management API, поэтому цифры у них одни и те же. Сам модуль ничего не хранит и ничего не пишет.
- Чужих типов модуль данных не знает: леджер отдаёт начисления и отмены по типу ссылки (`LedgerTotals::accruedBy`,
  `reversedBy`), как их назвал модуль, который их провёл. По каким источникам их раскладывать, решает `reports`: покупки
  — `Checkout::LEDGER_REFERENCE`, бонусы — `BonusKind::ledgerReference()`, действия — `ActivityRewards::REFERENCE`,
  остальное — «другое».
- Собранный отчёт хранится 5 минут (`ProgramReports::KEEP_SECONDS`) — один для кабинета и API, по мерчанту,
  программе, поясу и дням периода. Отчётов мерчанта собирается не больше 30 в минуту (`PER_MINUTE`, счёт до того, как
  отчёт собран): отчёт читает квартал чеков и леджера, а база общая для касс всех мерчантов. Сверх лимита — 429
  `reports_throttled` с `retry_after`, в кабинете — сообщение; собранный отчёт отдаётся без лимита.

### Периоды (8a)

- Отчёт читает целые дни часового пояса программы (`ReportWindow`, не больше 92). Кроме последних N дней —
  `ReportWindow::between` (дни, которые выбрал человек или назвал клиент API, оба включительно, годов 2000–2099, по
  календарю: день перевода часов остаётся одним днём) и `previous()` — столько же дней до них, для сравнения.
  - День начинается тогда, когда начинается его первый час. В поясах, где часы переводят ровно в полночь (Сантьяго),
    такой день начинается в 01:00, и граница окна не захватывает час следующего дня.
  - Года нуля в PostgreSQL нет, а первый день года 1 в поясе восточнее UTC приходится на год ноль в UTC. Поэтому годы
    ограничены. День, которого в поясе нет (Самоа пропустило 30 декабря 2011), — тоже не период: в API это 422.
- В «Сводке»: 7, 30 и 90 дней, этот месяц (с первого числа по сегодня), прошлый месяц и «Свой период» — два дня в
  форме. Период живёт в адресе (`from`, `to`), поэтому страницу можно отправить ссылкой. Неверные свои дни в адресе —
  период из `period` или 30 дней, в форме — сообщение.
- Плитки участников, покупок, выручки, покупателей, начислений и оплаты баллами сравнивают себя с прошлым периодом
  той же длины: «к прошлому периоду: −50 %».

### «Обзор программы» (8a)

- **Покупки** — по времени покупки, чеки, которые остались покупками (подтверждённые, возвращённые частично или
  целиком).
  - Выручка — после скидок, вместе с частью, оплаченной баллами, за вычетом возвращённого к моменту отчёта: возврат
    уменьшает день покупки, а не день возврата.
  - Возвращённое считается по строкам чека без новых данных. Касса возвращает долю денег, которые заплатил покупатель,
    и долю оплаченного баллами, каждую накопительно и с округлением к нулю (`CheckoutService`). Поэтому все возвраты
    строки вместе дают `⌊(сумма − скидка − баллы) × r / q⌋ + ⌊баллы × r / q⌋`, где r — возвращённое количество, q —
    количество. Отчёт считает так же и сходится с кассой до копейки. Одна общая доля разошлась бы на копейку.
  - Произведения считаются в `numeric`: сумма и количество, которые принимает касса, вместе выходят за bigint.
  - Средний чек — участника и без участника.
- **Покупатели**: сколько участников купили за период, сколько из них впервые (до периода покупок не было) и сколько
  больше одного раза. Дубль, объединённый позже, считается отдельно: чек хранит участника, каким его знала касса
  (ADR-0019). Поэтому первая покупка после объединения тоже считается покупкой впервые — «Сводка» так и пишет.
- **Баллы** — текущего типа программы, по учёту баллов на дату операции: начислено по источникам, оплачено, сгорело,
  забрано по источникам, вручную, изменение счетов за период и что на счетах сейчас.
- **Management API** — `GET /programs/{program}/reports/overview?from=&to=`, скоуп `reports`, те же цифры, что в
  «Сводке», и каждый день периода. Без дат — последние 30 дней. Персональных данных нет, поэтому чтения не пишутся в
  журнал аудита; операция называется `reports.overview`. Приостановленный мерчант отчёты читает.
  - Скоуп `reports` выдаёт и разработчик партнёра. Персональных данных в отчётах нет, а суммы чеков такой разработчик
    и так видит в вебхуках `receipt.*`. Учётные данные, у которых `reports` уже был, теперь читают сводку.

### Обязательства (8b-1)

Данные, которые МСФО 15 просит раскрыть о программе лояльности: входящий и исходящий остаток обязательств, движение за
период, когда обязательства будут исполнены, фактическая доля погашения (docs/research/report.md). Платформа отдаёт их
по номиналу балла; оценку обязательства с учётом ожидаемого погашения делает бухгалтерия мерчанта.

- **Период** — целые месяцы пояса программы (`ReportMonths`, не больше 12 — год баланса, годы 2000–2099): последние N
  месяцев с текущим, месяцы, которые выбрал человек или назвал клиент API. Месяц начинается тогда, когда начинается его
  первый час (Асунсьон перевёл часы в полночь 1 октября 2023 года).
- **Остаток на начало** — то, что на счетах участников сейчас, за вычетом всего, что вступило в силу с начала периода
  (`LedgerStats::movement`). Так читаются операции только с начала периода, а не вся история: чаще всего период —
  недавние месяцы. Обе суммы берутся одним запросом, поэтому операция периода, проведённая между чтениями, не сдвигает
  остаток на начало. Остаток — за вычетом долгов участников, вместе с баллами в резерве под оплату, как `liability`.
- **Движение** — суммы операций по месяцам, как в «Сводке» (по дате операции). **Остаток на конец** — начало плюс
  движение, поэтому таблица сходится по построению. Объединение дублей (ADR-0019) переносит баллы двумя операциями с
  одной датой: в сумме они дают ноль.
- **График сгорания** — что на счетах сейчас, по месяцу сгорания с текущего на 12 месяцев вперёд
  (`LedgerStats::expirySchedule`): остатки партий (`point_lots`), ещё не доступных и доступных, по сроку; что уже должно
  было сгореть, но ещё не списано, — в текущем месяце; дальше «позже» и «бессрочные». Отдельно — резервы под оплату (их
  баллы вернутся к своим срокам или будут оплачены) и долги участников. Партии и счета читаются одним запросом: всё
  вместе — то, что на счетах (инвариант леджера, который проверяет сверка). Срок баллов, сдвигающийся с покупками, — тот,
  что у них сейчас. Нового индекса нет: индекс по `remaining` лишил бы обновления партий HOT.
- **Когорты** — партии каждого месяца периода по дате операции, которая их создала, и что с ними стало к моменту
  отчёта (`LedgerStats::cohorts`), по движениям партий: начислено — сколько партии получили (начисления, баллы вручную,
  баллы возврата отдельной партией); оплачено — что взяли резервы за вычетом вернувшегося при отменах и возвратах, вместе
  с резервами, которые ещё не проведены; забрано отменой своего начисления; сгорело; списано вручную, в счёт долга или
  долга дубля, а также вместо уже потраченных баллов другого отменённого начисления (`SpentPointsPolicy`: отмена
  забирает их с других партий — это не отмена их начисления); осталось. Начислено минус ушедшее — осталось: так устроен
  журнал партий. Доли оплаты и сгорания — от начисленного за вычетом забранного: фактическая доля погашения, на которую
  опирается оценка breakage. Партии объединённого дубля остаются в своём месяце.
- **Месяцы в запросах** — по границам, которые считает PHP (`ReportMonths::ends`): операция или срок партии относится
  к месяцу, до конца которого наступил. База сама месяцы в поясе не считает, поэтому разница таблиц часовых поясов PHP
  и PostgreSQL не теряет и не переносит баллы между месяцами.
- **Кабинет**: страница «Обязательства» — 12 месяцев, этот и прошлый месяц, прошлый квартал, прошлый год, «Свои месяцы»
  (два месяца из последних пяти лет); плитки остатков и движения в баллах и рублях по номиналу балла (с округлением вниз
  до копейки), движение по месяцам, график сгорания, когорты с долями.
- **Management API**: `GET /programs/{program}/reports/liabilities?from=&to=` (месяцы `Y-m`, без них — последние 12),
  скоуп `reports`, операция `reports.liabilities`; в баллах, с номиналом балла и точностью, как сводка. Хранение 5 минут
  и лимит в 30 отчётов мерчанта в минуту — общие со сводкой. Остаток на начало читает операции от первого месяца
  периода до сегодня, по программе и по партиям юрлиц, поэтому отчёт об обязательствах считается в лимите за два и ещё
  за каждый целый год, на который его первый месяц раньше текущего, но не больше чем за всю минуту: период
  двадцатилетней давности не собрать 30 раз в минуту.

### Обязательства по юрлицам (8b-2)

Решение владельца продукта (2026-11-10): баллы без точки — отдельной строкой «Без юрлица», без настройки основного
юрлица программы; расчёты между юрлицами — сразу.

- **Юрлицо операции** — то, что было у её точки, когда операцию записали: `ledger_transactions.legal_entity_id`
  пишет сама база перед вставкой (триггер по `location_id`), поэтому юрлицо есть у каждой операции в точке, кто бы её
  ни провёл, и не меняется, когда точка переходит к другому юрлицу. Операции, записанные до этого, получили юрлицо своей
  точки один раз, миграцией (порциями по ключу, каждая — в своей транзакции, которая снимает и возвращает защиту
  таблицы; тест следит, что защиты всех таблиц только для добавления включены). Бонус за покупку (приветственный, за
  приглашение) начисляется в точке покупки (`ConfirmedPurchase::$locationId`); приветственный бонус при вступлении,
  бонус ко дню рождения, баллы вручную, действия без точки и бонусы за покупки, начисленные до этого этапа, — без
  юрлица. Резерв под оплату по чеку датирован временем покупки, как и его проведение (`HoldPoints::$effectiveAt`):
  иначе чек, присланный кассой после конца месяца, разнёс бы резерв и возврат его остатка по двум месяцам.
- **Юрлицо партии** — юрлицо операции, которая её создала. Остаток юрлица — что в его партиях: сейчас минус движения
  партий с начала периода, одним запросом (`LedgerStats::movementByEntity`; индекс `lot_movements_transaction_index`).
  Движения — как в когортах; резерв тратит партии в момент, когда сделан, его отмена и возврат возвращают в них.
- **Резервы и долги**: партии не держат ни баллов резервов, которые ещё не проведены, ни долгов участников. Их строка —
  обязательства программы (8b-1) за вычетом партий юрлиц (`PointsLiabilities::beyondLots`), поэтому строки складываются
  во всю программу точно. Движение в ней: оплачено — разница моментов (резерв тратит партии при резерве, а программу —
  при оплате); забрано — долг, который сделала отмена начисления (её часть сверх баллов, AllowNegative); списано —
  долг, сделанный списанием вручную, а со знаком минус — долг, погашенный следующими баллами или покрытый при
  объединении дублей; не забрано — всё программы (у партий его нет). Отмена начисления считается забранным и у партий
  юрлиц, с какой бы партии она ни брала (в когортах — нет: там отмена чужой партии — «списано»). Все цифры отчёта
  читаются одним снимком базы (repeatable read): иначе операция между чтениями программы и партий попала бы в эту
  строку.
- **Расчёты между юрлицами** (`LedgerStats::settlements`): баллы партий юрлица A, которые взяли резервы в точках юрлица
  Б (по операции `hold` резерва), за вычетом вернувшегося при отмене резерва и возврате в те же партии, по месяцу
  движения (возврат в следующем месяце — минус в нём). Возврат отдельной партией расчёт не уменьшает: это новые баллы
  юрлица точки возврата.
- **Когорты по юрлицам** (`cohortsByEntity`); когорты программы — их сумма.
- В кабинете — разделы «По юрлицам» и «Расчёты между юрлицами» страницы «Обязательства» (юрлицо — название и ИНН,
  как сейчас); в API — `legal_entities` (с движением по месяцам и когортами, юрлицо — по идентификатору: название и
  ИНН ИП — данные человека, их читают со скоупом `organization`), `beyond_lots`, `settlements`. Хранимый отчёт — новой
  формы, ключ кэша `v2`; отчёт считается в лимите за два и ещё за каждый год давности.

### Точки и кассиры (8c-1)

- **Где и кем продано** (`ReceiptStats::places`): чеки периода, которые остались покупками, по времени покупки — по
  точкам, по кассам точек и по кассирам точек, одним запросом (`grouping sets`). Что осталось от чека после возвратов,
  читается из его строк, как в «Обзоре»: возврат отдаёт долю каждой цифры строки, накопленно и с округлением вниз —
  отдельно деньгами, оплаченными баллами, и остальными, — так что от строки остаётся x − ⌊x·возвращено/количество⌋.
  Возврат уменьшает цифры точки, кассы и кассира покупки, где бы его ни оформили. Баллы — чеков текущего типа баллов
  программы. «Карта вручную» — чеки, где касса назвала участника номером, набранным руками (`manual_entry`): частый
  признак того, что кассир отмечает свою карту на чужих покупках. Вступившие — по точке регистрации участника
  (`Members::joinedByLocation`): кто вступил через кассу — и через сайт или приложение с ключом кассы, — в её точке;
  в кабинете покупателя и при загрузке списка — ни в какой.
- **Кассир** — текст, которым касса назвала его в чеке: веб-касса передаёт идентификатор своего кассира, и кабинет
  показывает его имя из «Кассиров»; другие кассы — что передают. Кассиры разных точек — разные строки: две кассы,
  которые зовут разных людей одним номером, не сольются. Отдельно — до 300 кассиров с самыми частыми чеками, остальные
  — одной строкой (касса может слать в этом поле что угодно, вплоть до своего текста на каждый чек).
- **Итоги смен** на странице «Смены»: чеки, с картой, сумма после скидок, оплачено баллами и возвраты каждой смены —
  то, что касса считает в итогах смены (устройство смены от открытия до закрытия или до сейчас), для всех смен списка
  двумя запросами (`ReceiptStats::ofDevices`); итоги хранятся минуту для того же списка смен — открытие или закрытие
  смены читает их заново.
- В кабинете — страница «Точки и кассиры» (`reports.view`, все роли: названия точек, касс и имена кассиров каждая роль
  видит и в настройках). В API — `GET /programs/{program}/reports/locations` (скоуп `reports`, операция
  `reports.locations`): точки и кассы по идентификаторам, без кассиров — касса может назвать кассира именем человека,
  а у скоупа `reports` персональных данных нет; выгрузки 8d решат, как их отдавать. Хранение и лимит — как у «Обзора».

### Результаты акций (8c-2)

- **Что акция дала на чеке** хранится построчно с чеком (`receipt_campaigns`): скидка и баллы каждой акции на каждой
  строке, из расчёта, который чек хранит (`receipts.calculation`). Их пишет сама база, когда чек вставляют (триггер
  `receipts_campaign_effects`), кто бы его ни вставил, — и код прошлого этапа во время обновления, — тогда же, когда акция
  тратит бюджет, лимиты участника и промокод. Баллы — только там, где чек их начисляет: у чека без участника расчёт
  показывает, сколько могло бы быть. Чего функция прочесть не может (акция не той программы, строка без своего номера,
  цифра не целым числом), того строкой нет, а чек вставляется: отчёт не должен останавливать покупку. Строки не
  меняются никогда. Чеки, вставленные раньше, получили их той же функцией из своих расчётов — миграцией, порциями по
  ключу, с ожиданием блокировок не дольше 5 секунд; что уже есть, не пишется второй раз, так что прерванную миграцию
  запускают снова. Отчёт читает акции периода по их индексу (`tenant_id, program_id, purchased_at`), а не расчёты всех
  чеков, и каждый чек — один раз, сколько бы акций на нём ни сработало.
- **Результаты** (`ReceiptStats::campaigns`): по каждой акции, которая за период дала скидку или баллы, — чеки,
  которые остались покупками, у скольких участников, их выручка, скидка и баллы акции, сколько чеков по промокоду;
  всё за вычетом возвращённого: возврат отдаёт долю эффекта строки, как и каждой её цифры (x − ⌊x·возвращено/
  количество⌋). Чек, на котором сработали две акции, — у обеих. Баллы — чеков текущего типа баллов программы.
  Стоимость — скидка и баллы по номиналу балла (с округлением вниз), её доля — от выручки чеков акции. Это итоги, а не
  прирост от акции: сравнение с контрольной группой — во второй фазе.
- В кабинете — страница «Результаты акций» (`reports.view`, все роли): акция — по названию и состоянию. В API —
  `GET /programs/{program}/reports/campaigns` (скоуп `reports`, операция `reports.campaigns`): акции по
  идентификаторам, их названия — со скоупом `programs`. Хранение и лимит — как у «Обзора».

### 8d-1. Выгрузки и доступ для BI

- **Файлы** (`ReportExports`): отчёт, как его даёт `ProgramReports` (то же хранение и тот же лимит), с названиями из
  настроек мерчанта — точек, касс, кассиров веб-кассы, акций, юрлиц, — файлом XLSX со всеми таблицами отчёта или CSV
  одной таблицы. Первый лист XLSX — что это за отчёт: программа, период, часовой пояс, момент сбора, номинал балла и
  как читать цифры. Таблицы — как на странице кабинета, но дни и месяцы идут от первого, а цифры — все, что есть в
  отчёте (у точек и касс — ещё выручка с участников и карты, набранные вручную; у юрлиц ИНН — отдельным столбцом).
  Что запрошено, проверяется до чтения: таблицы, которой у отчёта нет, нет и в лимите.
- XLSX пишет сам модуль `reports`, а не библиотека: цифра попадает в файл десятичной записью своих целых копеек или
  единиц балла (у библиотек под рукой числа — float, и их запись округляется после 14 цифр), текст — всегда строкой,
  а не формулой, с чего бы он ни начинался, а знак, которого в XML нет, — своим кодом. Запись `_xHHHH_`, которую Excel
  читает как знак с этим кодом, пишется с экранированным подчёркиванием (`_x005F_`): иначе касса показала бы в файле
  то, чего нет на странице. Нужен ext-zip (его требует и openspout из зависимостей Filament, так что `composer install`
  без него не пройдёт; CI его ставит). Деньги — числа с форматом `#,##0.00`, баллы — по своей точности, доли — частью
  от целого с форматом `0.0%`, дни — датами, месяцы — по названию. Шапка таблицы закреплена.
- CSV — для таблиц на русском: разделитель «;», дробная часть через запятую, UTF-8 с меткой, строки — CR LF, дни и
  месяцы — `Y-m-d` и `Y-m`, доли — частью от целого, как в XLSX. Каждый текст — в кавычках, так что и программа,
  которая читает файл по запятым или табуляциям, прочтёт его одним полем; текст, который таблица приняла бы за формулу
  (начинается — после пробелов — с `=`, `+`, `-`, `@` или их широких форм, или с табуляции либо перевода строки),
  начинается с апострофа: названия приходят от касс и людей. Excel теряет нули в начале кодов и ИНН из CSV — смотреть
  отчёт в Excel лучше файлом XLSX.
- Кассир, которого назвала касса, — как назвала, а невидимое в имени (управляющие и форматирующие знаки, знаки, которые
  Unicode велит рисовать пустотой, неназначенные, пробелы, кроме обычного, и сдвоенный обычный) — кодом `[U+XXXX]`
  (`Kernel\Text\VisibleText`; им же теперь пользуется страница, которая прежде не показывала управляющие знаки и
  знаки-пустоты).
- В кабинете — «Выгрузить» на всех четырёх страницах отчётов: те же дни или месяцы, что страница показала (она держит
  их, пока открыта, — и после полуночи); Excel — весь отчёт, CSV — таблица на выбор. Выгрузка ничего не меняет, поэтому
  её может каждый, кто видит страницу (и у приостановленного мерчанта), но файл уносит из кабинета то, что страница
  показывает, — названия и ИНН юрлиц, кассиров веб-кассы, — и каждая выгрузка — запись журнала аудита
  (`reports.download`: отчёт, дни, формат, таблица; цифр в нём нет).
- **BI.** Ключу со скоупом `reports` хватает его одного: `GET /reports/programs` (операция `reports.programs`) —
  программы мерчанта, а в отчётах точек и касс и в результатах акций — названия точек, коды и названия касс, названия
  и состояния акций. Юрлица — по идентификаторам, как и прежде (название и ИНН индивидуального предпринимателя — его
  персональные данные), кассиров — нет. Как подключить BI — `docs/api/reports.md`.

### 8d-2. Отчёты по расписанию на почту

- **Подписка** (`ReportSubscriptions`, таблица `report_subscriptions`): человек из команды мерчанта подписывает на отчёт
  программы себя и только себя — на любой из четырёх отчётов, каждый день, по понедельникам или 1-го числа
  («Обязательства», отчёт целых месяцев, — только 1-го), файлом Excel или CSV по каждой таблице. Строка — человек,
  программа и отчёт; человек — из модуля `identity`, по идентификатору. Слать отчёты другим людям нельзя: адрес
  письма — всегда адрес того, кто подписался, и его подписка — его решение.
- **Когда и за что** (`SubscriptionSchedule`): в 8:00 по часовому поясу программы — за вчера, за прошлую неделю с
  понедельника по воскресенье, за прошлый месяц; дни считаются датами календаря, так что переход часов (в Сантьяго —
  в полночь) не сдвигает ни дня. Первое письмо — в ближайшие 8:00 своей частоты после подписки; смена одного лишь
  файла сегодняшнего письма не сдвигает. Письмо, которое ушло с опозданием (после полуночи), — за то время, к которому
  было назначено (`lastAt`), а не за ночь, когда ушло: ни одного дня дважды, ни одного пропущенного. Пропущенные прогоны
  не шлют писем за каждый пропущенный период: приходит отчёт за последний.
- **Отправка** (`reports:mail` раз в 15 минут в фоне, язык — русский, `ScheduledReports`): системная роль находит
  подписки всех мерчантов, которым пора, — не больше 50 от одного мерчанта за прогон, так что мерчант с множеством
  подписок или с исчерпанным лимитом отчётов не занимает чужую очередь, — и каждая уходит в своём мерчанте в три шага:
  её берут (`for update skip locked` и срок, сдвинутый на 15 минут: другой прогон её не возьмёт, а прервавшийся вернёт
  её сам), её файлы собираются вне транзакций (отчёт об обязательствах — в своём снимке базы) — те же, что выгрузка
  (`ReportExports`: хранение и лимит отчётов мерчанта), — и письмо, запись журнала и следующий срок пишутся вместе.
  Мерчанту, отчётов которого за минуту собрано столько, сколько можно, письмо уйдёт, когда минута пройдёт (его
  остальные подписки ждут следующего прогона); письмо, которое не удалось, ждёт час, а после трёх неудач подряд — свой
  следующий срок. Подписка на программу в архиве заканчивается.
- **Кому** (`identity`, `ReportMails`): письмо уходит, только пока человек может видеть отчёты мерчанта — по
  `StaffAccess`, через команду мерчанта или его партнёра, с работающей учётной записью, у открытого мерчанта, — и
  никогда через доступ поддержки: оператор смотрит в кабинет мерчанта, он не человек его команды. Кто больше не может,
  того подписка заканчивается; подписать такого человека контракт не даёт. Адрес из модуля `identity` не выходит:
  модуль отчётов передаёт ему файлы, и письмо уходит из него — на русском, после коммита, зашифрованным в очереди, со
  ссылкой на страницу отчёта в кабинете (`PanelGate::reportUrl`, на APP_URL), а когда очередь его отправляет, доступ
  спрашивается ещё раз (`shouldSend`). Название программы и мерчанта — чужой текст (`MailText::literal`; в теме — без
  управляющих и форматирующих знаков, разворачивающих строку), имя вложения — только из букв, цифр и простых знаков.
- **Журнал аудита** (канал `schedule`, «По расписанию», действует `platform`): каждое письмо — «Отчёт отправлен на
  почту» (`report-subscriptions.mail`: отчёт, его дни или месяцы, файл; получатель — в `subject.user`), каждая
  подписка, которую платформа закончила, — `report-subscriptions.end` с причиной (`access`, `program`): файлы уносят
  из кабинета то же, что выгрузка, и выгрузка тоже записывается.
- В кабинете — «На почту» на каждой странице отчётов (`report-subscriptions.save` в журнале аудита: отчёт, частота,
  файл): окно говорит, на какой адрес (маской) и когда придёт письмо; «Не присылать» — отписка; надпись кнопки —
  «Приходит на почту», пока подписка есть. Оператору с доступом поддержки кнопки нет. Подписка меняет только почту
  самого человека, поэтому её меняют и у приостановленного мерчанта.

### Впереди

- Отчёты по расписанию для других людей и для адресов вне команды, рассылки через API — когда о них попросят
  мерчанты: каждая — решение о данных, которые уходят из кабинета.

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

- Возврат, проведённый после закрытого периода, меняет выручку прошлого периода: отчёт — о том, что осталось от
  покупок. Так же меняет прошлое и чек, который касса прислала позже (до 7 дней онлайн, до 30 офлайн).
- Деньги в отчёте считаются по дню покупки, а баллы — по дню операции. Поэтому возврат уменьшает выручку дня покупки,
  а его баллы попадают в день возврата.
- Отчёт за 92 дня читает чеки, их строки и операции леджера за этот период, а для сравнения — и прошлый период.
  Хранение на 5 минут и лимит в 30 отчётов в минуту держат нагрузку одного мерчанта. Ограничение времени запросов
  отчёта на стороне базы — настройка развёртывания (этап 11). Нагрузку крупных сетей снимет аналитический контур
  второй фазы.
- Отчёт, собранный 5 минут назад, отдаётся как есть: новая покупка видна в нём, когда отчёт соберут заново.
- Остаток на начало закрытого месяца меняется, если позже проведена операция с датой до него: чек, который касса
  прислала позже, списание, которое джоб провёл после срока. Отчёт показывает учёт на дату операции, а не то, что
  было записано к тому дню.
- Отчёт об обязательствах читает операции леджера с начала периода до сегодня, а когорты — партии периода и их
  движения; график сгорания — все живые партии программы при каждом сборе. Для периода в далёком прошлом или крупной
  сети это много строк; хранение, лимит с весом по годам и ограничение времени запросов на стороне базы (этап 11)
  держат нагрузку одного мерчанта, а аналитический контур второй фазы её снимет. Лимит — у каждого мерчанта свой:
  партнёр, у которого много мерчантов, ограничен в отчётах их лимитами и общим лимитом своих запросов к API.
