Не подставляйте имя из текущего профиля прямо в момент скачивания. Сначала зафиксируйте факт выдачи: кому, за что, когда и по какой версии шаблона выдан сертификат. Тогда исправление профиля не перепишет прошлый документ, а повторная загрузка не возьмёт данные другого пользователя из общего кеша.

Визуальный PDF-сертификат и юридически значимая электронная подпись — разные задачи. Если документ должен иметь регулируемую подпись, долговременную валидацию или архивный профиль PDF/A, требования определяются отдельно; картинка подписи и QR-код сами по себе этого не обеспечивают.

Snapshot делает выдачу воспроизводимой

ПолеПримерПравило
certificate_idслучайный UUIDне порядковый публичный номер
recipient_nameснимок строкине читать заново из профиля
program_titleкурс на дату выдачисохранить редакцию
issued_atUTC + отображаемая зонане время скачивания
template_versioncert-v3для повторного рендера
statusactive/revokedпроверяется отдельно от PDF

Для исправления опечатки создайте новую редакцию или управляемую замену с аудитом. Молча менять уже опубликованный файл опасно: получатель и проверяющая сторона увидят разные версии под одним идентификатором.

HTML-шаблон печатается как страница

@page { size: A4 landscape; margin: 12mm; }
@media print {
  .certificate { break-inside: avoid; }
  .actions { display: none; }
}
.recipient {
  overflow-wrap: anywhere;
  max-width: 240mm;
}

CSS Paged Media определяет размер страницы, поля и разрывы. Puppeteer `Page.pdf()` использует print CSS; параметр `preferCSSPageSize` позволяет отдать приоритет `@page`, а `printBackground` нужен, если фон является частью дизайна. Эти возможности проверяйте на закреплённой версии браузера.

Рендер ждёт шрифты и ресурсы

  1. Собрать HTML только из очищенных snapshot-данных.
  2. Подключить локальные или разрешённые шрифты с устойчивыми URL.
  3. Дождаться `document.fonts.ready` и загрузки обязательных изображений.
  4. Сгенерировать PDF с фиксированными page options.
  5. Посчитать hash файла и сохранить размер, версию движка и время.
  6. Опубликовать файл только после структурной проверки.

Одна общая временная HTML-страница для параллельных jobs может подмешать данные. Используйте изолированный page/context на задачу, не переиспользуйте mutable global state и не сохраняйте в лог полный документ.

Проверочный код не равен database id

Публичный адрес строят на случайном непредсказуемом токене или UUID, а не на последовательном `certificate_id=123`. Страница подтверждения показывает минимальный набор: статус, имя в допустимом виде, программу и дату. Отзыв меняет статус проверки, а исходный файл остаётся в журнале доступа согласно вашей политике.

ЗапросОтветЧто не показывать
валидный active codeдействителен + основные поляemail, внутренний user id
revoked codeотозван + датавнутренняя причина без необходимости
неизвестный codeне найденсуществование других записей
слишком частые запросыконтролируемое ограничениедетали защиты

QR-код ведёт на HTTPS-проверку

В QR помещайте короткий HTTPS URL, а не имя, email или весь JSON сертификата. Перед выпуском убедитесь, что домен находится под вашим управлением и будет жить дольше самого документа. Перенаправления и смена домена должны иметь план миграции.

Регрессия ловит не только битый файл

  • PDF открывается и имеет ожидаемое число страниц.
  • Из него извлекается имя и название программы.
  • Длинное имя, дефис и нелатинские символы не выходят за рамку.
  • Шрифты встроены или воспроизводимо доступны рендеру.
  • QR читается с экрана и печатной копии тестового размера.
  • Повтор одной версии даёт одинаковые данные и объяснимый hash.

Ошибочный выпуск не исправляют поверх файла

Если в сертификат попали чужие данные, остановите скачивание, отзовите публичную проверку, определите затронутые IDs и создайте корректные редакции. Не ограничивайтесь очисткой кеша: источник подмены может находиться в общей job, неверном ключе файла или запросе профиля во время рендера.

Для запуска подготовьте HTML/CSS-шаблон, список шрифтов и лицензий, обезличенный snapshot, версию Chromium/Puppeteer, критерии отзыва и три тестовых имени. Если документ должен иметь юридическую силу, добавьте отдельное заключение специалиста по требованиям подписи и хранения.

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