Печатная форма должна строиться из зафиксированного snapshot заказа, а не заново пересчитывать скидки и налоги при каждом скачивании. Сначала сформируйте JSON документа с номером, датой, сторонами, строками и итогами, затем передайте его в отдельный HTML-шаблон и только после этого печатайте PDF.
Для серверной генерации Chromium/Puppeteer используйте `page.pdf()`: он рендерит страницу с print media. Закрепите версию runtime, дождитесь загрузки fonts и задайте размер через CSS `@page` вместе с `preferCSSPageSize`, иначе обновление браузера или шрифта может незаметно изменить переносы.
Данные документа замораживаются отдельно
| Поле snapshot | Источник | Почему нельзя считать при печати |
|---|---|---|
| Номер и дата | Система нумерации документов | Повторное открытие не меняет идентификатор |
| Наименование и цена | Строка заказа на момент фиксации | Каталог позже редактируется |
| Скидка и налог | Результат расчётного движка | Новые правила не переписывают прошлый документ |
| Реквизиты сторон | Версия профиля на дату | Адрес и название могут измениться |
| Валюта и округление | Payment/order snapshot | Текущий курс не относится к старому заказу |
| Версия шаблона | Template registry | Можно объяснить внешний вид документа |
Если заказ ещё редактируется, формируйте preview с явной пометкой. Финальный документ создаётся после бизнес-события и получает собственную версию; исправление оформляется новой версией или корректировочным документом по правилам продукта.
Print CSS управляет листом и разрывами
@page {
size: A4;
margin: 16mm 14mm 18mm;
}
@media print {
.screen-only { display: none; }
.order-row { break-inside: avoid; }
thead { display: table-header-group; }
tfoot { display: table-footer-group; }
body { font-family: 'Inter', sans-serif; }
}Не ставьте `break-inside: avoid` на огромный контейнер: браузер не сможет поместить его на лист и результат будет непредсказуем. Защищайте небольшие строки, подпись и блок итогов; длинное описание товара разрешайте переносить.
Генератор ждёт контент, а не таймер
Откройте локальный защищённый render URL или передайте HTML напрямую, дождитесь `document.fonts.ready` и явного признака `data-render-ready`. Таймер «подождать секунду» ломается под нагрузкой. Внешние картинки предварительно загрузите или встройте как контролируемые assets.
- Отключите произвольные внешние URL в шаблоне, чтобы не получить SSRF.
- Установите timeout и ограничение размера HTML/PDF.
- Используйте printBackground, если фон несёт смысл, а не декор.
- Не передавайте cookie пользователя headless-браузеру без необходимости.
- Удаляйте временные файлы после сохранения результата в document storage.
Длинные данные проверяются заранее
Эталонный набор должен включать длинное имя компании, несколько языков, пустой optional field, 1 и 100 строк, крупные суммы, отрицательную скидку если она допустима, QR/штрихкод и подписи. Откройте PDF на desktop и mobile viewer, затем напечатайте хотя бы один образец.
Сравнение только по размеру файла бесполезно. Извлеките текст для проверки суммы и номера, посчитайте страницы и добавьте визуальный diff отрендеренных PNG с допустимым порогом. Изменение шрифта и Chromium обновляйте осознанно.
Повторная генерация не меняет документ
Два запуска для одного snapshot должны дать одинаковые бизнес-данные и ожидаемую верстку. Если нужен новый вид, сохраните template version. Кэшируйте готовый PDF по document version, но не по изменяемому order ID без версии.
Для разбора подготовьте обезличенный snapshot, HTML/CSS template, версию Puppeteer/Chromium и проблемный PDF. Реальные реквизиты клиента, подписи и токены доступа следует заменить.