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

Data: 19/09/22

Autores:

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.