Project

Desafio 01 - Programa If Black Then Code - Gama Academy & IBM

API - Loja Tudo De Bom

Plataforma para controle de estoque e gerenciamento de cadastro de clientes e transações de vendas.

💊 Sobre a Tudo de Bom:

A Tudo de Bom é uma farmácia que não comercializa apenas medicamentos, mas também produtos para higiene e cuidados pessoais, bem como outros tipos de produtos. A loja pretende adquirir sua própria plataforma de gestão, e precisa de uma API para gerenciar seu estoque e seu banco de dados de clientes. A empresa deseja poder realizar as seguintes ações em sua plataforma:

• Cadastrar, Listar, Atualizar e Excluir de dados de clientes;
• Acessar o histório das transações de vendas;
• Controlar o estoque, adicionando e removendo produtos;
• Automatizar a aplicação de descontos em medicamentos genéricos.

🛠️ Desenvolvimento

• Estrutura do banco de dados e relacionamento entre tabelas

Em ...\src\main\java\com\tudoDeBom\Project encontramos os pacotes criados para desenvolvimento da API, nestes pacotes teremos Classes e Interfaces que mais adiante veremos como funcionam e para que servem. Entendendo melhor os pacotes então, temos:

📦 com.tudoDeBom.Project

Este é um pacote que contém a classe ProjectApplication.java que realiza a inicialização da aplicação do Spring Boot;

📦 com.tudoDeBom.Project.Controller

Contém a classes que possuem métodos CRUD e suas respectivas anotações JPA, que tornam possível a comunicação entre a API e o Banco de Dados MySql. As classes são:

• ClienteController.java;
• ProdutoController.java;
• PedidoController.java.

📦 com.tudoDeBom.Project.Model

Aqui, temos classes que contém a declaração de seus atributos e seus respectivos getters, setters e a estrutura toSting(). Essas classes são:

• Cliente.java;
• Pedido.java;
• ItemPedido.java;
• Produto.java.

📦 com.tudoDeBom.Project.Repository

Este pacote contém interfaces herdeiras da interface JPARepository, que possui uma variedade de métodos como save(), delete() e findAll(), por exemplo. Essa relação é útil para a injeção de dependência. As interfaces contidas neste pacote são:

• ClienteRpository;
• ProdutoRepository;
• PedidoRepository;

📦 com.tudoDeBom.Project.Service

O pacote service tem classes e interfaces. As interfaces possuem a declaração de métodos, como por exemplo listar(), listarPeloNome(), editar(), entre outros, enquanto as classes correspondentes implementam estas interfaces e descrevem as ações dos métodos. As classes e interfaces são:

• ClienteService.java
• ClienteServiceInterface.java
• PedidoService.java
• PedidoServiceInterface.java
• ProdutoService.java
• ProdutoServiceInterface.java

⚙️ Executando os testes

• GET - Listar todos os clientes

• GET - Listar clientes pelo ID

• GET - Listar clientes pelo nome

• GET - Listar todos os pedidos

• GET - Listar pedidos pelo ID

• GET - Listar todos os produtos

• GET - Listar produtos pelo ID

• PUT - Atualizar clientes

• PUT - Atualizar clientes

• PUT - Atualizar produtos

• POST - Cadastrar clientes

• POST - Cadastrar produtos

• DELETE - Deletar cliente

• DELETE - Deletar produto

• CREATED - Criar novo pedido

💻 Tecnologias:

🏆 DevTeam:

Cristhiane da Cruz

Paulo Henrique

Caio Negrão

Cássia Leal

🎁 Agradecimentos

Agradecemos à IBM pela oportunidade de participarmos desta bela iniciativa que é o programa de treinamento If Black, Then Code, voltado para estudantes pretos(as) e pardos(as), que proporciona a ampliação de conhecimentos e de qualificação na área de desenvolvimento Back End e DevOps (Java). Agradeçemos também à Gama Academy e seus Yellow Belts pelo apoio e atenção nestas primeiras 2 semanas de treinamento, e aos professores Isidro em suas espetaculares aulas assíncronas e Ricardo Alexandre Bontempo em suas suuuuper monitorias.

O aprendizado é contínuo e sempre haverá um próximo nível!