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

# Módulo de Testes

> Crie, edite, importe e aplique testes e avaliações educacionais.

## Visão Geral

O módulo de Testes é o coração do AssessIQ. Aqui você gerencia todos os formulários de avaliação — desde criação manual até importação via JSON.

**Acesso:** Menu lateral → **Testes**

***

## Criar um Teste

Acesse **Testes → Criar Novo**.

### Informações Básicas

| Campo        | Descrição                               | Obrigatório |
| ------------ | --------------------------------------- | :---------: |
| Título       | Nome da avaliação                       |      ✅      |
| Descrição    | Texto descritivo (aparece no relatório) |      ❌      |
| Categoria    | Ex: Psicologia, Fonoaudiologia          |      ❌      |
| Tipo         | `TEST` ou Template                      |      ✅      |
| Público-alvo | Aluno ou Candidato                      |      ✅      |
| Publicado    | Disponível para aplicação               |      ✅      |

### Tipos de Questão

| Tipo              | Comportamento                        |
| ----------------- | ------------------------------------ |
| `TEXT`            | Campo de texto livre, sem pontuação  |
| `MULTIPLE_CHOICE` | Escolha única; cada opção tem pontos |
| `CHECKBOX`        | Múltipla seleção; pontos cumulativos |
| `SCALE`           | Escala numérica (1–5, 1–10, etc.)    |
| `SECTION`         | Divisor visual, não conta pontuação  |

### Seções

Você pode organizar questões em **seções** para criar formulários com múltiplos blocos temáticos. Cada questão pertence a uma seção via `sectionCode` e `sectionName`.

### Faixas de Pontuação (Score Ranges)

Configure intervalos para classificar automaticamente os resultados:

```json theme={null}
[
  { "min": 0,  "max": 30,  "label": "Abaixo do esperado", "color": "#EF4444" },
  { "min": 31, "max": 70,  "label": "Em desenvolvimento",  "color": "#F59E0B" },
  { "min": 71, "max": 100, "label": "Acima da média",      "color": "#10B981" }
]
```

***

## Importar via JSON

Você pode importar um teste inteiro a partir de um arquivo JSON estruturado.

**Acesso:** Testes → Importar JSON

### Formato Esperado

```json theme={null}
{
  "title": "Avaliação Funcional Completa",
  "description": "Avaliação detalhada do perfil funcional",
  "category": "Psicologia",
  "sections": [
    {
      "code": "S1",
      "name": "Habilidades Motoras",
      "questions": [
        {
          "text": "A criança consegue segurar um lápis?",
          "type": "MULTIPLE_CHOICE",
          "required": true,
          "options": [
            { "text": "Sim, com autonomia",     "points": 3 },
            { "text": "Com auxílio",             "points": 1 },
            { "text": "Não consegue",            "points": 0 }
          ]
        }
      ]
    }
  ]
}
```

<Tip>
  Baixe templates de JSON prontos na própria tela de importação para usar como base.
</Tip>

***

## Aplicar um Teste

**Acesso:** Testes → Aplicar Teste

1. Selecione o teste a ser aplicado
2. Selecione o destinatário (Aluno ou Candidato), ou marque como **público** (sem destinatário)
3. Defina a data de expiração (opcional)
4. Clique em **Gerar Link**
5. Copie o link único gerado e envie ao respondente

O link leva o respondente a uma página pública sem necessidade de login.

***

## Templates

Templates são testes marcados com `isTemplate: true`. Eles ficam disponíveis para **duplicação** sem precisar recriar as questões do zero.

**Acesso:** Testes → Templates

Ao duplicar um template, uma cópia editável é criada com seu `authorId`.

***

## Testes Favoritos

Clique na estrela (⭐) em qualquer teste para favoritá-lo. Os favoritos aparecem no topo da listagem.