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

# Gestão de eventos

> Crie e gerencie eventos públicos, códigos de acesso privado, inscrições, check-in e autorizações de retirada no DMGTTRANS.

Perfis com permissão de **Administrador** e **Supervisor** acessam esta área. No menu lateral, vá em **Administração > Eventos**.

Esta tela centraliza a criação de eventos, o acompanhamento de inscrições e a gestão de acessos restritos. Os cidadãos interagem com os eventos pelo [Portal do Cidadão](https://dmgttrans.mintlify.site/portais/cidadao.md). Também há o [Portal de Eventos](https://dmgttrans.mintlify.site/portais/eventos.md) para atividades próprias do evento.

## Eventos cadastrados

A tela inicial lista todos os eventos em uma tabela com as colunas:

| Coluna | Conteúdo |
| - | - |
| **Nome** | Nome do evento |
| **Slug** | Identificador curto usado na URL pública |
| **Status** | **Ativo** ou **Inativo** |
| **Inscrições** | Públicas (com limite, se houver), privadas e total |
| **Ações** | Atalhos para gerenciar o evento |

### Ações disponíveis por evento

Cada linha exibe botões de ação:

* **Ver inscrições** (ícone de usuários): abre a lista de inscritos.
* **Copiar link público**: copia a URL do evento para a área de transferência.
* **Abrir página pública**: abre o evento em nova aba.
* **Gerenciar códigos de acesso** (aparece se **Inscrições privadas por código** estiver ativa): lista os lotes e códigos.
* **Copiar link de autorização de retirada** e **Abrir página de autorização** (aparecem se **Autorização de retirada por terceiro** estiver ativa).
* **Editar**: abre o formulário do evento.
* **Excluir**: remove permanentemente o evento e todas as inscrições, exigindo confirmação de senha.

> [!WARNING]
>
> A exclusão é irreversível. Para confirmar, digite sua senha no diálogo.

## Criar ou editar evento

Clique em **Novo Evento** ou no botão **Editar** de um evento existente.

### Dados básicos

| Campo | Obrigatório | Descrição |
| - | - | - |
| **Nome do evento** | Sim | Título visível ao público |
| **Slug** | Sim | Identificador da URL (`/eventos/{slug}`) |
| **Descrição** | Não | Texto com formatação HTML exibido na página pública |
| **Início do evento** | Não | Data e hora de início |
| **Término do evento** | Não | Data e hora de encerramento |

### Inscrições

| Campo | Descrição |
| - | - |
| **Abertura das inscrições** | Data e hora em que o público pode começar a se inscrever |
| **Encerramento das inscrições** | Data e hora limite para novas inscrições |
| **Limitar inscrições** | Ative e informe o número máximo de inscrições públicas |
| **Permitir duplicatas** | Permite que o mesmo CPF se inscreva mais de uma vez |

### Campos do formulário público

Na seção **Campos do formulário**, monte a ficha de inscrição:

**1. Adicione da biblioteca**

Use o seletor **Adicionar da biblioteca** para incluir campos já existentes.

**2. Crie novo campo**

Clique em **Novo Campo**, informe nome, identificador técnico e tipo (Texto, CPF/CNPJ, Email, Telefone, Data, Hora, Seleção única, Múltipla escolha, Foto, Documento, entre outros).

**3. Organize**

Marque **Obrigatório** quando aplicável, mova para cima ou para baixo com as setas, e remova campos desnecessários.

> [!NOTE]
>
> Campos de **CPF/CNPJ** podem ser usados como campo de validação de duplicidade e como destinatário do email de confirmação.

### Configurações adicionais

* **Evento ativo**: eventos inativos não aparecem no portal público.
* **Inscrições privadas por código**: ativa o uso de códigos de acesso por lote. Requer gestão em outra tela.
* **E-mail de confirmação**: envia email ao inscrito com um link de formulário. Defina assunto, HTML, e o campo que recebe o email.
* **Autorização de retirada por terceiro**: permite que o inscrito autorize outra pessoa a retirar o kit. Configure o texto da página pública e o modelo de email enviado.

## Inscrições

Acesse as inscrições pelo botão **Ver inscrições** na lista de eventos ou pelo caminho direto no menu.

### Visão geral

O topo da tela mostra o total de inscritos ativos, separados entre:

* **Com check-in**: já registraram presença
* **Sem check-in**: ainda não passaram pela validação
* **Cancelados**: não entram no total ativo

### Filtros

Abaixo dos totais, use os filtros rápidos:

* **Check-in**: Todos, Com check-in, Sem check-in
* **Buscar por CPF ou nome**
* **Faixa numérica**: do número X até o número Y da sequência de inscrição
* **Intervalo de datas**: inscritos entre duas datas

### Exportar e reenviar emails

* **Exportar CSV**: baixa a planilha com todos os inscritos filtrados.
* **Reenviar emails falhados**: inicia o reenvio para inscrições cujo email de confirmação não foi entregue. O botão fica indisponível se já houver um reenvio em andamento.

### Ações por inscrição

Cada linha da tabela permite:

* **Reenviar email**: envia manualmente a mensagem de confirmação.
* **Cancelar inscrição**: exige confirmação de senha. Após o cancelamento, a inscrição continua visível mas marcada como cancelada.
* **Check-in**: registra a presença do inscrito vinculando sua identificação ao registro.

### Status do email de confirmação

| Status | Significado |
| - | - |
| **Enviado** | Email entregue com sucesso |
| **Falhou** | Houve erro na entrega; pode ser reenviado |
| **Pendente** | Aguardando envio |
| **Não enviado** | Sem tentativa de envio |

## Códigos de acesso

Disponível para eventos com **Inscrições privadas por código** ativadas.

### Lotes de códigos

Códigos são organizados por lotes:

**1. Criar lote**

Clique em **Novo lote de códigos**, informe o **Nome do lote** e a **Quantidade** (de 1 a 500 códigos). O sistema gera códigos únicos automaticamente.

**2. Adicionar mais códigos**

Em um lote existente, use a opção **Adicionar códigos** para expandir o lote com novos códigos.

**3. Compartilhar**

Copie o link direto de um código para enviar ao convidado. O link leva à página de inscrição do evento com o código preenchido.

**4. Cancelar**

Códigos ainda não utilizados podem ser cancelados. Se já houver inscrição vinculada, a ação exige confirmação de senha.

A tabela de códigos mostra:

| Coluna | Significado |
| - | - |
| **Código** | Valor oculto; clique no olho para revelar |
| **Status** | **Disponível** ou **Utilizado** |
| **Inscrição** | Link para ver o inscrito, quando utilizado |
| **Ações** | Copiar link ou cancelar |

## Autorizações de retirada

Disponível para eventos com **Autorização de retirada por terceiro** ativada. Acesse pela tela de inscrições ou pelo link direto no menu.

### Como funciona

O inscrito recebe por email um link seguro para informar o nome e o CPF da pessoa autorizada a retirar o kit. O link expira em poucas horas e só pode ser usado uma vez. Se o procedimento for refeito, a autorização anterior é substituída.

### Consulta no dia do evento

Na tela de autorizações:

* Use a **busca por CPF ou nome** para conferir rapidamente se o inscrito autorizou alguém.
* Para cada autorização vigente, são exibidos: nome e CPF do inscrito, nome e CPF do autorizado, telefone (se informado), e data do registro.
* Autorizações substituídas ficam no **Histórico de substituições**, mantidas apenas para auditoria.

> [!TIP]
>
> No dia do evento, deixe esta tela aberta no check-in para consulta rápida.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.