Pular para o conteúdo
~/rafael-ferreira

Plataforma B2B para venda de ingressos e cursos

Venda de ingressos e cursos para treinamento corporativo, com check-in offline e painel da empresa

repositório privado
  • Laravel
  • Vue 3
  • Inertia.js
  • TypeScript
  • Tailwind CSS
  • Filament
  • MySQL
  • Redis
  • Horizon
  • Reverb
  • AWS S3
  • Bunny Stream
  • Docker
  • Pest
Capa do projeto Plataforma B2B para venda de ingressos e cursos

Construí uma plataforma de treinamento corporativo que vende ingressos para eventos presenciais e cursos online. O aluno compra, estuda e recebe certificado. O gestor da empresa compra licenças de curso para a equipe e acompanha o progresso de cada colaborador. O organizador do evento valida ingressos na porta e vê em tempo real quem entrou. A equipe interna administra tudo no Filament.

Os problemas difíceis ficam por trás das telas: estoque que não pode vender além do limite, pagamento que chega por webhook fora de ordem, check-in sem internet, licenças compartilhadas por uma empresa inteira e progresso de vídeo que não aceita atalho. O código é privado e o nome do produto fica de fora de propósito; aqui conto como resolvi cada parte.

Painel do aluno: continuar a aula de onde parou e o progresso de cada curso

Visão geral

O pagamento é por PIX, boleto ou cartão (com tokenização e parcelamento) via Asaas. Os cursos têm módulos com pré-requisitos e liberação programada, e as aulas podem ser texto, vídeo no Bunny Stream, sessão ao vivo, material para baixar ou atividade interativa. Ingressos e certificados saem em PDF.

Diagrama: painéis do aluno, da empresa, do check-in e do admin sobre os contextos de domínio e as integrações

Ingresso sem venda duplicada

Cada tipo de ingresso tem lotes com estoque, vendidos e reservados. Só um lote fica ativo por tipo, garantido por índice único, e a virada acontece por data, por quantidade ou manualmente. Ao pôr um ingresso no carrinho, a ReserveStockAction abre uma transação com lock de linha e faz um UPDATE condicional que só passa se ainda houver saldo. A reserva dura 10 minutos, congela o preço e volta ao estoque por um comando de expiração se o pagamento não vier.

Cada webhook de pagamento é gravado com chave única por provedor e identificador externo, então o mesmo aviso recebido duas vezes não paga o pedido duas vezes. O processamento roda numa fila própria, o estado do pedido é uma máquina de estados num enum e um comando de conciliação compara as cobranças com o gateway para aplicar o que o webhook não trouxe.

Diagrama: reserva no carrinho, webhook de pagamento, baixa no estoque, voucher e ingresso nominal

Pago o pedido, o comprador recebe vouchers, que viram ingressos nominais com nome e CPF do titular, preenchidos por link, por CSV ou pelo próprio participante. Um índice único impede o mesmo CPF duas vezes no evento.

Página do evento com tipos de ingresso, lote, local, datas e política de cancelamento

Check-in que funciona sem internet

O QR code carrega um payload assinado com HMAC-SHA256, com chave derivada por evento e verificação em tempo constante. O check-in é um PWA com leitor pela câmera, busca manual e opção de desfazer. Antes do evento, o aparelho guarda no IndexedDB a base de ingressos e uma chave offline daquele evento; sem sinal, a leitura é validada localmente e entra numa fila que sincroniza depois.

Busca de participante no celular, com confirmação de entrada e alerta de quem já entrou

O servidor continua sendo a fonte da verdade. QR, busca manual e sincronização offline passam pela mesma PerformCheckInAction, e um índice único no ingresso impede entrada dupla. Quando dois aparelhos leem o mesmo ingresso offline, vale a leitura mais antiga e o conflito vai para o log de auditoria.

Diagrama: QR assinado, verificação offline, caminho único de gravação e painel em tempo real

O painel do organizador é atualizado por WebSocket (Reverb, canal privado por evento, com polling quando a conexão cai) e mostra presentes, ausentes, taxa de comparecimento, entradas por tipo e por hora, aparelhos e conflitos. O acesso da portaria pode ser limitado a um evento e expira sozinho.

Painel de credenciamento com presentes, ausentes, presença por tipo de ingresso, chegadas por hora e aparelhos

Licenças da empresa e privacidade

A empresa compra um pacote de licenças por curso, com desconto por volume, e distribui por convite de e-mail ou CSV, com retorno linha a linha dos erros. A atribuição usa um UPDATE atômico condicional, então duas pessoas distribuindo ao mesmo tempo não estouram o pacote. Revogar uma licença devolve o assento e preserva o progresso da pessoa.

Diagrama: compra do pacote, atribuição da licença, matrícula, progresso e relatórios com travas de privacidade

O gestor vê progresso, conclusão, certificados, último acesso e avaliações de cada colaborador, além de alertas de inatividade (14 dias), licença parada (21 dias) e acesso perto de expirar (30 dias). A exportação em CSV sai por link com validade. Por serem dados de funcionários, coloquei travas pensando na LGPD:

  • do diagnóstico, o gestor vê só a faixa, nunca a nota;
  • recortes com menos de 5 pessoas não aparecem;
  • tentativas de quiz de prática ficam só com o aluno.

Ficha do colaborador com cursos, conclusões e avaliações aprovadas, e o aviso de privacidade no topo

Progresso de vídeo que resiste a atalho

O progresso é um bitmap de blocos de 5 segundos que o servidor mescla sob lock de linha, e a aula de vídeo só conclui com 90% de cobertura. Um orçamento de tempo barra progresso mais rápido que o relógio, e cada conta assiste uma aula por vez. O embed do Bunny é tokenizado com validade, e os materiais ficam num bucket S3 privado, servidos por URL assinada de 2 minutos.

Trilha personalizada

Um quiz diagnóstico mede o domínio por área de conhecimento e dispensa as aulas que a pessoa já domina, mas nunca as obrigatórias. As aulas dispensadas continuam acessíveis. A correção dos quizzes é sempre no servidor, e as avaliações têm nota mínima (70% por padrão), limite de tentativas e intervalo entre elas. Insígnias com seis tipos de critério, sequências de estudo e certificados com código de verificação, página pública de validação e link para o LinkedIn completam o engajamento.

Trilha com aulas obrigatórias e aulas dispensadas pelo diagnóstico, cada uma com o motivo

Como o código é organizado e testado

É um monólito em Laravel 12 com Vue 3, Inertia e TypeScript, dividido em 9 contextos de domínio (Billing, Catalog, Corporate, Editorial, Identity, Learning, Ordering, Shared e Ticketing). Cada caso de uso é uma Action, 112 no total, sobre 63 models. O frontend tem 110 páginas com rotas tipadas pelo Wayfinder. Eventos de domínio são persistidos e podem ser reprocessados, e as filas do Horizon são separadas por carga: pagamentos, notificações, broadcasts, mídia e o restante.

  • 228 arquivos de teste em Pest, entre unitários, de feature e de concorrência.
  • Suíte de concorrência com 14 arquivos; o teste de estoque roda em MySQL real, porque lock de linha não se testa em SQLite.
  • Testes de arquitetura que barram dependência fora das fronteiras de domínio, SQL cru, regra de negócio sem teste, recurso do Filament sem autorização e credencial de ingresso exposta.
  • CI no GitHub Actions com Pint, ESLint, Prettier, vue-tsc, testes e auditoria de dependências.

Também fiz uma auditoria de segurança própria contra o OWASP Top 10 2025.

Para ler mais

Galeria

Outros projetos

Capa do projeto Markmedi
markmedi.com · privado ★ destaque

Markmedi

Meu projeto principal: agenda, prontuário, telemedicina, financeiro, CRM e marketing para clínicas, num monólito modular em Laravel e Vue com filas, tempo real e criptografia por clínica.

  • Laravel
  • Vue 3
  • Inertia.js
  • TypeScript
  • Tailwind CSS
Capa do projeto Evidens
evidens · privado ★ destaque

Evidens

Pipeline em Python que coleta acórdãos do TJRJ com Playwright, guarda cada evidência com hash, extrai o texto dos PDFs e faz um modelo de linguagem ler 1.048 decisões inteiras, aceitando só classificações sustentadas por citações conferidas na página indicada.

  • Python
  • Playwright
  • BeautifulSoup
  • PostgreSQL
  • psycopg 3