| ... | ... | @@ -13,9 +13,9 @@ Esta página descreve todas as configurações a serem feitas na sua máquina pa |
|
|
|
- [Realizando o clone do projeto do GitLab](#realizando-o-clone-do-projeto-do-gitlab)
|
|
|
|
- [Backend](#backend)
|
|
|
|
- [Tecnologias](#tecnologias-do-backend)
|
|
|
|
- [Configurando a Máquina](#configurando-a-máquina-para-ambiente-backend)
|
|
|
|
- [Configurando a IDE](#configurando-a-ide-para-ambiente-backend)
|
|
|
|
- [Instalando a ferramenta de gerenciamento de banco de dados](#instalando-a-ferramenta-de-gerenciamento-de-banco-de-dados)
|
|
|
|
- [Configurando o Postman](#configurando-o-postman)
|
|
|
|
- [Configurando o Postman (opcional)](#configurando-o-postman)
|
|
|
|
- [Frontend](#frontend)
|
|
|
|
- [Tecnologias](#tecnologias-do-frontend)
|
|
|
|
- [Configurando a Máquina](#configurando-a-máquina-para-ambiente-frontend)
|
| ... | ... | @@ -69,20 +69,20 @@ Esta seção descreve as configurações a serem feitas para o ambiente de desen |
|
|
|
|
|
|
|
### Tecnologias do Backend
|
|
|
|
|
|
|
|
- Java 11
|
|
|
|
- Spring Boot 2.7.8
|
|
|
|
- Java 17
|
|
|
|
- Spring Boot 2.7.18
|
|
|
|
- Gradle 8.6
|
|
|
|
- Docker
|
|
|
|
- Docker Compose
|
|
|
|
- PostgreSQL
|
|
|
|
|
|
|
|
Para instalar o Java 11 na sua máquina, realize o *download* de um dos instaladores presentes [neste site da Oracle](https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html).
|
|
|
|
Para instalar o Java 17 na sua máquina, realize o *download* de um dos instaladores presentes [neste site da Oracle](https://www.oracle.com/java/technologies/javase/jdk11-archive-downloads.html).
|
|
|
|
|
|
|
|
Caso você já possua o Java instalado em sua máquina, mas não tem certeza se é a versão correta, execute o comando abaixo via terminal.
|
|
|
|
```shell
|
|
|
|
java -version
|
|
|
|
```
|
|
|
|
Se ao lado de "java version" for exibido uma versão que inicia com "11.", então não é necessário instalar uma nova versão em sua máquina.
|
|
|
|
Se ao lado de "java version" for exibido uma versão que inicia com "17.", então não é necessário instalar uma nova versão em sua máquina.
|
|
|
|
|
|
|
|
### Configurando a IDE para ambiente Backend
|
|
|
|
|
| ... | ... | @@ -92,7 +92,7 @@ Após clonar o repositório do GitLab do Backend, abra a pasta onde o repositór |
|
|
|
|
|
|
|
<img src="./resources/images/intellij-criar-projeto.png" width="400">
|
|
|
|
|
|
|
|
|
|
|
|
Mais detalhes sobre como executar o projeto em sua máquina podem ser lidos no [README](https://tools.ages.pucrs.br/sem-barreiras/sembarreiras-backend/-/blob/main/README.md) do repositório Backend do projeto.
|
|
|
|
|
|
|
|
### Instalando a ferramenta de gerenciamento de banco de dados
|
|
|
|
|
| ... | ... | @@ -100,9 +100,27 @@ Como será utilizado o **PostgreSQL** como banco de dados relacional do projeto, |
|
|
|
|
|
|
|
Para instalar o DBeaver, siga as instruções presentes no [site da ferramenta](https://dbeaver.io/download/).
|
|
|
|
|
|
|
|
Uma vez instalado o DBeaver, para se conectar com o banco de dados utilizado pela aplicação, siga os passos abaixo:
|
|
|
|
|
|
|
|
1. Clique no botão para criar uma nova conexão com um banco de dados
|
|
|
|
|
|
|
|
<img src="./resources/images/dbeaver-criar-nova-conexao.png" width="400">
|
|
|
|
2. Selecione a opção PostgreSQL e clique em "Next"
|
|
|
|
|
|
|
|
<img src="./resources/images/dbeaver-selecionar-postgresql.png" width="350">
|
|
|
|
3. Configure a conexão com o banco de dados, preenchendo o host, o nome do banco de dados, o usuário e a senha conforme configurações presentes no [repositório Backend do projeto](https://tools.ages.pucrs.br/sem-barreiras/sembarreiras-backend).
|
|
|
|
|
|
|
|
<img src="./resources/images/dbeaver-configurar-conexao-postgresql.png" width="350">
|
|
|
|
4. Teste a conexão clicando no botão "Test Connection"
|
|
|
|
|
|
|
|
<img src="./resources/images/dbeaver-testar-conexao-postgresql.png" width="350">
|
|
|
|
5. Se no teste a conexão for realizada com sucesso, clique em "Finish" para se conectar ao banco de dados. Ao finalizar, você deve conseguir visualizar os dados da sua conexão na lateral esquerda da interface, onde você pode: visualizar as tabelas presentes no banco de dados e as suas colunas; criar e executar scripts SQL; entre outros.
|
|
|
|
|
|
|
|
<img src="./resources/images/dbeaver-conexao-postgresql-finalizada.png" width="350">
|
|
|
|
|
|
|
|
### Configurando o Postman
|
|
|
|
|
|
|
|
Realizada a configuração do ambiente Backend do projeto, é possível utilizar a plataforma **Postman** como cliente HTTP para realizar as requisições para a API a partir de uma interface gráfica. Para isso e para documentar a API, no entanto, também pode-se utilizar o Swagger, que está configurado para o projeto de Backend, então só é preciso instalar o Postman caso você prefira trabalhar com esta ferramenta.
|
|
|
|
Realizada a configuração do ambiente Backend do projeto, é possível utilizar a plataforma **Postman** como cliente HTTP para realizar as requisições para a API a partir de uma interface gráfica. Para isso e para documentar a API, no entanto, também pode-se utilizar o **Swagger**, que está configurado para o projeto de Backend, então só é preciso instalar o Postman caso você prefira trabalhar com esta ferramenta.
|
|
|
|
|
|
|
|
O Postman pode ser instalado [neste link](https://www.postman.com/downloads/).
|
|
|
|
|
| ... | ... | |
