> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skillfactory.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Criando Simulados

> Como criar e configurar avaliacoes com questoes de multipla escolha e dissertativas

## Simulados e avaliacoes

Crie avaliacoes completas para testar o conhecimento dos estudantes. A plataforma suporta questoes de multipla escolha com correcao automatica e questoes abertas (dissertativas) com correcao manual pelo professor.

## Criando um simulado

<Steps>
  <Step title="Acesse a lista de simulados">
    No menu lateral, clique em **Simulados**. Voce vera a lista de todos os simulados existentes com titulo, curso vinculado, numero de questoes e status.
  </Step>

  <Step title="Clique em Novo simulado">
    Preencha as informacoes basicas: titulo, descricao e selecione o curso ao qual o simulado sera vinculado.
  </Step>

  <Step title="Configure as regras">
    Defina tempo limite, numero de tentativas, nota minima para aprovacao e demais opcoes de comportamento.
  </Step>

  <Step title="Adicione questoes">
    Crie questoes de multipla escolha ou dissertativas. Cada questao tem um valor em pontos.
  </Step>

  <Step title="Publique">
    Ative o simulado para que os estudantes possam acessa-lo. Voce pode agendar a disponibilidade para uma data futura.
  </Step>
</Steps>

## Campos do simulado

Ao criar ou editar um simulado, voce configura os seguintes campos:

| Campo                          | Descricao                                                    |
| ------------------------------ | ------------------------------------------------------------ |
| **Titulo**                     | Nome do simulado exibido para os estudantes                  |
| **Descricao**                  | Texto explicativo sobre o conteudo avaliado                  |
| **Curso**                      | Curso ao qual o simulado esta vinculado                      |
| **Categoria**                  | Classificacao tematica do simulado                           |
| **Nivel de dificuldade**       | Facil, medio ou dificil                                      |
| **Tipo**                       | `multipla_escolha`, `resposta_aberta` ou `diversos` (misto)  |
| **Tempo (minutos)**            | Limite de tempo para conclusao. Deixe vazio para sem limite  |
| **Minimo de acertos**          | Quantidade minima de acertos para aprovacao                  |
| **Maximo de tentativas**       | Quantas vezes o estudante pode refazer. Vazio para ilimitado |
| **Intervalo entre tentativas** | Tempo minimo em minutos entre uma tentativa e outra          |
| **Mostrar resultado imediato** | Se o estudante ve o resultado logo apos finalizar            |

### Agendamento e expiracao

Voce pode controlar quando o simulado fica disponivel:

| Campo                   | Descricao                                      |
| ----------------------- | ---------------------------------------------- |
| **Simulado aberto**     | Se esta acessivel para estudantes agora        |
| **Agendado**            | Se tem data programada para abrir              |
| **Data de agendamento** | Quando o simulado sera aberto automaticamente  |
| **Data de expiracao**   | Quando o simulado sera fechado automaticamente |
| **Tags**                | Etiquetas para organizacao e busca             |

<Info>
  Simulados agendados ficam visiveis na lista do estudante com a indicacao de quando estarao disponiveis, mas nao podem ser iniciados antes da data.
</Info>

## Tipos de questoes

### Multipla escolha

Questoes objetivas com uma ou mais alternativas corretas.

Para cada questao de multipla escolha, voce define:

* **Enunciado** - Texto da questao (suporta formatacao rica via editor Lexical)
* **Alternativas** - Lista de opcoes com texto
* **Resposta(s) correta(s)** - Marque quais alternativas sao corretas
* **Valor** - Pontuacao da questao

A correcao e **automatica**: o sistema compara as respostas do estudante com o gabarito e calcula a nota imediatamente.

### Questoes abertas (dissertativas)

Questoes que exigem resposta escrita do estudante.

Para cada questao aberta, voce define:

* **Enunciado** - Texto da questao (editor Lexical com formatacao rica)
* **Valor** - Pontuacao maxima da questao

A correcao e **manual**: o professor precisa avaliar cada resposta individualmente, atribuir nota e fornecer feedback.

<Note>
  O editor de enunciado utiliza o Lexical e armazena o conteudo como JSON estruturado, permitindo formatacao rica com negrito, italico, listas, links e imagens.
</Note>

### Tipo diversos (misto)

Simulados do tipo `diversos` permitem combinar questoes de multipla escolha e dissertativas no mesmo simulado. Questoes objetivas sao corrigidas automaticamente e questoes abertas aguardam correcao manual.

## Ciclo de vida de uma tentativa

Quando o estudante inicia um simulado, a tentativa passa pelos seguintes estados:

```
Iniciar → Em andamento → Finalizar
                       → Abandonar (timeout ou desistencia)
```

1. **Iniciar** - O estudante clica em "Iniciar simulado". Uma tentativa e criada com status `em_andamento` e o cronometro comeca (se houver tempo limite)
2. **Responder** - O estudante responde as questoes. As respostas sao salvas progressivamente
3. **Finalizar** - O estudante clica em "Finalizar" ou o tempo expira. A tentativa recebe status `finalizado` e a nota e calculada
4. **Abandonar** - Se o estudante sai sem finalizar e o tempo expira, a tentativa recebe status `abandonado`

<Warning>
  Se o simulado tem tempo limite, o cronometro continua mesmo que o estudante feche o navegador. Ao voltar, o tempo restante sera o que sobrou.
</Warning>

## Resultado e estatisticas

Quando `mostrar_resultado_imediato` esta ativo, apos finalizar a tentativa o estudante ve:

* **Nota obtida** - Pontuacao total
* **Total de acertos** - Quantidade de questoes corretas (para multipla escolha)
* **Posicao no ranking** - Comparacao com outros estudantes
* **Media geral** - Media de todos os participantes
* **Total de participantes** - Quantos estudantes ja fizeram
* **Taxa de acerto por questao** - Percentual de acerto em cada questao

## Dicas para criar bons simulados

<Tabs>
  <Tab title="Multipla escolha">
    * Escreva enunciados claros e sem ambiguidade
    * Crie alternativas plauseis (evite opcoes obviamente erradas)
    * Varie a posicao da resposta correta
    * Inclua entre 4 e 5 alternativas por questao
    * Use o campo de categoria para organizar questoes por tema
  </Tab>

  <Tab title="Dissertativas">
    * Defina criterios de avaliacao claros no enunciado
    * Especifique o que espera na resposta (extensao, formato)
    * Use o valor da questao proporcionalmente a complexidade
    * Considere compartilhar a rubrica de avaliacao com os estudantes
  </Tab>
</Tabs>

<Tip>
  Use simulados com `intervalo_tentativas_minutos` para incentivar o estudo entre tentativas. Um intervalo de 24 horas (1440 minutos) entre tentativas faz com que o estudante revise o conteudo antes de tentar novamente.
</Tip>

## Proximos passos

<CardGroup cols={2}>
  <Card title="Corrigir questoes" icon="pen-to-square" href="/pt-br/teachers/grading">
    Avalie respostas dissertativas e forneca feedback
  </Card>

  <Card title="Analytics" icon="chart-line" href="/pt-br/teachers/analytics">
    Veja metricas de desempenho dos simulados
  </Card>
</CardGroup>
