API-Estoque-Bebidas

API para controle de Estoque de bebidas.

Api desenvolvida para controle de estoque de bebidas com formas variadas de consulta, cadastro e atualização.

Desenvolvido em Java com JPA, Swagger e PostgreSQL

Como Utilizar

Após o término do projeto tentei efetuar um deploy para o Heroku para que a API ficasse disponível de forma online no entanto não obtive sucesso nessa parte, porém posteriormente posso deixar ele online.

Para executar a API:

• Baixe todo o projeto presente na pasta "apirest"
• Abra o projeto com a IDE de sua preferência fazendo um "import" com "Existing Maven Projects"
• Configure o banco através do "application.properties" presente no caminho "src/main/resources" Dentro deste arquivo constará a seguinte configuração

spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation=true

#Banco local - Ergon
spring.datasource.url= jdbc:postgresql://localhost:5432/banco_de_bebidas_estoque
spring.datasource.username=postgres
spring.datasource.password=banco123
spring.jpa.hibernate.ddl-auto=update 

• Altere para:

#Banco local - Ergon
spring.datasource.url= jdbc:postgresql://localhost:5432/banco_de_bebidas_estoque
spring.datasource.username= seu usuario do banco postgres
spring.datasource.password= sua senha do banco postgres
spring.jpa.hibernate.ddl-auto=update

• Depois de feito isso, entre no banco e crie um banco de dados com o nome idêntico a "banco_de_bebidas_estoque"

• Feito isso, clique com o botão direito em "ApirestApplication.java " e depois em "Run As" > "Java Application"

• Depois de feito isso, em seu browser acesse "http://localhost:8080/swagger-ui.html"

• Pronto, agora é só testar!!

Cadastrar

Para o cadastramento, usar os textos em Json abaixo:

EXEMPLOS DE CADASTROS
{
  "historicoEntradaSaida": {
    "dataEntrada": "2020-11-14",
    "dataSaida": " ",
    "horaEntrada": "12:54",
    "horaSaida": " ",
    "responsavelPelaEntrada": "ERGON ZAMARIAN LIMA",
    "responsavelPelaSaida": " ",
    "secao": {
      "numeroDaSecao": 1,
      "tipoDeBebidaNaSecao": "NAO_ALCOOLICA",
      "volumeDaBebida": 70,
      "volumeTotalSecao": 400
    }
  },
  "idBebida": 0,
  "nomeBebida": "TODDYNHO"
}
---copiar até aqui
{
  "historicoEntradaSaida": {
    "dataEntrada": "2020-11-14",
    "dataSaida": " ",
    "horaEntrada": "18:58",
    "horaSaida": " ",
    "responsavelPelaEntrada": "ERGON ZAMARIAN LIMA",
    "responsavelPelaSaida": " ",
    "secao": {
      "numeroDaSecao": 1,
      "tipoDeBebidaNaSecao": "NAO_ALCOOLICA",
      "volumeDaBebida": 70,
      "volumeTotalSecao": 400
    }
  },
  "idBebida": 28,
  "nomeBebida": "LEITE"
}
---copiar até aqui
{
  "historicoEntradaSaida": {
    "dataEntrada": "2020-11-14",
    "dataSaida": " ",
    "horaEntrada": "20:58",
    "horaSaida": " ",
    "responsavelPelaEntrada": "ERGON ZAMARIAN LIMA",
    "responsavelPelaSaida": " ",
    "secao": {
      "numeroDaSecao": 2,
      "tipoDeBebidaNaSecao": "ALCOOLICA",
      "volumeDaBebida": 90,
      "volumeTotalSecao": 500
    }
  },
  "idBebida": 0,
  "nomeBebida": "SKOL"
}

Atualizar - Venda de Bebida

Para a atualização, usar os textos em Json abaixo:

EXEMPLOS DE ATUALIZAÇÕES - VENDAS
{
  "historicoEntradaSaida": {
    "dataEntrada": "2020-11-14",
    "dataSaida": "2020-11-17",
    "horaEntrada": "12:54",
    "horaSaida": "17:54",
    "responsavelPelaEntrada": "ERGON ZAMARIAN LIMA",
    "responsavelPelaSaida": "FULANO",
    "secao": {
      "numeroDaSecao": 0,
      "tipoDeBebidaNaSecao": "NAO_ALCOOLICA",
      "volumeDaBebida": 70,
      "volumeTotalSecao": 400
    }
  },
  "idBebida": inserir id correspondente,
  "nomeBebida": "TODDYNHO"
}
---copiar até aqui
{
  "historicoEntradaSaida": {
    "dataEntrada": "2020-11-14",
    "dataSaida": "2020-11-19",
    "horaEntrada": "18:58",
    "horaSaida": "11:40",
    "responsavelPelaEntrada": "ERGON ZAMARIAN LIMA",
    "responsavelPelaSaida": "DELTRANO",
    "secao": {
      "numeroDaSecao": 1,
      "tipoDeBebidaNaSecao": "NAO_ALCOOLICA",
      "volumeDaBebida": 70,
      "volumeTotalSecao": 400
    }
  },
  "idBebida": inserir id correspondente,
  "nomeBebida": "LEITE"
}

Outras Funções dentro da API

As outras funções presentes na API estão descritas no botão que chama cada método, todas são explicativas.

Importante lembrar que a inserção deve ser feita da forma como foi passado acima, bem como a atualização.

As regras de cadastramento não foram cumpridas, no entanto disponibilizei a tentativa Aqui que fazia direto no banco e tentava passar para o JPA.

Autor

Ergon Zamarian Lima