Не подставляйте имя из текущего профиля прямо в момент скачивания. Сначала зафиксируйте факт выдачи: кому, за что, когда и по какой версии шаблона выдан сертификат. Тогда исправление профиля не перепишет прошлый документ, а повторная загрузка не возьмёт данные другого пользователя из общего кеша.
Визуальный PDF-сертификат и юридически значимая электронная подпись — разные задачи. Если документ должен иметь регулируемую подпись, долговременную валидацию или архивный профиль PDF/A, требования определяются отдельно; картинка подписи и QR-код сами по себе этого не обеспечивают.
Snapshot делает выдачу воспроизводимой
| Поле | Пример | Правило |
|---|---|---|
| certificate_id | случайный UUID | не порядковый публичный номер |
| recipient_name | снимок строки | не читать заново из профиля |
| program_title | курс на дату выдачи | сохранить редакцию |
| issued_at | UTC + отображаемая зона | не время скачивания |
| template_version | cert-v3 | для повторного рендера |
| status | active/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` нужен, если фон является частью дизайна. Эти возможности проверяйте на закреплённой версии браузера.
Рендер ждёт шрифты и ресурсы
- Собрать HTML только из очищенных snapshot-данных.
- Подключить локальные или разрешённые шрифты с устойчивыми URL.
- Дождаться `document.fonts.ready` и загрузки обязательных изображений.
- Сгенерировать PDF с фиксированными page options.
- Посчитать hash файла и сохранить размер, версию движка и время.
- Опубликовать файл только после структурной проверки.
Одна общая временная 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, критерии отзыва и три тестовых имени. Если документ должен иметь юридическую силу, добавьте отдельное заключение специалиста по требованиям подписи и хранения.