# ADR-0031. Данные покупателя по его запросу

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

## Контекст

Человек вправе узнать, какие его персональные данные обрабатываются (ст. 14 152-ФЗ). Оператор — мерчант, платформа
обрабатывает данные по его поручению (ADR-0008). Отвечает оператор:

- в течение 10 рабочих дней с запроса, срок можно продлить ещё на 5 (ч. 1 ст. 20);
- в доступной форме и без персональных данных других людей (ч. 3 ст. 14).

В ответе должны быть сами данные и их источник, а также сведения об обработке: цели, правовые основания, сроки,
оператор и лицо, которое обрабатывает данные по его поручению (ч. 7 ст. 14).

До этого этапа мерчант мог собрать ответ только вручную: открыть карточку, покупки, историю баллов и сообщения, а
телефон показать отдельно. Часть данных кабинет не показывает вовсе: обстоятельства согласий, коды подтверждения, лоты
баллов, привязки мессенджеров, связи с МоимСкладом. Management API отдаёт данные участника по частям и без полного
телефона.

## Решение

### Файл данных участника

На карточке участника появилась кнопка «Выгрузить данные». Она отдаёт файл Excel со всем, что программа хранит об
участнике и о записях, объединённых с ним (ADR-0019):

- первый лист «Сведения»: программа, участник, оператор — юридические лица мерчанта с ИНН, — обработчик, момент
  выгрузки, часовой пояс, как читать файл;
- затем по листу на каждый вид данных:
  - профиль с полным телефоном и почтой, карты, объединённые записи (их имена и внешние номера: остальное объединение
    стирает), согласия с обстоятельствами, подтверждение телефона при вступлении;
  - баланс, операции, которые меняли баллы участника (как история баллов в карточке), начисленные баллы и их сгорание;
  - покупки, товары, акции в покупках, возвраты, МойСклад, уровень, бонусы, баллы за действия, личные промокоды,
    промокоды в покупках, участие в акциях, ручные начисления;
  - сообщения — что, когда, каким путём ушло и дошло ли (тексты после отправки не хранятся), коды подтверждения,
    мессенджеры, предупреждения о карте («Не вы?»), входы в кабинет покупателя;
- листов без данных нет; время — по часовому поясу программы, суммы — в рублях, баллы — в единицах программы.

Цели и правовые основания обработки описаны в документах, которые принял участник. Их версии есть на листе
«Согласия». Сопроводительное письмо со сведениями об обработке готовит оператор, его шаблон — в документах этапа 11.5.

### Источники

Каждый модуль сам описывает, что хранит об участнике: источник `Modules\Kernel\Privacy\MemberDataSource`. Источник
регистрируется в провайдере модуля (`MemberDataSources::register`), так же как проверки состояния. Источник:

- читает таблицы своего модуля по участнику и объединённым с ним записям, в тенанте мерчанта;
- называет листы и столбцы по-русски, текстами своего модуля (`<module>::member_data`);
- называет таблицы, которые читает (`tables()`).

Файл собирает модуль отчётов (`Modules\Reports\Contracts\MemberDataExports`): листы идут в порядке
`MemberDataExportService::ORDER`. Ячейки и листы файлов — общие для всех модулей (`Modules\Kernel\Files`), к ним
добавился момент времени (`Cell::moment`). Файл собирается целиком до отправки: если источник упал, файла нет, а не
файл без части данных.

Архитектурный тест (`tests/Architecture/MemberDataTest.php`) проверяет полноту. Каждая таблица, где есть участник,
читается источником или исключена с причиной. Участник есть в таблице, если у неё столбец `member_id`, если это сама
`members` или если таблица названа в тесте: журнал сообщений (по слепому индексу), строки и акции чеков, возвраты,
пачки касс, заказы Tilda, продажи МоегоСклада, ключи повторов, события и вебхуки, журнал аудита. Исключены:

- живущие минуты или сутки: коды карты, коды и ссылки привязки, сессии, коды и расчёты касс МоегоСклада, адрес на
  подтверждении, ключи повторов запросов, пачки касс до обработки;
- служебные таблицы, содержание которых уже есть в файле в другом виде: резервы баллов, цепочка объединений,
  счётчики лимитов действий, заказы Tilda и продажи МоегоСклада (их чеки в файле есть);
- события и вебхуки для систем самого мерчанта (идентификаторы и суммы, 30 дней);
- журнал аудита: он о действиях сотрудников, называет их, и хранится ради защиты обработки (ADR-0010).

### Данные других людей

В файл не входят:

- кассир покупки, возврата и согласия;
- сотрудник, который начислил баллы вручную или закрепил уровень;
- участник, который пригласил или был приглашён: файл говорит только, был ли пригласивший, и сколько людей пригласил
  участник;
- номер аккаунта MAX или ВКонтакте: аккаунт мог привязать не сам участник, для этого есть «Не вы?»;
- адрес, с которого запросили код: код может запросить кто угодно;
- коды, которые ушли на номер или почту до того, как они стали участника: у номера мог быть другой владелец. Код
  вступления и смены номера уходит немного раньше, поэтому граница — за час до этого;
- адрес и браузер согласия, данного на кассе, в приложении или через интеграцию: это адрес кассы или сервера. Они
  есть только у согласий из кабинета покупателя, с сайта и со страницы «Отписаться». Отписку в один клик присылает
  сервер почтовой службы, поэтому её адреса тоже нет;
- служебные идентификаторы сессий и ключей.

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

### Доступ

- Право `members.export_data`. Его получают владелец, администратор и поддержка мерчанта — те, кто отвечает на
  обращения покупателей. Сотрудники партнёра работают у его мерчантов в роли администратора или поддержки
  (`PartnerRole::merchantRole`), поэтому получают это право так же, как право видеть полный телефон.
- Право чувствительное: нужен недавний вход со вторым фактором или паролем. Под доступом поддержки платформы его нет.
- Это чтение, поэтому приостановленный мерчант тоже отвечает своим покупателям.
- Не больше 20 файлов в час и 40 в сутки на человека (`GuardedAction::perHour`, `perDay`). Обращения приходят по
  одному, а скрипт сессии за сутки базу не вынесет.
- Каждая выгрузка — запись журнала аудита `members.export-data`. В записи только участник, содержимого файла нет.
- Обезличенного участника выгрузить нельзя: данных уже нет. Объединённого — тоже: его данные в файле основной записи.

Обработчика — компанию, которая ведёт платформу, — называют настройки `privacy.processor.name` и
`privacy.processor.address` (`LOYAL_PROCESSOR_NAME`, `LOYAL_PROCESSOR_ADDRESS`). Если они не заданы, строки в файле нет.

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

- **Выгрузка через Management API** (например, для CRM мерчанта). Пока её нет: API отдаёт данные по частям. Добавить,
  если попросит партнёр.
- **Выгрузка в кабинете покупателя** («Скачать мои данные»). Закон этого не требует, а сессия кабинета живёт год:
  телефон, который попал в чужие руки, отдаст и файл. Пока нет.
- **Реквизиты обработчика** для `privacy.processor.*` указать при развёртывании.
- **Сопроводительное письмо** со сведениями об обработке готовит юрист (этап 11.5, документы). В нём же — адрес
  оператора (у юридического лица в программе хранятся только название и ИНН) и кому данные передаются: провайдеры
  SMS и почты мерчанта, MAX, ВКонтакте, системы мерчанта через вебхуки (ч. 7 ст. 14).
- **Уведомлять ли владельцев** о каждой выгрузке письмом. Сейчас её видно в журнале аудита, а частоту держат лимиты.

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

- Новая таблица, где есть участник, не пройдёт архитектурный тест, пока её не прочтёт источник или не исключат с
  причиной.
- Модуль, который начинает хранить что-то об участнике, добавляет или расширяет свой источник и тексты
  `<module>::member_data`.
- Файл — персональные данные. Сотрудник отправляет его только самому человеку, убедившись, что запрос от него. Кабинет
  напоминает об этом в окне выгрузки.
- Файл собирается в памяти запроса. Временный файл архива удаляется сразу и, если процесс упадёт, при его завершении.
  У участника с десятками тысяч покупок файл большой. Если такое встретится, сборку стоит перенести в очередь с
  одноразовой ссылкой.
- Источники читают данные отдельными запросами. Покупка, сделанная во время выгрузки, может попасть в один лист и не
  попасть в другой.
