Online Campus: pagamentos confiáveis em uma plataforma de ensino
O backend do campus online de uma escola de negócios: venda de cursos, provas com tempo e certificados que qualquer pessoa pode verificar.
- Função
- Engenheiro de backend e DevOps
- Período
- abr. de 2026 a set. de 2026
- Status
- No ar em ebschool.org
- Stack
- NestJS, Fastify, Prisma, Postgres, BullMQ, Paystack
- Problema
- Uma escola de negócios precisava vender cursos, aplicar avaliações com tempo e emitir certificados, com pagamentos que nunca matriculam em dobro nem somem.
- O que eu fiz
- Construí o backend e operei a infraestrutura, junto com um engenheiro de frontend e um designer: fulfillment idempotente do Paystack com um job de reconciliação, prazos de prova controlados pelo servidor e certificados gerados em uma fila.
- Resultado
- No ar, com alunos pagantes avançando nas aulas e provas com tempo, e certificados verificáveis prontos para as primeiras conclusões.

O sistema
Os alunos pagam, fazem avaliações com tempo e recebem certificados, e cada uma dessas coisas é uma promessa. Um pagamento precisa gerar exatamente uma matrícula, mesmo quando o provedor envia o webhook duas vezes ou não envia. O prazo de uma prova precisa valer mesmo que o navegador minta sobre o horário.
Engenheiro de backend e DevOps por cinco meses, junto com um engenheiro de frontend e um designer: 97 commits, 117 endpoints, 24 modelos e cerca de 350 testes.
- alunos
- 10+
- endpoints
- 117
- testes
- 350
Do pagamento ao certificado. Passe o mouse ou toque em um nó para ver cada etapa.
Processar exatamente uma vez
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
O Paystack informa uma cobrança aprovada.
Um webhook verificado só enfileira um job. O worker processa dentro de uma transação que deduplica pelo id do evento do provedor e trata uma violação de unicidade na matrícula como algo já feito. Se um pagamento foi aprovado mas não pode ser processado, ele é registrado como precisando de reembolso em vez de ser descartado em silêncio.
Um cron de reconciliação roda a cada cinco minutos e consulta o provedor sobre tudo que ainda está pendente, então um webhook que nunca chega ainda termina em matrícula.
Prazos que o servidor controla
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();
Iniciar uma prova grava as questões embaralhadas e um prazo no servidor.
As tentativas de prova guardam a própria ordem embaralhada das questões e um prazo no servidor. Salvar uma resposta usa concorrência otimista e retorna um conflito se a tentativa mudou em outra aba. Um job a cada minuto expira tentativas abandonadas, e a conclusão alimenta o progresso no curso.
Certificados fora do caminho da requisição
Concluir um curso só enfileira um job. A requisição retorna na hora.
Renderizar um PDF no Chrome headless é lento e consome muita memória, então isso nunca acontece dentro de uma requisição. Uma fila dedicada renderiza, faz o upload e envia cada certificado por e-mail, e os admins podem reemiti-los ou revogá-los. Um endpoint público permite que qualquer pessoa verifique um certificado pelo id.
Decisões que valem a pena defender
Processo de worker separado
O Chrome e picos de webhooks não conseguem sufocar a API, e o worker escala sozinho.
Paginação por offset em vez de cursores
Os admins pulam para a página N e ordenam por várias colunas; as listas são pequenas o bastante para que o custo do offset nunca apareça.
Circuit breaker apoiado no Redis
Quando um provedor cai, todas as instâncias param de chamá-lo ao mesmo tempo, em vez de cada uma descobrir isso por conta própria.