Home | Escopo | Processo | Mockups | Configuração | Arquitetura | Gerência | Código | BD | Qualidade | Utilização |
---|
Configurações do Projeto
Descrição
Esta seção é dedicada a apresentar as tecnologias apresentadas no projeto.
Sumário
Configuração geral
Frontend
React
React é uma biblioteca JavaScript desenvolvida pelo Facebook, utilizada para construir interfaces de usuário modernas e dinâmicas. Ela permite a criação de componentes reutilizáveis que gerenciam seu próprio estado, facilitando o desenvolvimento de aplicações frontend de grande escala. React utiliza um conceito chamado "virtual DOM" para otimizar atualizações na interface, tornando as aplicações mais rápidas e responsivas.
Backend
Flask
Flask é um microframework web para Python, popularizado por conta de sua simplicidade e flexibilidade. Ele oferece uma estrutura mínima que permite aos desenvolvedores adicionar apenas os componentes necessários, como roteamento, gestão de sessões e integração com bancos de dados, ideal para projetos pequenos e médios ou como base para aplicações maiores. Flask facilita a criação de APIs RESTful e aplicações web com uma curva de aprendizado baixa e uma comunidade ativa.
Python
Python é uma linguagem de programação interpretada, famosa por sua sintaxe clara e código legível, o que facilita a aprendizagem e a manutenção de software. Ela é amplamente utilizada em diversos domínios, incluindo desenvolvimento web, automação, análise de dados, inteligência artificial e aprendizado de máquina. Python possui uma vasta biblioteca padrão e milhares de pacotes adicionais criados pela comunidade.
PostgreSQL
PostgreSQL é um sistema de gerenciamento de banco de dados relacional de código aberto, reconhecido por sua robustez, conformidade com padrões SQL e suporte a tipos de dados avançados. Ele oferece recursos como controle de concorrência multiversionamento, replicação, extensões personalizadas e integração com várias linguagens de programação. PostgreSQL é altamente escalável e é amplamente utilizado em aplicações críticas, onde a integridade dos dados e a performance são essenciais.
### 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.
![image](uploads/d6c6a199cb863f37adc669007bbdd0eb/image.png)
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 - Normalmente essa ação não seria necessária, mas por garantia execute o commit:
``` flask db migrate -m "migração inicial" ```
7 - Migre a última versão do Banco de Dados:
``` flask db upgrade ```
8 - Instalar dependência para manipular PDFs
``` pip install PyPDF2 ```
9 - Rode a aplicação:
``` flask --app app.py run ```
Não se esqueça de estar na raiz do projeto ao executar o projeto.
10 - 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 ```.
![image](uploads/d4cdf63f40b55135c1bd4de603eef1d9/image.png)
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.
![image](uploads/4b2427f38ea0fe1b4dfd6ee3a01dd906/image.png)
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.