Livraria Project

Descrição

O projeto Biblioteca é uma aplicação Java desenvolvida com Spring Boot, que permite a gestão de livros, autores, editoras, resumos e clientes. O sistema é projetado para realizar operações de CRUD (Create, Read, Update, Delete) em livros, autores, editoras, resumos e pedidos de livros.

Funcionalidades

Gerenciamento de Livros: Adicionar, atualizar, excluir e listar livros.
Gerenciamento de Autores: Adicionar, atualizar, excluir e listar autores.
Gerenciamento de Clientes: Adicionar, atualizar, excluir e listar clientes.
Pedidos de Livros: Criar e gerenciar pedidos de livros.
ViaCepApi: O projeto ultiliza a API Via Cep para transformar o cep em uma entidade de endereço no BD.

Tecnologias Utilizadas

Java: Linguagem de programação principal.
Spring Boot: Framework para desenvolvimento do backend.
Spring Data JPA: Para gerenciamento de persistência e banco de dados.
H2 Database: Banco de dados em memória para testes.
PostgreSQL: Banco de dados para desenvovimento.
Maven: Gerenciador de dependências e build.

Pré-requisitos

Antes de começar, você precisará ter os seguintes softwares instalados:

Instalação

Clone o repositório:

git clone https://github.com/thiagovanzele/livraria-app.git

Navegue até o diretório do projeto::
```
cd livraria-app
```
Compile e execute o projeto:
```
mvn clean install
mvn spring-boot:run
```

Configuração do Banco de Dados

Antes de iniciar a aplicação, você precisa configurar as propriedades do banco de dados no arquivo application.properties.

Passos para Configuração

Abra o arquivo application.properties localizado em src/main/resources.

Atualize as propriedades do banco de dados com as informações do seu ambiente PostgreSQL. Substitua os valores de spring.datasource.url, spring.datasource.username, e spring.datasource.password conforme suas configurações:

spring.datasource.url=jdbc:postgresql://localhost:5432/livraria-app
spring.datasource.username=postgres
spring.datasource.password=

spring.jpa.properties.hibernate.jdbc.lob.non_contextual_creation=true
spring.jpa.hibernate.ddl-auto=update
spring.jpa.show-sql=true
spring.jpa.properties.hibernate.format_sql=true

spring.jpa.database-platform=org.hibernate.dialect.PostgreSQLDialect

Uso

Após iniciar a aplicação, você pode acessar a API REST através do endpoint:

Base URL: http://localhost:8080

Endpoints

Livros:
- GET /livros - Listar todos os livros.
- POST /livros - Adicionar um novo livro.
- PUT /livros/{id} - Atualizar um livro existente.
- DELETE /livros/{id} - Excluir um livro.
Autores:
- GET /autores - Listar todos os autores.
- POST /autores - Adicionar um novo autor.
- PUT /autores/{id} - Atualizar um autor existente.
- DELETE /autores/{id} - Excluir um autor.
Clientes:
- GET /clientes - Listar todos os clientes.
- POST /clientes - Adicionar um novo cliente.
- PUT /clientes/{id} - Atualizar um cliente existente.
- DELETE /clientes/{id} - Excluir um cliente.
Pedidos:
- POST /pedidos - Criar um novo pedido.
Item Pedido:
- POST /itens-pedido - Criar um novo item de pedido.

Exemplos de Requisições HTTP POST

Aqui estão alguns exemplos de como interagir com a API usando ferramentas como Postman ou cURL:

Adicionar um Novo Livro

Requisição POST:

POST /livros
Content-Type: application/json

{
  "titulo" : "Harry Potter e a Pedra Filosofal",
  "resumo" : "Harry Potter, um garoto de 11 anos, descobre que é um bruxo e vai para a Escola de Magia e Bruxaria de Hogwarts.",
  "idEditora" : 1,
  "autoresIds" : [1],
  "preco" : 35.29
}

Retorno da Requisição:

 {
"id": 2,
"titulo": "Harry Potter e a Pedra Filosofal",
"resumo": {
  "id": 1,
  "comentario": "Harry Potter, um garoto de 11 anos, descobre que é um bruxo e vai para a Escola de Magia e Bruxaria de Hogwarts."
},
"editora": {
  "id": 1,
  "nome": "Bloomsbury Publishing"
},
"autores": [
  {
    "id": 1,
    "nome": "J. K. Rowling"
  }
],
"preco": 35.29
}

Adicionar um Novo Cliente

Requisição POST:

POST /clientes
Content-Type: application/json

{
  "nome": "João Silva",
  "documento": "12345678901",
  "email": "[email protected]",
  "cep": "01001000",
  "numero": "123"
}

Retorno da Requisição:

 {
  "id": 1,
  "nome": "João Silva",
  "documento": "12345678901",
  "email": "[email protected]",
  "endereco": {
      "id": 1,
      "cep": "01001000",
      "complemento": null,
      "rua": "Praça da Sé",
      "bairro": "Sé",
      "cidade": "São Paulo",
      "estado": "SP",
      "numero": "123"
  }
}

Adicionar um novo pedido

Requisição POST:

POST /pedidos
Content-Type: application/json

{
  "data" : "2024-08-04T15:30:00",
  "itens" : [{
      "livroId" : 2,
      "quantidade" : 3
  }],
  "clienteId" : 1
}

Retorno da Requisição:

{
  "id": 1,
  "data": "2024-08-04T15:30:00",
  "cliente": {
      "id": 1,
      "nome": "João Silva",
      "documento": "12345678901",
      "email": "[email protected]",
      "endereco": {
          "id": 1,
          "cep": "01001000",
          "complemento": null,
          "rua": "Praça da Sé",
          "bairro": "Sé",
          "cidade": "São Paulo",
          "estado": "SP",
          "numero": "123"
      }
  },
  "itens": [
      {
          "quantidade": 3,
          "preco": 105.87,
          "livro": {
              "id": 2,
              "titulo": "Harry Potter e a Pedra Filosofal",
              "resumo": {
                  "id": 1,
                  "comentario": "Harry Potter, um garoto de 11 anos, descobre que é um bruxo e vai para a Escola de Magia e Bruxaria de Hogwarts."
              },
              "editora": {
                  "id": 1,
                  "nome": "Bloomsbury Publishing"
              },
              "autores": [
                  {
                      "id": 1,
                      "nome": "J. K. Rowling"
                  }
              ],
              "preco": 35.29
          },
          "subTotal": 105.87
      }
  ],
  "total": 105.87
}

Exemplos de Requisições HTTP GET

Resgatar Livros por Nome

Requisição GET:

GET /livros/buscarpornome/harry
Content-Type: application/json

Retorno da Requisição:

 [
  {
      "id": 2,
      "titulo": "Harry Potter e a Pedra Filosofal",
      "resumo": {
          "id": 1,
          "comentario": "Harry Potter, um garoto de 11 anos, descobre que é um bruxo e vai para a Escola de Magia e Bruxaria de Hogwarts."
      },
      "editora": {
          "id": 1,
          "nome": "Bloomsbury Publishing"
      },
      "autores": [
          {
              "id": 1,
              "nome": "J. K. Rowling"
          }
      ],
      "preco": 35.29
  },
  {
      "id": 6,
      "titulo": "Harry Potter e a Câmara Secreta",
      "resumo": {
          "id": 3,
          "comentario": "Harry Potter em seu segundo ano em Hogwarts, onde ele descobre que a Câmara Secreta foi aberta novamente, causando ataques misteriosos a alunos e um gato."
      },
      "editora": {
          "id": 1,
          "nome": "Bloomsbury Publishing"
      },
      "autores": [
          {
              "id": 1,
              "nome": "J. K. Rowling"
          }
      ],
      "preco": 35.99
  }
]

Resgatar um Livro pelo ID

Requisição GET:

GET /livros/3
Content-Type: application/json

Retorno da Requisição:

 {
  "id": 3,
  "titulo": "Memorias Postumas de Brás Cubas",
  "resumo": {
      "id": 2,
      "comentario": "Um romance que narra a vida de Brás Cubas, um defunto-autor que conta sua história a partir de sua perspectiva após a morte."
  },
  "editora": {
      "id": 2,
      "nome": "Tipografia Nacional"
  },
  "autores": [
      {
          "id": 2,
          "nome": "Machado de Assis"
      }
  ],
  "preco": 25.19
}

Resgatar um Cliente pelo ID

Requisição GET:

GET /clientes/2
Content-Type: application/json

Retorno da Requisição:

{
  "id": 2,
  "nome": "Maria Joana",
  "documento": "45678912345",
  "email": "[email protected]",
  "endereco": {
      "id": 2,
      "cep": "26413410",
      "complemento": null,
      "rua": "Rua Adalgisa",
      "bairro": "Cidade Jardim Marajoara",
      "cidade": "Japeri",
      "estado": "RJ",
      "numero": "456"
  }
}

Resgatar um Pedido pelo ID

Requisição GET:

GET /pedidos/2
Content-Type: application/json

Retorno da Requisição:

 {
  "id": 2,
  "data": "2024-08-02T10:30:00",
  "cliente": {
      "id": 2,
      "nome": "Maria Joana",
      "documento": "45678912345",
      "email": "[email protected]",
      "endereco": {
          "id": 2,
          "cep": "26413410",
          "complemento": null,
          "rua": "Rua Adalgisa",
          "bairro": "Cidade Jardim Marajoara",
          "cidade": "Japeri",
          "estado": "RJ",
          "numero": "456"
      }
  },
  "itens": [
      {
          "quantidade": 1,
          "preco": 35.29,
          "livro": {
              "id": 2,
              "titulo": "Harry Potter e a Pedra Filosofal",
              "resumo": {
                  "id": 1,
                  "comentario": "Harry Potter, um garoto de 11 anos, descobre que é um bruxo e vai para a Escola de Magia e Bruxaria de Hogwarts."
              },
              "editora": {
                  "id": 1,
                  "nome": "Bloomsbury Publishing"
              },
              "autores": [
                  {
                      "id": 1,
                      "nome": "J. K. Rowling"
                  }
              ],
              "preco": 35.29
          },
          "subTotal": 35.29
      },
      {
          "quantidade": 1,
          "preco": 25.19,
          "livro": {
              "id": 3,
              "titulo": "Memorias Postumas de Brás Cubas",
              "resumo": {
                  "id": 2,
                  "comentario": "Um romance que narra a vida de Brás Cubas, um defunto-autor que conta sua história a partir de sua perspectiva após a morte."
              },
              "editora": {
                  "id": 2,
                  "nome": "Tipografia Nacional"
              },
              "autores": [
                  {
                      "id": 2,
                      "nome": "Machado de Assis"
                  }
              ],
              "preco": 25.19
          },
          "subTotal": 25.19
      }
  ],
  "total": "60,48"
}

Exemplos de Requisições HTTP PUT

Alterar um Livro pelo ID

Requisição PUT:

PUT /livros/6
Content-Type: application/json

{
  "titulo" : "Harry Potter e a Câmara Secreta",
  "resumo" : "Harry Potter em seu segundo ano em Hogwarts, onde ele descobre que a Câmara Secreta foi aberta novamente, causando ataques misteriosos a alunos e um gato.",
  "idEditora" : 1,
  "autoresIds" : [1],
  "preco" : 35.99
}

Retorno da Requisição:

 {
  "id": 6,
  "titulo": "Harry Potter e a Câmara Secreta",
  "resumo": {
      "id": 3,
      "comentario": "Harry Potter em seu segundo ano em Hogwarts, onde ele descobre que a Câmara Secreta foi aberta novamente, causando ataques misteriosos a alunos e um gato."
  },
  "editora": {
      "id": 1,
      "nome": "Bloomsbury Publishing"
  },
  "autores": [
      {
          "id": 1,
          "nome": "J. K. Rowling"
      }
  ],
  "preco": 35.99
}

Licença

Este projeto está licenciado sob a Licença MIT - veja o arquivo LICENSE para detalhes.

Contato

Se você tiver alguma dúvida ou sugestão, entre em contato:

Thiago Vanzele - [email protected]
LinkedIn - Thiago Vanzele

Name		Name	Last commit message	Last commit date
Latest commit History 67 Commits
.metadata		.metadata
.mvn/wrapper		.mvn/wrapper
src		src
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
mvnw		mvnw
mvnw.cmd		mvnw.cmd
pom.xml		pom.xml

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Livraria Project

Descrição

Funcionalidades

Tecnologias Utilizadas

Pré-requisitos

Instalação

Configuração do Banco de Dados

Passos para Configuração

Uso

Endpoints

Exemplos de Requisições HTTP POST

Adicionar um Novo Livro

Adicionar um Novo Cliente

Adicionar um novo pedido

Exemplos de Requisições HTTP GET

Resgatar Livros por Nome

Resgatar um Livro pelo ID

Resgatar um Cliente pelo ID

Resgatar um Pedido pelo ID

Exemplos de Requisições HTTP PUT

Alterar um Livro pelo ID

Licença

Contato

About

Releases

Packages

Languages

License

thiagovanzele/livraria-app

Folders and files

Latest commit

History

Repository files navigation

Livraria Project

Descrição

Funcionalidades

Tecnologias Utilizadas

Pré-requisitos

Instalação

Configuração do Banco de Dados

Passos para Configuração

Uso

Endpoints

Exemplos de Requisições HTTP POST

Adicionar um Novo Livro

Adicionar um Novo Cliente

Adicionar um novo pedido

Exemplos de Requisições HTTP GET

Resgatar Livros por Nome

Resgatar um Livro pelo ID

Resgatar um Cliente pelo ID

Resgatar um Pedido pelo ID

Exemplos de Requisições HTTP PUT

Alterar um Livro pelo ID

Licença

Contato

About

Resources

License

Stars

Watchers

Forks

Releases

Packages 0

Languages

Packages