Online Campus: verlässliche Zahlungen auf einer Lernplattform
Das Backend für den Online-Campus einer Business School: Kursverkauf, zeitgebundene Quizze und Zertifikate, die jeder prüfen kann.
- Rolle
- Backend- und DevOps-Engineer
- Zeitraum
- Apr. 2026 bis Sept. 2026
- Status
- Live unter ebschool.org
- Stack
- NestJS, Fastify, Prisma, Postgres, BullMQ, Paystack
- Problem
- Eine Business School musste Kurse verkaufen, zeitgebundene Prüfungen durchführen und Zertifikate ausstellen, mit Zahlungen, die nie doppelt einschreiben oder verloren gehen.
- Was ich gemacht habe
- Das Backend gebaut und seine Infrastruktur betrieben, zusammen mit einem Frontend-Engineer und einem Designer: idempotente Paystack-Abwicklung mit Abgleichsjob, vom Server verwaltete Quiz-Deadlines und Zertifikate, die über eine Queue gerendert werden.
- Ergebnis
- Live, mit zahlenden Studierenden, die Lektionen und zeitgebundene Quizze durcharbeiten, und verifizierbaren Zertifikaten, bereit für die ersten Abschlüsse.

Das System
Studierende zahlen, legen zeitgebundene Prüfungen ab und erhalten Zertifikate, und jedes davon ist ein Versprechen. Eine Zahlung muss genau einmal einschreiben, auch wenn der Anbieter den Webhook doppelt oder gar nicht schickt. Eine Quiz-Deadline muss halten, auch wenn der Browser bei der Uhrzeit lügt.
Fünf Monate Backend- und DevOps-Engineer, zusammen mit einem Frontend-Engineer und einem Designer: 97 Commits, 117 Endpunkte, 24 Modelle und rund 350 Tests.
- Studierende
- 10+
- Endpunkte
- 117
- Tests
- 350
Von der Zahlung zum Zertifikat. Fahren Sie über einen Knoten oder tippen Sie darauf, um jeden Schritt zu sehen.
Genau einmal abwickeln
payment-fulfillment.service.ts (simplified)
await prisma.$transaction(async (tx) => { if (await tx.paymentEvent.findUnique({ where: { eventId } })) return; await tx.paymentEvent.create({ data: { eventId } }); await tx.enrollment.create({ data: { userId, courseId } });});// every 5 minutes: ask Paystack about anything still pending
Paystack meldet eine erfolgreiche Zahlung.
Ein verifizierter Webhook stellt nur einen Job in die Queue. Der Worker wickelt in einer Transaktion ab, die über die Event-ID des Anbieters dedupliziert und eine Unique Violation bei der Einschreibung als bereits erledigt behandelt. Ist eine Zahlung erfolgreich, kann aber nicht abgewickelt werden, wird sie als zu erstatten protokolliert, statt still verloren zu gehen.
Ein Abgleichs-Cron läuft alle fünf Minuten und fragt beim Anbieter nach allem, was noch offen ist. So endet auch ein Webhook, der nie ankommt, in einer Einschreibung.
Deadlines, die der Server verwaltet
learn-quiz-session.service.ts (simplified)
const { count } = await tx.quizAttempt.updateMany({ where: { id, version, deadlineAt: { gt: new Date() } }, data: { answers, version: { increment: 1 } },});if (count === 0) throw new ConflictException();
Beim Start eines Quiz speichert der Server die gemischten Fragen und eine Deadline.
Quizversuche speichern ihre eigene gemischte Fragenreihenfolge und eine serverseitige Deadline. Das Speichern einer Antwort nutzt Optimistic Concurrency und liefert einen Konflikt, wenn der Versuch in einem anderen Tab geändert wurde. Ein minütlicher Job lässt abgebrochene Versuche ablaufen, und abgeschlossene Versuche fließen in den Kursfortschritt ein.
Zertifikate abseits des Request-Pfads
Ein abgeschlossener Kurs stellt nur einen Job in die Queue. Der Request kehrt sofort zurück.
Ein PDF in Headless Chrome zu rendern ist langsam und speicherhungrig, deshalb passiert es nie in einem Request. Eine eigene Queue rendert jedes Zertifikat, lädt es hoch und verschickt es per E-Mail, und Admins können Zertifikate neu ausstellen oder widerrufen. Über einen öffentlichen Endpunkt kann jeder ein Zertifikat anhand seiner ID prüfen.
Entscheidungen, die ich vertreten kann
Eigener Worker-Prozess
Chrome und Webhook-Spitzen können die API nicht ausbremsen, und der Worker skaliert unabhängig.
Offset-Pagination statt Cursor
Admins springen zu Seite N und sortieren nach vielen Spalten; die Listen sind klein genug, dass die Kosten von Offset nie auffallen.
Circuit Breaker auf Redis-Basis
Fällt ein Anbieter aus, hören alle Instanzen gleichzeitig auf, ihn aufzurufen, statt es jede für sich herauszufinden.