Vincular a carta de serviços a um CNPJ
Data de elaboração | 20/10/2022 |
---|---|
Responsável pelo estudo |
|
Equipe do estudo |
|
Alvo | Alpha - Carta de serviços |
Origem |
Implementação: Implementação de melhorias visuais e funcionais na tela inicial do Portal do Servidor. |
Objetivo |
O presente estudo tem como objetivo analisar o que terá que ser feito para alterar a vinculação da carta de serviços através do CNPJ e os possíveis impactos às aplicações dependentes da API da carta de serviços |
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 tem como objetivo analisar o que terá que ser feito para alterar a vinculação da carta de serviços através do CNPJ e os possíveis impactos às aplicações dependentes da API da carta de serviços
1.1 JUSTIFICATIVA
Há uma necessidade de integrar carta de serviços de outras instituições que também utilizarão o Alpha, porém não fazem parte da hierarquia interna do Governo. Para essas instituições foi levantada a hipótese de se realizar este estudo para verificar a possibilidade de também utilizar o CNPJ para identificar as entidades do governo nas cartas de serviço.
1.2 RESULTADOS ESPERADOS
Espera-se que, após este estudo, seja possível avaliar a possibilidade de se utilizar o CNPJ para criar e buscar a carta de serviços de instituições internas e externas do Governo
2. Introdução
O Alpha é uma aplicação desenvolvida pela SETIC - esta é utilizada pelos servidores gestores das cartas de serviços do Estado de Rondônia.
3. Desenvolvimento - Melhorias na página inicial do Portal do Servidor
3.1 CENÁRIO ATUAL
A carta de serviços foi desenvolvida baseada em um identificador interno (unidadeOrcamentariaId), trata-se de um campo que identifica qual unidade orçamentária corresponde a determinada carta de serviços.
1. Tabela da carta de serviços
Nesta tabela esse campo é identificado com CodigoDaUnidadeGestoraDoDepartamento.
Para identificar qual a unidade que o servidor está lotado, utilizamos a rota no e-estado API trazendo as movimentações:es com os seguintes campos:
- codigoDaUnidadeOrcamentaria - código que identifica qual a unidade de origem do servidor
- codigoDaUnidadeGestoraDoDepartamento - código que identifica a unidade em que o servidor está lotado
- departamentoPadrao - flag que identifica que a movimentação é a padrão, ou seja, movimentação vigente do servidor.
Obs: Nesta rota, não existe a informação de qual é o CNPJ da unidade.
RELACIONAMENTO COM OUTRAS TABELAS
Foi verificado que o campo que relaciona com as outras tabelas (Serviços), trata-se do campo "Id", ou seja, o campo "CodigoDaUnidadeGestoraDoDepartamento" não é utilizado para relacionamento.
3.2 SOLUÇÃO
É possível implementarmos duas soluções:
- Incluir o campo CNPJ na tabela de Carta de Serviços e Obtenção dos CNPJs da Unidade Gestora do Departamento e da Unidade Orcamentaria do servidor na rota de movimentações. Dessa forma, será padronizada a busca por CNPJ, retirando o campo de Unidade orçamentaria das buscas.
- Incluir o campo CNPJ na tabela de Carta de Serviços e adicionar o campo CNPJ nas buscas da carta de serviço. Dessa forma, a carta poderá ser buscada tanto por unidade orçamentária quanto por CNPJ, realizando a tratativa de acordo se um dos campos estiver nulo.
Após estudosa de melhorias nestes pontos de atenção,análise, foi possível constatar levantarque algumasserá prototipagenspossível realizar a busca por CNPJ, para melhorarisso estaé tela.
1 - Remover a barra superior comcriar o nomecampo (apenase nestaoutras tela);
2no -item Criação de elementos separados por Informativos, para aumentar a relevância de cada um:
3 - Bem como a criação de elementos apenas para Campanhas:
4 - A criação de dois botões de Ver Todos, assim como o número existente - mais visíveis ao usuário:
Com estas melhorias, a tela incial deverá ficar com este design:
3.3 IMPLEMENTAÇÃO E HISTÓRIAS DE USUÁRIOS
Para aplicar a solução acima será necessário as seguintes histórias de usuários:
O que? | Pontos | Regras | Produto |
- |
3 |
Deixar o campo CodigoDaUnidadeGestoraDoDepartamento como nullable |
Alpha API |
- Adicionar parâmetro CNPJ nas rotas de ObterCartaDeServicos na |
5 |
As rotas receberão dois campos: 1) CodigoDaUnidadeOrcamentaria - para as unidades do 2) CNPJ - para as unidades externas A rota deve ser alterara para que no caso do Rotas a serem alteradas:
|
Alpha API |
- Adicionar parâmetro CNPJ nas rotas de ObterCartaDeServicos no Alpha WEB | 3 |
|
Alpha |
Portal do servidor | 3 |
|
Portal do |
|
3.4 POSSÍVEIS IMPEDIMENTOS
Não foram encontrados possíveis problemas de implementação.
4. Conclusão
Conclui-se que para a devida implementação destas melhorias, o time poderá, além consultar este documento, consultar a PO e os demais integrantes da SETIC, pois objetiva-se uma real melhora de usabilidade deste sistema.