Ir para o conteúdo principal

Análise para integração do consumo das informações do Consignação no Portal do servidor (Sistema Consignação)

Data de elaboração 16/08/2023
Responsável pelo estudo
  1. Emanuel Rufino Alcantara de Lima (Analista)
Equipe do estudo
  1. Arthur Leandro dos Anjos Nunes (Product Owner)
  2. André Honório de Andrade Silva (Técnico)
  3. Alef Carvalho (Analista)
  4. Gustavo Felix (Analista)
  5. Thiago Alencar (Estagiário)
Alvo Portal do Servidor
Origem

Implementação: Análise para integração do consumo das informações do Consignação no Portal do servidor 

Objetivo

Levantar as formas de integração para consumo das informações do consignação pelo portal do servidor

Documentação correlata
Observações O presente estudo pretende também pretende levantar as Historias dos Cards para a Sprint 
1. Objetivo

O Presente estudo objetiva levantar as formas de integração para consumo das informações do consignação pelo portal do servidor.

1.1 JUSTIFICATIVA

O portal do servidor possui diversas integrações com outros sistemas, a ideia é que o portal do servidor seja um ponto único em que o servidor acessa suas informações. O sistema consignação possui diversas informações desejadas pelo servidor e para que sejam mostradas, deve haver uma forma segura em que o portal do servidor acesse tais informações. 

1.2 RESULTADOS ESPERADOS

Espera-se que após a conclusão desse estudo seja possível mostrar como será possível a forma que o portal do servidor acessará as informações do sistema consignação.

2. Introdução

3. Desenvolvimento

3.1 CENÁRIO ATUAL

Atualmente a funcionalidade de quitação automática apresenta problemas de completude, permanecendo algumas averbações ativas mesmo com o valor restante a pagar zerado.

3.2 SOLUÇÕES PROPOSTAS

Devido ao alto nível de complexidade encontrada na funcionalidade de quitação automática, é possível estimar que uma alternativa mais rápida e que representa menos riscos a integridade geral do código fonte, seria a de desenvolver funcionalidades complementares à quitação automática.

A primeira trata-se de uma tela nova no sistema com um relatório, que informa o usuário se a quitação foi bem sucedida ou não. Este relatório trará todas as parcelas indevidamente ativas.

A segunda funcionalidade trará um botão na mesma tela anteriormente criada, que executa um script de atualização do status das parcelas que não foram devidamente quitadas.

3.2.1 Relatório de Averbações Ainda Não Quitadas

Atualmente os dados são obtidos via script direto em banco de dados, utilizando o seguinte script:

SELECT DISTINCT
a.COD_AVERBACAO,
a.VLR_PARCELA,
a.VLR_PAGO,
a.VLR_A_PAGAR,
a.MES_REFERENCIA,
a.ANO_REFERENCIA,
QTD_PARCELA,
a.IND_STATUS,
a.NUM_MATRICULA,
a.DAT_CRIACAO,
a.DAT_ALTERACAO,
a.COD_VERBA
FROM
AVERBACAO a
JOIN CORRESPONDENTE c ON
c.COD_CORRESPONDENTE = a.COD_CORRESPONDENTE
JOIN AVERBACAO_DESCONTO ad ON
ad.COD_AVERBACAO = a.COD_AVERBACAO
JOIN VERBA v on
v.COD_VERBA = a.COD_VERBA
join TIPO_VERBA tv on
tv.COD_TIPO_VERBA = v.COD_TIPO_VERBA
WHERE
a.VLR_A_PAGAR = 0
AND a.IND_STATUS = 'ATV'
and v.COD_TIPO_VERBA = 1
;

Com base neste script é possível se obter todas as parcelas que ainda estão incorretamente ativas, logo é possível criar uma tela com esta filtragem para que - após executado o processo de quitação, o usuário com maior permissão de acesso possa constatar via sistema se o processo está certo ou não, o que eliminará a necessidade de intervenção manual da SETIC na elaboração deste relatório.

3.2.2 Funcionalidade de Atualização de Status das Parcelas

A partir do relatório gerado pelo sistema, será possível desenvolver uma nova funcionalidade que complementará a quitação. Esta funcionalidade utilizará a filtragem criada para atualizar o status das averbações que não foram devidademente atualizadas com a quitação automática. Estima-se que esta funcionalidade complementar não trará problemas a estabilidade do sistema como um todo e então entregará o resultado necessário para o momento em questão, no qual o sistema passa por uma série de problemas relacionados a integridade de dados e segurança.

Atualmente a SETIC conta com o apoio da CAGD para a atualização manual dos dados em banco de dados, então uma breve colaboração entre a CODE e a CAGD será necessária para o desenvolvimento desta funcionalidade.

3.2 HISTÓRIAS DE USUÁRIO

Para aplicar a solução acima será necessário as seguintes histórias de usuários:

O que? Pontos Regras Produto
Criar tela com relatório de parcelas relatório de servidores cujo as averbações com o valor a pagar = 0 e quantidade de parcelas = 0 com tipo de empréstimo = 1, a partir de script de filtragem existente. 8

Permitir apenas usuários administradores acessarem esta tela.

Consignação
Criar botão na tela de relatório, que acione uma funcionalidade de corrigir o status das averbações com o valor a pagar = 0 e quantidade de parcelas = 0 com tipo de empréstimo = 1.  8

Permitir apenas usuários administradores acessarem esta tela.

Consignação
Salvar log com informações sobre quem realizou a ação de corrigir status das averbações. 5

Salvar logs com todas as informações pertinentes ao usuário.

Salvar informações de quais foram as averbações afetadas.

Consignação

3.3 POSSÍVEIS IMPEDIMENTOS

É possível que existam alguns problemas relacionados a tecnologia utilizada na criação do sistema, ou a falta de disponibilidade da CAGD para colaboração com a CODE no desenvolvimento destas funcionalidades.

4. Conclusão

Conclui-se que a entrega destas funcionalidades complementares à quitação automática trarão benefícios ao sistema e a todos os servidores que fazem empréstimo consignado.