Розробка системи сертифікатів (генерація 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+ сертифікатів) запускаємо кілька воркерів паралельно. Puppeteer вимогливий до пам'яті (~200MB на екземпляр браузера)—використовуємо пул з 3–5 браузерів через puppeteer-cluster.
Терміни
Базова система з одним шаблоном, генерацією через Puppeteer, зберіганням в S3 та відправкою email—4–5 днів. Візуальний редактор шаблонів для адміністратора та публічна верифікація—ще 3–4 дня.