Instalação do docker
https://www.docker.com/products/docker-desktop/
Clonar Backend
https://tools.ages.pucrs.br/adote-um-amanha/adote-um-amanha-backend
Docker Compose
Após instalar o docker com sucesso, acessar o terminal de comando e navegar até a pasta raiz do projeto, onde o arquivo docker-compose.yml
se encontra, estando neste diretório, executar o comando docker-compose up -d
. Isso irá fazer com que o banco e o seu administrador subam na sua máquina. Verifique no docker se há dois containers e se ambos estão executando.
Administrado do Banco de Dados
Se tudo ocorreu corretamente, agora acesse a url http://localhost:5050/browser/ em seu navegador.
- Talvez aparece para colocar uma senha qualquer de admin, coloque uma fácil que irá se recordar caso seja pedido posteriormente em outro acesso.
- Já na dashboard do administrado do banco, crie um novo servidor, clicando no ícone de
Add a new Server
ou pelo menu clicando com o botão direito em cima deServers
no lado esquerdo da tela. - Na tela que abrir, na aba
General
no campo de textoName
coloque um nome de sua preferência para o servidor. - Na aba seguinte, em
Connection
, os seguintes valores devem ser colocados nos campos de textos , emHostname: postgres
, emUsername: ages
e emPassword: ages
. - O hostname é o nome do container criado por você, e que deve estar com o mesmo nome que aparece no seu docker, assim como a imagem acima, já o username e password são definidos no arquivo do docker compose no qual você executou o comando anteriormente.
- Para finalizar é só clicar em save, deve ter sido criado então o servidor com o nome que você deu.
Executar o backend
Deve ser baixado as dependências do projeto, de preferencia recomendo executar o comando clean install do maven para evitar alguns erros bobos. Pelo IntelliJ é possível fazer isso no meu presente no lado direito da tela na aba lateral Maven
.
-
Adicionar o plugin do lombok na sua IDE. No IntelliJ,
apertar Shitft x2 vezes
procurar porPlugins
e depois procurar porlombok
para adiciona-lo a IDEA, reiniciar a IDEA após isso. -
No arquivo
application.yml
, dentro da estrutura do projeto, na pastaresources
. Há uma configuração que pega o mapeamento das entidades feitas no backened e já cria o banco para a gente fazendo o insert, caso tenha executado a primeira vez. De preferência é bom trocar, para não ficar dando drop no banco inteiro toda vez que executar a aplicação. Portanto na linha11
onde tem a seguinte configuraçãoddl-auto: create-drop
deve ser trocado paraddl-auto: update
. -
Dentro do banco criado por você, deve ter sido criado a tabela
usuario
- Acesse dentro do banco a Query tool para executar comandos SQL.
-
Insira um novo usuário com o comando
insert into usuario(id, ativo, documento, email, endereco_cep, endereco_bairro, endereco_cidade, endereco_complemento, endereco_estado, endereco_numero, endereco_rua, nome, perfil, senha, site, telefone) values (3, true, 32132132132, '[email protected]', '3213213-321', 'bairro', 'Porto Alegre', 'nao', 'RS', 123, 'Rua', 'adm', 'ADMIN', '$2a$10$KDZdDpsS30B0YID4riOWoeUwfvRB5lXRB8WOoNFiO/nidARaU4haC', 'admin.com.br', 51985858585)
-
A senha é criptografada, a senha do usuário inserido no banco acima corresponde a palavra
admin
. Para inserir um novo usuário com uma senha diferente, use o site https://appdevtools.com/bcrypt-generator para saber o hash desta nova senha.
Instalação do postman
https://www.postman.com/downloads/
-
Baixar a collection e importar no postman collection
-
Disparar a requisição de login, se retornar o token, deu tudo certo!