Отчёты и файлы результатов должны скачиваться через gateway и files/report-контур, а не через прямые пути на сервере.
Какие файлы можно скачивать
- результаты email-проверок;
- SEO-отчёты;
- XLSX-выгрузки;
- PDF-отчёты;
- JSON-структуры отчётов;
- архивы логов для администратора.
[ТУТ СКРИНШОТ: кнопка скачивания отчёта на странице результата]
Порядок действий
- Откройте карточку проверки или отчёт.
- Нажмите кнопку скачивания.
- Выберите формат, если доступно несколько вариантов.
- Дождитесь генерации файла.
- Скачайте файл по ссылке.
Если скачивание не работает
- ссылка ведёт на frontend route, а не gateway endpoint;
- файл ещё не сгенерирован;
- cdp_files недоступен;
- cdp_report не нашёл reportUuid;
- у пользователя нет доступа к проекту;
- истёк временный download token.
Правильная цепочка:
Frontend -> GET /v1/.../report/download
Gateway -> gRPC cdp_report / cdp_files
Browser <- file stream / signed download responseВажно. Не публикуйте абсолютные пути файлов сервера. Пользователь должен получать только контролируемую ссылку через gateway/files.
Контрольный чек-лист
- Проверьте, что вы находитесь в правильном проекте, а не в соседнем тестовом проекте.
- Проверьте роль пользователя: часть кнопок видна только администратору.
- Откройте DevTools → Network и найдите запрос к
/v1/.... - Скопируйте точный текст ошибки, HTTP-статус и время возникновения.
- Если операция связана с лимитом, откройте страницу лимитов до повторного запуска.
Что приложить к задаче разработчику
Чтобы проблему можно было быстро воспроизвести, приложите URL страницы, projectUuid, время ошибки, скриншот интерфейса, скриншот Network-запроса и архив логов. Для ошибок bootstrap отдельно проверьте, были ли в gateway.log не только GET, но и POST/PUT запросы.
[ТУТ СКРИНШОТ: Network-запрос с route, HTTP-статусом и response body]
