Sênior ERP - API de Pedidos

Para executar os testes unitários localmente, é necessário configurar o JDK e o maven nas variáveis ambiente do sistema;
Acesse a pasta raiz do projeto 'senior-erp-spring' e execute o comando: mvn verify
O mvn verify executará os testes unitários, Esse comando também cria a pasta 'target'.
O relatório de teste do jacoco será gerado após o comando acima no caminho: target\site\jacoco\index.html
Exemplo:
Também é possível acessar o resultado de testes no sonar. Esse projeto está configurado com CI/CD Jenkins + Sonar para análise contínua de código + Deploy docker. Para verificar o relatório de testes no SONAR: IR PARA O SONAR

É necessário possuir o DOCKER.
Na pasta raiz do projeto: 'senior-erp-spring' execute o comando: docker compose up -d --build
Esse comando subirá o container do banco de dados do sistema e o próprio sistema.
Após subir o projeto localmente, será possível acessar a documentação da API - Swagger através da URL: http://localhost:8095/swagger-ui.html

Para consumir a API através do Swagger ou POSTMAN, será necessário obter o TOKEN JWT.
A url para obtenção dos tokens: http://localhost:8095/oauth/token
O Verbo HTTP é: POST
Deverá ser passado o Header Authorization como Basic Auth, o Username é: senior-erp-cli o Password: @321-senior
No BODY, deverá ser passado como x-www-form-urlencoded os seguintes parametros:
username: admin
password: senior-erp
grant_type: password
Exemplo de obtenção do TOKEN via POSTMAN:
Após obter o token JWT, será possível consumir a API passando em todas as requisições POSTMAN ou no Swagger o TOKEN Jwt no Header Authorization.
Exemplo de Autenticação no Swagger com o TOKEN obtido, basta informar no campo o token JWT, informe assim: Bearer meu-token-jwt:
Exemplo:
Após autorização todos os endpoints estarão disponíveis para uso no SWAGGER.
Para informar o token obtido no POSTMAN faça como no exemplo:

Para ter acesso as operações de Create/Read/Update/Delete referente ao ProdutoServiço e Pedidos Acesse a documentação swagger: http://localhost:8095/swagger-ui.html
A documentação fornecerá as informações necessárias para que seja consumida a API de forma correta.
Endpoints ProdutoServiço:
Endpoints Pedido:

Existem endpoints que permitem a listagem dos dados com a opção de realizar filtro, para isso, encaminharemos um DTO com os campos necessários para a aplicação do filtro.
Para aplicar filtro apenas em 1 campo, preencha somente esse campo e deixe os demais como 'null'.
Exemplo de DTO para aplicar filtro apenas no atributo descrição: { "ativo": null, "descricao": "Descrição ou parte da descrição", "id": null, "preco": null, "tipo": null }

A branch 'master' desse projeto está configurada para que sejam executados os testes unitários e publicado o resultado no SONAR: IR PARA O SONAR
Também é possível verificar a análise de qualidade de código.
Além dos testes unitários o Jenkins faz o deploy da API em um servidor docker.
A API também poderá ser acessada nesse servidor: http://cloudtecnologia.dynns.com:8095/swagger-ui.html

thi4go-git / senior-erp-spring