📦 Inventory Management API

API REST desenvolvida com Spring Boot para gerenciamento de ativos de TI.

Projeto criado com foco em aprendizado de desenvolvimento Backend utilizando Java, Spring Boot, JPA, PostgreSQL e boas práticas de desenvolvimento.

---

🚀 Tecnologias Utilizadas

• Java 21+
• Spring Boot 3
• Spring Data JPA
• PostgreSQL
• Maven
• Hibernate
• Swagger / OpenAPI
• Git
• GitHub

---

📋 Funcionalidades

CRUD Completo de Ativos

• Criar ativo
• Listar ativos
• Buscar ativo por ID
• Atualizar ativo
• Excluir ativo

Filtros

• Buscar por nome
• Buscar por categoria
• Buscar por status

Paginação

• Listagem paginada de ativos

Tratamento de Exceções

• Validação de campos obrigatórios
• Recurso não encontrado (404)
• Erros de validação (400)
• Erros internos do servidor (500)

---

🗄️ Estrutura da Entidade

{
  "id": 1,
  "nome": "Notebook Dell Latitude",
  "categoria": "Notebook",
  "patrimonio": "PAT-001",
  "status": "DISPONIVEL",
  "localizacao": "TI",
  "responsavel": "Carlos Pereira"
}

---

📡 Endpoints

Criar Ativo

POST /ativos

Listar Todos

GET /ativos

Buscar por ID

GET /ativos/{id}

Atualizar

PUT /ativos/{id}

Excluir

DELETE /ativos/{id}

---

🔎 Filtros

Buscar por Nome

GET /ativos/busca?nome=Notebook

Buscar por Categoria

GET /ativos/categoria?categoria=Notebook

Buscar por Status

GET /ativos/status?status=DISPONIVEL

---

📄 Paginação

GET /ativos/paginado?page=0&size=5

Exemplo:

GET /ativos/paginado?page=0&size=2

---

⚙️ Como Executar o Projeto

Clonar o Repositório

git clone https://github.com/carloska24/inventory-management-api.git

Entrar na Pasta

cd inventory-management-api

Configurar PostgreSQL

Criar banco:

CREATE DATABASE inventory;

Configurar o arquivo:

application.properties

com os dados do PostgreSQL local.

Executar

./mvnw spring-boot:run

ou

mvn spring-boot:run

---

📚 Documentação Swagger

Após iniciar a aplicação:

http://localhost:8080/swagger-ui/index.html

---

🎯 Objetivo do Projeto

Este projeto foi desenvolvido como parte da minha transição de carreira para Desenvolvimento Backend, aplicando conceitos de:

• APIs REST
• Spring Boot
• Persistência de Dados
• PostgreSQL
• Tratamento de Exceções
• Boas Práticas de Backend
• Git e GitHub

---

👨‍💻 Autor

Carlos Pereira

LinkedIn: https://www.linkedin.com/

GitHub: https://github.com/carloska24