📚 BookManager API

🧭 Visão Geral

O BookManager é uma API REST desenvolvida em Spring Boot para gerenciar livros e suas categorias. O sistema permite o cadastro, listagem, atualização e exclusão de livros, além da organização por categorias.

Foi construída com boas práticas de arquitetura em camadas (Controller, Service, Repository e DTOs), além de migrações automáticas com Flyway para controle do banco de dados PostgreSQL.

⚙️ Tecnologias Utilizadas

• Spring Boot 3.x
• Spring Web
• Spring Data JPA
• Flyway Migration
• PostgreSQL
• Maven
• Lombok

🗂️ Estrutura do Projeto

BookManager/
 ├── src/
 │   ├── main/
 │   │   ├── java/com/sousaarthur/BookManager/
 │   │   │   ├── controller/
 │   │   │   │   ├── BookController.java
 │   │   │   │   └── CategoriesController.java
 │   │   │   ├── dto/
 │   │   │   │   ├── BookDTO.java
 │   │   │   │   ├── CategoryDTO.java
 │   │   │   │   ├── ListBooksDTO.java
 │   │   │   │   └── UpdateBookDTO.java
 │   │   │   ├── entity/
 │   │   │   │   ├── Book.java
 │   │   │   │   └── Category.java
 │   │   │   ├── repository/
 │   │   │   │   ├── BookRepository.java
 │   │   │   │   └── CategoryRepository.java
 │   │   │   └── Application.java
 │   │   └── resources/
 │   │       ├── application.yml
 │   │       └── db/migration/
 │   │           ├── V1__create-table-categories.sql
 │   │           ├── V2__create-table-books.sql
 │   │           └── V3__alter-table-books.sql
 ├── pom.xml
 └── README.md

🧩 Configuração e Execução

1. Clonar o repositório

git clone https://github.com/seu-usuario/BookManager.git
cd BookManager

2. Configurar o banco de dados (PostgreSQL) Crie um banco chamado bookmanager e atualize o arquivo application.yml com suas credenciais:

spring:
  datasource:
    url: jdbc:postgresql://localhost:5432/bookmanager
    username: seu_usuario
    password: sua_senha
  jpa:
    hibernate:
      ddl-auto: validate
  flyway:
    enabled: true

3. Executar a aplicação

./mvnw spring-boot:run

A API será iniciada em: 👉 http://localhost:8080

📘 Endpoints da API

📗 Livros (Books)

GET /books

Retorna a lista de todos os livros cadastrados.

Exemplo de resposta:

{
  "content": [
    {
      "id": 4,
      "title": "Harry Potter e a Pedra Filosofal: 1",
      "description": "Isso é uma descrição",
      "author": "J.K. Rowling ",
      "link": "https://sitedolivro.com",
      "urlImage": "https://image/exemplo.jpg",
      "createdAt": "2025-10-08T09:58:18.525399",
      "category": {
        "id": 4,
        "name": "Fantasia"
      },
      "actived": true
    },
    {
      "id": 5,
      "title": "O Pequeno Príncipe",
      "description": "Isso é uma descrição",
      "author": "Antoine de Saint-Exupéry",
      "link": "https://sitedolivro.com",
      "urlImage": "https://image/exemplo.jpg",
      "createdAt": "2025-10-08T09:58:18.525399",
      "category": {
        "id": 12,
        "name": "Infantil"
      },
      "actived": true
    }
  ],
}