Опасная массовая кнопка звучит так: «обновить всё, что сейчас подходит под фильтр». Между просмотром и нажатием могут появиться новые строки, измениться права или сам фильтр. Поэтому подтверждают не формулировку, а конкретный снимок выбранных объектов и конкретное изменение.

Пользователь сначала видит количество, примеры и поля до/после. Сервер сохраняет job с selection hash и выдаёт короткоживущий token подтверждения. Повторный запрос с тем же idempotency key возвращает ту же job, а не запускает вторую.

Preview — часть контракта, а не декорация

В previewЗачемЧто не показывать
Число разрешённых записейОценка масштабаЧужие строки до авторизации
Несколько примеровПроверка смысла фильтраСекретные поля
Точное изменениеИсключить двусмысленностьПроизвольный SQL
Selection hash/versionСвязать apply с previewВнутренний подписывающий ключ
Ожидаемые конфликтыВыбрать политикуИгнорирование ошибок
Возможность восстановленияПонять цену действияОбещание полного rollback без копии

Выборку замораживают до выполнения

POST /bulk-jobs/preview
{
  "filter": {"status": "draft", "team_id": 42},
  "change": {"status": "archived"}
}

201 Created
{
  "job_id": "job_01J...",
  "selected": 842,
  "selection_hash": "sha256:..."
}

Формат условный. Snapshot может быть таблицей id, экспортом ключей или условием с зафиксированной ревизией — выбор зависит от базы и объёма. Критерий один: apply не должен молча захватывать записи, которых пользователь не видел в preview.

Авторизацию повторяют для каждого объекта

Право открыть экран массового редактирования не означает право менять любую строку. OWASP рекомендует deny by default и проверку прав на каждом запросе. Сервер ограничивает выборку tenant, ролью и разрешённым действием, а перед применением повторно проверяет актуальные права; id из клиента не являются доверенными.

  • Allowlist изменяемых полей и допустимых переходов хранится на сервере.
  • Tenant или организация берутся из проверенного контекста, а не hidden field.
  • CSRF-защита применяется к browser session так же, как к одиночному edit.
  • Экспорт preview не раскрывает записи, которые пользователь не может читать.
  • Снятие прав во время очереди останавливает или отклоняет оставшиеся записи.

Одна огромная транзакция подходит не всегда

СтратегияПлюсЦена
Одна транзакцияall-or-nothingдолгие locks и большой rollback
Чанкиконтроль нагрузки и прогрессчастичный результат
Очередь по записиточные retriesбольше событий и координации
Новый version + switchатомарное чтениесложнее модель данных

PostgreSQL описывает транзакцию как all-or-nothing для входящих в неё шагов. Это не делает автоматически атомарной job из нескольких транзакций и внешних API. Для большой операции чаще используют ограниченные чанки, явно показывают partial status и проектируют компенсирующее действие.

Версия строки защищает от тихой перезаписи

UPDATE records
SET status = 'archived', version = version + 1
WHERE id = :id
  AND version = :version_seen_in_preview;

-- affected_rows = 0 означает конфликт, а не успех

Optimistic check не универсален, но ясно фиксирует конкурентное изменение. Политику задают заранее: пропустить конфликт и перечислить его, остановить job или отправить на повторное подтверждение. Без этого bulk edit может затереть ручную правку, сделанную минутой раньше.

Журнал позволяет исправить результат

  1. Записать actor, job id, selection hash, change и время подтверждения.
  2. Для каждой записи сохранить outcome: changed, unchanged, denied, conflict или failed.
  3. Не копировать в аудит секретные и лишние поля целиком.
  4. После выполнения показать counts и скачать список исключений.
  5. Для обратимого поля подготовить отдельную compensating job из сохранённых old values.
  6. Протестировать повтор apply с тем же idempotency key.

Bulk edit готов, если оператор до запуска понимает масштаб, повтор не удваивает действие, конкурентная правка не исчезает молча, а итог можно расследовать по job id. Для проектирования нужны пример фильтра, модель прав, максимальный объём и ответ на вопрос, какие поля действительно обратимы.

Проверенные источники