Сертифікат про закінчення курсу — відчутний результат для студента, але генерація тисячі PDF за годину — нетривіальне завдання. Якість рендеру, кастомізація шаблонів, пікове навантаження (кінець семестру) — типові вузькі місця. Помилка у виборі інструменту або архітектури призводить до повільної видачі, падіння сервера або низької якості PDF. Ми пропонуємо готове рішення під ключ: асинхронна генерація через чергу завдань, зберігання в S3, QR-верифікація та email-доставка. Наші інженери мають досвід у розробці LMS понад 6 років і реалізували 35+ проєктів. Оцінимо ваш проєкт за один робочий день і запропонуємо оптимальну архітектуру.
Які проблеми вирішує система сертифікатів?
Повільна синхронна генерація. Якщо студент чекає відповіді після завершення курсу — сервер може впасти під навантаженням 500+ одночасних запитів. Рішення: асинхронна черга (BullMQ/Celery) з 3–5 воркерами.
Якість PDF. Бібліотеки на кшталт fpdf дають примітивний дизайн. Ми використовуємо Puppeteer або Playwright — рендеримо HTML/CSS з шаблону: градієнти, користувацькі шрифти, прозорість, QR-код.
Кастомізація без деплою. Шаблони зберігаються в БД (HTML + Handlebars). Викладач змінює дизайн через адмінку — не потрібно перезбирати додаток.
Чому асинхронна генерація критична для LMS?
При піковому навантаженні, наприклад в кінці семестру, система одночасно отримує сотні запитів на сертифікати. Синхронна генерація блокує воркери, кожен PDF створюється послідовно. Сервер може не витримати. Асинхронна черга (BullMQ/Celery) розподіляє завдання між воркерами, студент отримує сповіщення одразу, а генерація відбувається у фоновому режимі. На практиці 3 воркери Puppeteer обробляють 1200 PDF за 40 хвилин. Це надійно та масштабовано.
Як вибрати інструмент генерації PDF?
| Інструмент | Мова | Якість рендеру | Швидкість | Складність | Краще для |
|---|---|---|---|---|---|
| Puppeteer/Playwright | Node.js | Відмінна (CSS, шрифти, градієнти) | Середня (витрати пам'яті ~200MB) | Середня | Складні дизайни, брендування |
| WeasyPrint | Python | Хороша (HTML/CSS) | Висока | Низька | Прості сертифікати, висока продуктивність |
| PDFKit | Node.js | Програмне малювання | Висока | Висока | Точний контроль позиціонування, динамічні елементи |
Ми частіше вибираємо Puppeteer — він рендерить будь-який веб-дизайн «піксель в піксель». Код генерації — пара десятків рядків.
Як організована асинхронна генерація?
Студент завершує курс. Якщо оцінка прохідна, в чергу (BullMQ/Celery) потрапляє завдання. Воркер забирає його: завантажує дані студента та курсу, рендерить HTML-шаблон з Handlebars, генерує PDF через Puppeteer, завантажує в S3, зберігає запис у БД і відправляє email з посиланням.
Приклад шаблону:
<!-- 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> Модель даних у PostgreSQL:
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 ); Верифікація та масштабування
Публічна сторінка верифікації без авторизації: GET /verify/{certificate_id} — відображає дані сертифіката та підтверджує його справжність. QR-код (Wikipedia: QR-код) використовується для швидкої верифікації.
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. На практиці 3 воркери обробляють 1200 PDF за 40 хвилин. Порівняння синхронного та асинхронного підходу:
| Аспект | Синхронна | Асинхронна |
|---|---|---|
| Час очікування студента | Залежить від навантаження | Одразу отримує сповіщення |
| Навантаження на сервер | Високе при піку | Розподілена чергою |
| Складність реалізації | Низька | Середня (черга, воркери) |
| Масштабованість | Погана | Хороша (додавання воркерів) |
Що входить у нашу роботу
- Аналіз поточної LMS та потоків студентів
- Проєктування архітектури (вибір інструменту, черги, зберігання)
- Розробка генератора PDF та шаблонів (HTML+Handlebars)
- Інтеграція API верифікації з QR-кодом
- Налаштування асинхронної черги та масштабування
- Тестування (навантажувальне 500-2000 запитів, pixel-perfect перевірка)
- Деплой у ваше середовище (Docker, CI/CD)
- Документація та 3 місяці супроводу
- Гарантія продуктивності та конфіденційності даних
Строки та вартість
Базова система з одним шаблоном, генерацією через Puppeteer, зберіганням у S3 та email-відправкою — 4–5 днів. Візуальний редактор шаблонів для адміністратора та публічна верифікація — ще 3–4 дні. Підсумок: від 4 до 9 днів під ключ. Вартість розраховується індивідуально — зв'яжіться з нами для оцінки. Отримайте консультацію інженера: обговоримо архітектуру, строки та вартість вашого проєкту. Замовте розробку системи сертифікатів під ключ — автоматизуйте видачу та економте ресурси.