API do Programa de Gestão (PGD)

Repositório com o código-fonte da API do Programa de Gestão (PGD).

Contextualização

O Programa de Gestão, segundo a Instrução Normativa Conjunta SEGES-SGPRT n.º 24, de 28 de julho de 2023, da Secretaria de Gestão e Inovação (SEGES e da Secretaria de Gestão de Pessoas e de Relações de Trabalho (SGPRT) do Ministério da Gestão e da Inovação em Serviços Públicos (MGI), é um:

programa indutor de melhoria de desempenho institucional no serviço público, com foco na vinculação entre o trabalho dos participantes, as entregas das unidades e as estratégias organizacionais.

As atividades mensuradas podem ser realizadas tanto presencialmente quanto na modalidade de teletrabalho.

O objetivo desta API integradora é receber os dados enviados por diversos órgãos e entidades da administração, por meio dos seus próprios sistemas que operacionalizam o PGD no âmbito de sua organização, de modo a possibilitar a sua consolidação em uma base de dados.

Instalando a API em ambiente de desenvolvimento

Instalar Docker CE (as instruções variam conforme o sistema operacional).

Clonar o repositório:

git clone git@github.com:gestaogovbr/api-pgd.git

Variáveis de ambiente do Fief

A gestão de usuários é realizada por uma aplicação chamada Fief. Para obter as suas configurações iniciais, as quais serão preenchidas no passo seguinte,

Será pedido um endereço de e-mail e uma nova senha para o usuário administrador do Fief.

O script irá criar o arquivo .env as configurações necessárias referentes a:
- o servidor smtp para envio de e-mails,
- o banco de dados (Postgres), e
- a ferramenta de gestão de usuários (Fief), gerados no passo anterior.
Utilize o comando:
```
make init-env
```
Na gestão de usuários e controle de acesso da API é usada a aplicação Fief. Para o seu correto funcionamento pela interface Swagger UI, é necessário que ela seja alcançável pelo mesmo host, tanto no navegador quanto dentro do container. Para isso, em ambiente de desenvolvimento, será necessário estabelecer um alias fief para o host localhost no arquivo /etc/hosts. Abra-o e acrescente a seguinte linha:
```
127.0.1.1	fief
```
Para iniciar a API, suba os containers:
```
make up
```
⚠️ Caso apareçam erros de permissão em "database", pare os containers (ctrl + C) e digite:
```
sudo chown -R 999 ./database/
```
Para ajustar as permissões das pastas database e todas as suas subpastas
Por fim, é necessário configurar o Fief para incluir dados necessários ao funcionamento da API PGD (URI de autenticação, campos personalizados de usuários). Use:
```
make fief-configure-instance
```
Estarão disponíveis os seguintes serviços:
- http://localhost:5057 -- A API e sua interface Swagger UI em http://localhost:5057/docs para interagir e testar suas funcionalidades
- http://fief:8000/admin/ -- interface do Fief para cadastro de usuários da API e outras configurações

Usuário administrador e cadastro de usuários

Ao realizar a configuração inicial do Fief já é criado um usuário administrador, o qual pode alterar algumas configurações e cadastrar novos usuários.

O usuário e senha desse usuário administrador ficam configurados nas variáveis de ambiente FIEF_MAIN_USER_EMAIL e FIEF_MAIN_USER_PASSWORD (vide passos 4 e 5 da configuração do ambiente).

Ajustando os containers

Durante o desenvolvimento é comum a necessidade de inclusão de novas bibliotecas python ou a instalação de novos pacotes Linux. Para que as mudanças surtam efeitos é necessário apagar os containers e refazer a imagem docker.

Desligando e removendo os contêineres:
```
make down
```
Construindo novamente o Dockerfile para gerar uma nova imagem:
```
make rebuild
```
O comando rebuild usa o parâmetro --rm do comando docker para remover a imagem criada anteriormente.
Agora a aplicação já pode ser subida novamente:
```
make up
```
Alternativamente você pode subir a aplicação sem o parâmetro detached -d possibilitando visualizar o log em tempo real, muito útil durante o desenvolvimento. Para isso use o comando abaixo:
```
docker compose up
```

Arquitetura da solução

O arquivo docker-compose.yml descreve a receita dos contêineres que compõem a solução. Atualmente são utilizados 4 containers:

um rodando o sistema gerenciador de banco de dados Postgres 11,
outro rodando a API,
outro rodando o sistema de gestão de usuários e controle de acesso Fief, e

Dicas

Para depuração, caso necessite ver como está o banco de dados no ambiente local, altere a porta do Postgres no docker-compose.yml de "5432" para "5432:5432" e o banco ficará exposto no host. Depois, basta usar uma ferramenta como o DBeaver para acessar o banco.
O login e senha do Fief são definidos no item 5 do passo a passo em "Instalando a API em ambiente de desenvolvimento". Depois disso eles ficam no arquivo .env, bem como o client_id e o client_secret usados na autenticação da API (variáveis FIEF_CLIENT_ID e FIEF_CLIENT_SECRET, respectivamente).
O login, senha e nome do banco do Postgres estão em variáveis de ambiente. A forma mais prática de fazer isto em ambiente de desenvolvimento é criando-se um arquivo .env, conforme o item 6 do passo a passo em "Instalando a API em ambiente de desenvolvimento".
Para fazer deploy usando algum outro banco de dados externo, basta redefinir a variável de ambiente SQLALCHEMY_DATABASE_URL no contêiner da aplicação.

Rodando testes

Para executar os testes:

make tests

Para rodar uma bateria de testes específica, especifique o arquivo que contém os testes desejados. Por exemplo, os testes sobre atividades:

make test TEST_FILTER=test_create_huge_plano_trabalho

washolive / api-pgd