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

# Gestão de Certificados

> Configure templates de certificado, emissão automática e validação pública

## Certificados

Configure templates de certificado de conclusão para seus cursos. A plataforma suporta geração automática, campos dinâmicos posicionáveis e validação pública via código único.

## Templates de certificado

Cada curso pode ter seu próprio template de certificado com design personalizado.

### Criar um template

<Steps>
  <Step title="Acesse Admin → Certificados">
    Clique em "Novo template"
  </Step>

  <Step title="Associe a um curso">
    Selecione o curso que utilizará este template.
  </Step>

  <Step title="Upload das imagens">
    Faça upload da imagem de frente (obrigatória) e opcionalmente da imagem de verso.
  </Step>

  <Step title="Configure os campos">
    Posicione os campos dinâmicos sobre a imagem do certificado.
  </Step>

  <Step title="Ative a geração automática">
    Se desejar, habilite para que certificados sejam gerados automaticamente quando o aluno concluir o curso.
  </Step>
</Steps>

### Imagens do certificado

| Imagem     | Obrigatória | Dimensões padrão  |
| ---------- | ----------- | ----------------- |
| **Frente** | Sim         | 1056 x 816 pixels |
| **Verso**  | Não         | 1056 x 816 pixels |

### Campos dinâmicos

Os campos são posicionados visualmente sobre a imagem do certificado. Para cada campo, você configura:

| Propriedade          | Descrição                                          |
| -------------------- | -------------------------------------------------- |
| **Tipo**             | Nome do aluno, data de início ou data de conclusão |
| **Posição (X, Y)**   | Coordenadas em pixels sobre a imagem               |
| **Tamanho da fonte** | Em pixels                                          |
| **Família da fonte** | Ex: Arial, Times New Roman                         |
| **Cor**              | Cor do texto em hexadecimal                        |
| **Peso**             | Normal, bold ou valores numéricos (100-900)        |
| **Alinhamento**      | Esquerda, centro ou direita                        |
| **Largura**          | Largura da caixa de texto em pixels                |

<Info>
  O posicionamento dos campos é visual. Arraste e solte os campos sobre a imagem de preview para definir a posição exata.
</Info>

## Geração automática

Quando a opção `auto_generate` está ativada no template:

1. O aluno conclui todas as aulas do curso
2. O sistema detecta a conclusão automaticamente
3. Um certificado é gerado com os dados do aluno
4. O aluno recebe uma notificação informando que o certificado está pronto
5. Opcionalmente, um email é enviado com os detalhes

<Note>
  A geração automática depende do progresso do aluno. O curso precisa estar 100% concluído para acionar o certificado.
</Note>

## Validação pública

Cada certificado recebe um código único alfanumérico que pode ser usado para validação.

### Como validar

Qualquer pessoa pode verificar a autenticidade de um certificado:

1. Acesse a página pública de validação da plataforma
2. Insira o código do certificado
3. O sistema exibe os dados do certificado se for válido

### Informações exibidas na validação

* Nome do estudante
* Nome do curso
* Data de início e conclusão
* Código de validação
* Imagens do certificado (frente e verso)

### Segurança da validação

* A busca é feita por código (case-insensitive)
* Certificados revogados ou expirados retornam erro
* Rate limiting de 10 validações por IP por minuto para evitar abuso
* Acesso público (não requer autenticação)

## Status do certificado

| Status       | Descrição                                   |
| ------------ | ------------------------------------------- |
| **Gerado**   | Certificado válido e disponível             |
| **Revogado** | Certificado invalidado por um administrador |
| **Expirado** | Certificado com prazo de validade esgotado  |

### Revogar certificado

Administradores podem revogar um certificado quando necessário. A revogação registra:

* Quem revogou
* Quando revogou
* Motivo da revogação

## Notificação por email

Quando um certificado é gerado, o sistema pode enviar um email ao estudante contendo:

* Nome do aluno
* Nome do curso
* Data de conclusão
* Código de validação

O email utiliza o template `certificate_ready` configurável nos templates de email.

## Próximos passos

<CardGroup cols={2}>
  <Card title="Templates de email" icon="envelope-open-text" href="/pt-br/admin/email-templates">
    Personalize o email de certificado
  </Card>

  <Card title="Certificados (estudante)" icon="certificate" href="/pt-br/students/certificates">
    Veja como estudantes acessam certificados
  </Card>
</CardGroup>