AL-Metrics

Sobre o Projeto

AL-Metrics é uma plataforma SaaS de analytics para infoprodutores e gestores de cursos online, com foco em saúde de base de alunos, receita e previsão de churn. O sistema agrega dados de integrações externas (Hotmart, importações CSV) e os transforma em métricas acionáveis — tudo em um dashboard centralizado por workspace.

Frontend

Dashboard construído em React 19 com TypeScript, Vite e TailwindCSS. A interface é orientada a dados: tabelas, gráficos e filtros compostos que permitem ao gestor navegar por diferentes cortes da base sem recarregar a página.

• Visualizações com Recharts: receita ao longo do tempo, distribuição de saúde de alunos, taxa de churn e inadimplência
• Tabelas com ordenação, filtros e paginação via TanStack Table
• Estado global gerenciado com Zustand: filtros de data, fonte de dados e sessão do usuário compartilhados entre páginas
• Formulários com validação em Zod e React Hook Form
• Acompanhamento de sincronização em tempo real via Server-Sent Events — a barra de progresso atualiza conforme o servidor processa os dados da Hotmart, sem polling

Backend

API RESTful em NestJS com arquitetura modular, PostgreSQL via Prisma ORM e autenticação por JWT + Google OAuth.

• Multi-workspace: cada workspace tem seus próprios dados, usuários e permissões — um usuário pode pertencer a múltiplos workspaces com papéis diferentes
• Criptografia de dados sensíveis: campos de PII dos alunos (e-mail, telefone, endereço) são criptografados em repouso com chave mestra rotacionável
• Integração com Hotmart: autenticação OAuth, sincronização paginada com checkpoint de retomada em caso de falha e ingestão de webhooks em tempo real
• Importação de CSV em larga escala: o arquivo é enviado diretamente do browser para o Cloudflare R2 (sem passar pelo servidor), processado em lotes com progresso transmitido via SSE
• Health Score: serviço dedicado que classifica alunos em três categorias (engajado, desengajado, crítico) com base em recência de acesso, histórico de transações e status de matrícula — resultados materializados em snapshots para consulta rápida
• Exportação de relatórios em CSV e XLSX com mais de 40 colunas configuráveis
• Rate limiting, Helmet para segurança de headers HTTP e cobertura de testes com Jest

Arquitetura

O sistema segue separação clara entre cliente e servidor: o frontend consome a API REST com tokens JWT injetados automaticamente, e a única exceção é o canal SSE que usa token por query string (limitação do protocolo nativo do browser). Dados de integrações são sincronizados de forma idempotente — re-sincronizar não gera duplicatas graças a identificadores externos únicos por registro.