1. Primeiro Acesso
Login, perfis e assinatura
Cria turmas, lança notas, usa o scanner e publica no mural.
Vê as próprias notas, ranking anônimo e feed da turma. Criado pelo professor.
Acesso total. Pode visualizar a plataforma como qualquer aluno (impersonação).
estudante. Redefina pelo painel da turma sempre que necessário./subscription-required.2. Criar Turma e Importar Alunos
Configuração inicial
Turmas → Nova Turma
Preencha nome, série, disciplina, escola e ano letivo. Escolha o método de cálculo anual: Soma (soma os bimestres) ou Média.
Importe os alunos via planilha
Vá em Importações → Cole o conteúdo de uma planilha. Colunas reconhecidas: nome, e-mail. O sistema cria os logins automaticamente.
Atribua números de cartão
Cada aluno recebe um número de cartão para usar no scanner. Defina em Alunos → Editar número de cartão.
3. Montar a Estrutura de Avaliação
Períodos → Grupos → Instrumentos
Divisão temporal. Cada período soma ou pondera os grupos.
Agrupa instrumentos dentro do período.
O item que gera a nota do aluno. Tipos: numérico, quiz, coleta, RPG.
4. Lançar Notas no Diário
Gradebook interativo com auto-save
Turma → Diário de Notas
Tabela: linhas = alunos, colunas = instrumentos agrupados.
Clique em qualquer célula e digit
Auto-save: a nota é salva automaticamente ao sair do campo. Sem botão 'Salvar'.
Subtotais em tempo real
Totais de grupos e períodos calculam enquanto você digita.
5. Quiz com Cartões de Resposta
OMR e QR: do cartão físico à nota automática
Crie um instrumento do tipo Quiz
No editor de avaliação, adicione instrumento → tipo Quiz → defina a nota máxima.
Cadastre as questões e o gabarito
No instrumento, adicione cada questão com alternativas A–D e marque a resposta correta. Ou use a importação em massa (cole questões separadas por linha em branco).
Imprima os cartões de resposta
Turma → Cartões → Gerar Cartões. Um cartão por aluno, com número de identificação.
Aplique o quiz em sala
Alunos marcam as alternativas no cartão físico. O cartão tem espaço para até 20 questões.
Abra o Scanner: Turma → Scanner → [Instrumento]
A câmera é ativada. Posicione cada cartão de frente.
Escaneie e confirme
O sistema identifica o aluno (pelo número) e lê as marcações. Revise e salve.
Nota calculada e lançada automaticamente
Acertos ÷ Total × Nota Máxima. O diário é atualizado na hora.
Modo OMR (Ótico)
Reconhece marcações a lápis ou caneta em cartões impressos comuns.
- Funciona com qualquer cartão impresso
- Detecta marcações mesmo em cartões levemente tortos
- Requer boa iluminação
Modo QR Code
Cartão com QR Code impresso que codifica aluno + respostas em um único código.
- Leitura instantânea (< 1 segundo)
- Não depende de iluminação perfeita
- Cartão deve ser gerado pelo sistema
QR Code — Como Funciona por Baixo dos Panos
O QR Code impresso não é um simples link — ele carrega um token de identificação assinado com HMAC-SHA256. O token codifica o número do cartão do aluno e uma assinatura criptográfica que impede falsificação. Isso é complementar ao modo OMR:
OMR: identifica + lê respostas
O scanner analisa a imagem do cartão: detecta o número do aluno (via área dedicada) e lê as bolhas marcadas para extrair as respostas. Requer boa iluminação e cartão plano.
QR Code: identificação segura
O QR Code identifica o aluno de forma instantânea e à prova de falsificação via HMAC. O mesmo QR Code do cartão funciona em qualquer turma ou quiz — a identificação é universal dentro da conta.
Formato do token: cardNumber:hmac16
Ex: 3:a1b2c3d4e5f6a7b8. O número de cartão é público; o HMAC (16 hex chars do SHA-256) é o segredo que garante autenticidade. Cartões forjados ou modificados são rejeitados pelo scanner.
Cada leitura = UPSERT em respostas_alunos
Ao confirmar a leitura de um cartão, o sistema faz um UPSERT (insert ou update) na tabela de respostas e recalcula a nota imediatamente. O diário é atualizado em tempo real.
Validade das Respostas — O que acontece ao escanear duas vezes?
Se o professor escanear o mesmo aluno duas vezes (seja por erro de leitura, por cartão amassado ou por qualquer outro motivo), a segunda leitura substitui a anterior — e a nota é recalculada automaticamente com base nas novas respostas.
Segunda leitura substitui
O UPSERT garante que cada aluno tenha exatamente um conjunto de respostas por instrumento. Reler o cartão é a forma mais simples de corrigir uma leitura ruim.
Nota recalculada automaticamente
Após o UPSERT, a nota é recalculada na hora. O diário já mostra o valor correto sem necessidade de ação adicional.
Respostas persistem entre sessões
Fechar e reabrir o scanner não apaga os dados já salvos. As respostas ficam no banco e reaparecem normalmente ao reabrir o diário.
Editar Respostas ou Notas após Escanear
O scanner não é o único caminho. Qualquer resposta ou nota pode ser editada manualmente no gradebook após o escaneamento — útil para correções pontuais sem precisar reler o cartão inteiro.
Abra o Diário de Notas da turma
A tabela exibe todos os alunos e instrumentos, incluindo as notas já escaneadas.
Clique na célula que quer corrigir
A célula entra em modo de edição. Digite o valor correto.
Pressione Enter ou clique fora da célula
A nota é salva automaticamente e o subtotal do grupo/período é recalculado na hora.
6. Coleta de Contexto e INSE
Questionários socioeconômicos sem nota curricular
O que é uma Coleta de Contexto?
Instrumentos de Coleta de Contexto funcionam como questionários ou pesquisas que não geram nota curricular. Os dados coletados aparecem no Hub Analítico, no diário de informações e nos exports CSV, mas não somam ao boletim.
O INSE (Índice Socioeconômico) é um caso especial de coleta de contexto: além de registrar as respostas brutas, o sistema calcula automaticamente um índice numérico e classifica o aluno em um dos grupos I a VIII.
Fluxo: criar uma coleta e adicionar perguntas
Avaliações → Nova Coleta
Dê um nome (ex: 'Perfil Socioeconômico'), escolha se cria um novo período de contexto ou vincula a um existente.
Clique em 'Criar Questionário'
O instrumento é criado e a aba 'Questões' abre automaticamente.
Adicione as perguntas
Uma por vez ou via importação em massa: cole as perguntas em bloco de texto (pergunta na primeira linha, alternativas abaixo, linha em branco entre questões).
Escaneie os cartões ou lance individualmente
Use o scanner (cartões físicos) ou clique em 'Coletar Dados' para lançar aluno por aluno digitalmente.
Veja os dados no Hub Analítico
Frequência de respostas, médias, distribuição — tudo disponível para análise e export.
Cálculo do INSE — passo a passo numérico
Quando o instrumento de coleta se chama INSE ou SAEB, o sistema ativa automaticamente a fórmula do índice socioeconômico baseada no questionário do SAEB/INEP.
- 1.
Mapeamento das respostas
Cada alternativa é convertida em um valor numérico:
A / Não / Nunca→ 0B / Sim, um / Às vezes→ 1C / Sim, dois / Frequentemente→ 2D / Sim, três ou mais / Sempre→ 3 - 2.
Cálculo da média (somente os 17 itens indicadores)
INSE = soma(valores das 17 respostas) / quantidade_de_respostas_válidasMínimo de 3 respostas válidas para o cálculo ser realizado. Resultado varia de 0 a 4.
- 3.
Exemplo numérico
Aluno respondeu 10 questões com valores: 3, 2, 1, 2, 3, 0, 2, 1, 2, 2
soma = 3+2+1+2+3+0+2+1+2+2 = 18
INSE = 18 ÷ 10 = 1,80
- 4.
Classificação nos grupos I–VIII
I
< 0,50
Muito Baixo
II
0,50–1,00
Baixo
III
1,00–1,50
Médio Baixo
IV
1,50–2,00
Médio
V
2,00–2,50
Médio
VI
2,50–3,00
Médio Alto
VII
3,00–3,50
Alto
VIII
≥ 3,50
Muito Alto
* Limites aproximados baseados em intervalo fixo (0,5 por grupo). O INEP usa percentis nacionais — os grupos aqui são uma aproximação para uso escolar.
O que aparece no Diário de Informações?
Para cada aluno: score numérico (ex: 1,80) + grupo (ex: IV). Ambos também estão disponíveis no export CSV/TSV para análise no R ou Python.
7. Modo Ao Vivo
Quiz em tempo real no telão
Professor
Aluno
8. Gamificação (RPG)
Distribuir XP e converter em nota
Como distribuir XP
Crie um instrumento do tipo RPG
Defina a nota máxima (ex: 10). Os XPs distribuídos serão convertidos automaticamente para essa escala.
Clique no ícone 🏆 ao lado do instrumento
O painel de distribuição de XP abre. Selecione aluno(s) e quantidade.
A nota é calculada automaticamente
A fórmula usa a média da turma como referência. Ver Referência Técnica para detalhes.
Exemplo rápido
- Nota máxima do instrumento10,0
- Média de XP da turma500 XP
- XP da aluna Ana400 XP
- Nota da Ana no boletim8,0 ✓
(400 ÷ 500) × 10 = 8,0
9. Hub Analítico
Visualize, cruze e exporte os dados da sua turma
Visão consolidada
Escola → Turma → Aluno → drill-down completo.
Drag de variáveis
Construa análises cruzadas sem código.
Export CSV/TSV
Compatível com R e Python (pandas).
CALC: Nota Final e CALC: {Período} — Total como variáveis prontas para análise — calculadas server-side com os mesmos métodos do gradebook.ITEM: enunciado. O tipo é detectado automaticamente: ≤ 10 inteiros únicos → categórico (gráfico de frequência); caso contrário → numérico (histograma).Aba Transversal
Análise de relações entre variáveis em um snapshot dos dados — todos os alunos em um mesmo momento. Use para responder perguntas do tipo "existe correlação entre INSE e nota do Quiz 1?" ou "qual turma teve melhor desempenho na AV1?".
Como usar
Detecção automática de gráfico
Aba Longitudinal
Evolução ao longo do tempo — novidade
A análise longitudinal usa o período como eixo temporal para ver como notas e indicadores contextuais evoluem ao longo dos bimestres ou trimestres. O sistema detecta automaticamente quais instrumentos/grupos formam séries temporais comparáveis.
Auto-detecção de séries longitudinais
O sistema identifica como "série longitudinal" qualquer instrumento ou grupo com o mesmo nome em dois ou mais períodos. A detecção funciona em dois níveis:
Nível do instrumento
"Quiz 1" no Trimestre 1 + "Quiz 1" no Trimestre 2 = série temporal "Quiz 1"
Aparecem no seletor como "Instrumentos"
Nível do grupo
"AV1" em múltiplos períodos = série "AV1" (usando a média de todos os instrumentos do grupo em cada período)
Aparecem no seletor como "Grupos (média)"
Três sub-abas disponíveis
Períodos Avaliativos
Evolução de notas de quizzes ou grupos ao longo dos bimestres/trimestres. Ideal para ver se a turma melhorou no Quiz 1 do 1º para o 2º trimestre.
Períodos de Contexto
Evolução de dados contextuais como INSE e SDQ ao longo das coletas. Essas coletas podem ter frequência diferente dos períodos avaliativos (ex.: uma coleta semestral vs. notas bimestrais).
Combinado
Para quando surveys de contexto foram aplicados dentro de períodos avaliativos. Correlaciona notas e dados de contexto no mesmo eixo temporal, mostrando se a associação entre INSE e desempenho muda ao longo do ano.
Gráficos automáticos baseados na seleção
1 variável selecionada→ Gráfico de linha — média ± desvio-padrão por período2 variáveis selecionadas→ Duas linhas paralelas OU scatter facetado por período (para ver se a correlação muda ao longo do tempo)+ Segmentar Por→ Linhas coloridas por categoria — ex.: uma linha por turma ou por escolaDicas de uso
10. Resposta Online pelo Aluno
Alunos respondem quizzes e surveys direto pelo celular, sem cartão físico
Como habilitar (professor)
Edite o instrumento
Clique no ícone de edição do instrumento na aba Avaliação.
Ative 'Permitir resposta online'
Toggle na aba de detalhes do instrumento. Pode ser ativado em qualquer tipo: numérico, quiz, survey ou personalizado.
Salve
O botão aparece automaticamente no dashboard do aluno.
Como responder (aluno)
Acesse o dashboard
O botão 'Responder Online' (ícone de globo, azul) aparece no bloco do instrumento.
Responda no modal
Numérico: campo de valor (0 até a máxima). Com questões: uma por tela com as opções.
Envie
Única submissão por instrumento. O botão vira o badge 'Enviado online'.
O que acontece com a resposta
Instrumento com questões
Respostas salvas em respostas_alunos (UPSERT) com flag __online: true. Aparece no relatório e no Hub Analítico.
Instrumento numérico
Além de respostas_alunos, a nota é lançada automaticamente em notas. O gradebook exibe o valor sem ação adicional do professor.
10. Relatórios
Documentos descritivos por turma ou comparativos
Tipos de Relatório
ClassReport (Descritivo)
Tabela com uma linha por aluno e uma coluna por instrumento. Inclui médias da turma e linha de totais por período.
IndividualReport
Ficha por aluno com notas detalhadas, respostas por questão, presença e nota final.
Comparar Múltiplas Turmas
Acesse /professor/relatorios
Clique em 'Comparar múltiplas turmas' para ativar o modo de seleção.
Marque as turmas com checkbox
Selecione 2 ou mais turmas da lista.
Clique em 'Comparar (N)'
O sistema abre /professor/relatorios/comparar com todas as turmas carregadas lado a lado.
Instrumentos de Contexto no ClassReport
Para instrumentos personalizados de contexto (com questões configuradas), o ClassReport expande em uma coluna por questão (fundo laranja claro). Para surveys INSE, há uma coluna extra "Grupo INSE" (fundo violeta) com score numérico e grupo.
Instrumento personalizado
Uma coluna por questão. Célula mostra a resposta do aluno (ex: 'Sim, duas').
INSE — Grupo
Score numérico (ex: 2,45) + Grupo INSE (ex: Grupo D) na mesma célula.
Gradebook
A célula do survey no diário também exibe o score e o Grupo INSE abaixo.