Quando o e‑CIGA informa que o CPF “já está cadastrado” 👤🧩

Situação típica:
Um usuário com perfil habilitado para cadastrar outros usuários tenta criar um novo cadastro no e‑CIGA, digita o CPF e o sistema responde:

“Este CPF já está cadastrado.”

Nessa situação, o usuário não consegue seguir com o cadastro, porque esse CPF já existe na base.
Ajustes nesse usuário não são feitos pela área comum, e sim por quem administra usuários via Keycloak.

Aqui está o passo a passo de como tratar esse caso.

1. Entender o que está acontecendo

Quando o e‑CIGA diz que o CPF já está cadastrado:

• O sistema está informando que já existe um usuário com esse CPF na base.
• Mesmo que o usuário não apareça para quem está tentando cadastrar, ele está registrado “por trás” (no Keycloak e/ou no e‑CIGA).

Isso significa:

• O usuário não deve ser cadastrado de novo;
• O que precisa é verificar e ajustar o cadastro já existente.

2. O que precisamos fazer 🛠️

Quando recebemos a informação de que um CPF “já está cadastrado” e o usuário não aparece corretamente no e‑CIGA, o procedimento é:

2.1. Localizar o usuário pelo CPF

1. Acessar o Keycloak.
2. Ir até a seção de usuários.
3. Buscar pelo CPF informado.

Se o usuário aparecer:

• Confirmar que é a pessoa correta (nome e e‑mail ajudam a identificar).

2.2. Conferir se os dados cadastrais estão atualizados

No registro do usuário, verificar:

1. Nome completo

   • Conferir se está correto.
   • Corrigir nome incompleto ou com erro de digitação.

2. E‑mail

   • Verificar se é o e‑mail atual da pessoa.
   • Atualizar se estiver errado ou desatualizado.

3. Role de acesso (perfil/role)

   • Checar se o usuário está com a role de acesso habilitada para o e‑CIGA.
   • Se não estiver:
     • Adicionar a role adequada de acesso ao sistema.

4. Vínculo de setor e cargo

   • Ver se o usuário tem:
     • Setor vinculado (unidade de lotação);
     • Cargo/função vinculado.

   Se estiver faltando:

   • Vincular o setor correto (ex.: Contabilidade, RH, Protocolo).
   • Vincular o cargo/função (ex.: Analista, Técnico, Gestor).

Esses vínculos são fundamentais para:

• Aparecer nas listas de usuários do e‑CIGA;
• Receber permissões e perfis compatíveis com suas funções.

3. Ajustes e validações finais

Após corrigir o cadastro:

1. Salvar as alterações no Keycloak.

2. Confirmar se o usuário está:

   • Com nome e e‑mail atualizados;
   • Com role de acesso habilitada;
   • Com setor e cargo devidamente vinculados.

3. Em seguida, o usuário passa a:

   • Acessar normalmente o e‑CIGA com seu CPF/login;
   • Aparecer nas telas de seleção (responsável, carga, assinante etc.), conforme perfil.

4. Fluxo resumido 🧭

Quando o sistema informa “CPF já está cadastrado”:

1. Entender que não é para criar um novo usuário com esse CPF.
2. A equipe com acesso ao Keycloak deve:
   • Buscar o usuário pelo CPF;
   • Atualizar:
     • nome,
     • e‑mail,
     • role de acesso,
     • setor,
     • cargo;
   • Salvar e liberar o uso normal no e‑CIGA.

5. Boa prática

• Evitar cadastros duplicados para o mesmo CPF.
• Sempre tratar esses casos via ajuste do usuário existente no Keycloak.
• Garantir que cada usuário tenha:
  • dados corretos,
  • role de acesso ativa,
  • setor e cargo vinculados.

Assim, o CPF permanece como chave única confiável para o acesso ao e‑CIGA.