Central de Ajuda

Início Rápido

Comece a usar o QuizLab em menos de 1 minuto. Não precisa de cadastro, instalação ou conexão permanente com a internet.

Opção A Importar um simulado pronto

Baixe o arquivo de exemplo (.json), clique em "Começar Agora" e arraste o arquivo para a área de upload. Você também pode selecionar um ou múltiplos arquivos pelo botão.

Opção B Criar do zero

Na tela inicial, clique em "Criar Simulado". Preencha o título, adicione questões com suas alternativas e marque a resposta correta em cada uma. Ao terminar, exporte para a biblioteca ou para um arquivo .json.

Modos de Jogo

Ao iniciar um simulado salvo na biblioteca ou após importar um arquivo, você escolhe o modo e as opções de embaralhamento.

Modo Estudo

Após confirmar cada resposta, o sistema mostra imediatamente se você acertou ou errou, destacando a alternativa correta em verde e a errada em vermelho. O progresso é salvo automaticamente se sair da página, pode retomar de onde parou pela biblioteca. Ideal para aprender e revisar conteúdo.

Modo Exame

Sem feedback durante o simulado, igual a uma prova real. O resultado completo aparece apenas ao finalizar. Se o simulado tiver um campo tempoLimiteMinutos definido no JSON, o cronômetro ativa automaticamente. Caso contrário, o tempo é calculado em 2 minutos por questão. Quando o timer chega a zero, o quiz é finalizado e o resultado é exibido com o que foi respondido até então.

Embaralhamento

Nas opções de início você pode ativar, de forma independente, o embaralhamento da ordem das questões e o embaralhamento das alternativas de cada questão. Ambos são aplicados a cada nova tentativa.

Durante o Quiz

Navegar entre questões

Use os botões "Anterior" e "Próxima" ou clique diretamente em qualquer número na grade de progresso. Você pode revisitar qualquer questão já visitada antes de confirmar a resposta.

Confirmar resposta

Após selecionar uma alternativa (ou o número correto delas, em múltipla escolha), clique em "Confirmar". No Modo Estudo, o gabarito aparece imediatamente. Uma vez confirmada, a resposta não pode ser alterada.

Marcar questões (Flag)

Clique no ícone de bandeira em qualquer questão para marcá-la para revisão posterior. As questões marcadas aparecem em destaque na tela de resultado, facilitando a revisão do gabarito.

Tela de Revisão antes de finalizar

Ao clicar em "Finalizar" na última questão, o sistema exibe a lista de todas as questões que ainda não foram confirmadas. Você pode voltar e responder cada uma ou finalizar mesmo assim. Questões sem resposta confirmada aparecem como "NÃO VIU" no resultado.

Retomar uma sessão salva

Se você fechar o navegador durante o Modo Estudo, o progresso é preservado. Na próxima vez que abrir a biblioteca, o card do simulado exibirá um botão "Retomar". Clicar nele restaura exatamente o estado anterior, incluindo respostas confirmadas e posição atual.

Criador de Simulados

O criador funciona em dois passos sequenciais.

Passo 1 Dados gerais

Informe o título (obrigatório), descrição, tags de busca separadas por vírgula e, opcionalmente, um limite de tempo em minutos. Clique em "Confirmar" para avançar. Você pode voltar e editar os dados gerais a qualquer momento clicando em "Editar".

Passo 2 Questões

Cada questão precisa de um enunciado, tipo (única ou múltipla escolha), ao menos 2 alternativas e ao menos uma alternativa marcada como correta via checkbox. Use arrastar e soltar para reordenar as questões.

Exportar e Salvar

Clique em "Exportar". O sistema oferece duas opções: salvar na biblioteca local (acesso rápido sem precisar de upload) ou baixar como arquivo .json para guardar no computador e compartilhar.

Editar um simulado existente

Na biblioteca, clique no ícone de lápis de qualquer card para abrir o simulado no criador com todos os dados já preenchidos. Ao exportar novamente, você escolhe entre atualizar a versão na biblioteca ou apenas baixar o arquivo.

Formato do Arquivo JSON

Se preferir criar o arquivo manualmente ou integrar com outras ferramentas, use esta estrutura:

{
  "nomeSimulado": "Título do Simulado",
  "descricao": "Descrição opcional",
  "tags": ["matematica", "enem"],
  "tempoLimiteMinutos": 60,
  "questoes": [
    {
      "id": 1,
      "enunciado": "Qual a capital do Brasil?",
      "tipo": "unica",
      "alternativas": [
        { "id": "a", "texto": "São Paulo" },
        { "id": "b", "texto": "Brasília" },
        { "id": "c", "texto": "Rio de Janeiro" }
      ],
      "respostasCorretas": ["b"]
    },
    {
      "id": 2,
      "enunciado": "Quais são números primos? (marque 2)",
      "tipo": "multipla",
      "alternativas": [
        { "id": "a", "texto": "2" },
        { "id": "b", "texto": "4" },
        { "id": "c", "texto": "7" },
        { "id": "d", "texto": "9" }
      ],
      "respostasCorretas": ["a", "c"]
    }
  ]
}

Regras de validação

O sistema valida o arquivo antes de qualquer operação. Os requisitos são:

• nomeSimulado e questoes são obrigatórios.
• Cada questão deve ter id, enunciado, tipo, alternativas (mínimo 2) e respostasCorretas (mínimo 1).
• Para tipo: "unica", respostasCorretas deve conter exatamente 1 elemento.
• Todos os IDs em respostasCorretas devem existir em alternativas.
• tempoLimiteMinutos é opcional. Se ausente, o timer do Modo Exame é calculado como questões × 2 minutos.
• respostasCorretas deve ser sempre um array, mesmo para questão de única escolha.

Importação em massa

Você pode selecionar ou arrastar múltiplos arquivos .json de uma só vez. O sistema processa cada arquivo individualmente e exibe um relatório final com: salvos com sucesso, ignorados (duplicatas idênticas já na biblioteca), conflitos (mesmo nome mas conteúdo diferente) e falhas de validação.

Biblioteca Local

A biblioteca salva simulados diretamente no armazenamento do seu navegador (localStorage). Nenhum dado é enviado para servidores.

Capacidade de armazenamento

Não há um limite fixo de simulados. A biblioteca pode armazenar até 4 MB de dados (quota segura do localStorage). Um indicador circular no topo da tela mostra o percentual de uso em tempo real: neutro abaixo de 70%, amarelo entre 70% e 85%, e vermelho acima de 85%. Quando o uso projetado ultrapassa 85%, novas importações são bloqueadas e uma mensagem de aviso é exibida.

Busca e ordenação

Use o campo de busca para filtrar simulados por título, descrição ou tags. O menu de ordenação permite organizar por mais recentes, mais antigos, ordem alfabética ou número de questões.

Editar

Clique no ícone de lápis de qualquer card para abrir o simulado no criador com todos os dados preenchidos.

Exclusão em massa

Clique em "Selecionar" para ativar o modo de seleção em massa. Marque os cards desejados e clique em "Excluir Selecionados". A operação é confirmada antes de executar.

Histórico de desempenho

Cada card exibe sua média de acertos e o número de partidas jogadas. Na tela de resultado, o histórico das últimas 10 tentativas é exibido com data, pontuação e percentual de acerto.

Revisão de Erros

O QuizLab rastreia automaticamente as questões que você erra em cada simulado salvo na biblioteca e permite criar um simulado de revisão focado nas suas dificuldades.

Como o rastreamento funciona

Ao finalizar qualquer partida de um simulado salvo na biblioteca, o sistema registra as questões respondidas incorretamente. Questões acertadas são removidas do banco de erros. O histórico de erros acumula até 65 questões por simulado.

Acessar a aba Revisão

Na biblioteca, clique na aba "Revisão" (ao lado de "Simulados"). Um badge numérico indica o total de questões com erro disponíveis em todos os seus simulados. A aba lista cada simulado com o respectivo número de erros registrados.

Configurar e iniciar a revisão

Marque os simulados cujos erros você quer revisar. Use o slider para definir quantas questões incluir (até o máximo disponível nas fontes selecionadas). Clique em "Iniciar Revisão". As questões são embaralhadas e apresentadas em um simulado temporário.

O que acontece ao finalizar

O simulado de revisão é temporário e não aparece na biblioteca. Ao finalizar, o sistema distribui os resultados de volta para cada simulado de origem: questões acertadas são removidas do banco de erros, e questões erradas têm seu contador incrementado. No resultado, um botão "Ver Revisão" leva você de volta à aba.

Perguntas Frequentes

O botão "Confirmar" não aparece ou está desabilitado

Em questões de múltipla escolha, você precisa selecionar exatamente o número de alternativas indicado no enunciado nem mais, nem menos. O aviso "(SELECIONE EXATAMENTE X)" indica quantas você deve marcar.

Meu arquivo JSON dá erro de validação

Verifique se o arquivo começa com { e termina com }, sem vírgulas sobrando no final de listas. Confira se todos os campos obrigatórios estão presentes e se os IDs em respostasCorretas coincidem exatamente com os IDs das alternativas. Use o JSONLint para validar a sintaxe.

Posso usar offline?

Sim. Após carregar a página uma vez com conexão, toda a lógica fica disponível offline. A única exceção é o carregamento das fontes do Google Fonts em modo offline, o sistema usa fontes de fallback e os ícones podem ter aparência diferente.

Como compartilhar um simulado?

Use o botão de download (ícone de seta para baixo) no card da biblioteca para exportar o arquivo .json e envie para outra pessoa. Ela importa da mesma forma que você, arrastando o arquivo ou selecionando pelo botão.

Posso importar vários arquivos de uma vez?

Sim. Selecione múltiplos arquivos no seletor de arquivo ou arraste vários ao mesmo tempo para a área de upload. O sistema processa cada um individualmente e exibe um relatório de resultado.

O timer do Modo Exame não apareceu

O timer só ativa no Modo Exame. Se o simulado não tiver o campo tempoLimiteMinutos no JSON, o tempo é calculado automaticamente como número de questões × 2 minutos. Certifique-se de ter selecionado "Modo Exame" nas opções de início.

A aba Revisão está vazia

O banco de erros só é preenchido ao finalizar partidas de simulados salvos na biblioteca. Se você acabou de importar um simulado sem salvá-lo, ou se ainda não completou nenhuma partida, a aba ficará vazia até que você finalize ao menos uma tentativa.

Meus dados estão seguros?

Todos os dados (simulados, histórico, erros) ficam exclusivamente no seu navegador via localStorage. Nenhuma informação é enviada para servidores externos. Por isso, limpar o cache ou trocar de navegador apaga os dados sempre exporte os simulados importantes.

Limites e Especificações