GT-Covid19-Atendimento

Sistema web responsável pelo telemonitoramento de pacientes com suspeita de Covid-19.

Passo a passo para iniciar o projeto sem o DOCKER

• Necessário ter o Python 3 instalado na máquina

• Necessário ter o GIT instalado na máquina

• Necessário ter o MySQL instalado na máquina (Devs novos sem acesso a VPN da UFRJ)

• Necessário ter o WeasyPrint instalado para geração do PDF de agendamentos. Escolha o passo-a-passo para instalação do seu Sistema Operacional.

• Fazer o do projeto

• Clonar o projeto do seu repositório para uma pasta local em sua máquina

  • git clone "Link do projeto forkado no seu github" (https://github.com/*seu-usuario-github*/GT-Covid19-Atendimento)

• Instalar dependências

  • pip install -r requirements.txt

  • • Obs: A cada novo pacote necessario para a implmentação , lembrar de incluí-lo no requirements.txt. É melhor sobrar do que faltar ^^
  • • Obs2: Se quiser, pode utilizar o recurso de ambiente virtual para evitar a instalação de pacotes de forma global em sua máquina

• Instalar o MySQL

  • Criar banco com nome 'covid3'

  • python app/config_database.py dev (Cria o esquema no banco local com ORM)

• Rodar o sistema

  • python app/app.py dev (Acessa banco local)

  • python app/app.py teste (Acessa banco de dados de teste. Necessário ter VPN configurada)

  • python app/app.py (Acessa banco de dados de produção. Necessário ter VPN configurada)

Passo a passo para iniciar o projeto com o DOCKER

• Necessário ter o GIT instalado na máquina

• Necessário ter o Docker Desktop instalado na máquina

• Clonar o projeto do seu repositório para uma pasta local em sua máquina

  • git clone "Link do projeto forkado no seu github" (https://github.com/*seu-usuario-github*/GT-Covid19-Atendimento)

• Construir imagens e rodar o sistema

  • docker-compose up --build (Rodar de dentro do diretório do projeto; Rodar com sudo no Linux)

Usuário de Teste

• Nas migrations, um usuário para testes é adicionado para ser usado localmente ao iniciar a aplicação pela primeira vez:
  • CPF: 01010101010
  • Senha: 123456789

Passo a passo para atualização do projeto

• Caso nunca tenha feito uma atualização, configure para seu repositório local apontar para o repositório principal (faça isso apenas uma vez)

  • git remote add upstream https://github.com/CarlosEduAC/GT-Covid19-Atendimento

  • git checkout master

• Ao começar uma nova feature ou tarefa, atualize seu repositório local com as atualizações do Git principal do projeto:

  • git fetch upstream

  • git rebase upstream/master

• Após codificar a alteração do projeto local, atualize o projeto no seu repositório forkeado:

  • git add .
  • git commit -m "Exemplo de commit com comentário que descreva a atualização feita."
  • git push

• Abrir a página do seu fork e clicar em:

  • 

  • Comentar detalhando as informações sobre a atualização

Migrations

• Para usar as migrations, a biblioteca alembic precisa estar instalada.

• Configuração inicial

  • No arquivo alembic/env.py, devem ser definidos os valores DB_USER, DB_PASS e DB_MACHINE para criação da string de conexão utilizada pela aplicação

  • Para atualizar seu banco, execute:

    alembic upgrade head
    

• Criação e execução das migrations

  • Todos os comandos devem ser executados dentro da pasta app

  • Para gerar uma migration automaticamente (caso você apenas tenha feito alterações nos modelos), executar:

    alembic revision --autogenerate -m "nome da migration"
    

  • O nome da migration deve ser único para cada migration executada e descrever qual foi a modificação

  • Para criar uma migration, execute:

    alembic revision -m "nome da migration"
    

  • Um arquivo novo será gerado dentro de alembic/versions. Modifique o método "upgrade" para realizar as modificações necessárias da sua migration e o método "downgrade" para realizar as operações necessárias para revertê-la

  • Para executar as migrations, execute:

    alembic upgrade head
    

  • Caso queira reverter a ultima migration executada, execute:

    alembic downgrade -1