{"id":21605959,"url":"https://github.com/matheusvidal21/dscommerce","last_synced_at":"2026-04-18T01:06:26.260Z","repository":{"id":219119570,"uuid":"748216358","full_name":"matheusvidal21/DSCommerce","owner":"matheusvidal21","description":"O DSCommerce é uma API completa que oferece endpoints para o cadastramento, gerenciamento e interação com diversos recursos essenciais para uma loja virtual.","archived":false,"fork":false,"pushed_at":"2024-12-23T16:12:28.000Z","size":1762,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-03-18T14:49:02.280Z","etag":null,"topics":["java","spring","spring-boot"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/matheusvidal21.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-25T14:18:24.000Z","updated_at":"2024-12-23T16:12:31.000Z","dependencies_parsed_at":"2024-02-01T21:59:37.892Z","dependency_job_id":"d59fd686-c9b9-4d14-b6b9-21e61f3075f8","html_url":"https://github.com/matheusvidal21/DSCommerce","commit_stats":null,"previous_names":["matheusvidal21/dscommerce"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/matheusvidal21/DSCommerce","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusvidal21%2FDSCommerce","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusvidal21%2FDSCommerce/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusvidal21%2FDSCommerce/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusvidal21%2FDSCommerce/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/matheusvidal21","download_url":"https://codeload.github.com/matheusvidal21/DSCommerce/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/matheusvidal21%2FDSCommerce/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268644966,"owners_count":24283406,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["java","spring","spring-boot"],"created_at":"2024-11-24T20:18:22.578Z","updated_at":"2026-04-18T01:06:21.207Z","avatar_url":"https://github.com/matheusvidal21.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Finalizado](https://img.shields.io/badge/Status-Conclu%C3%ADdo-brightgreen)](https://github.com/matheusvidal21/DSCommerce)\n\n\u003ch1 align=\"center\"\u003eDSCommerce\u003c/h1\u003e\n\n\u003cp align='center'\u003e \n    \u003cimg src=\"https://img.shields.io/badge/Spring_Boot-F2F4F9?style=for-the-badge\u0026logo=spring-boot\"/\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Java-ED8B00?style=for-the-badge\u0026logo=java\u0026logoColor=white\"/\u003e  \n    \u003cimg src=\"https://img.shields.io/badge/java-%23ED8B00.svg?style=for-the-badge\u0026logo=openjdk\u0026logoColor=white\"/\u003e\n\u003c/p\u003e    \n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/logo.png\" alt=\"Logo DSCommerce\" height=\"300\"\u003e\n\u003c/p\u003e\n\n[Testando endpoints.webm](https://github.com/matheusvidal21/DSCommerce/assets/102569695/8dc7beb7-7542-48c1-a731-dda4f41c7507)\n\n# 🔍 Visão Geral\n\u003cb\u003eO sistema deve manter um cadastro de usuário, produtos e suas categorias.\u003c/b\u003e \n- Cada usuário possui nome, email, telefone, data de nascimento e uma senha de acesso.\n- Os dados dos produtos são: nome, descrição, preço e imagem.\n  \nO sistema deve apresentar um catálogo de produtos, os quais podem ser filtrados pelo nome do produto. A partir desse catálogo, o usuário pode selecionar um produto para ver seus detalhes e para decidir se o adiciona a um carrinho\nde compras. O usuário pode incluir e remover itens do carrinho de compra, bem como alterar as quantidades de cada item. Uma vez que o usuário decida encerrar o pedido, o pedido deve então ser salvo no sistema com o status de\n\"aguardando pagamento\".\n\n- Os dados de um pedido são: instante em que ele foi salvo, status, e uma lista de itens, onde cada item se refere a um produto e sua quantidade no pedido.\n- O status de um pedido pode ser: aguardando pagamento, pago, enviado, entregue e cancelado.\n  \nQuando o usuário paga por um pedido, o instante do pagamento deve ser registrado. Os usuários do sistema podem ser clientes ou administradores, sendo que todo usuário cadastrado por padrão é cliente. Usuários não identificados podem\nse cadastrar no sistema, navegar no catálogo de produtos e no carrinho de compras. Clientes podem atualizar seu cadastro no sistema, registrar pedidos e visualizar seus próprios pedidos. Usuários administradores tem acesso à área\nadministrativa onde pode acessar os cadastros de usuários, produtos e categorias.\n\n\n\u003cb\u003e🖥️ Protótipos de tela:\u003c/b\u003e [clique aqui](https://www.figma.com/file/ZrGNVNG0kZL6txDv4G8P6s/DSCommerce)\n\n## Índice\n- 🧠 [Modelo conceitual](#-modelo-conceitual)\n- 📑 [Casos de Uso](#-casos-de-uso)\n- 📁 [Estrutura de pacotes](#-estrutura-de-pacotes)\n- 💻 [Tecnologias utilizadas](#-tecnologias-utilizadas)\n- 🔧 [Como executar](#-como-executar)\n- 🛠️ [Testando a API com o Postman](#%EF%B8%8F-testando-a-api-com-o-postman)\n- 👥 [Autor](#-autor)\n\n# 🧠 Modelo conceitual\n- Este é o modelo conceitual do sistema DSCommerce. Considerações: Cada item de pedido (OrderItem) corresponde a um produto no pedido, com uma quantidade. Sendo que o preço também é armazenado no item de pedido por\nquestões de histórico (se o preço do produto mudar no futuro, o preço do item de pedido continua registrado com o preço real que foi vendido na época).\n\n- Um usuário pode ter um ou mais \"roles\", que são os perfis de acesso deste usuário no sistema (client, admin).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/modelo_conceitual.png\" alt=\"Modelo conceitual\"\u003e\n\u003c/p\u003e\n\n \n# 📑 Casos de Uso\nO DSCommerce possui um conjunto de casos de uso que abrangem as principais funcionalidades do sistema. Eles incluem desde a navegação no catálogo de produtos até as operações administrativas.\n\n## Visão geral\n| Caso de uso | Visão geral | Acesso |\n|----------|----------|----------|\n| Manter produtos | CRUD de produtos, podendo filtrar itens pelo nome | Somente Admin |\n| Manter categorias | CRUD de categorias, podendo filtrar itens pelo nome | Somente Admin |\n| Manter usuários | CRUD de usuários, podendo filtrar itens pelo nome | Somente Admin |\n| Gerenciar carrinho | Incluir e remover itens do carrinho de compras, bem como alterar as quantidades do produto em cada item | Público |\n| Consultar catálogo | Listar produtos disponíveis, podendo filtrar produtos pelo nome | Público |\n| Sign up | Cadastrar-se no sistema | Público |\n| Login | Efetuar login no sistema | Público |\n| Registrar pedido | Salvar no sistema um pedido a partir dos dados do carrinho de compras informado | Usuário logado |\n| Atualizar perfil | Atualizar o próprio cadastro | Usuário logado |\n| Visualizar pedidos | Visualizar os pedidos que o próprio usuário já fez | Usuário logado |\n| Registrar pagamento | Salvar no sistema os dados do pagamento de um pedido | Somente Admin |\n| Reportar pedidos | Relatório de pedidos, podendo ser filtrados por data | Somente Admin |\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"docs/caso_de_uso.png\" alt=\"Caso de uso\"\u003e\n\u003c/p\u003e\n\n## Atores\n\n| Ator | Responsabilidade | \n|----------|----------|\n| Usuário anônimo | Pode realizar casos de uso das áreas públicas do sistema, como catálogo, carrinho de compras, login e sign up |\n| Cliente | Responsável por manter seu próprios dados pessoais no sistema, e pode visualizar histórico dos seus pedidos. Todo usuário cadastrado por padrão é um Cliente | \n| Admin | Responsável por acessar a área administrativa do sistema com cadastros e relatórios. Admin também pode fazer tudo que Cliente faz | \n\n## Detalhamento\n1. Consultar catálogo\n- Atores: Usuário anônimo, Cliente, Admin\n- Precondições: -\n- Pós-condições: -\n- Visão geral: Listar produtos disponíveis, podendo filtrar produtos pelo nome\n\n2. Manter produtos\n- Atores: Admin\n- Precondições: Usuário logado\n- Pós-condições: -\n- Visão geral: CRUD de produtos, podendo filtrar itens pelo nome\n\n4. Login\n- Atores: Usuário anônimo\n- Precondições: -\n- Pós-condições: Usuário logado\n- Visão geral: Efetuar login no sistema\n\n6. Gerenciar carrinho\n- Atores: Usuário anônimo\n- Precondições: -\n- Pós-condições: -\n- Visão geral: Incluir e remover itens do carrinho de compras, bem como alterar as quantidades do produto em cada item\n\n6. Registrar pedido\n- Atores: Cliente\n- Precondições: Usuário logado, Carrinho de compras não vazio\n- Pós-condições: Carrinho de compras vazio\n- Visão geral: Salvar no sistema um pedido a partir dos dados do carrinho de compras informado.\n\nPara mais detalhamento dos casos de uso, consulte o documento de requisitos do sistema [clicando aqui](/docs/documento_de_requisitos.pdf).\n\n# 📁 Estrutura de pacotes\n- **/docs:** Contém a documentação do projeto;\n- **/src:** Contém o código fonte do projeto;\n  - **/config:** Pacote com classes de configurações;\n      - **/customgrant:** Implementação de custom grant para autenticação;\n  - **/controllers:** Controladores da aplicação;\n      - **/handlers:** Manipuladores de requisição;\n  - **/dto:** Objetos de transferência de dados (DTO);\n  - **/entities:** Contém as entidades do projeto;\n  - **/entities:** Contém as projeções de entidades;\n  - **/repositories:** Repositórios para operações de banco de dados;\n  - **/services:** Serviços da aplicação;\n      - **/exceptions:** Exceções personalizadas;\n- **.gitignore:** Arquivo do Git para ignorar arquivos no controle de versão;\n- **README.md:** Documentação essencial do projeto em texto.\n\n# 💻 Tecnologias utilizadas\n![Java](https://img.shields.io/badge/java-%23ED8B00.svg?style=for-the-badge\u0026logo=openjdk\u0026logoColor=white)\n![Spring](https://img.shields.io/badge/spring-%236DB33F.svg?style=for-the-badge\u0026logo=spring\u0026logoColor=white)\n![Spring Security](https://img.shields.io/badge/Spring_Security-6DB33F?style=for-the-badge\u0026logo=Spring-Security\u0026logoColor=white)\n![JWT](https://img.shields.io/badge/JWT-black?style=for-the-badge\u0026logo=JSON%20web%20tokens)\n![IntelliJ IDEA](https://img.shields.io/badge/IntelliJIDEA-000000.svg?style=for-the-badge\u0026logo=intellij-idea\u0026logoColor=white)\n![Apache Maven](https://img.shields.io/badge/Apache%20Maven-C71A36?style=for-the-badge\u0026logo=Apache%20Maven\u0026logoColor=white)\n![Postman](https://img.shields.io/badge/Postman-FF6C37?style=for-the-badge\u0026logo=postman\u0026logoColor=white)\n![Hibernate](https://img.shields.io/badge/Hibernate-59666C?style=for-the-badge\u0026logo=Hibernate\u0026logoColor=white)\n\n# 🔧 Como executar?\nSegue abaixo as instruções para executar o projeto:\n\n## Pré-requisitos\n- Certifique-se de ter o Java JDK instalado na sua máquina\n- Instale o IntelliJ IDEA ou outra IDE de sua preferência para desenvolvimento Java\n- É necessário ter o Maven instalado em sua máquina\n\n### Passo 1: Clonar o Repositório\n```\ngit clone git@github.com:matheusvidal21/DSCommerce.git\n```\n\n### Passo 2: Importar o Projeto\n- Abra o Intellij IDEA ou sua IDE de preferência\n- Selecione \"Open\" no menu e escolha o diretório do projeto clonado\n- Aguarde até que o IntelliJ configure o projeto\n\n### Passo 3: Configuração\n- Verifique se todas as dependências foram carregadas corretamente pelo Maven \n\n### Passo 4: Execução\n- Localize a classe principal da aplicação `DscommerceApplication`(localizado em src/main/java/com/devsuperior/dscommerce) e execute-a\n- Ou, se preferir utilizar o Maven, você pode executar o projeto a partir da linha de comando:\n```\nmvn spring-boot:run\n```\n\n### Passo 5: Acesso à Aplicação\n- Uma vez que a aplicação esteja em execução, você pode interagir com ela consumindo os endpoints da API. Para isso, recomenda-se o uso de ferramentas como o Postman, que permite fazer requisições HTTP de forma fácil e eficiente\n- Se preferir, também é possível acessá-la através do navegador web, digitando o endereço \u003cb\u003e `http://localhost:8080` na barra de endereços\n\n# 🛠️ Testando a API com o Postman\nPara facilitar o teste dos endpoints da API, disponibilizei uma coleção e um ambiente (environment) no Postman contendo todas as requisições disponíveis. Siga os passos abaixo para importar a coleção e começar a testar:\n1. Baixe e Instale o Postman\n- Se você ainda não tem o Postman instalado, você pode baixá-lo e instalá-lo gratuitamente a partir do [site oficial](https://www.postman.com/downloads/)\n2. Importe a collection e o environment\n- Após instalar o Postman, faça o download da coleção que disponibilizei. Você pode encontrá-la [aqui](docs/postman/DSCommerce.postman_collection.json)\n- Também faça o download do ambiente (environment) localizado [aqui](docs/postman/DSCommerce%20auth.postman_environment.json)\n3. Importe no Postman\n- Abra o Postman e clique no botão \"File\" localizado no canto superior esquerdo da interface. Em seguida, selecione a opção \"Import\" e depois localize os dois arquivos e selecione-os\n4. Teste os Endpoints\n- Agora que a coleção foi importada com sucesso, você verá todas as requisições listadas no painel esquerdo do Postman. Basta selecionar a requisição desejada e clicar em \"Send\" para testá-la\n- Na parte superior direita do Postman, você verá um dropdown com a lista de environments. Selecione o environment recém-importado\n  \nCom a coleção disponível no Postman, você poderá testar facilmente todos os endpoints da sua API e garantir que ela esteja funcionando corretamente.\n\n# 👥 Autor\n\n| [\u003cimg src=\"https://avatars.githubusercontent.com/u/102569695?s=400\u0026u=f20bbb53cc46ec2bae01f8d60a28492bfdccbdd5\u0026v=4\" width=115\u003e\u003cbr\u003e\u003csub\u003eMatheus Vidal\u003c/sub\u003e](https://github.com/matheusvidal21) |\n| :---: |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatheusvidal21%2Fdscommerce","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmatheusvidal21%2Fdscommerce","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmatheusvidal21%2Fdscommerce/lists"}