# ADR-0015. Консоль платформы: статусы мерчантов и партнёров, доступ поддержки, состояние системы

- Статус: принято; реализовано на этапе 6 — ✅ 6d-1 (партнёры, мерчанты и их статусы), ✅ 6d-2 (ключи в консоли),
  ✅ 6d-3 (доступ поддержки), ✅ 6d-4 (состояние системы), ✅ 6d-5 (журнал платформы), ✅ 6d-6 (учётные записи)
- Дата: 2026-10-03

## Контекст

Операторам платформы нужна консоль: заводить партнёров и мерчантов, приостанавливать и закрывать их, видеть ключи
доступа и отзывать их, помогать мерчанту в его кабинете, следить за состоянием системы. Статусы мерчантов (`active`,
`suspended`, `closed`) и партнёров (`active`, `suspended`) были в базе с этапа 0, но значили мало: ключ кассы
закрытого мерчанта работал, приостановленный мерчант менял данные через Management API. Владелец продукта выбрал
(вопрос 4 плана этапа 6): приостановленный мерчант только читает, а его кассы и виджеты работают; закрытый получает
отказ везде; консоль не выпускает ключи; «вход от имени» — доступ поддержки под своим именем.

## Решение

### Статусы

- **Мерчант `suspended`** (приостановлен платформой, например за неоплату).
  - Кабинет мерчанта — только чтение (ADR-0013), кроме действий, которые только защищают мерчанта, пока его кассы
    работают: отзыв ключей, отключение промокода или партии промокодов, блокировка потерянной карты (решение владельца
    продукта от 2026-10-11, 6h-2b), приостановка действия, за которое начисляются баллы (6m, ADR-0017), отзыв
    приглашения в команду (6i-2b), пауза рекламы и служебных сообщений (7d-2, ADR-0020). Их права — `keys.revoke`,
    `promo_codes.disable`, `members.block_cards`, `activities.pause`, `messages.pause`, `invitations.revoke`,
    `invitations.revoke_owners` — не
    считаются записью (`MerchantPermission::isWrite()`), поэтому остаются у команды приостановленного мерчанта и у
    сотрудников его партнёра (кроме командных: приглашения — дело своей команды мерчанта); доступ поддержки к
    приостановленному мерчанту только читает (см. «Что можно по выдаче»). У приостановленного партнёра так же остаются
    отзыв приглашений в его команду и, с 6i-3, отзыв его ключей доступа (`credentials.revoke`,
    `PartnerPermission::isWrite()`).
  - В Management API любое изменение получает 403 `merchant_suspended`, кроме отзыва ключа кассы, отключения
    промокода или партии и приостановки действия (`RequireMerchant::WRITES_WHILE_SUSPENDED`): они только защищают
    мерчанта. С 6j-1 там же открытие и закрытие сеансов виджетов участника (ADR-0018): виджеты, как и кассы, работают.
    Отказ пишется в
    журнал мерчанта, кто бы ни спрашивал — и партнёр, и ключ мерчанта.
  - Runtime API работает: кассы начисляют и списывают баллы, участники регистрируются.
- **Мерчант `closed`** (договор расторгнут).
  - Кабинет отвечает 404, как будто мерчанта нет.
  - В Management API партнёр и ключ мерчанта получают 403 `merchant_not_accessible`; такой отказ остаётся в журнале
    вызывающего, как отказ в чужом мерчанте.
  - Ключи мерчанта и касс перестают проходить проверку (401).
  - Данные сохраняются, и мерчанта можно открыть снова.
- **Переходы.** Каждый — одно условное обновление из своего статуса, поэтому два оператора не перешагнут через
  изменение друг друга:
  - приостановить можно только работающего;
  - снять приостановку — только с приостановленного;
  - открыть снова — только закрытого;
  - закрыть — любого незакрытого.

  Повтор того же перехода возвращает мерчанта как есть, а переход из чужого статуса получает отказ (`InvalidMerchant`).
  Так снятие приостановки никогда не откроет мерчанта, которого другой оператор только что закрыл.
- **Открытый мерчант** — `active` или `suspended`. Доступ проверяется по этому списку (`MerchantData::isOpen()`), а не
  как «не закрыт», поэтому статус, который добавят позже, сначала будет отказом везде.
- **Ключ кассы работает, пока его касса включена.** Отключение кассы или закрытие точки останавливает её ключи;
  включение кассы возвращает их. Открытые чеки отключённой кассы она уже не подтвердит и не отменит: их резерв
  истечёт сам.
- **Партнёр `suspended`.**
  - Новые токены ему не выдаются сразу, а выданные перестают приниматься в течение минуты (кэш проверки).
  - Его сотрудники сразу теряют доступ к его мерчантам (ADR-0013).
  - Сами мерчанты партнёра продолжают работать: их команды, ключи и кассы.
  - Кабинет партнёра (6i) только читается, кроме того, что только защищает: отзыва приглашений в команду (6i-2b).
- **Где проверяется.**
  - `api_key_candidates` (SECURITY DEFINER) находит ключ кассы вместе со статусами мерчанта и кассы. Ответ кэшируется
    на `ApiKeyService::CACHE_SECONDS`, поэтому смена статуса доходит до проверки ключей касс в течение минуты.
  - Management API читает статус мерчанта на каждом запросе (`RequireMerchant`): закрытие и приостановка действуют
    сразу, даже пока ключ мерчанта ещё в кэше проверки.
  - Кабинеты решают доступ на каждом запросе (`StaffAccess`).

### Партнёры и мерчанты в консоли (6d-1)

- **Кто видит и кто меняет.** Видят все операторы (`directory.view`). Меняют администраторы (`partners.manage`,
  `merchants.manage`) со вторым фактором, подтверждённым за последние 10 минут, как любое изменение из консоли.
- **«Партнёры».** Список новых сверху, по 50 на страницу, поиск по части названия или по id. Партнёра можно добавить,
  переименовать, приостановить (с причиной) и возобновить; ссылка «Мерчанты партнёра» открывает его мерчантов.
  «Пригласить владельца» (6i-4b, `partners.manage`, второй фактор) — письмо владельцу работающего партнёра
  (`Invitations::invitePartnerOwner`): приглашение платформы одно за раз — новое отменяет ждущее, а также ждущее
  приглашение того же адреса в команду партнёра, даже владельца; окно говорит, какое приглашение ждёт. «Отозвать
  приглашение владельца» (`partners.manage`, и у приостановленного партнёра: это только защищает) отзывает ждущее
  приглашение платформы. Приглашение принимается в кабинете партнёра как добавление владельца платформой
  (`PartnerMemberships::addOwnerByPlatform` от имени пригласившего, пока у него есть `partners.manage`; человек из
  команды партнёра становится владельцем в своём членстве, закрытое членство не открывается, сотрудник платформы
  владельцем не станет). Владельцам партнёра с работающей учётной записью уходит письмо с замаскированным адресом
  (`TeamNotices::partnerOwnerInvited`), уведомление называет, скольким. Журнал — `partners.invite-owner` и
  `partners.owner-invitation-revoke` с партнёром и приглашением, без адреса, копией в журнале партнёра. Командная
  строка — `staff:grant --partner`.
- **«Мерчанты».**
  - Поиск по части названия, по id или по идентификатору у партнёра. Фильтры: партнёр (или свои мерчанты платформы) и
    статус.
  - Фильтры приходят и в адресе страницы (ссылка от партнёра). Метка фильтра называет партнёра, даже если его нет среди
    50 последних в списке выбора.
  - Мерчанта можно добавить — своего или для партнёра, с идентификатором у партнёра.
  - Можно изменить название, страну и часовой пояс. Пояс только подставляется в форму новой точки в кабинете мерчанта;
    у программ и точек — свой.
  - Можно приостановить, снять приостановку, закрыть и открыть снова; приостановка, закрытие и повторное открытие — с
    причиной.
  - «Подробнее» показывает, сколько у мерчанта точек и касс и сколько из них работают, сколько участников в его
    программах (`Members::count`, без обезличенных) и сколько чеков пробито за 30 дней (`ReceiptStats::count`, каждая
    программа считает дни в своём поясе; 6g-4). Эти числа читаются в контексте мерчанта (`TenantContext::run`) вне
    транзакции.
- **Ввод из браузера.**
  - Фильтры, пришедшие в запросе Livewire или в адресе, очищаются до строк (`Kit\Tables\FilterState`), поиск остаётся
    строкой: Filament упал бы, отрисовывая список. Так же защищены таблицы кабинета мерчанта с фильтрами («Кассы»,
    журнал аудита).
  - Символ NUL в поиске отбрасывается.
  - Названия и идентификаторы у партнёра с управляющими символами домен не принимает.
- **Контракты.**
  - `Partners`: `search`, `findMany`, `rename`, `suspend`, `activate`.
  - `Merchants`: `search(MerchantQuery)`, `createDirect`, `update(MerchantChanges)`, `suspend`, `activate`, `close`,
    `reopen`, `countOfPartners`.
  - Индексы `(created_at, id)`. Поиск по части названия читает список в этом порядке: справочник небольшой, а
    триграммный индекс потребовал бы расширения PostgreSQL.
- **Курсоры.** Курсор страницы проверяется (`Cursor::timeAndId`): время ровно в том виде, в каком его пишет платформа
  (UTC, год, который принимает PostgreSQL), и UUID. Чужой курсор — 400 `invalid_cursor`, а не ошибка базы.

### Журнал

- **Названия действий:**
  - `partners.store`, `partners.update`, `partners.suspend`, `partners.activate`;
  - `merchants.store` (как маршрут Management API);
  - `merchants.update`, `merchants.suspend`, `merchants.activate` (снятие приостановки), `merchants.close`,
    `merchants.reopen`.
- **Что пишется.** Запись ложится в журнал платформы с выбранными значениями и причиной: партнёр нового мерчанта,
  часовой пояс и страна, причина приостановки, закрытия и повторного открытия. Названий в журнале нет: мерчант или
  партнёр, названный по имени владельца (ИП), называет человека, а журнал нельзя чистить (ADR-0010).
- **Копии.** Изменение партнёра копируется в журнал партнёра, изменение мерчанта — в журнал мерчанта, новый мерчант
  партнёра — в журнал партнёра. Копии идут без введённого, без адреса и браузера оператора (ADR-0010).
- **Оператор в чужих журналах.** Журналы мерчантов и партнёров — в кабинете и в `GET /audit-entries` — называют
  оператора платформы только так: без id учётной записи, адреса и браузера. Всё это остаётся в журнале платформы.
- **Без лимита частоты.** Копии из консоли не ограничены числом в час, в отличие от копий кабинета мерчанта
  (`GuardedAction::perHour`). Операторы — доверенные сотрудники (второй фактор с 2026-10-22 — по желанию, ADR-0013), а
  массовая работа (приостановить
  неплательщиков в конце месяца) не должна упираться в лимит.

### Ключи в консоли (6d-2)

- **Консоль видит и отзывает, но не выпускает.** Учётные данные выдаёт тот, кто ими пользуется: партнёр — в своём
  кабинете («Ключи доступа», с 6i-3; до него и сейчас вне кабинета — команда платформы командой `oauth-clients:issue`),
  мерчант — в своём. Архитектурный тест не даёт консоли собрать команду
  выпуска.
- **«Ключи доступа партнёра»** (из «Партнёров») — OAuth-клиенты партнёра: название, публичный `client_id`, права,
  время выпуска и последнего токена, состояние. Секретов нет. Отозвать может администратор (`partners.manage`) со
  вторым фактором:
  - клиент больше не получает токены;
  - выданные токены удаляются, а метка отзыва в кэше проверки отказывает им со следующего запроса — и тому, что успел
    закэшировать запрос, читавший клиента до отзыва;
  - клиент ищется по партнёру страницы (`ManagementCredentials::revokeClientOf`): чужого клиента так не отозвать.
- **Что остаётся после отзыва клиента.** Ключи касс и вебхуки, которые партнёр создал через клиента, продолжают
  работать: отзыв может быть плановой сменой ключа, и обрывать кассы партнёра нельзя. Поэтому:
  - ключ кассы, выпущенный через Management API, помнит, чем выпущен: ключом мерчанта или клиентом партнёра (его
    публичным `client_id`, неизменяемым);
  - «Ключи мерчанта» показывают, кто или что выпустило каждый ключ;
  - окно отзыва и письмо владельцам партнёра говорят, что созданное через клиент остаётся.

  Происхождения вебхуков пока нет: их проверяют в кабинете мерчанта.
- **«Ключи мерчанта»** (из «Мерчантов») — ключи мерчанта и ключи его касс в одной таблице: вид, название, начало ключа,
  касса, права, кто выпустил, срок, последнее использование ключа кассы, состояние. Ключ кассы отключённой кассы
  помечен «Касса отключена»: проверка его не принимает, но касса может заработать снова. Читаются и отзываются в
  контексте мерчанта. Отзывает администратор (`merchants.manage`) со вторым фактором, только работающий ключ (и ключ
  отключённой кассы): истёкший отзывать незачем.
- **Журнал.** Отзыв клиента — `oauth-clients.revoke`, ключа мерчанта и кассы — `merchant-keys.revoke` и
  `api-keys.revoke`, как в кабинете мерчанта. В объекте записи — партнёр или мерчант и ключ; клиент назван своим
  публичным `client_id`, как в записях самого API. Копия идёт в журнал владельца.
- **Письмо владельцам** (`TeamNotices`) уходит, только если отзыв что-то остановил. Получатели — владельцы партнёра или
  мерчанта, чьё членство и учётная запись работают. У мерчанта партнёра без своих владельцев письмо получают владельцы
  партнёра: мерчантом управляет он.
  - В письме — что отозвано, что делать дальше и что неожиданный отзыв — повод спросить поддержку.
  - Название ключа и организации — чужой текст, в письме он только текст.
  - Письмо, которое не удалось поставить в очередь, попадает в отчёт об ошибках и не мешает ни отзыву, ни записи в
    журнале.
  - Уведомление в консоли говорит, скольким владельцам ушло письмо, или что сообщить некому.

### Доступ поддержки (6d-3)

- **Не «вход от имени».** Оператор платформы работает в кабинете мерчанта под своим именем, по выдаче
  (`SupportAccess`, таблица `support_access_grants`):
  - с причиной (до 500 символов); телефоны, адреса почты и номера карт в ней маскируются при сохранении;
  - на 30 минут по умолчанию, не больше 120;
  - только чтение по умолчанию; изменения — только у тех, у кого `support_access.full` (администраторы).

  Выдача — данные платформы, а не мерчанта: они читаются до выбора мерчанта и называют его `merchant_id`. Что
  выдано, не меняется; выдача только заканчивается — по времени или раньше, и завершённая остаётся завершённой
  (триггер). Удалять выдачи рабочим ролям базы нельзя: история остаётся. Открытая выдача оператора для мерчанта одна:
  новая заменяет действующую и называет её (`replaced_grant_id`), а истёкшую закрывает моментом её истечения.
- **Когда выдача заканчивается сама.** Вместе с тем, на чём она держалась, в той же транзакции: роль оператора
  отозвана или сменилась, учётная запись отключена или обезличена, второй фактор сброшен, мерчант закрыт (событие
  `MerchantClosed` модуля мерчантов). Вернуть роль, учётную запись или мерчанта — не значит вернуть выдачу.
  `ended_by` — тот, кто завершил выдачу сам; у истёкших и закончившихся вместе с чем-то он пуст.
- **Что можно по выдаче.** `StaffAccess::merchant` проверяет выдачу последним шагом, на каждом запросе, вместе с
  ролью оператора:
  - только права из явного списка режима (`SupportMode::permissions`); тест разбирает каждое право мерчанта, так что
    новое право не попадёт к поддержке, пока его туда не впишут;
  - никогда — чувствительные права (`MerchantPermission::isSensitive`): ключи и их отзыв, вебхуки, касса, публикация
    правил и согласий, публикация и запуск акций (6h-2), команда, раскрытие контактов, выгрузка кодов, обезличивание
    и объединение участников;
  - при выдаче «только чтение», у приостановленного мерчанта или у оператора без `support_access.full` — только то,
    что ничего не меняет;
  - ни одного права, если оператор потерял доступ к консоли или учётная запись отключена;
  - роль доступа — `support`: с её лимитами ручных корректировок (`cabinet.adjustment_limits`, ADR-0014).

  Если команда мерчанта отключила эту учётную запись (человек работал у мерчанта, а потом стал оператором), выдачи для
  этого мерчанта нет: запрет команды сильнее.

  Решение: полная выдача включает `organization.manage` целиком — с закрытием точки и включением отключённой кассы
  (которое возвращает её ключи в работу). Это та настройка, ради которой полный доступ и нужен; поэтому он только у
  администраторов, с причиной, на время, со вторым фактором и в журнале платформы.
- **В каком браузере.** Выдача действует в сеансе, из которого её открыли (если консоль и кабинеты на одном хосте —
  локально), и в сеансе, где оператор подтвердил себя после её начала (кодом второго фактора, а без него — паролем,
  поправка ADR-0013 от 2026-10-22). Сеанс кабинетов, начатый раньше, — например,
  оставленный на общем компьютере, — выдачу не получает: кабинет завершает его и отправляет на вход
  (`ApplyMerchantContext`, `SupportAccess::worksIn`). С консолью на своём хосте оператор входит в кабинеты заново после
  каждой выдачи.
- **Консоль.**
  - «Открыть кабинет как поддержка» в «Мерчантах» (не у закрытого мерчанта): режим, минуты, причина, подтверждение
    (код или, без второго фактора, пароль).
    Затем консоль ведёт в кабинет мерчанта на хосте кабинетов (`APP_URL`), где оператор входит той же учётной записью:
    у консоли свой хост и своя cookie. Уведомления нет: консольное ждало бы в её сеансе следующей страницы консоли, а
    время окончания показывает плашка.
  - «Доступ поддержки» — все действующие выдачи. Свою выдачу оператор завершает сам; чужую — только с
    `support_access.full` (отдельное действие, поэтому отказ попадает в журнал).
- **Кабинет мерчанта.**
  - Шлюз панелей пускает оператора, пока у него есть действующая выдача, и показывает её мерчанта в переключателе.
  - Над каждой страницей — плашка: режим и время окончания с поясом, кнопка «Завершить доступ». «Обзор» называет режим
    доступа поддержки, а не приостановку мерчанта.
  - «Завершить доступ» — форма кабинетов (CSRF), но не страница мерчанта: выдача, которая уже закончилась (истекла,
    завершена в консоли), тоже ведёт дальше, а не к отказу. Поэтому проверки входа она делает сама: сеанс сотрудника
    проверяет маршрут, всем, кроме операторов платформы, — 404.
  - Дальше — страница «Доступ поддержки завершён» со ссылкой в консоль: CSP кабинетов (`form-action 'self'`) не пускает
    ответ формы на другой хост. Её видит только браузер, который завершил доступ: остальным хост кабинетов адрес
    консоли не называет.
- **Журнал.**
  - `support-access.start` пишется в журнал платформы с режимом, минутами и причиной, копия — в журнал мерчанта, без
    введённого. Если новая выдача заменила действующую, перед ним так же пишется `support-access.end` прежней.
  - `support-access.end` из консоли пишется так же.
  - Всё, что оператор делает в кабинете мерчанта, включая «Завершить доступ», идёт в журнал мерчанта под видом
    «Сотрудник платформы», без имени, адреса и браузера, и копией в журнал платформы: с мерчантом в предмете, с
    адресом и браузером оператора, без введённого — так платформа знает, кто из операторов что сделал.

### Состояние системы (6d-4)

- **Проверки.** Каждый модуль регистрирует свои проверки (`Modules\Kernel\Health\HealthCheck`,
  `HealthChecks::register` в своём провайдере).
  - У проверки — ключ `<модуль>.<что>`, статус (в порядке, внимание, сбой), код находки и факты: числа, минуты,
    имена задач и очередей, никаких персональных данных.
  - Тексты на русском — в консоли (`cabinet::health.checks.<ключ>.<код>`); тест требует текст для каждого кода
    каждой проверки и только известные факты в них.
  - Проверка, которую не удалось создать, которая упала сама или ответила необъявленным кодом, показывается как сбой
    «Проверка не выполнилась»; её исключение уходит в журнал приложения, остальные проверки идут дальше.
  - Подсчёты ограничены: больше 10 000 строк проверка не считает и пишет «10000+».
- **Снимок, а не запрос.** Проверки выполняет только `platform:health` — фоновый процесс раз в минуту (без
  наложения, блокировка — пять минут). Он сохраняет результаты (`health_reports`), а консоль читает их ролью
  приложения. Так данные всех мерчантов читает системная роль только в фоне (ADR-0002), и цена страницы не зависит от
  того, сколько людей на неё смотрит. Результаты старше трёх минут — сбой «Проверки не пересчитывались»: что бы в них ни
  было, их больше никто не проверяет; так же видно, что `platform:health` ни разу не запускался.
- **Что проверяется.**
  - планировщик: `platform:heartbeat` отмечается каждую минуту; три минуты без отметки или ни одной — сбой;
  - очереди: тот же пульс отправляет в каждую очередь из `queue.heartbeat_queues` (`default`, `offline`) задание с
    временем отправки, а обработчик, выполнив его, отмечает очередь этим временем: видно, на сколько очередь отстаёт.
    Три минуты — внимание, десять или ни одной отметки — сбой. В очередь, которую никто не обслуживает, такие задания
    копятся по одному в минуту;
  - сбойные задания за сутки — внимание;
  - задачи по расписанию, последний запуск которых завершился ошибкой, — внимание;
  - пропущенные запуски: задача уже запускалась, но с тех пор пропустила своё время больше чем на десять минут
    (зависла или её держит блокировка упавшего запуска) — внимание; задача, которая не запускалась ни разу, не
    оценивается — она может быть новой;
  - исходящие события, которые ждут передачи: минута — внимание, пять — сбой; события, которые ретранслятор
    бросил за неделю, — внимание;
  - вебхуки: доставки, которые ждут отправки дольше пяти минут, — сбой (отправка не успевает или остановилась); не
    доставленные за сутки работающим вебхукам — внимание (отключённый мерчантом вебхук — его дело);
  - сверка баллов (`ledger:reconcile`): последний запуск нашёл расхождения или упал — сбой; успешной сверки не было
    26 часов и больше или ни разу — внимание;
  - резервы чеков, истёкшие больше пяти минут назад и всё ещё держащие баллы, — сбой.
- **Запуски по расписанию.** Ядро записывает последний запуск каждой задачи по событиям планировщика
  (`scheduled_runs`): начало, конец, код выхода, длительность, время последнего успеха.
  - Задача называется своей командой artisan, никогда — командной строкой.
  - Запуск без кода выхода не записывается как завершённый: его держал другой запуск (`withoutOverlapping`) или он
    идёт в фоне (`runInBackground`), и его конец придёт отдельным событием.
  - Сбой записи только попадает в журнал приложения: расписание идёт дальше.
  - Запуски задач, которых больше нет в расписании, `platform:health` забывает.
- **Консоль.** «Состояние системы» видят все операторы (`system.view`): общий итог, свежесть расчёта, проверки и
  последние запуски задач.
  - Открытая страница обновляется сама каждые 30 секунд — по одному запросу, не дольше 20 секунд — через отдельный
    маршрут: вход, право видеть состояние, частота (30 в минуту) и пассивная проверка сеанса
    (`identity.session:console,passive`). Обновления — не активность, так что консоль, оставленная открытой, всё равно
    закрывает сеанс по простою. Опрос Livewire (`wire:poll`) для этого не подходит: он продлевал бы сеанс.
  - Отказ (сеанс закончился, доступа нет, переадресация на вход) останавливает обновления; сбой сервера или сети
    только показывает заметку, и следующее обновление пробует снова.
- **Остаточный риск.** Таблицы состояния (`scheduled_runs`, `platform_heartbeats`, `health_reports`) рабочие роли
  могут менять, как и остальные данные платформы: SQL-инъекция в приложении могла бы подделать успешную сверку. Это
  тот же риск, что принят в ADR-0002; отнять запись у роли приложения можно, когда все писатели будут работать от
  системной роли.

### Журнал платформы (6d-5)

- **Что в нём.** Записи без мерчанта и без партнёра (`AuditLog::ofPlatform`):
  - всё, что сделано в консоли;
  - копии действий операторов в кабинетах мерчантов по доступу поддержки.

  Копии для мерчантов и партнёров остаются в их журналах.
- **Как читается.** Системной ролью, как журнал партнёра: роль приложения такие записи только добавляет. В отличие от
  журналов мерчанта и партнёра, журнал платформы называет операторов — с адресом и браузером: за них отвечает
  платформа. Введённое мерчантом в его кабинете остаётся в журнале мерчанта.
- **Консоль.** «Журнал платформы» видят все операторы (`audit.view`). Записи — новые сверху, по пятьдесят, с
  фильтрами по периоду, действию, месту и оператору (операторы сегодняшние; записи бывших находятся по периоду и
  действию), подробности — с запросом, адресом и браузером. Страница общая с журналом мерчанта
  (`Kit\Pages\AuditLogPage`): страница говорит только, чей журнал она читает, кого предлагает фильтр и кого называет.
- **Индексы.** У записей платформы свои частичные индексы — по времени, по действию и по оператору (без мерчанта и
  без партнёра): индексы журнала партнёра порядок им не дают, `partner_id is null` для планировщика не равенство.
  Строятся без блокировки записи.
- **Выгрузка.** `audit:export --platform` — записи платформы, одна JSON-строка на запись.
- **Обезличенные операторы.** Журнал неизменяем (ADR-0010): записи об операторе, учётную запись которого позже
  обезличат, остаются с его идентификатором, адресом и браузером на весь срок хранения журнала — как записи о
  сотрудниках мерчантов в их журналах. Имя обезличенного оператора журнал уже не покажет.

### Учётные записи (6d-6)

- **Поиск.** «Учётные записи» находят любую учётную запись сотрудника — оператора, сотрудника мерчанта или партнёра:
  - по e-mail — целиком, через слепой индекс, как при входе;
  - по идентификатору — так её называют журналы.

  Списка всех сотрудников консоль не показывает, только запись, которую нашёл поиск. Искать могут операторы с
  `directory.view` (сегодня все), без кода второго фактора: поиск ничего не меняет. Каждый поиск попадает в журнал
  платформы (`accounts.lookup`):
  - найденная учётная запись — в предмете (`subject`) записи журнала;
  - введённый адрес — никогда;
  - неудачный поиск — 404 `staff_user_not_found`, без предмета; он же убирает с экрана запись, найденную раньше.
- **Что показано.** Имя, маскированный e-mail, состояние (активна, отключена, обезличена), второй фактор, роль в
  консоли, команды (мерчанты и партнёры с действующим членством), последний вход.
- **Действия.** Те же, что у «Сотрудников платформы» (`Platform\Accounts\AccountActions`, общие для обеих страниц):
  отключить, включить, сбросить 2FA, отправить ссылку для смены пароля; и только здесь — обезличить. Условия:
  - нужно право `accounts.manage` и подтверждение не старше 10 минут (код или, без второго фактора, пароль); сбросить
    2FA можно только у записи, у которой она подключена;
  - своя учётная запись — никогда;
  - только запись, которую показывает страница. Она хранится в заблокированном свойстве страницы (`#[Locked]`), и
    меняет её только поиск: никакой запрос не вызовет действие над записью, которую никто не искал (и поиск которой
    не попал в журнал).
- **Обезличивание** (`AccountAdministration::anonymize`, `accounts.anonymize`, ADR-0013) — навсегда. Администратор
  пишет причину (она попадает в журнал платформы) и вводит слово «обезличить», чтобы случайный клик ничего не сделал.
  Блокировки — в общем порядке: учётная запись, затем администраторы. Отказы:
  - последний действующий администратор платформы — `last_owner`;
  - запись, обезличенная раньше, — `invalid_staff_user`.

  У оператора обезличивание снимает роль и завершает выданные ему доступы поддержки. Ждущие приглашения на адрес
  человека — в консоль и во все команды — отзываются, и адрес стирается и в них.
- **Последний владелец команды.** Правило последнего владельца (ADR-0013) — правило изменений команды. Учётную запись
  последнего владельца мерчанта или партнёра администратор платформы отключить и обезличить может: за учётные записи
  отвечает платформа. Тогда команде некому управлять владельцами, и нового владельца назначает платформа:
  `staff:grant <email> --merchant=<id> --role=owner` (или `--partner=<id>`); партнёру — и «Пригласить владельца» в
  консоли, мерчанту партнёра — его партнёр (ADR-0013, 6i-4). Формы отключения и обезличивания
  предупреждают об этом и называют такие команды (`StaffAccess::teamsOwnedAlone`: команды, где человек —
  единственный владелец с работающей учётной записью; у мерчантов их находит функция `staff_sole_owner_tenants`).
- **Журналы команд.** Каждое действие над учётной записью уходит копией в журналы мерчантов и партнёров, в командах
  которых человек состоит (ADR-0010), без причины, адреса и браузера. Команды читаются до изменения: обезличивание
  отключает членство у партнёров.
- **Меню строки.** Filament запоминает, показано ли действие, по ключу записи. Строка таблицы из массива после
  изменения сохраняет ключ, и меню в ответе показывало бы действия её прежнего состояния (нажатие на них следующий
  запрос всё равно отклонил бы). Поэтому `GuardedAction` после успешного изменения забывает видимость всех действий
  таблицы (ADR-0014).

### Сообщения и коды мерчанта (7d-3)

- «Мерчанты» → «Сообщения и коды» и «Состояние системы»: остановка сообщений мерчанта и всех сообщений платформы, свои
  пределы кодов мерчанта — подробно в ADR-0020 («Переключатели консоли»). Видят все операторы, меняют администраторы
  (`merchants.manage`) с причиной; у изменений одного мерчанта — копия в его журнале без неё.

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

- Новая операция Management API, которая меняет данные мерчанта, получает отказ у приостановленного мерчанта сама.
  Тест обходит все такие маршруты. Исключение добавляется только в `RequireMerchant::WRITES_WHILE_SUSPENDED`, с
  причиной.
- Смена статуса мерчанта или кассы доходит до касс в течение минуты, до Management API и кабинетов — сразу.
- Фоновые работы закрытого мерчанта продолжаются: баллы сгорают, уровни пересматриваются, а события об этом уходят
  его вебхукам. Если мерчанта откроют снова, его данные верны. Остановить такие работы можно будет вместе с удалением
  данных закрытых мерчантов, которого пока нет в плане.
- Тесты справочника ищут по слову своего теста: интеграционные тесты оставляют партнёров и мерчантов в тестовой базе
  до следующего запуска.
- Новая фоновая работа модуля приносит свою проверку состояния (`HealthCheck`, `HealthChecks::register`) и её тексты
  в консоли; задача по расписанию попадает в «Задачи по расписанию» сама. Новая очередь, которую обслуживают
  обработчики, добавляется в `queue.heartbeat_queues`, иначе её молчание никто не заметит.
