Gustavo - Estudo técnico sobre viabilidade de utilizar o Portal do Cidadão sem o Alpha
Data: 19/09/22
Autores:
- Rafael Passos Dos Santos (Assessor)
- Lucas de Souza e Souza (Assessor)
1. Objetivo
Verifica a possibilidade de gerenciar os serviços do portal do cidadão por outra aplicação, para usuário de entidades externas.
2. Introdução
Para que um usuário de uma entidade externa possa gerenciar os serviços do portal do cidadão, será necessário a criação de uma outra aplicação (API).
Atualmente só é possível cadastrar, listar, editar um serviço por meio do alpha.
3. Desenvolvimento
A carta de serviço consome outros sistemas para consumir alguns dados, por exemplo:
- Organograma - Obter departamentos e hierarquias dos departamentos e endereços.
- Eestado - Obter departamentos
Com esse cenário, vindo de uma entidade externa, será necessário consumir aplicações externas para obter dados dos departamentos, ou criar de uma forma genérica uma estrutura para guardar os dados dos departamentos externos. Esses dados são essenciais, pois com eles, o serviço tem um ou vários endereços onde pode ser atendido, qual ou quais departamentos podem atender aquele serviço, etc.
Deverá ser criado a documentação de como consumir a API, para que entidades externas que precisem cadastrar seus serviços para o portal do cidadão, possam consultar.
A entidade externa deverá solicitar o acesso a api, por meio de chamado, para que seja liberado o acesso ao sistema. Com acesso ao sistema, a entidade externa irá implementar e consumir a API
Carta de Serviço:
Para se cadastrar uma carta de serviços é necessário informar qual a Unidade gestora do departamento, nesse caso, a aplicação salva o ID da unidade gestora do departamento. Minha sugestão é que seja criado um novo campo, por exemplo: Origem.
Assim a carta de serviços teria o departamento e a origem
Departamento: SETIC (02) - Origem : GOVRO
Departamento: Atendimento BB (022) - Origem: BancoDoBrasil.
Assim teríamos o controle do departamento e de qual entidade seria essa carta de serviço.
Dessa forma, quando um usuário do banco do brasil acessar a carta de serviço, poderiam ser filtradas somente as cartas de serviços do banco do brasil.
Serviço:
Nos serviços, para um melhor controle, seria necessário criar um outro campo (Tipo de Serviço), com os seguintes valores: EXTERNO/INTERNO.
Para preencher o campo origem do serviço, usaremos a sigla da nova aplicação por exemplo: EGCS (externo gerenciamento da carta de serviço).
No campo cadastradoPor, usaremos uma sigla com a junção da entidade + o departamento. exemplo: BBDepartamento, CXDeparamento, etc.
No campo AreaResponsavel, usaremos a mesma sigla anterior: BBDepartamento.
Possíveis histórias
| História | Pontos |
| Criar a aplicação e toda estrutura da aplicação, entidades, interfaces e toda configuração. | 8 pts |
| Adicionar o ELK na aplicação. | 3 pts |
| Criar autenticação para a API, ou usar uma existente. exemplo: central do desenvolvedor. | 5 pts |
| Serviço | |
| Criar uma action método POST, para cadastrar um serviço | 8 pts |
| Criar uma action método PUT, para atualizar os dados do serviço de meio externo. | 5pts |
| Criar uma action método GET, para buscar os serviços. | 5 pts |
| Criar uma action método GET, para buscar um serviço especifico. | 3 pts |
| Carta de Serviços | |
| Criar uma action método POST, para cadastrar a carta de serviço. |
8 pts |
| Criar uma action método PUT, para atualizar a carta de serviço. | 5 pts |
| Criar uma action método GET, para obter as cartas de serviços. | 5 pts |
| Criar uma action método GET, para obter uma carta de serviço especifico. | 3 pts |
| Total: | 58 pts |
4. Conclusão
Visto a necessidade de que se possa fazer o gerenciamento do serviços do portal do cidadão por uma entidade externa, algumas mudanças terão que serem feitas.