Diagrama de arquitetura

Como configurar o ambiente backend

Requisitos:

• PostgreSQL, preferencialmente com PgAdmin 4.
• Python 3.12 ou superior.

1 - Primeiramente, faça download dos requisitos descritos acima

Baixe a versão 16 do PostgreSQL através do link: https://www.enterprisedb.com/downloads/postgres-postgresql-downloads. Durante a instalação haverá uma checkbox perguntando se você deseja baixar PgAdmin 4, normalmente ela já estará marcada, mas certifiques-se de conferir. Além disso, durante a instalação o setup lhe pedirá para definir uma senha de acesso, coloque a senha padrão "postgres".

Já para o Python, não se esqueça de baixar a versão 3.12 ou superior, você pode realizar o download através do link: https://www.python.org/downloads/.

Após isso, adicione os recursos recém baixados nas Variáveis de Ambiente. No menu iniciar do Windows digite "Editar Variáveis de Ambiente do Sistema", clique no botão "Variáveis de Ambiente...", em seguida procure por Path na caixa Variáveis do Sistema, selecione-o e clique em "Editar...", clique no botão "Novo" e adicione o caminho das pastas "Python\Python312", "Python\Python312\Scripts" e "PostgreSQL\16\bin", semelhante a imagem a seguir.

1 - Com o projeto clonado na máquina local, certifique-se de que tudo está devidamente instalado:

psql --version

python --version

2 - Em seguida instale o gerenciador de dependências Poetry:

pip install poetry

Se ocorrer algum problema, verifique se o pip está corretamente instalado.

pip --version

Caso o sistema não identifique o comando "pip", instale-o

python -m ensurepip --upgrade

3 - Navegue até a raiz do projeto (pasta que contém pyproject.toml) para instalar as dependências do projeto com Poetry:

poetry install

4 - O Flask será instalado automaticamente, mas você pode verificar se a instalação ocorreu corretamente:

poetry run flask --version

5 - Ative o Ambiente Virtual:

poetry shell

6 - Migre a última versão do Banco de Dados:

flask db upgrade

7 - Rode a aplicação:

flask --app app.py run

Não se esqueça de estar na raiz do projeto ao executar o projeto.

8 - Criar as tabelas no banco de dados automaticamente:

Abra o PgAdmin 4 e clique na setinha ao lado esquerdo de "Servers", o programa pedirá a senha definida durante a instalação, caso tenha configurado uma senha diferente de "postgres", você pode muda-la através do comando psql -U postgres.

Em seguida, clique com o botão direito em Database vá em "Create > Database...", no campo Database digite "vir_db" e salve as configurações.

Ao abrir a database vir_db vá até a aba Schemas, lá você pode notar que aba Tables estará vazia, tudo que você precisa fazer é executar o código novamente com o PgAdmin aberto, se tudo ocorrer bem, as tabelas serão criadas automaticamente.