# Convites Digitais — Manual do Usuário

Este manual explica como **criar eventos, montar e enviar convites e acompanhar as respostas**. É para o **organizador da festa** e não exige conhecimento técnico. A seção 3 mostra o que o **convidado** vê ao abrir o link.

> A instalação e a manutenção do servidor ficam com o **administrador do sistema**. Quando algo depender dele, este manual avisa. As situações mais comuns estão na [seção 5](#5-quando-falar-com-o-administrador).

---

## Sumário

1. [Conceitos](#1-conceitos)
2. [Área do organizador](#2-área-do-organizador)
   - 2.1 [Entrar](#21-entrar) · 2.2 [Painel de eventos](#22-painel-de-eventos) · 2.3 [Criar um evento](#23-criar-um-evento)
   - 2.4 [Criar um convite](#24-criar-um-convite) · 2.5 [Enviar o convite](#25-enviar-o-convite) · 2.5.1 [Personalizar a mensagem do WhatsApp](#251-personalizar-a-mensagem-do-whatsapp)
   - 2.6 [Acompanhar as respostas](#26-acompanhar-as-respostas) · 2.7 [Editar um convite](#27-editar-um-convite) · 2.8 [Zerar as respostas](#28-zerar-as-respostas-de-um-convite)
   - 2.9 [Excluir um convite](#29-excluir-um-convite) · 2.10 [Editar ou excluir um evento](#210-editar-ou-excluir-um-evento) · 2.11 [PDFs dos convites](#211-pdfs-dos-convites)
   - 2.12 [Prazo de confirmação](#212-prazo-de-confirmação-como-funciona) · 2.13 [Bloquear um convite](#213-bloquear-um-convite)
3. [Experiência do convidado](#3-experiência-do-convidado)
4. [Perguntas frequentes](#4-perguntas-frequentes)
5. [Quando falar com o administrador](#5-quando-falar-com-o-administrador)

---

## 1. Conceitos

| Termo | Significado |
| --- | --- |
| **Evento** | A festa: nome, data, horário, local e endereço. Ex.: "1º Aniversário do Arthur" |
| **Convite** | Um link enviado para uma família/grupo. Tem um **nome exibido** (ex.: "Família Silva") e uma lista de convidados |
| **Convidado** | Cada pessoa do convite, marcada como **Adulto**, **Adolescente** ou **Criança** |
| **Tema** | Visual do convite (cores e ícones), escolhido por evento. Há temas infantis e temas para adultos e adolescentes |
| **Prazo de confirmação** | Data opcional do evento. Depois dela, quem não respondeu conta como ausente e o convite não aceita mais respostas |
| **Código do convite** | Sequência única no final do link (ex.: `.../r/Ab3xY9kL`). Funciona como a "chave" do convite |
| **RSVP / Status** | Resposta de cada convidado: ✓ **Presente**, ✗ **Ausente** ou ⏳ **Pendente** |

Um evento pode ter vários convites; cada convite pode ter vários convidados.

---

## 2. Área do organizador

### 2.1 Entrar

1. Acesse o endereço da área do organizador informado pelo administrador (ex.: `https://<seu-domínio>/admin`). Também há o link discreto **"Área do organizador"** no rodapé da página inicial.
2. Digite a senha do organizador, também fornecida pelo administrador, e clique em **Entrar**.

A sessão dura **7 dias** no mesmo navegador. No topo da página:

- **Sair** encerra a sessão neste navegador;
- **Sair de todos** encerra a sessão em todos os dispositivos (use se esqueceu o admin aberto em outro computador ou celular).

> 🔒 Depois de **5 senhas erradas em 15 minutos**, o login fica bloqueado por 15 minutos naquele endereço de internet. A mensagem na tela mostra quanto tempo falta.

**Mensagens da tela de login:**

| Mensagem | Significado |
| --- | --- |
| **Senha incorreta.** | A senha digitada não é a senha do organizador. Confira com o administrador |
| **Muitas tentativas incorretas. Tente novamente em N minutos.** | Bloqueio temporário após 5 erros. Durante o bloqueio, nem a senha certa é aceita |

**Sessão vencida:** depois de 7 dias, ou após **Sair de todos**, qualquer página do organizador volta para a tela de login. Basta entrar de novo.

**Página inicial do site:** é uma página neutra. Ela não lista eventos nem convites: só diz "Recebeu um convite? Abra o link que foi enviado para você" e tem o link discreto **Área do organizador**. Cada convite só é aberto pelo próprio link.

### 2.2 Painel de eventos

A tela inicial do organizador lista todos os eventos com:

- data, horário e local;
- quantidade de convites;
- resumo de presença: **Presentes** (com divisão adultos/adolescentes/crianças), **Ausentes** e **Pendentes**.

Clique em um evento para abrir os detalhes.

**Detalhes do painel:**

- **Ordem:** os eventos aparecem do de **data mais distante para o de data mais próxima** (os mais recentes ou futuros no topo).
- **Prazo de confirmação:** quando o evento tem prazo, a linha de informações mostra ⏰ **"até dd/mm/aaaa"** enquanto o prazo está aberto, ou 🔒 **"encerrado"** depois dele.
- **Divisão por idade:** a linha "N adultos · N adolescentes · N crianças" só aparece quando há pelo menos um presente.
- **Depois do prazo:** quem não respondeu passa a contar como **Ausente** nos totais (ver 2.12).
- **Sem eventos:** aparece "Nenhum evento cadastrado ainda." e o botão **+ Novo evento**.

### 2.3 Criar um evento

1. No painel, clique em **+ Novo evento**.
2. Preencha:
   - **Nome da festa** — ex.: "1º Aniversário do Arthur"
   - **Data** e **Horário**
   - **Local** — ex.: "Espaço Festa"
   - **Endereço** — ex.: "Rua das Flores, 100 - Belo Horizonte/MG"
   - **Prazo para confirmar** (opcional) — último dia para responder
   - **Tema do convite** — a prévia logo abaixo mostra as cores e os ícones escolhidos
   - **Texto do selo** e **Texto do rodapé** (opcionais) — em branco, usam o texto padrão do tema
   - **Imagem de fundo** (opcional) — JPG, PNG ou WebP, até **3 MB**. Aparece no topo do convite (no cartão com o nome da família), com um véu claro por cima para o texto continuar legível, e também no card de pré-visualização do WhatsApp. Para tirar a imagem, ao editar o evento, clique em **Remover imagem de fundo** e depois em **Salvar alterações**. Prefira fotos leves: no WhatsApp, cards com imagem muito pesada podem aparecer sem foto
   - **Mensagem do WhatsApp** (opcional) — texto enviado pelo botão **WhatsApp** de cada convite. Em branco, usa a mensagem padrão (ver [2.5.1](#251-personalizar-a-mensagem-do-whatsapp))
3. Clique em **Criar evento**. Você será levado à página do evento.

**Regras dos campos:**

| Campo | Regra |
| --- | --- |
| Nome, Data, Horário, Local, Endereço | Obrigatórios |
| Prazo para confirmar | Opcional. Não pode ser **depois** da data da festa. Vale **até o fim do dia** informado, no horário de Brasília |
| Texto do selo | Opcional, até **40** caracteres. Em branco, usa o selo do tema (tabela abaixo) |
| Texto do rodapé | Opcional, até **120** caracteres. Em branco, usa **"Feito com carinho · <nome da festa>"** |
| Mensagem do WhatsApp | Opcional, até **950** caracteres, contando o texto final já com as variáveis trocadas. O link do WhatsApp gerado com ela vai até **2300** caracteres. Aceita variáveis e a formatação do WhatsApp (ver 2.5.1) |

A prévia abaixo do campo **Tema** mostra, em tempo real:

- o selo com o ícone do tema;
- um título de exemplo ("Família Exemplo");
- o ícone separador;
- as seis cores da paleta;
- o rodapé com o texto digitado.

**Temas disponíveis:**

| Grupo | Tema | Selo padrão | Ícones (selo · separador) |
| --- | --- | --- | --- |
| Festas infantis | Safári | Safari Party | 🦁 · 🌿 |
| Festas infantis | Princesas | Reino Encantado | 👑 · ✨ |
| Festas infantis | Super-heróis | Super-Heróis | 🦸 · ⚡ |
| Festas infantis | Fundo do mar | Fundo do Mar | 🐳 · 🐚 |
| Festas infantis | Dinossauros | Dino Party | 🦖 · 🦕 |
| Festas infantis | Unicórnio | Mundo Mágico | 🦄 · 🌈 |
| Festas infantis | Astronauta | Missão Espacial | 🚀 · ⭐ |
| Festas infantis | Fazendinha | Fazendinha | 🐄 · 🌻 |
| Festas infantis | Futebol | Bola na Rede | ⚽ · 🏆 |
| Adultos e adolescentes | Clássico dourado | Celebração | 🥂 · ✨ |
| Adultos e adolescentes | Azul noturno | Noite de Festa | 🎉 · ✨ |
| Adultos e adolescentes | Rosé floral | Celebração | 💐 · 🌸 |
| Adultos e adolescentes | Boho verde sálvia | Encontro Especial | 🌿 · 🍃 |
| Adultos e adolescentes | Minimalista preto e branco | Vamos Celebrar | 🎈 · ✦ |
| Adultos e adolescentes | Balada neon | Bora Curtir | 🎧 · 🎶 |

O ícone do selo também é usado na mensagem pronta do botão **WhatsApp** (variável `{icone}`) e no card de pré-visualização.

**Mensagens de erro do formulário:**

| Mensagem | Causa |
| --- | --- |
| **Preencha todos os campos.** | Falta nome, data, horário, local ou endereço |
| **Data ou horário inválido.** | Data ou horário em formato não reconhecido |
| **Tema inválido.** | Tema inexistente (não acontece pelo formulário normal) |
| **Textos do convite muito longos (selo até 40, rodapé até 120 caracteres).** | Selo ou rodapé acima do limite |
| **Mensagem do WhatsApp muito longa (até 950 caracteres).** | O texto digitado passa do limite |
| **Com as variáveis trocadas, a mensagem do WhatsApp fica com N caracteres (máximo 950). Encurte a mensagem.** | O texto cabe no limite, mas passa dele depois de trocar as variáveis pelos dados do evento e dos convites (ex.: endereço ou nome de família longos) |
| **Com as variáveis trocadas, o link do WhatsApp fica com N caracteres (máximo 2300): acentos e emojis ocupam mais espaço no link. Encurte a mensagem.** | O texto tem até 950 caracteres, mas muitos acentos ou emojis deixam o link longo demais |
| **Prazo de confirmação inválido.** | Data do prazo em formato não reconhecido |
| **O prazo de confirmação não pode ser depois da festa.** | Prazo posterior à data do evento |

### 2.4 Criar um convite

1. Na página do evento, clique em **+ Novo convite**.
2. Preencha o **Nome exibido no convite** — é o título grande que o convidado vê. Ex.: "Família Silva", "Tio João e Tia Ana".
3. Adicione os convidados:
   - digite o nome na primeira linha e escolha **Adulto**, **Adolescente** ou **Criança**;
   - use **+ Adulto** / **+ Adolescente** / **+ Criança** para adicionar mais linhas;
   - use **✕** para remover uma linha.
   Linhas com o nome em branco são ignoradas.
4. Clique em **Criar convite**.

O link do convite é gerado automaticamente.

> 💡 Dica: crie **um convite por família/núcleo**. Assim cada família responde por todos os seus membros de uma vez.

**Detalhes:**

- **Mínimo de um convidado:** o botão **✕** fica desativado quando sobra só uma linha.
- **Link:** termina com um código de 8 caracteres aleatórios (letras, números, `-` e `_`), ex.: `/r/Ab3xY9kL`. Ele aparece em cada card como **"Link: /r/Ab3xY9kL"**.
- **Ordem na página do evento:** os convites aparecem em **ordem alfabética** do nome exibido.

**Mensagens de erro do formulário (criar e editar):**

| Mensagem | Causa |
| --- | --- |
| **Informe o nome exibido no convite.** | Campo "Nome exibido no convite" vazio |
| **Adicione pelo menos um convidado.** | Todas as linhas estão com o nome em branco |
| **Tipo de convidado inválido.** / **Lista de convidados inválida.** | Dados corrompidos no envio (não acontece pelo uso normal). Recarregue a página |
| **Convite não encontrado.** | O convite foi excluído enquanto era editado |
| **Com este nome, a mensagem do WhatsApp fica com N caracteres (máximo 950). Encurte o nome ou a mensagem do evento.** | O evento tem mensagem do WhatsApp personalizada e, com este nome no lugar de `{nome}`, ela passa do limite |
| **Com este nome, o link do WhatsApp fica com N caracteres (máximo 2300): acentos e emojis ocupam mais espaço no link. Encurte o nome ou a mensagem do evento.** | Mesmo caso, mas o que passa do limite é o link (ver 2.5.1) |

### 2.5 Enviar o convite

Em cada convite, na página do evento:

- **Copiar link** — copia o endereço completo (ex.: `https://seu-dominio/r/Ab3xY9kL`) para colar onde quiser.
- **Copiar mensagem** — copia a mesma mensagem do botão **WhatsApp**, já com o nome da família, a formatação e o link. Use para enviar por outro caminho: e-mail, SMS, Telegram, WhatsApp Web, um grupo ou uma conversa já aberta. O botão mostra "✓ Mensagem copiada"; depois é só colar.
- **WhatsApp** — abre o WhatsApp com uma mensagem pronta contendo o nome da família, o nome da festa e o link. Basta escolher o contato e enviar. O texto pode ser personalizado por evento (ver 2.5.1).
- **Abrir convite** — abre o convite em outra aba, exatamente como o convidado verá.

Ao colar o link no WhatsApp, aparece um **card de pré-visualização** com o tema, o nome da família, o nome da festa, a data e o local. O título do card é "*Família Silva*, chegou o seu convite!". Se o card aparecer sem imagem, veja a [seção 5](#5-quando-falar-com-o-administrador).

> 🔒 Cada link dá acesso àquele convite e permite responder por ele. **Envie apenas para a família correspondente** e não publique em grupos abertos ou redes sociais.

#### 2.5.1 Personalizar a mensagem do WhatsApp

A mensagem do botão **WhatsApp** é definida **por evento**, no campo **Mensagem do WhatsApp** de **+ Novo evento** ou **Editar evento**. Vale para todos os convites daquele evento. Cada convite troca as variáveis pelos próprios dados.

> Não existe mensagem diferente por convite. Para escrever algo especial para uma família, clique em **WhatsApp** e **edite o texto no próprio WhatsApp** antes de enviar. A alteração vale só para aquele envio.

**Mensagem padrão** (usada quando o campo fica em branco):

```
Olá, {nome}! Chegou o seu convite para: *{evento}* {icone}
Confirme a presença: {link}
```

**Variáveis** — escreva entre chaves, ou clique no botão da variável abaixo do campo para inseri-la na posição do cursor:

| Variável | Vira | Exemplo |
| --- | --- | --- |
| `{nome}` | Nome exibido no convite | Família Silva |
| `{evento}` | Nome da festa | 1º Aniversário do Arthur |
| `{data}` | Data da festa | 15/11/2026 |
| `{hora}` | Horário | 16:00 |
| `{local}` | Local | Espaço Festa |
| `{endereco}` | Endereço (sem cedilha no nome da variável) | Rua das Flores, 100 - Belo Horizonte/MG |
| `{icone}` | Ícone do tema | 🦁 |
| `{link}` | Link do convite daquela família | https://seu-dominio/r/Ab3xY9kL |

**Formatação do WhatsApp** — funciona normalmente, porque o texto chega ao WhatsApp exatamente como foi digitado:

| Digite | Aparece como |
| --- | --- |
| `*texto*` | **negrito** |
| `_texto_` | *itálico* |
| `~texto~` | ~~riscado~~ |
| ```` ```texto``` ```` | `monoespaçado` (pode ocupar várias linhas) |
| `` `texto` `` | `código`, monoespaçado num trecho da linha |

Quebras de linha e emojis também são mantidos.

**Exemplo:**

```
Olá, *{nome}*! 🎉
Chegou o seu convite para: _{evento}_ {icone}

📅 {data} às {hora}
📍 {local} — {endereco}

Confirme a presença: {link}
```

**Pré-visualização:** abaixo do campo há um balão no estilo do WhatsApp que mostra a mensagem já formatada, atualizada enquanto você digita. Nome da festa, data, horário, local, endereço e ícone vêm do próprio formulário. Nome do convite e link usam valores de exemplo ("Família Exemplo" e um link fictício do mesmo tamanho de um link real).

> Em navegadores muito antigos (ex.: Safari anterior à versão 16.4), a pré-visualização aparece **sem formatação**: o texto fica com os `*` e `_` à mostra. O envio pelo WhatsApp não é afetado.

**Regras:**

- **Link garantido:** se a mensagem não tiver `{link}`, o link do convite é adicionado em uma linha no final.
- **Limite de 950 caracteres**, que vale duas vezes:
  - para o **texto digitado**;
  - para o **texto final**, já com as variáveis trocadas.

- **Limite de 2300 caracteres no link do WhatsApp.** Para abrir o WhatsApp, a mensagem vira um link. Nesse link, cada letra acentuada ocupa **6** caracteres e cada emoji até **12**. Por isso, uma mensagem com menos de 950 caracteres, mas cheia de acentos e emojis, ainda pode passar do limite.

As duas margens evitam que o WhatsApp recuse mensagens longas em alguns aparelhos. Abaixo do campo aparecem três contadores:
- **Modelo:** o texto digitado;
- **Texto final (exemplo):** a mensagem com as variáveis trocadas;
- **Link do WhatsApp (exemplo):** o tamanho do link gerado.

Os contadores ficam vermelhos quando algum limite é ultrapassado. O sistema confere os dois limites de novo:
- ao salvar o evento, com os nomes reais de todos os convites;
- ao criar ou editar um convite.
- **Variável escrita errada** (ex.: `{nomee}`) não é trocada: vai para o WhatsApp do jeito que foi digitada. Confira na pré-visualização.
- **Mudanças valem na hora** para os próximos cliques no botão **WhatsApp**. Mensagens já enviadas não mudam.
- A mensagem do botão é diferente do **card de pré-visualização** do link (imagem, título e descrição), que não é afetado por este campo.

### 2.6 Acompanhar as respostas

Na página do evento:

- O **Resumo de presença** mostra o total de presentes (adultos, adolescentes e crianças), ausentes e pendentes de todo o evento — útil para fechar números com buffet e decoração.
- Cada convite mostra seus convidados com o status colorido:
  - 🟢 **✓ Presente**
  - 🔴 **✗ Ausente**
  - 🟡 **⏳ Pendente**
- Quando a família responde, aparece **"respondeu em dd/mm/aaaa hh:mm"** abaixo do nome.

Recarregue a página para ver respostas novas.

**Cabeçalho da página do evento:** abaixo do nome aparecem:

- data, horário, local e endereço;
- o **tema** escolhido (ícone e nome);
- a situação do prazo, quando houver:
  - ⏰ **"Confirmações até dd/mm/aaaa"** enquanto o prazo está aberto;
  - 🔒 **"Confirmações encerradas em dd/mm/aaaa — pendentes contam como ausentes"**, em vermelho, depois dele.

**Exportar a lista:** abaixo do Resumo de presença, em **Exportar lista (CSV)**, escolha **Todos**, **Presentes**, **Ausentes** ou **Pendentes**. O arquivo abre direto no Excel ou no Google Planilhas, com as colunas Convite, Convidado, Tipo, Status e Respondido em. Útil para mandar a lista para o buffet ou para a portaria.

| Botão | Conteúdo do arquivo |
| --- | --- |
| **Todos** | Todos os convidados do evento |
| **Presentes** | Só quem confirmou |
| **Ausentes** | Só quem recusou (e, depois do prazo, quem não respondeu) |
| **Pendentes** | Só quem ainda não respondeu |

Detalhes do arquivo:

- **Colunas:**
  - **Tipo** sai como Adulto, Adolescente ou Criança;
  - **Respondido em** usa o horário de Brasília.
- **Formato:** separador `;` e UTF-8. Por isso o arquivo abre direto no **Excel em português**, com colunas e acentos corretos, e também no Google Planilhas.
- **Nome do arquivo:** junta o nome da festa e o filtro, ex.: `1-aniversario-do-arthur-presentes.csv`.
- **Proteção contra fórmulas:** nomes que começam com `=`, `+`, `-` ou `@` recebem um apóstrofo na frente, para o Excel não tratá-los como fórmula.
- **Acesso:** só funciona com o organizador logado. Sem login, o endereço do arquivo leva para a tela de login.
- **Depois do prazo de confirmação:** quem não respondeu sai como **Ausente** (ver 2.12).

### 2.7 Editar um convite

1. No convite, clique em **Editar**.
2. Altere o nome exibido, renomeie convidados, troque o tipo, adicione ou remova pessoas.
3. Clique em **Salvar alterações**.

O link **não muda** ao editar. O status de cada convidado aparece ao lado do nome durante a edição.

> ⚠️ Remover um convidado apaga também a resposta dele. Convidados mantidos ou apenas renomeados **preservam** a resposta.

### 2.8 Zerar as respostas de um convite

Se uma família respondeu por engano e quer começar de novo:

1. No convite, clique em **Zerar respostas** (só aparece se já houve resposta).
2. Confirme.

Todos os convidados daquele convite voltam para **Pendente**. O link continua o mesmo.

### 2.9 Excluir um convite

1. No convite, clique em **Excluir** e confirme.

O link deixa de funcionar imediatamente (o convidado verá "Convite não encontrado"). **Não é possível desfazer.**

### 2.10 Editar ou excluir um evento

1. Na página do evento, clique em **Editar evento**.
2. Altere os dados e clique em **Salvar alterações** — as mudanças aparecem na hora em todos os convites do evento.
3. Para excluir, use **Excluir evento** no final da página e confirme.

> ⚠️ Excluir um evento apaga **todos os convites e respostas** dele, além do PDF modelo e dos PDFs gerados. Não é possível desfazer.

### 2.11 PDFs dos convites

Cada evento pode ter um **PDF modelo** do convite. A partir dele o sistema gera um PDF por família, com o link do convite daquela família no lugar do link do modelo. Todo o resto do PDF (layout, imagens, textos, fontes, páginas e outros links) fica igual.

**Requisito do modelo:** o PDF precisa ter um **link clicável** para um convite, no mesmo formato dos links do sistema (ex.: `https://convite.n1b3.com.br/r/_3lXq-MW`). É esse link que é trocado. Um endereço escrito como texto, sem ser clicável, ou um QR code não são trocados.

**Enviar ou substituir o modelo**

1. Na página do evento, na seção **PDF do convite**, escolha o arquivo `.pdf` (até 10 MB).
2. Clique em **Enviar modelo** (ou **Substituir modelo**, se já houver um).
3. O sistema confere se o PDF tem o link do convite. Se não tiver, o envio é recusado com uma mensagem.

A seção mostra o nome do modelo atual, a data de atualização e a versão. Use **Baixar modelo** para conferir o arquivo.

**Gerar os PDFs**

- **Um convite:** no card do convite, clique em **Gerar PDF** (ou **Gerar novamente**). O botão mostra "Gerando PDF..." até terminar.
- **Todos:** clique em **Gerar PDFs de todos os convites**. A barra mostra o progresso ("23 de 58 concluídos"). A geração continua no servidor; você pode seguir usando a página ou até fechá-la.
- **Só o que falta:** **Gerar só pendentes e com erro** gera apenas os convites não gerados, com erro ou feitos com um modelo antigo.

**Status do PDF em cada convite**

| Status | Significado |
| --- | --- |
| **Não gerado** | Ainda não há PDF para este convite |
| **Gerando PDF...** | Em geração |
| **Gerado** | PDF pronto e feito com o modelo atual. Use **Baixar PDF** |
| **Modelo atualizado — gerar novamente** | O PDF foi feito com um modelo anterior. Gere de novo |
| **Erro ao gerar** | A geração falhou; a mensagem aparece abaixo. Clique em **Gerar novamente** |

Quando um convite tem um PDF antigo (modelo anterior ou última tentativa com erro), o botão **Baixar PDF anterior** baixa a última versão gerada com sucesso.

**Download:** o arquivo vem com o nome da família, ex.: `convite-familia-silva.pdf`. Só o organizador logado consegue baixar.

> Ao substituir o modelo, os PDFs já gerados **não** são refeitos sozinhos: eles passam a aparecer como "Modelo atualizado — gerar novamente". Enquanto uma geração em lote está em andamento, não é possível trocar o modelo.

**Detalhes da tela**

- **Contadores:** abaixo do modelo aparece o resumo do evento, ex.: "12 gerados · 3 com modelo antigo · 1 com erro · 4 não gerados".
- **Confirmação:** se algum convite já tem PDF, **Gerar PDFs de todos os convites** pede confirmação antes de gerar tudo de novo.
- **Quando o botão "Gerar só pendentes e com erro" aparece:** só quando **parte** dos convites precisa ser gerada. Se nenhum precisa, ele some. Se todos precisam, use o botão de todos.
- **Resultado do último lote:** depois que o lote termina, a seção mostra "Última geração em lote: 55 de 58 concluídos · 3 com erro" (e "interrompida", se for o caso).
- **Lista de falhas:** a seção também mostra os nomes dos convites com erro ("Com erro: Família Souza, Família Lima"), para gerar de novo só esses.
- **Data da geração:** ao lado do status **Gerado** aparece quando o PDF foi feito.
- **Sem modelo:** o botão **Gerar PDF** dos convites fica desativado. Passando o mouse, aparece "Envie o PDF modelo do evento primeiro".
- **Validação antes do envio:** um arquivo que não termina em `.pdf` ou passa de 10 MB é recusado na hora, sem ser enviado.
- **Dois envios ao mesmo tempo:** se o modelo for trocado em outra aba ou dispositivo durante o seu envio, aparece "O modelo foi alterado em outra sessão. Recarregue a página e tente de novo."
- **Sessão expirada:** se a sessão vencer enquanto a página acompanha uma geração, aparece "Sua sessão expirou. Recarregue a página e entre novamente." A geração continua no servidor normalmente.
- **Fechar a página:** a geração em lote não depende da página aberta. Ao voltar, a seção mostra o andamento atual.
- **Nomes dos arquivos baixados:**
  - PDF do convite: `convite-<nome-da-familia>.pdf`, ex.: `convite-familia-silva.pdf`;
  - modelo: `modelo-<nome-da-festa>.pdf`.

### 2.12 Prazo de confirmação: como funciona

O prazo é opcional e definido no evento (2.3). Ele afeta o organizador e os convidados assim:

| | Antes do prazo (até 23:59 do dia, horário de Brasília) | Depois do prazo |
| --- | --- | --- |
| **Convidado** | Vê "⏰ Confirme até dd/mm/aaaa" e responde normalmente | Vê "🔒 O prazo para confirmar presença terminou em dd/mm/aaaa. O convite não aceita mais alterações." Os botões ✓/✗ e **Confirmar Presença** somem |
| **Pendentes** | Aparecem como **Pendente** | Passam a aparecer como **Ausente**: no convite, no painel, na página do evento, na edição do convite e no CSV |
| **Organizador** | ⏰ "Confirmações até ..." | 🔒 "Confirmações encerradas em ..." |

Pontos importantes:

- **Nada é apagado.** Para o sistema, quem não respondeu continua como pendente; só a **exibição** muda.
  - Se você **remover ou adiar o prazo** em **Editar evento**, essas pessoas voltam a aparecer como pendentes e o convite volta a aceitar respostas.
- **Prazo vencido com a página aberta:** se o convidado deixar a página aberta, o prazo passar e ele tentar enviar, a resposta é recusada. A página passa para o modo encerrado e mostra os pendentes como ausentes.
- **Zerar respostas** depois do prazo volta todos para pendente no sistema, mas eles continuam aparecendo como ausentes enquanto o prazo estiver encerrado.

### 2.13 Bloquear um convite

Use para encerrar as respostas de **um convite só**, sem mudar o prazo do evento nem os outros convites.

1. Na página do evento, clique em **Bloquear** no convite.
2. Confirme. O convite passa a mostrar 🔒 **"Bloqueado — pendentes contam como ausentes"**.

Enquanto o convite estiver bloqueado:

- o convidado vê "🔒 O prazo para confirmar presença terminou. O convite não aceita mais alterações." Os botões ✓/✗ e **Confirmar Presença** somem;
- se o prazo do evento também já tiver passado, a mensagem é a do prazo, com a data (2.12);
- quem não respondeu aparece como **Ausente**, como acontece depois do prazo: no convite, no painel, na página do evento, na edição do convite e no CSV.

Pontos importantes:

- **Nada é apagado.** Clique em **Desbloquear** para reverter: os pendentes voltam a aparecer como pendentes e o convite volta a aceitar respostas, se o prazo do evento permitir.
- **Bloqueio com a página aberta:** se o convidado deixar a página aberta e tentar enviar depois do bloqueio, a resposta é recusada e a página passa para o modo encerrado.
- **Mensagem do WhatsApp:** o botão continua disponível e o texto não muda.

---

## 3. Experiência do convidado

O convidado **não precisa de cadastro nem senha** — só do link recebido.

### 3.1 Abrir o convite

Ao abrir o link, o convidado vê:

1. O **nome do convite** em destaque (ex.: "Família Silva — estamos esperando por você(s)!").
2. Os **detalhes da festa**: data, horário, local e endereço.
3. A **lista de convidados** daquele convite, cada um com seu status atual.
4. O quadro de **Confirmação de Presença**, com a contagem de presentes, ausentes e pendentes.

**Visual do convite:**

- **Topo:** o **selo** do evento, com o ícone do tema e o texto do selo (ou o padrão do tema). Abaixo, o nome do convite em letras grandes, a frase "estamos esperando por você(s)!" e o ícone separador do tema.
- **Detalhes da Festa:** quatro cartões (Data, Horário, Local e Endereço).
- **Convidados:** cada pessoa com o ícone do tipo (👤 Adulto, 🧑 Adolescente, 👶 Criança), o nome, o tipo e o status atual. No título, a contagem ("3 convidados").
- **Rodapé:** os três ícones do tema, a frase "Convite digital personalizado" e o texto do rodapé do evento (ou "Feito com carinho · <nome da festa>").
- **Cores:** todo o convite usa as cores do tema. No celular, a barra do navegador também fica na cor do tema.
- **Carregamento:** enquanto o convite abre, aparece "Carregando convite...".

### 3.2 Responder

1. Para cada pessoa da lista, toque em:
   - **✓** para confirmar presença, ou
   - **✗** para informar ausência.
   Para mudar de ideia antes de enviar, basta tocar no outro botão.
2. Toque em **Confirmar Presença**.
3. Aparece a tela **"Presença Confirmada!"** com o resumo de quem vai e quem não vai. Toque em **Fechar**.

Não é obrigatório responder por todos de uma vez: quem ficar como pendente pode ser respondido depois.

**Detalhes da resposta:**

- **Não dá para desmarcar:** o botão já marcado fica travado. Para mudar a resposta de uma pessoa, toque no **outro** botão (de ✓ para ✗ ou o contrário). Não há como voltar alguém para **Pendente** pelo convite; só o organizador pode fazer isso, com **Zerar respostas** (2.8), que vale para o convite inteiro.
- **Botão desativado:** **Confirmar Presença** só é liberado quando **pelo menos uma pessoa** está marcada. Antes disso aparece "Selecione a presença dos convidados acima para ativar o botão".
- **Dicas na tela:**
  - com todos pendentes, aparece "Toque em ✓ para confirmar ou ✗ para recusar";
  - com alguma seleção, aparece "Você pode alterar as seleções antes de enviar".
- **O que é enviado:** só as pessoas marcadas com ✓ ou ✗. Quem ainda está pendente não é enviado e continua pendente.
- **Durante o envio:** o botão mostra "Enviando..." e não aceita um segundo toque.
- **Contadores:** o quadro Presentes / Ausentes / Pendentes muda na hora, conforme as marcações, mesmo antes de enviar.
- **Tela de sucesso:**
  - mostra "<Nome do convite>, obrigado pela resposta!";
  - mostra as listas **Presentes (N)** e **Ausentes (N)**;
  - enquanto ela está aberta, a lista fica travada; depois de **Fechar**, dá para alterar e enviar de novo.
- **Para o organizador:** cada envio registra a data e hora da resposta. Ela aparece como "respondeu em ..." na página do evento e na coluna "Respondido em" do CSV.

### 3.3 Mudar a resposta

O convidado pode abrir o **mesmo link** a qualquer momento. As respostas já enviadas aparecem marcadas; basta trocar (ex.: de ✓ para ✗) e tocar em **Confirmar Presença** novamente.

Isso vale **até o prazo de confirmação**, se o evento tiver um. Depois dele, o convite só mostra as respostas, sem permitir alteração (ver 2.12).

### 3.4 Mensagens possíveis

| Mensagem | Significado |
| --- | --- |
| **Convite não encontrado** | Link digitado errado, incompleto ou convite excluído pelo organizador |
| **Não foi possível enviar sua resposta. Tente novamente.** | Falha de conexão ou o convite foi alterado no meio do caminho (ex.: o organizador removeu um convidado). Recarregue a página e responda de novo |
| **⏰ Confirme até dd/mm/aaaa** | O evento tem prazo e ele ainda está aberto |
| **🔒 O prazo para confirmar presença terminou em dd/mm/aaaa. O convite não aceita mais alterações.** | O prazo acabou. As respostas aparecem só para consulta e os pendentes aparecem como ausentes |
| **Selecione a presença dos convidados acima para ativar o botão** | Ninguém foi marcado ainda; o botão **Confirmar Presença** está desativado |

---

## 4. Perguntas frequentes

**O convidado precisa instalar algum aplicativo?**
Não. Funciona no navegador do celular ou do computador.

**Posso usar o mesmo sistema para várias festas?**
Sim. Crie um evento para cada festa; cada um tem seus próprios convites e totais.

**Duas pessoas da mesma família podem responder pelo mesmo link?**
Sim. Vale a última resposta enviada para cada convidado.

**Um convidado novo apareceu depois que a família já respondeu. O que faço?**
Edite o convite e adicione a pessoa. Ela aparece como **Pendente** e as respostas anteriores dos outros são mantidas. Peça para a família abrir o link de novo e responder por ela.

**O prazo acabou, mas uma família pediu para responder. Dá?**
Sim. Em **Editar evento**, adie ou apague o prazo. O convite volta a aceitar respostas na hora, e quem não tinha respondido volta a aparecer como pendente.

**Posso mudar o tema depois de enviar os convites?**
Sim. Em **Editar evento**, troque o tema; todos os convites do evento mudam na hora. Só o card do WhatsApp de links já compartilhados pode continuar com a imagem antiga por um tempo (o WhatsApp guarda o card).

**Dá para mudar o texto que o botão WhatsApp envia?**
Sim. Em **Editar evento**, preencha **Mensagem do WhatsApp**. Use variáveis como `{nome}` e `{link}` e a formatação do WhatsApp (`*negrito*`, `_itálico_`). Ver 2.5.1.

**Enviei o link errado para uma família. Como invalido?**
Exclua o convite e crie outro — o novo convite terá um link diferente.

**Esqueci a senha do organizador.**
Peça ao administrador do sistema. Ele consegue consultar ou trocar a senha.

**Os dados ficam salvos se o servidor reiniciar?**
Sim. Eventos, convites, respostas e PDFs ficam guardados no servidor. O administrador também faz cópias de segurança.

**O PDF de um convite mostra o link de outra família ou um link antigo.**
Gere o PDF daquele convite de novo. Se o endereço do link estiver errado em **todos** os PDFs, avise o administrador: esse endereço é configurado no servidor.

**O servidor reiniciou no meio da geração em lote. Perdi algo?**
Não. Os PDFs já gerados continuam valendo; os que estavam na fila aparecem com erro. Clique em **Gerar só pendentes e com erro**.


---

## 5. Quando falar com o administrador

Algumas situações dependem do servidor e só o administrador do sistema resolve. Outras você mesmo resolve. Use a tabela para saber o que fazer.

| Situação | O que fazer |
| --- | --- |
| Esqueci a senha do organizador | Peça a senha ao administrador |
| **"Muitas tentativas incorretas. Tente novamente em N minutos."** | Espere o tempo indicado. Se for urgente, o administrador pode liberar o acesso antes |
| O site não abre (nem a área do organizador nem os convites) | Avise o administrador |
| Link colado no WhatsApp aparece **sem imagem** | Teste com um convite que ainda não foi compartilhado: o WhatsApp guarda o card antigo de cada link por um tempo. Se o novo também vier sem imagem, avise o administrador |
| Link copiado aparece com **números** (ex.: `http://192.168...`) em vez do endereço do site | Entre na área do organizador pelo endereço do site, e não pelo número, e copie o link de novo |
| **"Nenhum link de convite (…/r/…) foi encontrado neste PDF"** ao enviar o modelo | Confira se o PDF tem um **link clicável** para um convite (ver 2.11). Se tiver e o erro continuar, avise o administrador |
| **"Serviço de PDF indisponível"** ou **"Endereço do link não configurado"** | Avise o administrador |
| Convite com **"Erro ao gerar"** | Clique em **Gerar novamente**. Se o erro se repetir, avise o administrador e informe a mensagem que aparece no card |
| **"Geração interrompida pela reinicialização do servidor"** | Clique em **Gerar só pendentes e com erro** |
| O link dentro de **todos** os PDFs está errado | Avise o administrador. Depois que ele corrigir, gere os PDFs de novo |

> Ao falar com o administrador, informe **a mensagem exata** que apareceu na tela e **o que você estava fazendo**: o evento, o convite e o botão clicado. Isso ajuda a encontrar o problema mais rápido.