Record sales system Backend

English

---

Created with Java version 17, Springboot version 3.2.5

---

Starting points

• This API has documentation generated by Swagger to help understand the requests, however it will be necessary to use a service like Postman, as most requests require the authentication token or some implementation made by the Middleware. is accessible at the URI: /swagger-ui/index.html#/.
• The Users Api development environment is on port 8081.
• The Integration Api development environment is on port 8082.

How to run the application

You must have Docker installed to run the application locally.

• git clone https://github.com/Maxixee/record-sales-backend.git To clone the repository in your IDE

  • docker-compose -f docker-compose.yml build To download images from Postgres, RabbitMQ and the 2 APIs
  • docker-compose -f docker-compose.yml up To create containers

• Once these commands have been carried out, simply build and run the application in your IDE.

Documentation

• Both APIs were documented by swagger, the documentation can be accessed at the URLs:
  • API User: http://localhost:8081/api/swagger-ui/index.html#/
  • API Integration: http://localhost:8082/api/swagger-ui/index.html#/

---

Database

The database used in the application is Postgresql

---

Authentication Service

Authentication is carried out through the endpoint '/api/users/auth', where it performs the POST verb, obtaining the email and password, returning the user's data, in addition to generating an authentication token.

---

Authentication Token

The authentication token is generated using SpringSecurity's Basic Auth

---

---

Backend do sistema de venda de discos

Portugues-Br

---

Criada com a versão 17 do Java, Springboot na versão 3.2.5

---

Pontos iniciais

• Essa API possui uma documentação gerada pelo Swagger para auxiliar na compreensão das requisições, porém será necessário utilizar um serviço como Postman, pois grande partes das requisições necessitam do token de autenticação ou de alguma implementação feita pelo Middleware. está acessível na URI: /swagger-ui/index.html#/.
• O ambiente de desenvolvimento da Api de Users está na porta 8081.
• O ambiente de desenvolvimento da Api de Integration está na porta 8082.

Como executar a aplicação

É necessário ter o Docker instalado para executar a aplicação localmente.

• git clone https://github.com/Maxixee/record-sales-backend.git Para clonar o repositório na sua IDE

  • docker-compose -f docker-compose.yml build Para baixar as imagens do Postgres, RabbitMQ e das 2 APIs
  • docker-compose -f docker-compose.yml up Para criar os containers.

• Realizados estes comandos, basta buildar e executar o backend na sua IDE.

Documentação

• Ambas as APIs foram documentadas pelo swagger, as documentações podem ser acessadas nas URLs:
  • API User: http://localhost:8081/api/swagger-ui/index.html#/
  • API Integration: http://localhost:8082/api/swagger-ui/index.html#/

---

Banco de dados.

O banco de dados utilizado na aplicação é o Postgresql

---

Serviço Autenticação

A autenticação é realizada através do endpoint '/api/users/auth', onde realiza o verbo POST, obtendo o email e a senha, retornando os dados do usuários, além de gerar um token de autenticação.

---

Token de autenticação

O token de autenticação é gerado utilizando Basic Auth do SpringSecurity

---