ClaOdin-Quiz
Servidor de quizzes estilo Kahoot para a sala de aula: roda na rede local, sem internet, com geração por IA, equações em LaTeX e relatórios em PDF.
A ideia
Um framework de quizzes estilo Kahoot feito para a realidade da escola pública: que roda na rede local, sem depender de internet e de acesso rápido. O professor projeta o jogo numa tela, cria uma sala, e os alunos entram pelo celular com um PIN (ou QR code) — sem instalar nada no aparelho.
Por que local e sem internet?
Em muitas escolas a internet é instável ou não chega na sala. O ClaOdin-Quiz roda no computador do professor, na rede local: sobe em minutos, funciona offline e os celulares dos alunos se conectam direto. Rápido, confiável e sob seu controle.
O que ele faz
Para jogar
- Entrada por PIN ou QR code, direto no navegador — sem app.
- Apelido no ranking + nome real visível só para o professor (para lançar nota).
- De 2 a 10 alternativas por pergunta.
- Dois modos de pontuação: rápido (quem responde antes pontua mais) e lento (valor fixo ao acertar).
- Ranking ao vivo e pódio no final.
Para criar
- Editor de texto rico com equações em LaTeX (renderizadas localmente, sem internet).
- Importação de quizzes no formato GIFT (Moodle).
- Geração automática por IA — Claude, ChatGPT ou Gemini (opcional).
- Os quizzes ficam salvos para reutilizar.
Robustez (o que faz diferença na prática)
- Reconexão automática: se o celular apagar a tela ou o Wi-Fi cair, o aluno volta na mesma pergunta.
- O professor vê quem caiu antes de avançar para a próxima.
- Estatísticas por turma + relatório em PDF com apelido, nome real e notas.
Tecnologia
TypeScript · React + Vite · Node + Fastify + Socket.IO · SQLite · Docker · MathJax (LaTeX local). Código aberto sob licença MIT.
Na sala de aula
O ClaOdin-Quiz já é usado na ETE Epitácio Pessoa — na foto, uma partida ao vivo projetada na sala, com os alunos respondendo pelo celular. Aprender virou jogo. 🎮
Quer instalar no seu notebook?
É código aberto e gratuito. Se você é professor e quer usar na sua escola, basta seguir o passo a passo e o tutorial na página do projeto no GitHub (botão abaixo) — tem guia completo para Windows e Linux, com Docker ou Node, incluindo configuração de rede e senha.