/Sistema_Programa_de_Gestao_Susep

Primary LanguageC#

Recomendação

Material de apoio

Para acompanhar sessões gravadas de instalação e configuração do sistema, assista os vídeos nos seguintes links:

Caso esteja interessado na instalação via Docker, acesse a documentação referente no banch docker, arquivo docker/README.md.

Parceiros

  • SUSEP - Superintendência de Seguros Privados
  • DTI ME - Diretoria de Tecnologia da Informação do Ministério da Economia
  • STI UFC - Superintendência de Tecnologia da Informação da Universidade Federal do Ceará

Introdução

Esse roteiro visa detalhar os procedimentos a serem seguidos para instalar e configurar o Sistema de Programa de Gestão, aqui chamado SISPG, ferramenta de apoio tecnológico para acompanhamento e controle do cumprimento de metas e alcance de resultados nos termos da Instrução Normativa Nº 65, de 30 de julho de 2020. Esse é um documento técnico destinado às áreas de tecnologia dos órgãos que visam adotar o SISPG como ferramenta de gestão do teletrabalho. Detalha tecnologias, padrões e pacotes que devem ser implantados para ter o sistema funcionando dentro dos ambientes de cada órgão.

Recursos Mínimos

Dimensionamento de recursos, pré-requisitos, dependências, etc.

  • ✔ Internet Information Services (IIS) 7.5 ou mais novo
  • ✔ Microsoft SQL Server 2012 ou, Microsoft SQL Server 2016 SP2 Express ou, Microsoft SQL Server 2019
  • ✔ Microsoft .NET Core 2.2 1 -Windows Server Hosting
  • ✔ Microsoft .NET Core Runtime –2.2.1 (x64)
  • ✔ Microsoft .NET Core Runtime –2.2.1 (x86)
  • ✔ Microsoft .NET Core Runtime –3.1.8 (x64)
  • ✔ Microsoft .NET Core Runtime –3.1.8 (x86)
  • ✔ Microsoft .NET Core SDK 3.1.403 (x64)
  • ✔ Microsoft Visual C++ 2015-2019 Redistributable (x64)
  • ✔ Microsoft Visual C++ 2017 Redistributable (x86)
  • ✔ Microsoft Windows Desktop Runtime –3.1.9 (x64)

Infraestrutura

Sequência de Passos

  1. Habilitar IIS
    Imagem de exemplo.
    • Realizar a instalação através do Server Manager (Add roles and features);
    • Selecionar o Role Web Server (IIS);
    • Selecionar (IIS);
    • Em Application Development: ASP.NET
  2. Instalar os arquivos da pasta "dependências".

Diagrama de Instalação

Passa-se, então, à configuração dos componentes da aplicação. O sistema segue modelos de arquitetura de micro serviços e utiliza estruturas separadas para o front-end e para o back-end. Diante disso, faz-se necessário configurar diferentes pacotes para o correto funcionamento da aplicação.

Sequência de instalação sugerida:

Etapa Tópico Módulo
1ª Etapa Base de Dados
2ª Etapa Back-End API
3ª Etapa Front-End Gateway e APP

Importante: Sugere-se as etapas acima destacadas para a correta instalação do SISGP.

Base de dados

O sistema foi desenvolvido utilizando o banco de dados Microsoft SQL Server com a ferramenta ORM da Microsoft Entity Framework Core nas funções de persistência e com SQL ANSI nas funções de consulta a dados. Em teoria, essa configuração permite que diferentes tecnologias de bancos de dados sejam utilizadas. Entretanto, a equipe de tecnologia da Susep garante a compatibilidade e realizou testes apenas com o Microsoft SQL Server.

Sequência de passos (SQL Server)
  1. Criar banco de dados DBSISGP;
  2. Executar os scripts que se encontram na pasta install/ na seguinte ordem:
    1. Obrigatório: install/1. Criação da estrutura do banco de dados - Obrigatorio.sql;
    2. Obrigatório: install/2. Inserir dados de domínio - Obrigatorio.sql;
    3. Obrigatório: install/Criação da tabela pessoa alocacao temporaria - Obrigatorio.sql;
    4. Se for ambiente de desenvolvimento/homologação: install/4. Inserir dados de teste - Opcional.sql;
    5. Se estiver atualizando de versões anteriores da V7: 5. Alteracoes da estrutura do BD para a V7.sql;
    6. Se estiver atualizando da V7 para a V8: 6. Alteracoes da estrutura do BD para a V8.sql.
Importação de usuários (desenvolvimento/homologação/produção)

Uma vez criada a estrutura de banco de dados, é necessário fazer a importação dos dados do órgão no SIAPE para a estrutura do sistema.

TOME NOTA: O script Inserir dados de teste traz um exemplo de carga com dados fictícios (CPFs gerados aleatoriamente e unidades da estrutura da Susep), serve para permitir o acesso e a validação do sistema. Assim que o sistema entrar em produção, os dados da tabela Pessoa e Unidade cadastrados por esse script devem ser apagados da base de dados.

Os perfis do sistema serão derivados da estrutura real do órgão. Desse modo, servidores que não tem função de chefia no órgão recebem valor null na coluna tipoFuncaoId da tabela Pessoa deste modo terão habilitadas apenas funções de acompanhamento dos seus próprios planos de trabalho, ao passo que servidores com função de chefia poderão ter acesso aos planos de trabalho das suas respectivas equipes e terão acesso às funções de programas de gestão (cadastro, seleção, avaliação, etc). Servidores que trabalham na área de indicadores poderão, além de acompanhar seus próprios planos de trabalho, cadastrar as listas de atividades do órgão e dos demais setores.

Sugestão Carga de dados

https://github.com/henrique-prog/pdg-carga-de-dados

Configurar gestores do sistema (1º Acesso)

Em determinadas situações como, por exemplo, no caso fictício em que o titular da unidade está de férias e o substituto de licença, pode ser necessário ter pessoas no órgão com acesso total ao sistema para evitar que o trabalho do setor fique parado. Para suprir tal necessidade, existe o perfil Gestor com controle total da ferramenta.

O cadastro de gestores do sistema é feito na tabela CatalogoDominio. Basta inserir um registro nessa tabela com a coluna classificação preenchida com o valor GestorSistema e a coluna descrição preenchida com o id da pessoa que terá perfil de gestor.

Aplicação

A publicação deve ser feita em algum servidor de aplicação. Sugere-se o Internet Information Services (IIS) na seguinte estrutura:

  1. Servidor web, acessível apenas por meio da máquina do Gateway, em que fica publicada a API.
    • SISGP
      • API
  2. Servidor web, aberto para a internet, em que ficam publicados o Gateway (pasta Gateway) e o front-end (pasta APP).
    • SISGP
      • APP
      • Gateway

As pastas APP, gateway e APIdevem ser convertidas em aplicações no IIS e sugere-se que rodem sob um mesmo Application Pool.

TOME NOTA: Para ambiente de desenvolvimento/homologação, é suficiente apenas servidor interno. Já para produção, faz-se necessário um servidor interno e outro externo, e nesse caso as pastas Gateway e APP deverão estar no servidor externo enquanto a pasta API estará no servidor interno.

As pastas APP, Gateway e API devem ser convertidas em aplicações no IIS e sugere-se que rodem sob um mesmo Application Pool. Os nomes e as estruturas das pastas poderão variar de acordo com a conveniência do Órgão, todavia será importante conhecer o caminho para cada uma delas.

Para facilitar o entendimento do roteiro, considera-se que os seguintes caminhos foram configurados:

  • APP: https://**servidorExterno**/sisgp/app
  • Gateway: https://**servidorExterno**/sisgp/gateway
  • API: https://**servidorInterno**/sisgp/api

Sequência de passos (.NET)

  1. Criar um Pool de Aplicativos chamado “sisgp”.
  2. Criar um novo site vinculado ao pool “sisgp” e apontando para o caminho físico da pasta “api”.
  3. Criar um novo site vinculado ao pool “sisgp” e apontando para o caminho físico da pasta “gateway”.
  4. Criar um novo site vinculado ao pool “sisgp” e apontando para o caminho físico da pasta “app”.

BACK-END!

O back-end concentra as regras de negócio e a interação da aplicação com o banco de dados e é composto por dois pacotes, API e Gateway.

API

A API é onde estão as regras de negócio, funcionalidades, operações de persistência e de consulta aos dados do sistema.

TOME NOTA: Alguns métodos só funcionarão quando invocadas por meio do Gateway. Entretanto, com algum conhecimento de chamadas HTTP é possível executar chamadas a alguns métodos da API. Por isso, recomenda-se que esse pacote fique em um ambiente acessível apenas por meio da máquina onde está hospedado o Gateway.

Sequência de Passos (pasta API)

  1. No arquivo web.config, alterar o valor da variável ASPNETCORE_ENVIRONMENT com um dos valores a seguir, de acordo com o ambiente: Dev, Homolog ou Prod.
  2. Em Settings/connectionstrings.AMBIENTE.json, informar os valores para conexão com o banco de dados, sendo data source o servidor, initial catalog o nome do banco, User ID o usuário e Password a senha.
  3. Em Settings/appsettings.AMBIENTE.json, configurar o servidor de e-mail SMTP e o LDAP para autenticação dos usuários - ESTA ETAPA PODE OCORRER APÓS VALIDAÇÃO DA APLICAÇÃO COM USERS DE TESTE.
Validação da Instalação – 1ª Etapa

Após instalação e configuração da base de dados e API, recomenda-se a validação dessas etapas pela seguinte URL:

**URL da Aplicação**/api/api/v1/dominio/ModalidadeExecucao

Se a instalação foi realizada corretamente, deverá retornar um json com as modalidades de trabalho da tabela catálogo domínio.

Em caso de erro
  1. Abra um prompt de comando
  2. Navegue até a pasta da API e digite o comando 
    Dotnet susep.sisrh.webapi.dll

O retorno é o possível erro.

Gateway

O Gateway adiciona camadas de segurança, cache e outros recursos à API. É essencial para o funcionamento do sistema, para a prevenção de ataques e outros problemas.

Sequência de Passos (pasta gateway)

  1. No arquivo web.config, alterar o valor da variável ASPNETCORE_ENVIRONMENT com um dos valores a seguir, de acordo com o ambiente: Dev, Homolog ou Prod.
  2. Em Settings/appsettings.**AMBIENTE**., informar a url da API no campo authority.
  3. Em Settings/ocelot.**AMBIENTE**.json, dentro do objeto ReRoutes, substituir todos os campos Host e Port pelas do servidor da API. Caso a API esteja com https, alterar todos os DownstreamScheme. Caso a API não esteja na raiz do servidor, completar os caminhos em todos os DownstreamPathTemplate. Já no final do arquivo substituir o campo BaseUrl pela url do gateway.
Validação da Instalação – 2ª Etapa

Após instalação e configuração do Gateway, recomenda-se a validação dessa etapa pela seguinte URL:

**URL da aplicação**/gateway/dominio/ModalidadeExecucao

Se a instalação foi realizada corretamente, deverá retornar um json com as modalidades de trabalho da tabela catálogo domínio (mesmo retorno da validação da API).

Em caso de erro:
  1. Abra um prompt de comando
  2. Navegue até a pasta do Gateway e digite o comando
Dotnet susep.sisrh.webapi.dll

O retorno é o possível erro.

Front-end!

O front-end é a camada de apresentação do sistema. Construída em angular, teoricamente, pode ser publicada em qualquer servidor de aplicação que rode node.js.

APP

ClientApp\dist\env.js

Nos dois pontos em que aparece, deve ser alterado de https://sitedoorgao/sisgp/gateway para o caminho do gateway no seu órgão.

ClientApp\dist\Index.html

A tag base deve ser alterada para refletir o caminho em que a aplicação está publicada entro do site do seu órgão. Exemplo: O acesso à aplicação é feito por meio do caminho https://sitedoorgao/sisgp/app, a tag deve ter o valor /app/.

web.config

A tag action do tipo Rewrite deve ser alterada para refletir o caminho em que a aplicação está publicada entro do site do seu órgão, conforme configuração feita anteriormente para o arquivo index.html.

Sequência de Passos (pasta app)
  1. No arquivo ClientApp/dist/env.js, alterar o valor das variáveis window.__env.identityUrl e window.__env.apiGatewayUrl para a url do gateway;
  2. No arquivo ClientApp/dist/index.html, dentro da tag <base />, colocar no href o caminho da publicação da pasta app no servidor;
  3. No arquivo ClientApp/dist/web.config, dentro da tag <action /> do tipo Rewrite, colocar na url o caminho da publicação da pasta app no servidor;
  4. Acessar a url do app e verificar se a instalação foi realizada corretamente. Ela deverá retornar a tela de login do sistema.
Validação da Instalação – 3ª Etapa

Após instalação e configuração da aplicação, recomenda-se a validação dessa etapa acesdo a aplicação com os usuários de teste cadastrados na carga de teste:

URL da aplicação

Usuários:
  • sisgp_gestor
  • sisgp_cg
  • sisgp_coget
  • sisgp_coordenador
  • sisgp_diretor
  • sisgp_servidor
  • sisgp_servidor1
  • sisgp_servidor2
  • sisgp_servidor3
  • sisgp_servidor4

Obs.: Senha para todos os usuários ("qualquer carácter")

ATENÇÃO Assim que o sistema entrar em produção, os dados da tabela Pessoa e Unidade cadastrados por esse script devem ser apagados da base de dados.

Volte à etapa Back-end e vincule o LDAP

Changelog

Nota da versão 7

Principais funcionalidades adicionadas:

  • Chefe passa a ter acesso a todos os planos dos servidores da sua unidade, mesmo que o plano tenha sido executado em outra unidade
  • Adição de tela para a consulta da estrutura hierárquica
  • Criação da possibilidade de reabertura de plano
  • Adição de botão para marcar/desmarcar todas as atividades ao criar um PGD
  • Ajustes gerais de layout

Principais bugs corrigidos:

  • Problemas no aceite do plano
  • Retirada de possibilidade de abrir mais de um plano de trabalho para o mesmo período
  • Ajustes na data de encerramento do plano
  • Atualização do tempo total do plano após alterar o periodo
  • Retirada da possibilidade de abrir mais de uma solicitação de exclusão da mesma atividade

Arquivos de configuração alterados:

Gateway:
  • Ocelot.json
    • Novas rotas: /pactotrabalho/{pactoTrabalhoid}/reabrir
API:
  • AppSettings.json
    • Configuração dos textos dos e-mails para deixar de ficar hard coded.
Banco de dados:
  • 5. Alteracoes da estrutura do BD para a V7.sql: Alterações na estrutura do banco
    • Aumento dos tamanhos dos campos Titulo e Entregas Esperadas da tabela ItemCatalogo;
    • Adição de campo na tabela PactoTrabalhoAtividade para informar onde (se local ou remoto) a atividade foi executada;
    • Adição de campos para registrar o chefe e o substituto da unidade.

Nota da versão 8

Principais funcionalidades adicionadas:

  • Agendamento presencial, funcionalidade ainda básica
  • Adição de notificações no quadro de pendências
  • Adição de links de refêrencias entre plano de trabalho e programa de gestão
  • Visualização de justificativa da nota

Principais bugs corrigidos:

  • Correção na funcionalidade de avaliação
  • Ajuste no calculo de horas do plano de trabalho
  • Correção no quadro Kanban, apenas atividades com descrição poderão ser finalizadas pelo quadro
  • Correção das notificações múltiplas

Arquivos de configuração alterados:

Gateway:
  • Ocelot.json
Banco de dados:
  • 6. Alteracoes da estrutura do BD para a V8.sql: Alterações na estrutura do banco