# pdfmake: девять документов из данных

Node.js 24 LTS >=24.15; pdfmake 0.3.14, PDF.js 6.5.438, Bootstrap 5.3.9.
Готовая public работает через HTTP без npm install. Для изменения сборки и серверной генерации установите зависимости по lock-файлу. Браузер создаёт реальный PDF и рисует его страницы PDF.js; при недоступности просмотра файл остаётся доступен для скачивания. JSON не отправляется на сервер.

## Windows / PowerShell
```powershell
node --version
npm.cmd ci --ignore-scripts
npm.cmd test
npm.cmd run build
npm.cmd run serve
```
Откройте http://127.0.0.1:8575/. Ctrl+C завершает только этот сервер.
```powershell
npm.cmd run generate -- invoice fixtures/invoice.json "$env:TEMP\invoice-demo.pdf"
$env:PORT = '8577'
npm.cmd run serve
```
## Linux
```bash
node --version
npm ci --ignore-scripts
npm test
npm run build
npm run generate -- report fixtures/report.json /tmp/report-demo.pdf
npm run serve
```
Выходной файл должен быть новым: CLI намеренно отказывает при существующем пути. Передайте другое имя. Не переносите node_modules с Windows на Linux.

## Сценарии
- letter: уведомление; styles: памятка; invoice: денежный расчёт в копейках;
- register: 85 строк с повтором заголовка; proposal: две колонки;
- ticket: встроенный SVG и QR HTTPS-ссылки; report: три раздела;
- landscape: недельный план; act: внутренний протокол с местом подписей.

В public JSON можно редактировать, менять акцент, скачивать PDF и проверенные данные, листать настоящие страницы. Любое изменение сбрасывает прошлый результат. Просмотр исходников загружает sources.json отдельно и не нужен для генерации. Исходники совпадают с проектом; файлы можно копировать и скачивать по одному.

## Внутренний API
```bash
npm run api
```
В другом терминале Linux:
```bash
curl --fail-with-body -H 'Content-Type: application/json' --data-binary @fixtures/invoice.json http://127.0.0.1:8576/invoice -o /tmp/api-invoice.pdf
```
PowerShell:
```powershell
curl.exe --fail-with-body -H "Content-Type: application/json" --data-binary "@fixtures/invoice.json" http://127.0.0.1:8576/invoice -o "$env:TEMP\api-invoice.pdf"
```
Только POST /invoice, до 32 KiB JSON, два параллельных запроса. Ответы: 200 PDF, 404 другой маршрут, 413 размер, 415 Content-Type, 422 данные, 429 занято. Слушает только 127.0.0.1: это внутренний обработчик, без пользовательской авторизации. Для VPS читайте VPS.md.

## Проверка
```bash
npm test
npm run capture
```
capture создаёт девять реальных PDF в qa и результаты с количеством страниц/размерами/SHA-256. Доступность PDF не гарантирует красивую вёрстку: проверяйте все страницы через целевой просмотрщик. У реестра убедитесь в наличии строки 85, повторах заголовка, номерах страниц; у расчёта — в итоге 79 500,00 руб.; у report — в трёх страницах.

## Границы
Данные ограничены по типу/размеру и преобразуются только в собственные шаблоны. Произвольные Document Definition, сетевые картинки и пути пользователя запрещены. QR — содержимое ссылки, не запрос по ней. Расчёт не включает налоги, банковские реквизиты или платёжный QR. Место подписи не является электронной подписью. PDF/A и PDF/UA не заявляются. Генератор не редактирует существующий PDF.

## Лицензии
Свой код MIT. pdfmake MIT; PDF.js Apache-2.0; Roboto Apache-2.0 (fonts-LICENSE.txt); Bootstrap MIT. Полные лицензии в public/LICENSES.txt. Roboto уже включён в browser VFS и npm-пакет pdfmake; внешние шрифты при генерации не скачиваются.
