> ## 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.

# Quickstart

> Crie seu primeiro teste e aplique para um aluno em menos de 10 minutos.

## Pré-requisitos

* Conta criada na plataforma com role `PROFESSOR`, `ADMIN` ou `SUPER_ADMIN`
* Pelo menos um aluno cadastrado

***

## Passo 1 — Faça login

Acesse a plataforma e entre com e-mail e senha (ou Google OAuth se configurado).

Após o login, você será redirecionado para o **Dashboard** onde os KPIs principais já aparecem:

* Testes criados
* Alunos cadastrados
* Testes concluídos (Professores veem apenas os seus próprios)

***

## Passo 2 — Crie um Teste

<Steps>
  <Step title="Acesse Testes → Criar">
    No menu lateral, clique em **Testes → Criar novo teste**.
  </Step>

  <Step title="Preencha as informações básicas">
    * **Título**: nome do teste (ex.: "Avaliação Funcional - Trimestre 1")
    * **Descrição**: opcional, aparece no relatório
    * **Categoria**: ex. "Psicologia", "Educação"
    * **Tipo**: `TEST` (padrão) ou template reutilizável
    * **Público-alvo**: Aluno ou Candidato
  </Step>

  <Step title="Adicione questões">
    Clique em **+ Adicionar Questão** e escolha o tipo:

    | Tipo              | Descrição                   |
    | ----------------- | --------------------------- |
    | `TEXT`            | Resposta aberta             |
    | `MULTIPLE_CHOICE` | Escolha única com pontuação |
    | `CHECKBOX`        | Múltipla escolha            |
    | `SCALE`           | Escala numérica             |
    | `SECTION`         | Separador de seções         |

    Para questões de múltipla escolha, defina **pontos por opção**.
  </Step>

  <Step title="Configure as faixas de pontuação">
    Em **Configurações de Score**, defina faixas como:

    * 0–30: "Abaixo do esperado"
    * 31–70: "Em desenvolvimento"
    * 71–100: "Acima da média"

    Essas faixas aparecem no relatório PDF gerado ao final.
  </Step>

  <Step title="Publique o teste">
    Clique em **Publicar** para tornar o teste disponível para aplicação.
  </Step>
</Steps>

***

## Passo 3 — Aplique o Teste a um Aluno

<Steps>
  <Step title="Acesse Testes → Aplicar">
    Clique em **Aplicar Teste** no menu lateral ou no botão de ação do teste criado.
  </Step>

  <Step title="Selecione o teste e o aluno">
    Escolha o teste publicado e selecione o aluno destinatário.

    Você também pode definir:

    * **Prazo de expiração** (em dias)
    * **Link público** — sem necessidade de destinatário específico
  </Step>

  <Step title="Copie o link único">
    O sistema gera um **token único** para aquela aplicação. Copie e envie ao aluno por qualquer meio (WhatsApp, e-mail, etc.).
  </Step>
</Steps>

***

## Passo 4 — Acompanhe e Veja o Relatório

Após o aluno completar o teste:

1. Acesse **Relatórios** no menu lateral
2. Localize a submissão pelo nome do aluno
3. Clique em **Ver Relatório** para visualização detalhada
4. Clique em **Exportar PDF** para baixar o relatório

<Note>
  Professores veem apenas as submissões dos seus próprios testes. Admins e Super Admins têm visão global.
</Note>

***

## Próximos Passos

<CardGroup cols={3}>
  <Card title="Importar via JSON" icon="file-import" href="/docs/modulos/testes">
    Importe testes inteiros a partir de arquivos JSON estruturados.
  </Card>

  <Card title="Gerenciar Alunos" icon="users" href="/docs/modulos/alunos">
    Cadastre perfis completos com dados familiares, plano e acesso à plataforma.
  </Card>

  <Card title="Notificações" icon="bell" href="/docs/admin/notificacoes">
    Configure templates de e-mail e notificações automáticas.
  </Card>
</CardGroup>