Опасная массовая кнопка звучит так: «обновить всё, что сейчас подходит под фильтр». Между просмотром и нажатием могут появиться новые строки, измениться права или сам фильтр. Поэтому подтверждают не формулировку, а конкретный снимок выбранных объектов и конкретное изменение.
Пользователь сначала видит количество, примеры и поля до/после. Сервер сохраняет 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 может затереть ручную правку, сделанную минутой раньше.
Журнал позволяет исправить результат
- Записать actor, job id, selection hash, change и время подтверждения.
- Для каждой записи сохранить outcome: changed, unchanged, denied, conflict или failed.
- Не копировать в аудит секретные и лишние поля целиком.
- После выполнения показать counts и скачать список исключений.
- Для обратимого поля подготовить отдельную compensating job из сохранённых old values.
- Протестировать повтор apply с тем же idempotency key.
Bulk edit готов, если оператор до запуска понимает масштаб, повтор не удваивает действие, конкурентная правка не исчезает молча, а итог можно расследовать по job id. Для проектирования нужны пример фильтра, модель прав, максимальный объём и ответ на вопрос, какие поля действительно обратимы.