# ADR-0030. Сроки хранения и удаление персональных данных

- Статус: принято; этап 11 — 11.5-1
- Дата: 2026-11-12

## Контекст

152-ФЗ требует хранить персональные данные не дольше, чем этого требуют цели обработки (ч. 7 ст. 5), и уничтожать их,
когда цель достигнута или согласие отозвано, в срок до 30 дней (ч. 4 и 5 ст. 21). Доказать, что согласие было, обязан
оператор (ч. 3 ст. 9). Журналы событий безопасности хранятся не меньше срока, который требуют меры защиты
(ПП № 1119, приказ ФСТЭК № 21). Оператор данных покупателей — мерчант, платформа обрабатывает их по его поручению
(ADR-0008).

Опись персональных данных (этап 11.5) показала, что код пока не держит сроков, которые должны пообещать документы:

- журнал аудита, журнал безопасности сотрудников и согласия хранятся вечно, их нельзя удалить даже владельцу схемы;
- подтверждённые коды, доставки вебхуков с ответами получателей, упавшие задачи очереди и события, которые не удалось
  отправить, тоже никогда не удаляются;
- при обезличивании покупателя остаются его покупатели в МоёмСкладе (`moysklad_counterparties`);
- аварийный журнал Laravel (когда не создаётся канал логов) пишет данные без маскировки; файл лога по умолчанию один и
  растёт без ограничения.

## Решение

### Что где хранится

Каждая таблица схемы отнесена к одной из двух групп: хранит персональные данные или нет. Перечень —
`tests/Architecture/PersonalDataTest.php`. Новая таблица не пройдёт тест, пока её не отнесут к группе, а таблица с
персональными данными — пока её нет в таблице сроков ниже.

### Как удаляется

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

| Что | Срок (настройка) | Нижняя граница в базе |
|---|---|---|
| Журнал аудита | 3 года, 1096 дней (`audit.keep_days`) | 1 год |
| Журнал безопасности сотрудников | 12 месяцев (`identity.security_events.keep_days`) | 90 дней |
| Попытки доставки вебхуков | 30 дней после завершения доставки (`webhooks.keep_days`) | 7 дней |
| Доказательства согласий | 3 года, 1096 дней после обезличивания (`members.keep_proofs_after_anonymization_days`) | 180 дней после обезличивания |

### Доказательство согласия

Согласие покупателя доказывают две записи:

- событие согласия с его обстоятельствами: адрес, касса, кассир, сессия;
- код, которым при вступлении подтверждён телефон. Только по коду видно, какому номеру он ушёл: у обезличенного
  покупателя номера больше нет.

Код помечается участником, согласия которого доказывает (`verification_requests.member_id`, `Verification::keepAsProof`;
коды прошлых согласий найдены по их доказательствам при миграции). Эту пометку база больше не меняет. Любой другой
подтверждённый код удаляется через 13 месяцев, как журнал сообщений.

Доказательства хранятся, пока покупатель участвует в программе, и ещё 3 года после его обезличивания: в это время могут
прийти претензии, а это общий срок исковой давности.

`members:prune` по времени обезличивания, записанному базой:

- удаляет события согласий (`ConsentProofs`) и коды-доказательства (`CodeProofs`);
- отмечает это в `members.proofs_erased_at`.

### Обезличивание

Обезличивание окончательно и в базе:

- время обезличивания `members.anonymized_recorded_at` записывает сама база в момент, когда покупателя обезличивают
  вместе со статусом. Сдвинуть его назад или стереть нельзя;
- статус обезличенного больше не меняется;
- отметку `proofs_erased_at` ставит один раз системная роль, и только обезличенному покупателю;
- иначе всё это может только владелец схемы (миграция).

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

Обезличивание стирает:

- профиль: телефон, почту, имя, дату рождения, пол, внешний номер, атрибуты;
- привязки MAX и ВКонтакте;
- сессии;
- письма в очереди;
- подтверждения адресов;
- заметки к ручным начислениям;
- причины фиксации уровня;
- покупателей МоегоСклада (`ForgetAnonymizedBuyers`). Привязку нового покупателя МоегоСклада касса пишет, удерживая
  участника, поэтому обезличивание её не пропустит. Привязки участников, обезличенных раньше, удалила миграция.

Остаются записи, которые держат только идентификатор участника и после обезличивания ни с кем не связаны:

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

### Закрытый мерчант

Этап 11.5-3. Когда платформа закрывает мерчанта, она записывает момент закрытия (`tenants.closed_at`). Через
`members.erase_after_merchant_closed_days` (30) дней после закрытия `members:erase-closed-merchants` (раз в час)
обезличивает всех его участников, так же как обезличивание вручную: профиль, контакты, привязки мессенджеров, сессии,
заметки сотрудников и имена объединённых записей.

- Участники идут по одному, каждый в своей транзакции, в пределах минут одного запуска (`--minutes`, 10). Мерчанты
  идут страницами по моменту закрытия. Большая база обезличивается за несколько запусков.
- Транзакция каждого участника держит мерчанта закрытым с того же момента (`Merchants::holdClosed`, строка
  `for share`, только внутри транзакции). Открытие ждёт участника, который обезличивается сейчас, после этого
  обезличивание мерчанта останавливается.
- Участника, которого не удалось обезличить, команда пропускает с отчётом об ошибке и идёт дальше. Мерчант тогда не
  отмечается и обрабатывается снова в следующий запуск.
- Когда участников не осталось и сбоев не было, мерчант отмечен (`tenants.members_erased_at`). Отметка ставится только
  той закрытой записи, от которой считались дни: открытый за это время мерчант её не получит. В журнал аудита мерчанта
  пишется запись `merchants.erase-members` (канал `schedule`): когда он был закрыт и через сколько дней обезличен.
  Это подтверждение уничтожения данных, оно остаётся и после повторного открытия.
- Открыть мерчанта снова можно в любой момент. Открытие забывает и момент закрытия, и отметку: при новом закрытии дни
  считаются заново. Уже обезличенные данные открытие не возвращает, консоль предупреждает об этом.
- Меньше 7 дней команда не принимает: мерчанта, закрытого по ошибке, успевают открыть. Выгрузить свои данные закрытый
  мерчант уже не может (кабинет и API закрыты): это нужно сделать до закрытия (см. «Выгрузка базы»). Диалог закрытия в
  консоли напоминает об этом.
- Закрытому мерчанту не уходят вебхуки (`FanOut`): договор кончился, а обезличивание (отзыв согласий участников)
  отправило бы его серверу идентификаторы всей базы. События за время закрытия теряются и при повторном открытии.
- Менять таблицу мерчантов может только роль сотрудников (консоль). Публичный трафик мерчантов читает и добавляет
  (Management API партнёра), но не меняет: внедрённый запрос не закроет мерчанта и не сдвинет момент закрытия.
- Мерчанты, закрытые до этого этапа, считают дни от выкладки, а не от закрытия.
- Остаются учёт мерчанта без людей (чеки, баллы, бонусы) и журналы по своим срокам. Имена кассиров веб-кассы и в
  чеках, учётные данные каналов рассылок и ключи остаются, пока записи мерчанта не удалят.
- Консоль показывает у закрытого мерчанта дату, с которой данные обезличат, что обезличивание идёт или когда оно
  закончилось.

### Выгрузка базы

Этап 11.5-4. Мерчант — оператор персональных данных своих покупателей, платформа обрабатывает их по его поручению.
Когда договор кончается, обработчик возвращает данные оператору. Поэтому владелец мерчанта может выгрузить базу
участников программы в любой момент, а перед закрытием — обязательно: «Участники» → «Выгрузить базу».

- Файл CSV (как CSV отчётов: «;», UTF-8 с BOM, тексты в кавычках, «формулы» обезврежены) со всеми участниками
  программы, кроме обезличенных и объединённых, новые первыми — как список участников. В строке:
  - телефон и почта целиком; телефон — цифрами без «+»: с «+» таблица приняла бы его за формулу, а апостроф, который
    это предотвращает, остался бы при загрузке в другую систему;
  - имя, пол, дата рождения, статус, где и когда зарегистрирован (время программы, её пояс — в названии столбца);
  - последние 4 цифры действующих карт: полный номер не хранится, он напечатан на карте;
  - код приглашения и дополнительные поля интеграций — объектом JSON, как их хранит база;
  - баллы каждого типа — те же четыре цифры, что на карточке: на счёте, можно потратить (без партий, срок которых
    прошёл, хотя их ещё не списали), ещё не стали доступны, в резерве под оплату;
  - уровень, в котором программа считает участника, как карточка и касса: сохранённый, если он есть в действующих
    правилах, иначе начальный; без уровней в правилах — пусто;
  - день, когда дано каждое действующее согласие (по поясу программы).

  Значение, которое таблица приняла бы за формулу (начинается с `=`, `+`, `-` или `@`), начинается с апострофа — так
  бывает с почтой или внешним номером; при загрузке его нужно снять.
- Только владельцы мерчанта (`members.export_all`). Ни администратор, ни люди партнёра: база принадлежит мерчанту.
  Мерчанту партнёра без своего владельца партнёр сначала приглашает владельца, и выгружает уже он. Право
  чувствительное (свежее подтверждение входа), недоступно поддержке платформы, только читает — приостановленный мерчант
  тоже выгружает базу. 5 раз в час и 10 в день на человека.
- Кнопка проверяет человека, подтверждение и лимиты, пишет в журнал аудита запись `members.export-all` с программой
  (без содержимого файла) и отправляет браузер по ссылке на минуту (`BaseDownloads`: в кеше — только SHA-256 ссылки,
  она привязана к человеку, мерчанту и программе и действует один раз). Файл отдаёт отдельный маршрут кабинета
  (`DownloadMemberBase`) обычной загрузкой: Livewire держал бы всю базу в памяти и отправлял бы её внутри JSON, и
  большая база не дошла бы до мерчанта как раз перед закрытием. Маршрут снова проверяет право человека в мерчанте
  адреса.
- Файл собирается целиком до отправки, в одном снимке базы: транзакция `repeatable read, read only` (объединение или
  покупка во время выгрузки не переносит баллы из строки в строку). Участники читаются по 500, баллы, уровни и
  согласия пачки — одним запросом каждого модуля (`Members::withContacts` по индексу регистрации,
  `LedgerStats::accountBalances`, `Tiers::currentOf`, `Consents::statesOf`), строки пишутся во временный поток: в
  памяти до 4 МБ, остальное — на диск. Сбой не отдаёт половину базы.
- Каждому владельцу приходит письмо: какая программа, сколько участников, когда и чья учётная запись (имя и маска
  почты). Так выгрузку чужим сеансом не скрыть. Письмо уходит, когда файл готов; если сообщить не удалось никому, файл
  не выдаётся, а человек возвращается к списку с объяснением.

### Функции базы

- Роли приложения не создают временных таблиц (у них снято право `TEMPORARY`): иначе временная таблица с именем
  настоящей подменила бы её в функции, которая ищет таблицы по пути поиска вызывающего.
- Каждая функция схемы читает таблицы по своему пути поиска, где временные объекты стоят последними
  (`set search_path = pg_catalog, public, pg_temp`). Это проверяет `tests/Architecture/FunctionSearchPathTest.php`.
  Исключение — две функции политик, которые читают только настройки.
- Представления для ролей приложения только для чтения: простое представление пишет в свою таблицу с правами
  владельца.

### Логи

- Аварийный журнал маскирует данные так же, как каналы (`RedactingLogManager`). Он пишет в `laravel.log`, только когда
  канал не создаётся.
- По умолчанию лог пишется в файл на каждый день и хранится `LOG_DAILY_DAYS` (14) дней.
- В контейнерах лог уходит в stderr (`LOG_CHANNEL=stderr`), его хранит сборщик (этап 11.1).
- Машина разработчика пишет один файл: локальные коды читают там.

### Сроки

Покупатели (данные мерчанта как оператора):

| Таблица | Что о человеке | Сколько хранится |
|---|---|---|
| `members` | телефон и почта (зашифрованы), имя, дата рождения, пол, внешний номер | пока участвует; обезличивание стирает |
| `loyalty_cards` | номер карты (слепой индекс, 4 последние цифры) | пока есть карта; при обезличивании блокируется |
| `consent_events` | согласия и их обстоятельства (адрес, касса, кассир, сессия) | пока участвует и 3 года после обезличивания |
| `verification_requests` | маска и слепой индекс номера, адрес запроса | неподтверждённые 30 дней; подтверждённые 13 месяцев; доказательства — как согласия |
| `messages` | маска и слепой индекс получателя | 13 месяцев |
| `member_messages` | кому и о чём (текст зашифрован до отправки) | 13 месяцев после отправки; при обезличивании не отправленные стираются |
| `member_email_confirmations` | адрес на подтверждении (зашифрован) | сутки; адрес — пока код действует |
| `member_presentation_codes` | код карты (слепой индекс) | сутки после конца срока |
| `member_sessions` | сессии участника (до часа) | сутки после конца срока; отозванные тоже |
| `portal_sessions` | сессии кабинета покупателя | сутки после конца срока или отзыва |
| `max_links`, `vk_links` | номер в MAX или ВКонтакте (зашифрован) | пока привязан; при обезличивании и «Не вы?» стирается |
| `max_link_tokens`, `max_link_codes`, `vk_link_tokens` | одноразовые ссылки и коды привязки | до конца срока |
| `vk_events` | события сообщества | сутки |
| `redemption_notices`, `max_link_notices` | уведомления «Не вы?» | 30 дней; оспоренные 13 месяцев |
| `idempotency_keys` | ответ на повтор запроса (маска номера, имя, код карты) | 48 часов |
| `moysklad_counterparties` | покупатель в МоёмСкладе | до обезличивания |
| `moysklad_codes`, `moysklad_quotes` | коды и расчёты касс МоегоСклада | час и полчаса |
| `receipt_batches` | телефон или карта в офлайн-пачке | до обработки пачки |
| `receipts`, `receipt_lines`, `receipt_returns`, `receipt_campaigns`, `moysklad_sales`, `moysklad_returns`, `tilda_orders` | покупки участника, имя кассира | учёт мерчанта, пока действует договор |
| `ledger_accounts`, `ledger_entries`, `ledger_holds`, `ledger_transactions`, `ledger_member_successors`, `point_lots`, `lot_movements` | баллы участника | учёт мерчанта, пока действует договор |
| `bonus_awards`, `activity_rewards`, `member_activity_days`, `member_tiers`, `campaign_member_uses`, `promo_codes`, `promo_code_redemptions`, `support_adjustments` | бонусы, награды, уровни, личные промокоды, ручные начисления | учёт мерчанта; заметки и причины стирает обезличивание |
| `outbox_events` | события интеграций (идентификаторы и суммы) | 30 дней после отправки; брошенные отправкой — 90 дней; ждущие — до отправки |
| `webhook_deliveries`, `webhook_attempts` | доставки вебхуков и ответы получателей | 30 дней после завершения |

Сотрудники мерчантов, партнёров и платформы:

| Таблица | Что о человеке | Сколько хранится |
|---|---|---|
| `users` | почта (зашифрована), имя | пока есть учётная запись |
| `tenant_memberships`, `partner_memberships`, `platform_staff` | членство в командах | пока состоит |
| `staff_sessions`, `sessions` | сессии кабинетов, адрес и браузер | 90 дней после конца; веб-сессии — до конца срока |
| `user_security_events` | входы и изменения учётной записи, адрес и браузер | 12 месяцев |
| `staff_invitations`, `tenant_invitations` | приглашения (почта зашифрована) | 30 дней после принятия, отзыва или конца срока |
| `audit_entries` | действия, адрес и браузер, причины | 3 года |
| `support_access_grants` | доступ поддержки к мерчанту и его причина | пока действует договор |
| `report_subscriptions` | рассылки отчётов | пока подписан |
| `till_cashiers`, `till_shifts` | кассиры веб-кассы и их смены | пока действует договор |
| `terminal_devices`, `device_pairing_codes` | касса и кто её привязал | касса — пока действует договор; код — сутки после использования или конца срока |
| `api_keys`, `merchant_keys`, `oauth_clients` | кто выпустил ключ | пока действует договор |
| `moysklad_connections`, `moysklad_link_codes` | кто связал аккаунт МоегоСклада | пока связан; код — до использования или замены |

Записи мерчанта и служебное:

| Таблица | Что о человеке | Сколько хранится |
|---|---|---|
| `tenants`, `partners`, `legal_entities`, `locations` | название, ИНН и адреса предпринимателя | пока действует договор |
| `communication_channels` | логины в сервисах рассылок (зашифрованы) | пока подключены |
| `failed_jobs` | упавшие задачи (письма людям зашифрованы) | 30 дней (`queue.failed.keep_days`) |
| `jobs` | задачи очереди (письма зашифрованы) | пока задачу не выполнят |
| `cache` | значения кеша | до конца их срока; в продакшене кеш в Redis |

## Решения владельца и юриста

- **Предложенные сроки.** Проверить у юриста:
  - доказательства согласий — 3 года после обезличивания;
  - журнал аудита — 3 года;
  - журнал безопасности — 12 месяцев;
  - коды и журнал сообщений — 13 месяцев;
  - вебхуки и упавшие задачи — 30 дней.

  Каждый срок меняется настройкой. Сократить срок ниже нижней границы базы можно только новой миграцией.
- **Данные закрытого мерчанта.** Сделано (11.5-3): через 30 дней после закрытия его покупателей обезличивают. Срок
  меняется настройкой, проверить у юриста. Выгрузка базы владельцем — сделано (11.5-4). Удалять ли потом весь учёт
  мерчанта и когда (по договору или после срока его учёта), решает владелец.
- **Выгрузка базы.** Право только у владельцев мерчанта, файл CSV без истории покупок и операций (она — в выгрузке
  данных отдельного участника и в отчётах). Если нужна полная история всей базы для переезда, это отдельная
  выгрузка. Мерчант партнёра без своего владельца выгружает базу только после приглашения владельца.
- **Учётные записи ушедших сотрудников.** Обезличивание сотрудника уже есть (ADR-0013), но запускают его вручную.
  Вопрос — обезличивать ли учётную запись автоматически через N дней после отключения.
- **Неактивные покупатели.** Правило программы «обезличивать участников без покупок N лет».
- **Срок учёта мерчанта** (чеки, баллы, по 402-ФЗ — 5 лет): выбирает мерчант.

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

- Документы этапа 11.5 описывают сроки этой таблицы. Новая таблица с персональными данными попадает в неё, иначе
  не пройдёт тест.
- Восстановить удалённое нельзя. Резервные копии хранят данные по своим срокам — это решается на этапе 11.2.
- История согласий обезличенного покупателя исчезает через 3 года вместе с кодом. Число согласий в отчётах за давние
  периоды может уменьшиться.
- **Развёртывание (11.1).**
  - Права снимает и пути закрепляет миграция от имени владельца базы. Где владелец схемы не владеет базой (управляемый
    PostgreSQL), снятие `TEMPORARY` нужно сделать при подготовке базы. Закреплённые пути защищают функции и без этого.
  - Временный каталог подов кабинетов — в памяти (tmpfs): выгрузка базы и файл данных участника пишут туда персональные
    данные, а при аварийной остановке пода файл остался бы на диске.
  - Миграция связывает коды с согласиями, данными до неё. Код согласия, которое дал под старой версии во время
    выкладки, останется несвязанным и уйдёт через 13 месяцев. Первая выкладка в продакшен будет без старых подов.
