🔍 Аудит #отчёт #rtf #pandoc #экспорт #markdown #клиент

Экспорт отчёта в RTF/Markdown

Готовый файл для отправки клиенту. Через pandoc, с группировкой по приоритетам. Появилось в Этапе E.

Зачем

До Этапа E экспорт был только в CSV — формат для Excel, не для отправки клиенту. Этап E добавил полноценный отчёт в RTF (или Markdown) — на 30-50 страниц, с группировкой по приоритетам, готовый для передачи на согласование.

Где скачать

Кнопка «Скачать отчёт» на странице Аудит сайта (выбор формата RTF/Markdown + чекбоксы приоритетов) или прямые URL:

  • GET /export/audit-report.rtf?site_id=N&priority=P0,P1
  • GET /export/audit-report.md?site_id=N (без приоритетов = все)

Что внутри

  1. Резюме — SiteScore, distribution P0/P1/P2/P3, изменение vs прошлого месяца.
  2. Сводная таблица проверенных страниц — топ по числу findings.
  3. Critical (P0) — все findings с issue / evidence / fix-инструкциями.
  4. High (P1) — то же.
  5. Medium / Low (P2/P3) — сводно.
  6. Чеклист по приоритетам — что чинить в первую очередь.
  7. Что не проверялось — например «CWV не настроен PAGESPEED_API_KEY».
  8. Сильные стороны — что сделано правильно (HTTPS, HSTS, JSON-LD и т. п.).

Технология

Пайплайн: Jinja-шаблон (audit_report.md.j2) → Markdown → pandoc 3.1.3 → RTF. RTF открывается в Word, LibreOffice, Google Docs без дополнительных шагов.

Совет по UX

Для клиента обычно достаточно ?priority=P0,P1 — Medium и Low слишком детальны и пугают объёмом. P2/P3 закрываются разработчиком в рабочем режиме без внешнего согласования.

🔎 ESC