# 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.