Pentágono - Agregar steps de filiação com dependentes

Data: 19/09/03/22

Autores:

1. Alexandre dos Santos Freire Ferreira (Assessor)

---

1. Objetivo

Avaliar o impacto na restruturação no cadastro de Filiação, Dependentes e Cônjuge em um Step de Parentes no Pentágono.

2. Introdução

Surgiu no Pentágono a necessidade de centralizar o cadastro de Filiação,  Dependentes e Cônjuge em um step genérico de Parentes com o objetivo de centralizar as informações e permitir o cadastro das informações de maneira eficiente. Além disso, ao realiza a análise de código do projeto, foi verificado o aumento de sua complexidade pois, as mesmas informações como CPF, nome e tipo de parentesco estão sendo inseridos e visualizados em lugares diferentes.

3. Desenvolvimento

Atualmente, as informações básicas para cadastro de cônjuge, filiação e parentesco são nome e CPF conforme as imagens a seguir:

Imagem: Formulário de Dados Básicos

Imagem: Formulário de dependentes

Imagem: Formulário de filiação

Foi verificado que a API de Pessoas Físicas possibilita cadastrar somente o nome do parente casa o usuário não possua o CPF para do mesmo conforme o estudo "Cadastro de Pessoas Físicas sem CPF"

Imagem: Requisição para cadastrar Parente sem CPF

• Requisição para buscar tipos de parente:

• Rotas utilizadas atualmente para cadastro de Dependentes Filiação e Cônjuge 

• Novas rotas da API de Pessoas para cadastrar parentes

• Corpo da requisição para adicionar parentes:

3.1 Cenários

1º - Cenário : Cadastrar parente com CPF existente no E-Estado

• Validar se o CPF do Parente já existe na base de dados do E-Estado
• Caso CPF do Parente já existir na base do Estado, exibir formulário com o Nome e CPF do parente bloqueados para adição.
• Exibir as opções de tipos de parente
• Caso a Pessoa ainda não tenha cadastrado seu parente com o CPF informado, vincular parente a pessoa com o tipo de parente

2º - Cenário : Cadastrar parente com CPF inexistente no E-Estado

• Validar se CPF do Parente já existe na base de dados do E-Estado
• Caso CPF não existir na base do Estado, exibir formulário com as informações necessárias para cadastrar parente
  
• Caso a Pessoa ainda não tenha cadastrado seu parente, registrar e vincular parente a pessoa com o tipo de parente

3º - Cenário : Cadastrar parente sem CPF na lista de parentes

• Validar se o Nome do Parente já existe na lista de parentes
• Caso Nome do Parente já existir na lista de parentes, informar que o Nome já existe e exibir as opções de tipo de parente.
• Caso a Pessoa ainda não tenha cadastrado seu parente, vincular parente da pessoa com o tipo de parente selecionado.

3.2 Funcionalidades

• Permitir cadastrar o cônjuge no step de "Parentes"
• Permitir vincular parente como dependente durante ou após o registro
• Redefinir configuração do step de parentes
• No select  de Tipos de Parente, permitir pai ou mãe como opção obrigatória  no step de parentes caso necessário 

Atualmente, o Pentágono permite configurar se o tipo de dependente será exibido no formulário ou se ele será obrigatório conforme a imagem a seguir:

Imagem: configuração atual do step de dependentes

Para atender a necessidade do outros sistemas que utilizam o Pentágono, o administrador poderá definir se as opções "Pai" ou Mãe serão obrigatórias ao marcar tipo de dependente como ativo. 

Imagem: Nova configuração do step de parentes.

3.3 Ações

• Remover o cadastro do cônjuge no step de "Dados Pessoais" 
• Mudar o step de "Dependentes" para "Parentes"
• Criar step de parentes para exibir e adicionar parentes 
• Refatorar o CRUD de cadastro de Cônjuge, Parentescos e Filiações para Parentes
• Atualizar a configuração do modelo de formulário
  
• possibilidade de obrigar a cadastra o cônjuge e um pai ou mãe caso seja a necessidade do sistema

4. Conclusão

A implementação que altera os métodos de cadastro de Parentes centralizará as informações, facilitando a manutenção de código e usabilidade da aplicação. Lembrado que as configurações no modelo de formulário também devem ser atualizadas.