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.1.5, 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), foto do documento da pessoa e do documento de cada veículo, ou envio 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ículos (opcional) | A pessoa pode informar placa, modelo e cor de um ou mais veículos 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.
Uma barra de progresso no topo indica a etapa atual.
Etapas do wizard
1. Boas-vindas
Exibe o título e a mensagem de boas-vindas configurados e o botão Iniciar.
2. Termos de Uso
Apresenta o texto dos termos (configurável) em uma área de leitura e o checkbox Li e aceito os termos acima, obrigatório para avançar em Continuar. Ao aceitar, o sistema registra o texto exato, o hash do texto e a data/hora do aceite (ver Consentimento e LGPD).
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: o card mostra o nome da categoria, a quantidade de campos e as fotos pedidas (ex.: Foto facial + Documento).
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. O campo Documento traz o seletor do tipo de documento, com os tipos aceitos pela categoria. Depois que o documento é informado, um aviso abaixo dos campos indica Novo cadastro ou, se o CPF já existir no sistema, Documento encontrado (os dados serão atualizados).
5. Dados dos veículos (opcional)
Exibida apenas quando a categoria habilita dados veiculares. Cada veículo é um cartão numerado com Placa, Modelo e Cor; o botão + Adicionar veículo inclui outro cartão, até o limite definido para a categoria. A pessoa também pode Pular esta etapa. Placas inválidas ou repetidas na mesma submissão são recusadas.
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: antes da câmera, uma tela de orientações (boa iluminação, sem óculos escuros, bonés ou máscaras, olhar para a câmera) e o botão Abrir câmera. A câmera frontal mostra uma guia oval e detecção automática de rosto: a mensagem muda de Posicione seu rosto no oval para Ajuste a posição... e, com o rosto bem enquadrado, Perfeito! Pode capturar, quando o botão Capturar foto é liberado. Se a detecção não carregar no aparelho, a tela avisa Detecção facial indisponível. Capture a foto manualmente. e libera a captura. A foto facial não pode ser pulada.
- Documento: câmera traseira com guia retangular (Posicione o documento no retângulo) e captura manual em Capturar. Pode ser pulada em Pular esta foto.
- Documento do veículo: uma foto por veículo informado, quando a categoria pede.
- Sem câmera: quando a câmera não está disponível ou a permissão é negada, a tela mostra Câmera indisponível. Envie uma foto do dispositivo. e a pessoa envia um arquivo de imagem (JPG ou PNG, até 2 MB).
Estado da captura facial com rosto detectado (guia verde e mensagem Perfeito! Pode capturar). Exige um rosto real diante da câmera.
7. Resumo
Mostra a categoria, os dados preenchidos, os veículos e as miniaturas das fotos para conferência. O botão Editar volta ao formulário e Enviar finaliza o envio.
8. Sucesso
Exibe Cadastro enviado!, 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.
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.
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.
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 mostra o aviso Pessoa já cadastrada no sistema (ID: ...). A aprovação atualizará os dados existentes. As fotos são carregadas ao clicar em Clique para ver, e o bloco Informações da Submissão traz a data de envio e o IP. A aprovação pede confirmação ("Confirmar aprovação desta submissão?"); a rejeição abre o campo do motivo e é concluída em Confirmar Rejeição.
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, com os botões Cancelar e Confirmar rejeição.
- Limpar seleção: desmarca tudo.
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 → slot 2. Os veículos informados são criados (ou reaproveitados pela placa) e vinculados à pessoa; com Placa como identificador (cartão) ligado na categoria, a placa também vira identificador.
- 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, depois que a aprovação é gravada.
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, em duas subabas: Geral e Categorias.
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
Na subaba Categorias (Categorias e Campos), a lista à esquerda define quais categorias ficam disponíveis no formulário (checkbox) e, para a categoria selecionada, o painel à direita define quais campos são exibidos e quais fotos são exigidas. As alterações são gravadas em Salvar Campos.
- Campos Padrão: mapeiam diretamente para campos da entidade Pessoa: Nome completo (sempre ativo e obrigatório), Email, Documento, Telefone, Empresa e Observações. Para cada um você liga ou desliga o campo, ajusta rótulo e placeholder e marca Obrig.. No Documento, escolhe os Tipos aceitos (CPF, RG, CNH, Passaporte, Outros).
- Campos configuráveis: campos adicionais do próprio ACCELERO, incluídos pelo seletor Selecione um campo adicional do Accelero... e pelo botão Adicionar campo do Accelero. Tipo e opções vêm do ACCELERO e não são editáveis no plugin; rótulo, placeholder, ordem e obrigatoriedade são. Campos livres criados em versões anteriores continuam ativos com a etiqueta Legado.
- Captura de Imagens: Foto facial, Documento da pessoa e Documento do veículo (qualquer combinação; se nenhuma, a etapa de fotos é pulada).
- Dados Veiculares: Solicitar dados veiculares, Placa como identificador (cartão) e Máximo de veículos por pré-cadastro (de 1 a 10; padrão 5).
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.
| 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 (Foto facial, Documento da pessoa e Documento do veículo 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