Online Campus : des paiements fiables sur une plateforme d'apprentissage
Le backend du campus en ligne d'une école de commerce : vente de cours, quiz chronométrés et certificats vérifiables par tous.
- Rôle
- Ingénieur backend et DevOps
- Période
- avr. 2026 à sept. 2026
- Stack
- NestJS, Fastify, Prisma, Postgres, BullMQ, Paystack
- Problème
- Une école de commerce devait vendre des cours, organiser des évaluations chronométrées et délivrer des certificats, avec des paiements qui ne provoquent jamais de double inscription ni ne se perdent.
- Ce que j'ai fait
- J'ai construit le backend et géré son infrastructure, aux côtés d'un ingénieur frontend et d'un designer : traitement idempotent des paiements Paystack avec un job de réconciliation, échéances de quiz détenues par le serveur et certificats générés via une file d'attente.
- Résultat
- En ligne, avec des étudiants payants qui suivent les leçons et les quiz chronométrés, et des certificats vérifiables prêts pour les premières complétions.

Le système
Les étudiants paient, passent des évaluations chronométrées et reçoivent des certificats, et chacune de ces étapes est une promesse. Un paiement doit inscrire exactement une fois, même quand le prestataire envoie le webhook deux fois ou pas du tout. L'échéance d'un quiz doit tenir même si le navigateur ment sur l'heure.
Ingénieur backend et DevOps pendant cinq mois, aux côtés d'un ingénieur frontend et d'un designer : 97 commits, 117 endpoints, 24 modèles et environ 350 tests.
- étudiants
- 10+
- endpoints
- 117
- tests
- 350
Du paiement au certificat. Survolez ou touchez un nœud pour voir chaque étape.
Traiter exactement une fois
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 signale un paiement réussi.
Un webhook vérifié ne fait que mettre un job en file. Le worker traite le paiement dans une transaction qui déduplique sur l'id d'événement du prestataire et considère une violation d'unicité sur l'inscription comme déjà traitée. Si un paiement a réussi mais ne peut pas être honoré, il est consigné comme devant être remboursé plutôt qu'ignoré en silence.
Un cron de réconciliation tourne toutes les cinq minutes et interroge le prestataire sur tout ce qui est encore en attente, si bien qu'un webhook qui n'arrive jamais aboutit tout de même à une inscription.
Des échéances détenues par le serveur
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();
Commencer un quiz enregistre les questions mélangées et une échéance sur le serveur.
Chaque tentative de quiz enregistre son propre ordre de questions mélangé et une échéance côté serveur. L'enregistrement d'une réponse utilise la concurrence optimiste et renvoie un conflit si la tentative a changé dans un autre onglet. Un job qui tourne chaque minute fait expirer les tentatives abandonnées, et la complétion alimente la progression dans le cours.
Des certificats hors du chemin de la requête
Terminer un cours ne fait que mettre un job en file. La requête répond aussitôt.
Rendre un PDF dans Chrome headless est lent et gourmand en mémoire, donc cela n'arrive jamais pendant une requête. Une file dédiée rend, téléverse et envoie par e-mail chaque certificat, et les admins peuvent les réémettre ou les révoquer. Un endpoint public permet à n'importe qui de vérifier un certificat grâce à son id.
Des choix que j'assume
Un processus worker séparé
Chrome et les rafales de webhooks ne peuvent pas affamer l'API, et le worker monte en charge de son côté.
Pagination par offset plutôt que par curseur
Les admins sautent à la page N et trient sur de nombreuses colonnes ; les listes sont assez petites pour que le coût de l'offset ne se voie jamais.
Circuit breaker adossé à Redis
Quand un prestataire est en panne, toutes les instances cessent de l'appeler en même temps au lieu de le découvrir chacune de leur côté.