¶ Possíveis inconsistências na integração do Atualização Cadastral
| Data de Elaboração | Responsável pelo Estudo | Alvo | Origem | Objetivo |
|---|---|---|---|---|
| 21/01/2025 | Lucas Bennesby Lima (Estagiário) | Portal do Servidor | Identificação e Desacoplação: mapear a integração dos sistemas e remover o uso da API do Atualização cadastral no Portal do Servidor | Mapear a integração dos sistemas para maior entendimento e facilidade de adaptações, correções e melhorias |
¶ 1. Justificativa
Dado o recente lançamento do Atualização cadastral - AC, notou-se que certos recursos utilizados no Portal do Servidor - PS entraram em depreciação, como a API do AC, este estudo visa mapear tais recursos para uma melhor tomada de decisão.
¶ 2. Desenvolvimento
¶ 2.1 Na Controller
Foi identificado o uso da API no arquivo “HomeController.cs" no método “NotificacaoAtualizacaoCadastral", usado para realizar notificação de pendências na atualização cadastral:
¶ 2.2 Na view
Atualmente é utilizada para gerar uma notificação em formato de badge que fica na view “MenuMinhasInformacoes.cshtml” das linhas 18 a 29:
Na interface web:
¶ 2.3 Na Model
Na model “MinhasInformacoesViewModel” existem duas propriedades utilizadas somente no consumo da API: “PodeNotificar” e “SucessoAoVerificar”:
¶ 2.4 Na Service/Interface
Onde se encontra a raiz da API no sistema, está particionada em 3 arquivos utilizados exclusivamente para essa API:
¶ 2.4.1 “IAtualizacaoCadastralAppService”
¶ 2.4.2 “AtualizacaoCadastralAppService”
¶ 2.4.3 “IAtualizacaoCadastralApi”
¶ 2.5 Outras utilizações
Além da utilização da API, o Portal do Sevidor contém dois botoes na view “MenuMinhasInformacoes.cshtml”, da linha 48 a 62, que direcionam para as seguintes Url’s do Atualização cadastral:
Na interface web:
O botão “Informações Cadastrais” está direcionando para uma URL desativada: Informações Cadastrais
O botão “Atualizar cadastro” redireciona o usuário para a página inicial do sistema Atualização Cadastral: Atualizar Cadastro
¶ 2.6 Historias necessárias e complexidade
| História | Complexidade |
|---|---|
| Remoção dos trechos de código que envolvem a API | 3 |
| Alteração ou remoção do botão que contém a URL inválida do Atualização Cadastral | 3 |
| Ideação para nova forma de notificar o servidor a respeito da situação de sua atualização cadastral | 8 |
¶ 3. Proposta de solução
- Remoção dos trechos de código que envolvem a API: Pretende tornar o código do projeto mais limpo e prever possíveis gargalos;
- Alteração ou remoção do botão que contém a URL inválida do Atualização Cadastral: Dar nova funcionalidade ao botão ou removê-lo, visto que atualmente está direcionando para uma página inexistente, tornando a experienciar do usuário menos agradável;
- Adicionar uma forma de notificar o servidor a respeito da situação de sua atualização cadastral: Dada a depreciação da API utilizada para realizar essa notificação, torna-se necessário a criação de uma nova ferramenta para alertar o servidor sobre inconsistências em sua ficha cadastral.
¶ 4. Conclusão
O estudo visa seguir as boas práticas de desenvolvimento ao mapear código obsoleto e não utilizado, evitando confusões e melhorando a performance do sistema.