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)
Avaliação formativa por oportunidade — além do 'aluno destaque'
Por que o sistema RPG existe?
O sistema RPG não é gamificação cosmética. É um instrumento de avaliação formativa que registra, por dimensão separada, em quais oportunidades pedagógicas específicas cada aluno participou — de forma rastreável, por data, com contexto retroativo.
O problema com “aluno destaque” no Conselho de Classe
O rótulo “destaque” mistura indiscriminadamente: desempenho acadêmico, comportamento escolarizante (obediência, silêncio), visibilidade social (participação verbal, carisma) e fatores familiares. Pesquisa educacional brasileira documenta forte correlação entre percepção de “destaque” e INSE do aluno — estudantes de maior nível socioeconômico exibem naturalmente os comportamentos que a escola valoriza como mérito. O viés racial é consequência estrutural dessa correlação. O resultado: o Conselho de Classe frequentemente reafirma desigualdades em vez de identificar capacidades reais.
Além disso, avaliar comportamento de forma composta (um único rótulo) mascara perfis distintos: um aluno que entrega todas as atividades mas é quieto não aparece como “destaque” — e o Conselho não consegue distingui-lo do aluno que não entrega nada.
O que o PCT por categoria resolve
Ao separar as categorias de XP (Atividade/Tarefa, Quadro/Caderno do dia, Atitude positiva, Livre), o sistema revela perfis que o rótulo composto esconde:
| Perfil | Atividade | Quadro/Caderno | Atitude positiva | O que o rótulo único esconde |
|---|---|---|---|---|
| Engajamento acadêmico silencioso | 95% | 90% | 40% | Produz consistentemente mas não aparece no Conselho |
| Engajamento social sem entrega | 45% | 30% | 90% | Aparece como 'participativo' mas não conclui tarefas |
| Irregular mas consistente quando presente | 80% | 75% | 70% | Faltas mascaram o potencial — o PCT filtra pelo denominador real |
XP Bruto por período
Volume de participação acumulada no período. Usado para calcular a nota RPG no boletim e para o nível do aluno. O professor distribui livremente — sem teto fixo.
PCT por categoria
Consistência de participação em cada dimensão: Atividade, Quadro/Caderno, Atitude Positiva, Livre. Calculado sobre as oportunidades reais disponíveis para aquele aluno naquele período — não sobre o total da turma.
Nota RPG no boletim
Conversão automática do XP bruto em nota curricular. Usa a média da turma como referência: quem está na média recebe a nota máxima. Quem está abaixo, recebe proporcionalmente.
Como o PCT por categoria é calculado
O percentual responde à pergunta: “das oportunidades que estavam disponíveis para este aluno, em quantas ele participou?” — não “quantas vezes recebeu em relação à turma toda”.
| Situação do aluno na data da oportunidade | Entra no denominador? | Entra no numerador? |
|---|---|---|
| Presente + recebeu XP | Sim | Sim |
| Presente + não recebeu (oportunidade perdida) | Sim | Não |
| Ausente + professor validou retroativamente (recuperou) | Sim | Sim |
| Ausente + não recuperou | Não | Não |
| Data antes da matrícula do aluno na turma | Não | Não |
| Aula sem chamada registrada (professor não lançou chamada) | Não (exceto se recuperou) | — |
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), categoria, quantidade e — se necessário — uma data retroativa.
Consulte o histórico de oportunidades
O painel mostra automaticamente todas as categorias e datas já lançadas para aquela turma. Clique em uma linha para preencher os campos — útil para lançamentos retroativos.
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
- 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
No Hub Analítico — cruzar com INSE
Arraste % Cumprimento: Atividade no eixo Y e Grupo INSE no eixo X para verificar se os percentuais de participação têm correlação com o nível socioeconômico — um sinal de viés na distribuição de XP.
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
Aba Frequência
Análise de presença dos alunos ao longo do tempo. Selecione uma turma específica no filtro superior para ativar esta aba.
Aba Mapas
Visualização geográfica de qualquer variável do Hub. Requer que os alunos tenham preenchido um instrumento de Geolocalização.
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 cabeçalho colorido, instrumentos organizados dentro de seus grupos avaliativos (com nota do grupo em badge verde/âmbar/vermelho), presença detalhada dia a dia, XP por categoria com oportunidades não aproveitadas (ghost logs) e comentário do professor. Gera link público sem login para compartilhar com responsáveis.
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.
11. YouDraw — Vídeos e Sketchbook
Biblioteca de vídeos e espaço de criação artística para os alunos
O YouDraw é o módulo criativo do Gestor de Sala de Aula. Ele tem duas partes: uma biblioteca de vídeos do YouTube que você publica para suas turmas, e um sketchbook pessoal onde cada aluno desenha livremente com a própria ferramenta de criação da plataforma.
Biblioteca de vídeos
Publique links do YouTube por turma ou por aluno específico. Os alunos assistem diretamente na plataforma, sem sair para o YouTube. Ideal para videoaulas, tutoriais e conteúdos de apoio.
Comentários por turma
Cada vídeo tem um painel de comentários da turma. Os alunos comentam suas dúvidas e percepções; o comentário fica visível para todos da turma no painel lateral do vídeo. Aparece um contador no card do vídeo para indicar que há conversa.
Ferramenta de desenho profissional
Cada aluno tem um sketchbook pessoal com ferramenta de desenho completa: lápis, pincel suave, marcador, spray, borracha, formas geométricas, conta-gotas, simetria horizontal, zoom com pinça no celular, desfazer/refazer e download em PNG.
Galeria — Meu Sketchbook
Os desenhos são salvos com prévia miniatura. O aluno pode rever todos os seus trabalhos, continuar um desenho salvo ou excluir o que quiser. Cada desenho tem nome e fica registrado no banco.