Разработка системы сертификатов (генерация PDF) для LMS
Сертификат об окончании курса — осязаемый результат для студента. Технически это генерация PDF по шаблону с персональными данными, уникальным номером и QR-кодом для верификации. При кажущейся простоте задача имеет нюансы: качество PDF, кастомизация шаблонов, масштабирование при пиковой нагрузке (конец семестра — тысячи сертификатов одновременно).
Архитектура
Студент завершает курс → Grade >= passing_score?
↓ YES
Job queue (BullMQ/Celery)
↓
Certificate generator worker
├── Fetch student data + course data
├── Render HTML template
├── Generate PDF (Puppeteer/WeasyPrint)
├── Upload to S3
├── Save certificate record (DB)
└── Send email with PDF link
Генерация асинхронная — студент получает уведомление когда сертификат готов, а не ждёт синхронного ответа.
Генерация PDF: инструменты
Puppeteer / Playwright — рендерит HTML в PDF через Chromium. Лучший вариант для сложных дизайнов с CSS, шрифтами, градиентами:
const browser = await puppeteer.launch({ args: ['--no-sandbox'] });
const page = await browser.newPage();
const html = await renderCertificateHtml({
studentName: 'Иван Петров',
courseName: 'React Professional',
completionDate: '28 марта 2026',
certificateId: 'CERT-2026-001234',
instructorName: 'Алексей Смирнов',
qrCodeDataUrl: await generateQrCode(`https://example.com/verify/CERT-2026-001234`),
});
await page.setContent(html, { waitUntil: 'networkidle0' });
const pdf = await page.pdf({
format: 'A4',
landscape: true,
printBackground: true,
margin: { top: '0', right: '0', bottom: '0', left: '0' },
});
await browser.close();
WeasyPrint — Python-библиотека, конвертирует HTML/CSS в PDF. Быстрее Puppeteer, но хуже поддерживает сложный CSS.
PDFKit (Node.js) — генерирует PDF программно, без HTML. Точный контроль позиционирования, но шаблоны сложнее поддерживать.
Шаблоны сертификатов
HTML-шаблоны с Handlebars или Jinja2 хранятся в БД — преподаватель или администратор может менять дизайн без деплоя:
<!-- certificate-template.hbs -->
<!DOCTYPE html>
<html>
<head>
<style>
@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:wght@700&family=Open+Sans&display=swap');
body { margin: 0; width: 297mm; height: 210mm; font-family: 'Open Sans'; }
.container { position: relative; width: 100%; height: 100%; }
.background { position: absolute; width: 100%; height: 100%; }
.content { position: relative; z-index: 1; padding: 40mm 30mm; text-align: center; }
.student-name { font-family: 'Playfair Display'; font-size: 36pt; color: #1a1a2e; }
.course-name { font-size: 18pt; color: #16213e; margin: 8mm 0; }
.cert-id { font-size: 8pt; color: #666; position: absolute; bottom: 10mm; left: 15mm; }
.qr-code { position: absolute; bottom: 10mm; right: 15mm; width: 25mm; }
</style>
</head>
<body>
<div class="container">
<img class="background" src="{{backgroundUrl}}" />
<div class="content">
<p>Настоящим подтверждается, что</p>
<div class="student-name">{{studentName}}</div>
<p>успешно завершил(а) курс</p>
<div class="course-name">{{courseName}}</div>
<p>{{completionDate}} · {{totalHours}} часов</p>
</div>
<div class="cert-id">ID: {{certificateId}}</div>
<img class="qr-code" src="{{qrCodeDataUrl}}" />
</div>
</body>
</html>
Модель данных
CREATE TABLE certificates (
id UUID PRIMARY KEY DEFAULT gen_random_uuid(),
certificate_id VARCHAR(50) UNIQUE NOT NULL, -- CERT-2026-001234
student_id UUID REFERENCES users(id),
course_id UUID REFERENCES courses(id),
template_id UUID REFERENCES certificate_templates(id),
pdf_url VARCHAR(2000),
issued_at TIMESTAMPTZ DEFAULT NOW(),
revoked_at TIMESTAMPTZ, -- NULL если активен
revoke_reason TEXT,
metadata JSONB DEFAULT '{}' -- score, hours, instructor
);
Верификация по QR-коду
Публичная страница верификации без авторизации: GET /verify/{certificate_id} — отображает данные сертификата и подтверждает его подлинность.
app.get('/verify/:certId', async (req, res) => {
const cert = await db.certificates.findOne({ certificateId: req.params.certId });
if (!cert || cert.revokedAt) {
return res.status(404).render('certificate-invalid');
}
res.render('certificate-valid', {
studentName: cert.student.name,
courseName: cert.course.name,
issuedAt: cert.issuedAt,
});
});
Масштабирование
При пиковой нагрузке (конец семестра, 1000+ сертификатов) запускаем несколько worker'ов параллельно. Puppeteer требователен к памяти (~200MB на экземпляр браузера) — используем пул из 3–5 браузеров через puppeteer-cluster.
Сроки
Базовая система с одним шаблоном, генерацией через Puppeteer, хранением в S3 и email-отправкой — 4–5 дней. Визуальный редактор шаблонов для администратора и публичная верификация — ещё 3–4 дня.