PhoneAPI - CRUD de Loja de Celulares

Este é um projeto de API CRUD desenvolvido com Spring Boot para o gerenciamento de uma loja de celulares. A API permite a criação, leitura, atualização e exclusão de produtos (celulares) de forma simples e eficiente.

Funcionalidades

• Criar: Adicione novos celulares à loja.
• Ler: Consulte os detalhes dos celulares cadastrados.
• Atualizar: Modifique as informações de celulares existentes.
• Excluir: Remova celulares do catálogo.

Tecnologias Utilizadas

• Spring Boot: Framework principal para construção da API.
• JPA (Java Persistence API): Para interação com banco de dados.
• PostgreSQL: Banco de dados relacional utilizado para armazenar os dados.
• Flyway: Para controle de migrações do banco de dados.
• Lombok: Para reduzir o código boilerplate, como getters, setters e construtores.

Pré-requisitos

Antes de rodar a API, garanta que você tenha:

• Java 17 ou superior instalado.
• Maven para gerenciamento de dependências e execução do projeto.
• PostgreSQL rodando em sua máquina ou em um ambiente de desenvolvimento.

Como Rodar o Projeto

1. Clone o repositório

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

2. Configurar o Banco de Dados

No arquivo src/main/resources/application.properties, configure as credenciais do banco de dados:

spring.datasource.url=jdbc:postgresql://localhost:5432/phone_store
spring.datasource.username=seu-usuario
spring.datasource.password=sua-senha
spring.jpa.hibernate.ddl-auto=update

3. Rodar o Projeto

Execute o seguinte comando para compilar e iniciar o projeto:

./mvnw spring-boot:run

Ou, se preferir usar Maven diretamente:

mvn spring-boot:run

A aplicação estará rodando em http://localhost:8080.

Endpoints da API

A API fornece os seguintes endpoints para realizar operações CRUD:

• GET /phones: Retorna todos os celulares cadastrados.
• GET /phones/{id}: Retorna os detalhes de um celular específico.
• POST /phones: Adiciona um novo celular à loja.
• PUT /phones/{id}: Atualiza os detalhes de um celular existente.
• DELETE /phones/{id}: Remove um celular do catálogo.

Exemplos de Uso

1. Criar um novo celular (POST)

POST /phones
{
  "name": "iPhone 13",
  "brand": "Apple",
  "price": 7999.99,
  "storage": "128GB"
}

2. Consultar todos os celulares (GET)

GET /phones

3. Atualizar um celular existente (PUT)

PUT /phones/1
{
  "name": "iPhone 13 Pro",
  "brand": "Apple",
  "price": 9999.99,
  "storage": "256GB"
}

4. Excluir um celular (DELETE)

DELETE /phones/1

Licença

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