The 2018.1_gerencia_mais from fga-eps-mds

ℹ️ Sobre o projeto

Projeto desenvolvido durante as disciplinas de Engenharia de Produto de Software e Métodos de Desenvolvimento de Software da Universidade de Brasília, campus Gama.

O principal objetivo do projeto é oferecer uma forma de melhor alocar os médicos, de acordo com a necessidade do público. Com isso trazendo atendimentos mais efetivos, e uma melhor organização do quadro médico, fazendo com que os mesmos possam se organizar de uma forma melhor, a fim de cumprir as horas de trabalho de forma mais eficiente.

Gostou do projeto e gostria de contribuir? Acesse Contribua e saiba como fazer parte.

📈 Monitoramento de serviços

Nossos servidores de homologação e produção são monitorados constantemente, você pode visualizar em tempo real o consumo de recursos como: cpu, memória entre outros dados. Clique na imagem abaixo.

Status do sistema

Homologação Produção

💻 Tecnologias

🐳 Guia de Uso do Docker

Instalação

Primeiramente é necessário ter o docker instalado, caso não tenha acesse o Instalação docker. Após feito isso, instale o Docker-compose.

Comandos básicos

Para a utilização do ambiente em background, basta dar o comando abaixo e ele irá ligar o container:

 docker-compose up -d

Caso queira utilizar o ambiente com logs:

 docker-compose up

Para a visualização dos logs quando em modo de execução background, use o comando abaixo:

 docker-compose logs -f

Para pausar o container:

docker-compose stop

E para religar um container parado use o comando:

 docker-compose start

Para listar os containers que estão em execução:

 docker ps

Para listar todos os containers já executados na sua máquina:

 docker ps -a

Para executar comandos dentro do container:

 docker-compose exec -it  "id do container"  "comandos"

Para acessar o bash do container, substitua "comandos" por "bash".

Rodando a aplicação

Para rodar a aplicação, entre na pasta do projeto em que está localizado o docker-compose e digite no terminal:

  docker-compose up -d

Espere até que todos os serviços estejam disponíveis, acesse a página inicial do projeto com o seguinte endereço: https://localhost:8000

📊 Rodando os testes

Para conferir a cobertura de testes, siga os passos abaixo:

1º No terminal digite:

  coverage run -m django test --settings=tests.settings

Isso fará com que os testes sejam executados.

obs: Para funcionar, é necessário estar na raiz do projeto.

2º No terminal digite:

  coverage report

Esse comando irá gerar um relatório contendo as porcentagens da cobertura de testes em cada módulo e a cobertura total.

Obs: Para funcionar, é necessário ter realizado o passo anterior.

3º No terminal digite (opcional):

  coverage html

Esse comando irá gerar uma pasta contendo um arquivo html(index.html) que apresenta a cobertura de testes.

ℹ️ Deploy

O deploy da aplicação é feito de forma automatizada por meio da integração contínua (Travis CI) que é responsável por verificar a cobertura de teste ,que não pode ser inferior a 95% , e realizar o deploy junto ao servidor de hospedagem Heroku. Na configuração da integração incluimos os ambientes de homologação e produção que são descritos logo em seguida.

Deploy ambiente de homologação: Para esse ambiente, usamos a brach development. O deploy ocorre de forma automatizada. toda vez que alguma alteração é feita nessa branch, que tem como filtro os testes implementados durante o desenvolvimento.
Deploy ambiente de produção: Quando lançada uma nova versão estável do sistema, um novo deploy é realizado de forma automatizada. Para isso usamos a brach master, onde a nova versão devidamente testada e obedecendo os critérios de qualidade estabelecidos no Plano de qualidade é entregue aos clientes de forma contínua. No tópico a seguir apresentamos os dois ambientes usados para validação e entrega ao cliente.

ℹ️ Micro Serviços

A aplicação utiliza dois serviços que funcionam de maneira independente. Gerencia report: Serviço de geração de relatório. Notifica mais: Serviço de notificação via email.

Ambos serviços necessitam apenas de dados em formato json. Informações mais detalhadas podem ser acessadas nos links abaixo:

Notifica mais: https://github.com/Eduardojvr/notifica_mais
Gerencia report : https://github.com/Eduardojvr/gerencia_report

🌎 Acessando a aplicação

O gerencia mais possui dois ambientes, ambiente de homologação que é usado para testar e verificar se as funcionalidade implementadas mantêm o ambiente estável e o ambiente de produção, onde apresentamos as novas funcionalidades verificadas e validadas aos clientes. Os dois ambiente podem ser acessados através dos endereços apresentados abaixo: