Pré-Cadastro (formulário público)
O Pré-Cadastro disponibiliza um formulário público self-service para que a própria pessoa (morador, prestador, etc.) preencha seus dados e envie suas fotos pelo celular, sem precisar de um operador logado. Cada envio entra em uma fila de moderação dentro do ACCELERO: um operador autorizado revisa e aprova (criando ou atualizando a pessoa no sistema) ou rejeita a submissão.
O formulário é acessível por um link único (com QR Code), montado como um wizard mobile-first em etapas, e respeita o consentimento LGPD antes da coleta dos dados.
Esta funcionalidade é disponibilizada como plugin (precadastro) e precisa ser instalada e habilitada pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.
Versão atual do plugin: 1.0.1 — compatível com ACCELERO 2.17.0 ou superior.
O Pré-Cadastro é um dos fluxos de auto-cadastro do ACCELERO. Se o seu objetivo é cadastrar visitantes sem moderação, ou pessoas com aprovação simples, veja:
O que o plugin faz
| Funcionalidade | O que acontece no ACCELERO |
|---|---|
| Formulário público self-service | A pessoa acessa um link único e preenche seus próprios dados em um wizard mobile-first |
| Captura de fotos pelo celular | Foto facial (com detecção de rosto), frente e verso do documento, ou upload de arquivo quando não há câmera |
| Campos por categoria | Cada categoria de pessoa expõe um conjunto próprio de campos (nativos e customizados) e exige ou não cada tipo de foto |
| Dados de veículo (opcional) | A pessoa pode informar placa, modelo e cor do veículo quando a categoria habilita |
| Fila de moderação | Cada envio fica pendente até um operador aprovar ou rejeitar |
| Aprovação cria/atualiza a Pessoa | Ao aprovar, os dados viram um cadastro de Pessoa, vinculado à categoria escolhida, com as fotos transferidas para os slots padrão |
| Detecção de duplicidade por CPF | Se já existe pessoa com o mesmo documento, a submissão é tratada como atualização do cadastro existente |
| Notificação por e-mail | A pessoa recebe e-mail de aprovação ou rejeição (com o motivo), quando configurado |
| Consentimento LGPD | O aceite dos termos é registrado com texto, hash, IP, navegador e data/hora |
Tira do operador o lançamento manual de cadastros: a pessoa preenche os próprios dados (com mais precisão) e envia fotos de qualidade direto do celular. O operador só revisa e aprova.
O formulário público
URL: https://{seu-host}/external/precadastro/form/{token}
O {token} é gerado pelo plugin e identifica a instalação. O link é distribuído como o cliente preferir (QR Code, WhatsApp, e-mail, impresso na portaria) — ver Link público.
O formulário é um wizard em etapas, com botão Voltar em todas as telas (exceto a inicial e a de sucesso) e sem navegação livre entre etapas.
Visão geral do formulário público no celular, mostrando o layout mobile-first com a identidade visual laranja do ACCELERO.
Etapas do wizard
1. Boas-vindas
Exibe o título e a mensagem de boas-vindas configurados e um botão para iniciar o pré-cadastro.
Tela de boas-vindas com título e mensagem configuráveis e o botão de iniciar.
2. Termos e Condições
Apresenta o texto dos termos (configurável) em uma área de leitura e um checkbox "Li e aceito os termos", obrigatório para avançar. Ao aceitar, o sistema registra o texto exato, o hash do texto e a data/hora do aceite (ver Consentimento e LGPD).
Tela de aceite dos termos com o texto e o checkbox de consentimento.
3. Categoria
A pessoa escolhe sua categoria entre as categorias liberadas na configuração. Cada categoria carrega seu próprio conjunto de campos e exigências de foto.
Tela de seleção de categoria, com as categorias disponíveis em cards clicáveis.
4. Dados pessoais
Os campos são renderizados dinamicamente conforme a configuração da categoria escolhida, com máscaras automáticas para CPF e telefone e validação dos campos obrigatórios. Se o CPF informado já existir no sistema, o formulário avisa que os dados serão atualizados.
Tela de preenchimento de dados pessoais com campos dinâmicos e máscaras de CPF/telefone.
5. Dados do veículo (opcional)
Exibida apenas quando a categoria habilita o veículo. A pessoa informa Placa, Modelo e Cor, ou pode pular esta etapa.
Tela de dados do veículo com os campos Placa, Modelo e Cor e o botão de pular.
6. Captura de fotos
Etapa pulada automaticamente quando a categoria não exige nenhuma foto. Conforme a configuração da categoria, podem ser solicitadas:
- Foto facial — câmera frontal com guia (silhueta) e detecção automática de rosto; o botão de capturar é liberado apenas quando o rosto é detectado corretamente.
- Documento (frente e/ou verso) — câmera traseira com guia retangular, captura manual.
- Fallback sem câmera — quando a câmera não está disponível ou a permissão é negada, a pessoa envia um arquivo de imagem (JPG/PNG, até 5 MB).
Tela de captura facial com a silhueta-guia e o indicador de rosto detectado.
Tela de captura de documento (frente) com a guia retangular.
7. Resumo
Mostra todos os dados preenchidos e as miniaturas das fotos para conferência, com a opção de voltar e editar. O botão Enviar Pré-Cadastro finaliza o envio.
Tela de resumo com os dados informados, miniaturas das fotos e o botão de enviar.
8. Sucesso
Exibe a mensagem de sucesso configurada e um protocolo de referência do envio. A submissão entra na fila de moderação com status Pendente.
Tela de sucesso com a mensagem de confirmação e o protocolo da submissão.
Painel administrativo
O painel de administração do Pré-Cadastro é aberto por um botão flutuante (laranja, com ícone de prancheta) exibido no rodapé das telas do ACCELERO. O botão só aparece para operadores com permissão de moderação ou configuração do plugin.
Diferente de outras integrações, o Pré-Cadastro não adiciona um item de menu: o painel abre em uma janela sobreposta a partir do botão flutuante. Quem não tem nenhuma das permissões do plugin não vê o botão.
Botão flutuante do Pré-Cadastro no rodapé de uma tela do ACCELERO e o painel aberto em sobreposição.
O painel tem três abas, conforme a permissão do operador:
| Aba | Permissão necessária | Função |
|---|---|---|
| Moderação | precadastroManager (Pré-Cadastro - Moderação) | Revisar, aprovar e rejeitar submissões |
| Configuração | precadastroConfig (Pré-Cadastro - Configuração) | Definir textos, categorias, rate limit e e-mails |
| Link Público | precadastroConfig (Pré-Cadastro - Configuração) | Gerar/regenerar o token e o QR Code do link |
Moderação
A aba Moderação lista as submissões recebidas, com abas de status, filtros e ações.
Aba de moderação com as abas de status (Pendentes/Aprovados/Rejeitados), os filtros e a tabela de submissões.
Abas de status
| Aba | Conteúdo |
|---|---|
| Pendentes | Submissões aguardando decisão (com badge de contagem) |
| Aprovados | Submissões já aprovadas |
| Rejeitados | Submissões rejeitadas |
Filtros
| Filtro | Opções |
|---|---|
| Busca | Pesquisa por nome, documento ou e-mail |
| Categoria | Filtra por uma das categorias do sistema |
| Tipo | Novos (CPF inédito) ou Atualizações (CPF já existente) |
Colunas
| Coluna | Conteúdo |
|---|---|
| Foto | Miniatura da foto facial (slot 1), quando houver |
| Nome | Nome informado; recebe a etiqueta Veículo quando a submissão inclui dados de veículo |
| Tipo | Novo ou Atualização |
| Documento | Documento (CPF) informado |
| Categoria | Categoria escolhida pela pessoa |
| Data | Data e hora do envio |
| Status | Pendente / Aprovado / Rejeitado |
Detalhe da submissão
Ao clicar em uma linha, abre-se o detalhe com os dados pessoais, as fotos enviadas e os botões Aprovar e Rejeitar. Quando o CPF já existe, o detalhe destaca a pessoa existente que será atualizada.
Detalhe de uma submissão com dados, fotos e os botões Aprovar / Rejeitar, incluindo o aviso de pessoa existente.
Ações em massa
Na aba Pendentes, é possível selecionar várias submissões com os checkboxes e usar a barra de ações:
- Aprovar selecionados — aprova todas as submissões marcadas.
- Rejeitar selecionados — abre um campo para informar o motivo da rejeição, aplicado a todas as submissões marcadas.
- Limpar seleção — desmarca tudo.
Barra de ações em massa com submissões selecionadas e o campo de motivo de rejeição em massa.
O que acontece ao aprovar ou rejeitar
Aprovação
Ao aprovar uma submissão, o ACCELERO:
- Cria ou atualiza a Pessoa — se o CPF é inédito, cria um novo cadastro; se já existe, atualiza apenas os campos preenchidos (não sobrescreve dados existentes com vazio).
- Preenche os campos nativos (nome, e-mail, documento, telefone, empresa, observações) e aplica o valor padrão de habilitação configurado.
- Grava os campos customizados nos metadados da pessoa.
- Vincula a categoria escolhida (Link Pessoa × Categoria), com vigência aberta. Se a pessoa já tem a categoria, o vínculo não é duplicado.
- Transfere as fotos para os slots padrão da pessoa: foto facial → slot 1, documento frente → slot 2, documento verso → slot 3.
- Registra a auditoria (quem aprovou, quando e qual pessoa foi criada/atualizada) e remove as fotos em base64 da submissão para liberar espaço.
- Envia o e-mail de aprovação, quando habilitado.
A aprovação salva a pessoa pelo fluxo normal do ACCELERO, disparando os eventos de cadastro do núcleo. Plugins que reagem a esses eventos (sincronização de controladores, templates faciais, etc.) atuam normalmente sobre a pessoa criada/atualizada.
Rejeição
Ao rejeitar, o operador informa um motivo. A submissão fica com status Rejeitado, as fotos em base64 são removidas (privacidade) e os dados pessoais são mantidos apenas para auditoria. Quando habilitado, a pessoa recebe o e-mail de rejeição com o motivo informado.
Configuração
A aba Configuração reúne os textos, categorias, limites e e-mails do plugin.
Aba de configuração geral com os campos de textos, rate limit e notificações por e-mail.
Configuração geral
| Campo | Descrição |
|---|---|
| Pré-cadastro habilitado | Liga ou desliga o formulário público. Desabilitado, o link não funciona |
| Título de boas-vindas | Título exibido na primeira tela do formulário |
| Mensagem de boas-vindas | Texto de apresentação na primeira tela |
| Texto dos termos de uso | Texto de consentimento exibido na etapa de termos |
| Mensagem de sucesso | Texto exibido após o envio bem-sucedido |
Rate limit
Protege os endpoints públicos contra abuso, limitando envios por IP:
| Campo | Descrição |
|---|---|
| Tentativas por janela | Máximo de submissões por IP dentro da janela |
| Janela (minutos) | Período de contagem do limite |
Ao exceder o limite, novas tentativas do mesmo IP são bloqueadas temporariamente. O valor padrão é de 5 tentativas por 60 minutos.
Notificações por e-mail
| Campo | Descrição |
|---|---|
| Enviar e-mail de aprovação | Liga o e-mail enviado quando a submissão é aprovada |
| Assunto / Corpo do e-mail de aprovação | Texto do e-mail de aprovação. Aceita o placeholder {nome} |
| Enviar e-mail de rejeição | Liga o e-mail enviado quando a submissão é rejeitada |
| Assunto / Corpo do e-mail de rejeição | Texto do e-mail de rejeição. Aceita os placeholders {nome} e {motivo} |
Use {nome} para inserir o nome da pessoa e {motivo} (apenas na rejeição) para incluir o motivo informado pelo operador.
Categorias e campos
A configuração define quais categorias ficam disponíveis no formulário e, para cada uma, quais campos são exibidos e quais fotos são exigidas.
Cada campo tem rótulo, tipo de input (texto, e-mail, telefone, CPF, número, data, seleção, área de texto), obrigatoriedade e ordem. Os campos podem ser:
- Nativos — mapeiam diretamente para campos da entidade Pessoa (ex.: nome, documento, e-mail, telefone, empresa, observações).
- Customizados — campos extras gravados nos metadados da pessoa após a aprovação.
Cada categoria também define quais fotos pedir: facial, documento frente e documento verso (qualquer combinação; se nenhuma, a etapa de fotos é pulada).
Editor de campos por categoria, mostrando a lista de campos (nativos e customizados) e os switches de fotos exigidas.
Quando o operador altera os campos, as submissões já pendentes mantêm os dados como foram enviados — não há revalidação retroativa. O moderador avalia cada submissão pelo que foi recebido.
Link público
A aba Link Público gera e gerencia o endereço do formulário.
Aba de link público com a URL do formulário, o botão de copiar, o QR Code e o botão de regenerar token.
| Elemento | Descrição |
|---|---|
| URL do formulário público | Endereço completo do formulário, com botão Copiar |
| QR Code | Imagem do QR Code do link, com opção Baixar QR Code |
| Regenerar Token | Gera um novo token; o link anterior deixa de funcionar imediatamente |
Ao regenerar o token, qualquer link ou QR Code distribuído anteriormente para de funcionar na hora. As submissões já realizadas não são afetadas. Redistribua o novo link após regenerar.
Se o pré-cadastro estiver desabilitado na aba Configuração, o link não funciona, mesmo com token válido.
Consentimento e LGPD
O formulário coleta dados pessoais (nome, CPF, e-mail, telefone e fotos), por isso o aceite dos termos é obrigatório antes da coleta e fica registrado.
Para cada consentimento, o plugin armazena:
| Dado registrado | Finalidade |
|---|---|
| Texto exato dos termos | Prova do que foi aceito |
| Hash do texto | Integridade — detecta alteração do texto |
| IP do titular | Identificação da origem |
| Navegador (User-Agent) | Contexto técnico |
| Data/hora do aceite | Registro temporal |
Após a moderação (aprovação ou rejeição), as fotos em base64 da submissão são removidas. Em caso de aprovação, elas permanecem apenas como fotos da pessoa no ACCELERO; em caso de rejeição, são descartadas.
O texto dos termos é configurável e deve refletir a política de privacidade do condomínio/empresa — quais dados são coletados, finalidade, quem terá acesso e se a foto facial será usada para reconhecimento facial nos dispositivos de acesso.
Casos de uso
Habilitar o pré-cadastro em um condomínio
- Solicitar à IONGRADE a instalação do plugin
precadastro. - Na aba Configuração, definir título, mensagem de boas-vindas, texto dos termos e mensagem de sucesso.
- Liberar as categorias que a pessoa poderá escolher (ex.: Morador, Prestador) e configurar os campos e fotos de cada uma.
- Marcar Pré-cadastro habilitado.
- Na aba Link Público, gerar o token e baixar o QR Code para divulgar.
- Acompanhar a aba Moderação conforme as submissões chegam.
Aprovar um morador
- Na aba Moderação > Pendentes, abrir a submissão.
- Conferir dados e fotos. Se houver aviso de pessoa existente, confirmar que é a atualização correta.
- Clicar em Aprovar — a pessoa é criada/atualizada e vinculada à categoria, com as fotos transferidas.
- Se configurado, a pessoa recebe o e-mail de aprovação.
Rejeitar com motivo
- Na submissão (ou em seleção em massa), clicar em Rejeitar.
- Informar o motivo da rejeição.
- Confirmar — a submissão fica rejeitada, as fotos são descartadas e, se configurado, a pessoa recebe o e-mail com o motivo.
Boas práticas
- Categorias específicas: libere no formulário apenas as categorias que fazem sentido para o público externo (ex.: Morador, Prestador). Evite categorias internas.
- Campos enxutos: peça só o necessário no formulário público. Quanto menos campos, maior a taxa de conclusão.
- Termos adequados: ajuste o texto dos termos à política de privacidade do cliente e ao uso real das fotos.
- QR Code visível: divulgue o QR Code na portaria e nos canais oficiais; regenere o token se o link vazar.
- Moderação frequente: revise a fila de pendentes regularmente — submissões não expiram e ficam aguardando ação manual.
- Cuidado ao regenerar o token: combine a redistribuição do novo link antes de invalidar o antigo.
Troubleshooting
O link público não abre
Possíveis causas:
- Pré-cadastro desabilitado na aba Configuração.
- Token regenerado — o link distribuído ficou inválido.
- Token incorreto na URL.
Solução:
- Confirme Pré-cadastro habilitado na aba Configuração.
- Pegue a URL atual na aba Link Público e redistribua.
A etapa de fotos não aparece
Possível causa: a categoria escolhida não exige nenhuma foto (facial, documento frente e verso todos desligados).
Solução: na configuração da categoria, habilite os tipos de foto desejados.
A pessoa recebe "muitas tentativas"
Possível causa: o rate limit por IP foi atingido.
Solução: aguarde a janela configurada ou ajuste Tentativas por janela / Janela (minutos) na aba Configuração. Lembre-se de que vários acessos pela mesma rede compartilham o IP.
Não aparece o botão flutuante do Pré-Cadastro
Possível causa: o operador não tem nenhuma das permissões do plugin.
Solução: conceda Pré-Cadastro - Moderação e/ou Pré-Cadastro - Configuração ao perfil do operador.
A pessoa não recebe o e-mail de aprovação/rejeição
Possíveis causas:
- Notificação por e-mail desabilitada na configuração.
- E-mail não informado na submissão.
- Servidor de e-mail do ACCELERO não configurado.
Solução:
- Na aba Configuração, confirme que Enviar e-mail de aprovação/rejeição está marcado.
- Verifique se a submissão tinha e-mail preenchido.
- Confirme a configuração de envio de e-mail do ACCELERO com o suporte.
Integração com outros módulos
Pessoas e Categorias
A aprovação cria ou atualiza uma Pessoa e a vincula a uma Categoria. Os campos nativos do formulário mapeiam diretamente para o cadastro de pessoa; os customizados vão para os metadados.
Plugins de auto-cadastro
O Pré-Cadastro é um dos fluxos de cadastro externo. Para visitantes sem moderação ou pessoas com aprovação simples, veja Auto-cadastro de visitantes e Auto-cadastro de pessoas.
Próximos Passos
- Pessoas — Entenda os campos e fotos que a aprovação preenche
- Categorias — Configure as categorias liberadas no formulário
- Auto-cadastro de visitantes — Cadastro externo de visitantes
- Auto-cadastro de pessoas — Cadastro externo de pessoas com aprovação
- Plugins — Saiba mais sobre o sistema de plugins do ACCELERO