Проверьте четыре состояния одной выгрузки: запрос принят, выборка сформирована, файл готов, скачивание разрешено. Кнопка «создать отчёт» может сработать, хотя работник ещё не начал задачу или ссылка уже недействительна. Начните с тестового продавца с одной известной продажей, чтобы отличить пустой период от потерянного задания.
Опишите смысл отчёта: продажи по моменту заказа, оплаты или завершения, часовой пояс, возвраты и граница периода. Одинаковые даты в интерфейсе не гарантируют одинаковую выборку. Изменение фильтра во время фоновой работы не должно незаметно изменить уже запрошенный отчёт. Это техническая сверка выгрузки, не определение правил бухгалтерской отчётности.
У задания должен быть проверяемый паспорт
| Поле | Для чего нужно |
|---|---|
| Разрешённая область продавца | Не брать произвольный seller_id из браузера |
| Период и тип времени | Повторить ту же выборку |
| Редакция формата | Объяснить набор колонок |
| Граница данных | Отличить новый отчёт от того же снимка |
| Количество и статус строк | Различить пустой результат и частичную ошибку |
Для долгого экспорта выберите понятную модель согласованности. Это может быть снимок на начало работы или явно указанный период данных с контрольной границей. Без неё заказы, появляющиеся между страницами выборки, могут попасть дважды либо пропасть. Простая сортировка по изменяемой дате не всегда даёт устойчивую пагинацию.
Готовый файл ещё нужно безопасно выдать
OWASP рекомендует проверять разрешения на каждом запросе и распространять авторизацию на статические ресурсы. Источник проверен 21 октября 2026 года. В сценарии отчёта это относится и к созданию задания, и к получению результата. Догадка о непредсказуемом имени файла не заменяет проверку принадлежности.
Условный путь отчёта:
запрос -> подтверждённая область и зафиксированные фильтры
очередь -> устойчивый job_id
работник -> выборка и сверка числа строк
хранилище -> закрытый результат с владельцем и сроком
скачивание -> текущая авторизация или согласованный временный доступ
пустой период -> успешный пустой отчёт, не вечная загрузкаОтдельно определите политику отзыва: если сотрудника исключили из магазина до скачивания, должен ли прежний способ получения всё ещё работать. Прямая временная ссылка может сохранять доступ до истечения срока; это нужно учитывать в выбранной схеме, а не обещать мгновенный отзыв без механизма. Уведомление о готовности содержит минимум сведений и не публикует файл в общий канал.
Повтор и частичный сбой не должны маскировать результат
- Пустая разрешённая выборка имеет конечный понятный статус.
- Сбой записи не выдаёт обрезанный файл как готовый.
- Повтор работника не смешивает части двух отчётов.
- Скачивание чужого job_id отклоняется.
- Просроченный результат предлагает создать новый отчёт по явному запросу.
Сначала записывайте результат в отдельную область задания и только после проверки переключайте статус на ready. Не оставляйте частичный файл под конечным именем. Для больших выгрузок важны контрольные количества и ошибка конкретной стадии; общая надпись «не удалось» заставляет пользователя снова запускать дорогое задание без понимания причины.
На приёмке сравните известные продажи, строки файла и объявленную границу данных, затем отзовите тестовый доступ перед скачиванием. При исправлении старые открытые ссылки разбирают отдельно: новый интерфейс не закрывает уже выданный доступ. Для диагностики передайте паспорт задания, времена стадий и количество строк, не сам файл с клиентскими данными.