Pular para o conteúdo principal

Auto-cadastro de pessoas

O Auto-cadastro de pessoas disponibiliza um formulário público, acessível por link ou QR Code, onde a própria pessoa preenche seus dados. Cada envio não cria a pessoa diretamente — ele entra em uma fila de moderação dentro do ACCELERO, e só vira um cadastro de Pessoa depois que um operador autorizado aprova o registro.

É indicado para cenários em que o cadastro inicial pode ser delegado ao próprio interessado (ex.: moradores, colaboradores, prestadores), mantendo o controle final com a equipe que opera o ACCELERO.

Disponibilidade

Este recurso é disponibilizado como plugin (autoenrollhosts) e precisa ser instalado e habilitado pela equipe técnica da IONGRADE. Consulte o suporte para verificar compatibilidade com a sua versão do ACCELERO.

Compatibilidade

Versão atual do plugin: 2.0.0 — compatível com ACCELERO 2.17.0 ou superior.

Relação com o Auto-cadastro de visitantes

Este plugin é voltado a pessoas (cadastro permanente, com aprovação na moderação). Para o cadastro de visitantes, consulte Auto-cadastro de visitantes.


O que o plugin faz

FuncionalidadeO que acontece no ACCELERO
Formulário público de cadastroA pessoa acessa um link/QR Code e preenche seus próprios dados, incluindo foto
Fila de moderaçãoCada envio fica pendente em uma lista de moderação, sem virar pessoa automaticamente
AprovaçãoAo aprovar, o ACCELERO cria (ou atualiza) a Pessoa, vincula a empresa/unidade e a categoria inicial configurada
ReprovaçãoAo reprovar, o registro pendente é descartado, sem gerar cadastro
Detecção de duplicidadeA lista de moderação indica se o documento informado já corresponde a uma pessoa existente
Notificação ao operadorQuando alguém se auto-cadastra, uma notificação é gerada no sistema
Benefício principal

Distribui o esforço de cadastro para o próprio interessado, mantendo a decisão de incluir ou não a pessoa sob controle de um operador autorizado.


Configuração

Caminho de acesso: Configurações > Plugins - auto-cadastro de pessoas

TODO: Adicionar Screenshot

Tela de configuração do plugin (Configurações > Plugins - auto-cadastro de pessoas), mostrando o switch de status, os campos obrigatórios, a categoria inicial, o endereço de acesso e os botões.

A tela possui a aba Geral com os seguintes itens:

CampoDescrição
StatusLiga/desliga o plugin. Com o status desligado, o formulário público de cadastro fica indisponível
Campos de preenchimento obrigatórioMulti-seleção dos campos do formulário que passam a ser obrigatórios para o interessado (ex.: e-mail, documento, telefone)
Categoria inicialCategoria atribuída automaticamente à pessoa quando o cadastro for aprovado. Campo obrigatório
Endereço de acessoToken (texto) que compõe a URL pública do formulário. O endereço final fica no formato <endereço-do-sistema>/autocadastro-pessoas/cadastro/<token>

Botões da tela

BotãoFunção
VoltarRetorna sem salvar
SalvarPersiste a configuração
Gerar QRCodeGera um QR Code apontando para a URL pública de cadastro (com o token informado), abrindo-o em uma nova janela para impressão
O Endereço de acesso é obrigatório

O campo do token é obrigatório. Defina um valor próprio (ex.: um nome curto, sem espaços) para compor o link público — esse texto faz parte da URL que será divulgada.

QR Code para divulgação

Use o botão Gerar QRCode para imprimir um código que leva direto ao formulário de cadastro — útil em recepções, murais ou comunicados.


Formulário público de cadastro

Caminho de acesso: URL pública <endereço-do-sistema>/autocadastro-pessoas/cadastro/<token> (não exige login).

A pessoa preenche os seguintes campos:

CampoDescrição
NomeNome completo (3 a 50 caracteres)
Selecione sua unidadeEmpresa / unidade à qual a pessoa será vinculada na aprovação
E-mailE-mail da pessoa (validação de formato)
TelefoneTelefone de contato
CódigoCódigo de identificação da pessoa (acmCodigo)
Tipo do documentoCPF, RG, CNH ou Outros
DocumentoNúmero do documento. Quando o tipo é CPF, o sistema valida o CPF informado
FotoCaptura por câmera ou upload de imagem. A imagem é comprimida no navegador antes do envio
TODO: Adicionar Screenshot

Formulário público de auto-cadastro de pessoas, mostrando os campos (nome, unidade, e-mail, telefone, código, tipo/número de documento) e a área de captura de foto.

Após o envio bem-sucedido, a pessoa é levada a uma tela de confirmação com a mensagem "Obrigado por se cadastrar, seus dados foram enviados para moderação."

TODO: Adicionar Screenshot

Tela de sucesso exibida ao interessado após o envio do auto-cadastro ("Sucesso! / Obrigado por se cadastrar...").

Validações no envio

O envio é recusado quando:

  • Algum campo obrigatório configurado está vazio.
  • O documento já existe em outro auto-cadastro pendente.
  • O documento já corresponde a uma Pessoa cadastrada no sistema.

Moderação

Caminho de acesso: menu lateral > Moderação (item de menu adicionado pelo plugin).

Permissão de acesso

O item de menu e a tela de moderação só aparecem para operadores que possuem a permissão Auto-cadastro de moradores - moderação (autoenrollmoderate).

A tela lista os auto-cadastros com status pendente. Operadores vinculados a empresas/unidades veem apenas os registros das suas unidades.

TODO: Adicionar Screenshot

Lista de moderação (Auto-cadastro de pessoas - Moderação) com as colunas e as ações em lote (Aprovar, Reprovar, Excluir).

Colunas da lista

ColunaConteúdo
Nome completoNome informado no formulário
DuplicadoSim quando o documento já corresponde a uma pessoa existente; Não caso contrário
Tipo do documentoCPF / RG / CNH / Outros
DocumentoNúmero do documento informado
TelefoneTelefone informado
E-mailE-mail informado
Data do cadastroData e hora em que o auto-cadastro foi enviado
UnidadeEmpresa/unidade selecionada pela pessoa
ImagemMiniatura da foto enviada
AçõesBotão para abrir o registro em Moderar

Ações em lote

No menu Mais ações da lista é possível selecionar vários registros e:

AçãoEfeito
AprovarAprova todos os selecionados (cria/atualiza as pessoas)
ReprovarReprova (descarta) todos os selecionados
ExcluirRemove os registros selecionados da fila
Confirmação obrigatória

Aprovar e reprovar em lote exigem confirmação ("Deseja aprovar todos os selecionados?" / "Deseja reprovar todos os selecionados?").

Tela de moderação individual

Ao clicar em Moderar, abre-se a ficha do auto-cadastro com os dados informados (nome, código, unidade, categoria, e-mail, telefone, tipo/número de documento e foto), em modo somente leitura. A partir dela o operador pode:

BotãoEfeito
VoltarRetorna à lista sem decidir
ReprovarDescarta o auto-cadastro (exige confirmação)
AprovarCria/atualiza a pessoa e remove o registro da fila
TODO: Adicionar Screenshot

Tela de moderação individual de um auto-cadastro, mostrando os dados em modo leitura, a foto e os botões Voltar / Reprovar / Aprovar.


O que acontece na aprovação

Quando um auto-cadastro é aprovado, o ACCELERO:

  1. Cria ou atualiza a pessoa correspondente ao documento informado — se já existir uma Pessoa com aquele documento, ela é atualizada com os dados do formulário; caso contrário, uma nova é criada. São gravados nome, documento (tipo e número), e-mail, telefone e código.
  2. Vincula a unidade/empresa selecionada no formulário, com a pessoa marcada como pré-autorizada e autorizante naquela empresa.
  3. Atribui a Categoria inicial definida na configuração do plugin.
  4. Importa a foto enviada, gravando-a como foto da pessoa.
  5. Remove o registro da fila de moderação.

Quando um auto-cadastro é reprovado, o registro pendente é simplesmente descartado e nenhuma pessoa é criada ou alterada.

Pessoa existente é atualizada

Como a aprovação usa o documento como chave, aprovar um auto-cadastro cujo documento já pertence a uma pessoa cadastrada atualiza essa pessoa (e adiciona o vínculo de empresa e a categoria), em vez de gerar um cadastro duplicado. A coluna Duplicado da lista de moderação ajuda a identificar esses casos antes de decidir.


Notificações

Quando uma pessoa conclui o auto-cadastro, o plugin gera uma notificação interna ("Pessoa se auto-cadastrou") para sinalizar que há um novo registro aguardando moderação.

Na edição de Operador, na seção de notificações, é possível habilitar a opção Auto-cadastro de pessoas para que o operador receba esses avisos.

TODO: Adicionar Screenshot

Seção de notificações na edição de operador, destacando a opção Auto-cadastro de pessoas.


Casos de uso

Liberar o auto-cadastro para uma unidade

  1. Solicitar à IONGRADE a instalação do plugin autoenrollhosts.
  2. Em Configurações > Plugins - auto-cadastro de pessoas, ativar o Status.
  3. Definir os Campos de preenchimento obrigatório e a Categoria inicial.
  4. Preencher o Endereço de acesso (token) e clicar em Salvar.
  5. Clicar em Gerar QRCode e divulgar o link/QR Code para o público desejado.

Moderar os cadastros recebidos

  1. Acessar Moderação no menu lateral.
  2. Conferir a coluna Duplicado e abrir os registros em Moderar para revisar os dados e a foto.
  3. Aprovar os cadastros válidos (a pessoa é criada/atualizada com unidade e categoria) ou Reprovar os indevidos.
  4. Para grandes volumes, usar as ações em lote em Mais ações.

Boas práticas

  • Token de acesso próprio: use um token de URL fácil de divulgar e específico do contexto, evitando expor links genéricos.
  • Categoria inicial dedicada: aponte a Categoria inicial para uma categoria de triagem (ex.: "Aguardando validação"), facilitando o tratamento posterior das pessoas recém-aprovadas.
  • Permissão restrita: conceda a permissão de moderação apenas a quem deve aprovar cadastros.
  • Revisar duplicados: antes de aprovar, observe a coluna Duplicado para entender se a aprovação vai atualizar uma pessoa já existente.
  • Desligar quando não usar: mantenha o Status desligado fora dos períodos de campanha de cadastro, para que o formulário público não fique acessível.

Troubleshooting

O formulário público não abre

Possíveis causas:

  • Plugin com Status desligado.
  • Token do Endereço de acesso diferente do que está na URL divulgada.

Solução:

  1. Em Configurações > Plugins - auto-cadastro de pessoas, confirme que o Status está ligado.
  2. Verifique se o token configurado corresponde ao trecho final da URL divulgada.

O envio é recusado por dados duplicados

Possíveis causas:

  • Já existe um auto-cadastro pendente com o mesmo documento.
  • O documento já corresponde a uma pessoa cadastrada.

Solução:

  1. Verifique a fila de Moderação por um registro pendente com o mesmo documento.
  2. Verifique em Pessoas se a pessoa já existe.

O item Moderação não aparece no menu

Possível causa:

  • Operador sem a permissão Auto-cadastro de moradores - moderação (autoenrollmoderate).

Solução:

  1. Conceda a permissão ao Perfil do operador.

Integração com outros módulos

Pessoas

A aprovação de um auto-cadastro cria ou atualiza uma Pessoa, incluindo nome, documento, contato e foto.

Empresas e Categorias

Cada cadastro é vinculado à Empresa/unidade escolhida no formulário e recebe a Categoria inicial definida na configuração do plugin.

Operadores e Perfis

A moderação depende da permissão autoenrollmoderate, atribuída via Perfis, e as notificações de novos cadastros podem ser habilitadas na edição do Operador.


Próximos Passos

  • Auto-cadastro de visitantes — Cadastro público voltado a visitantes
  • Pessoas — Entidade criada/atualizada na aprovação
  • Categorias — Defina a categoria inicial do plugin
  • Empresas — Unidades disponíveis no formulário
  • Perfis — Conceda a permissão de moderação
  • Plugins — Saiba mais sobre o sistema de plugins do ACCELERO