https://github.com/guilchaves/spring-professional-dscommerce
Projeto final da trilha Java Spring Professional da plataforma Dev Superior com instrutor Nelio Alves.
https://github.com/guilchaves/spring-professional-dscommerce
apache-tomcat bean-validation docker h2-database java-17 jwt maven oauth2 postgresql spring spring-boot spring-data-jpa spring-security
Last synced: 2 months ago
JSON representation
Projeto final da trilha Java Spring Professional da plataforma Dev Superior com instrutor Nelio Alves.
- Host: GitHub
- URL: https://github.com/guilchaves/spring-professional-dscommerce
- Owner: guilchaves
- License: mit
- Created: 2023-12-14T16:31:49.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2024-01-30T22:05:30.000Z (over 1 year ago)
- Last Synced: 2025-02-04T13:53:57.213Z (4 months ago)
- Topics: apache-tomcat, bean-validation, docker, h2-database, java-17, jwt, maven, oauth2, postgresql, spring, spring-boot, spring-data-jpa, spring-security
- Language: Java
- Homepage:
- Size: 179 KB
- Stars: 1
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Projeto Final - Sistema de Comércio Eletrônico
Este repositório contém o projeto final para conclusão do treinamento **Java Spring Professional** ministrado pelo
professor [Nelio Alves](https://www.udemy.com/user/nelio-alves/), oferecido pela plataforma [DevSuperior](https://devsuperior.com.br/).
Este projeto visa criar uma API RESTful de comércio
eletrônico usando tecnologias **Java, Spring Boot, Spring Data JPA, Bean Validation, PostgresSQL como banco de dados, Spring Security e JWT para controle de autenticação**.
###### Testes realizados com JUnit, Mockito, REST Assured. JaCoCo utilizado para cobertura de testes.
**Sistema em prod: [DSCommerce](https://dscommerce.onrender.com/products)**
## Visão Geral do Sistema
O sistema desenvolvido neste projeto é uma aplicação completa de comércio eletrônico,
abrangendo cadastros de usuários, produtos e categorias. Cada usuário, seja cliente ou administrador,
tem sua própria área de interação com o sistema. Os administradores têm acesso à área administrativa para gerenciar
usuários, produtos e categorias.
## Funcionalidades Principais
- Cadastro e autenticação de usuários com diferentes papéis (cliente, administrador).
- Catálogo de produtos com capacidade de filtragem por nome.
- Adição, remoção e alteração de itens no carrinho de compras.
- Registro de pedidos com status dinâmicos (aguardando pagamento, pago, enviado, entregue, cancelado).
- Área administrativa para gerenciamento de usuários, produtos e categorias.
## Como executar este projeto
##### Pré-requisitos:
- **Java 17**: [JDK 17](https://www.oracle.com/java/technologies/downloads/) ou superior.
- **IDEs**: [IntelliJ IDEA](https://www.jetbrains.com/idea/download/) ou [Spring Tools](https://spring.io/tools).
##### Passos:
1. **Clone o repositório**
Abra o terminal e navegue até o diretório onde deseja armazenar o projeto. Execute o seguinte comando para clonar o repositório:
```bash
git clone https://github.com/guilchaves/spring-professional-dscommerce.git
```
2. **Abra o projeto no IntelliJ IDEA ou STS:**
- _IntelliJ IDEA_: Abra o IntelliJ IDEA e selecione "Open" no menu principal. Navegue até o diretório do projeto e selecione o arquivo pom.xml.
- _Spring Tools Suite_: Abra o STS e selecione "Import..." > "Existing Maven Projects". Navegue até o diretório do projeto e selecione o arquivo pom.xml.
3. **Baixe as dependências do Maven:**
Aguarde até que o IntelliJ ou STS baixe automaticamente as dependências do Maven. Isso pode levar algum tempo, dependendo da conexão com a internet.
4. **Execute o projeto:**
No projeto, navegue até o arquivo `src/main/java/br/com/guilchaves/dscommerce/DscommerceApplication.java`. Este arquivo contém
a classe principal da aplicação Spring Boot.
- _IntelliJ IDEA_: Clique com o botão direito do mouse no arquivo DscommerceApplication.java e escolha "Run DscommerceApplication".
- _Spring Tools Suite_: Clique com o botão direito do mouse no projeto no navegador de projetos e escolha "Run As" > "Spring Boot App".
5. **Verifique a Execução:**
Após a execução bem-sucedida, abra um navegador da web e acesse `http://localhost:8080` (ou a porta configurada, se diferente) para verificar se a aplicação está em execução.
Acesse `http://localhost:8080/h2-console` para utilizar o console do H2 database.
## Para testar a API no postman:
Para importar e exportar dados no postman, consulte a documentação oficial [aqui](https://learning.postman.com/docs/getting-started/importing-and-exporting/importing-data/).
Download da coleção e variáveis de ambiente:
- [Collection](https://drive.google.com/file/d/1TjBh5Nu5znqEB-umnf304MMHe8USVLdj/view?usp=sharing)
- [Environment](https://drive.google.com/file/d/1_L1r4OSXcIJVxGzq-vGHYYP8CpoD5fhD/view?usp=sharing)
## Endpoints da API:
```
POST /login - Autenticação na API.
GET /categories - Retorna lista de categorias dos produtos.
GET /orders/{id} - Retorna pedido do usuário por id - clientes não podem acessar pedidos de outros clientes (requer privilégio ADMIN ou OPERATOR).
POST /orders - Adiciona novo pedido para cliente logado.
GET /products - Retorna lista de produtos.
GET /products/{id} - Retorna produto por id.
POST /products - Adiciona novo produto (requer privilégio ADMIN).
PUT /products/{id} - Atualiza dados de produto já existente (requer privilégio ADMIN).
DELETE /products/{id} - Remove produto da base de dados (requer privilégio ADMIN).
GET /users/me - Retorna dados do usuário logado (requer privilégio ADMIN ou OPERATOR).
```
## Autenticação
A API utiliza o Spring Security para controle de autenticação. Os seguintes papéis estão disponíveis:
```
OPERATOR -> Papel padrão para usuários autenticados.
ADMIN -> Papel de administrador para gerenciar produtos (adicionar, atualiza, remove produtos).
```
Para acessar os endpoints protegidos como um usuário ADMIN, forneça as credenciais de autenticação adequadas no cabeçalho da requisição.