{"id":31600286,"url":"https://github.com/kelvynamaral/pdv-mercearia-spring","last_synced_at":"2026-05-08T06:51:38.328Z","repository":{"id":317111126,"uuid":"1065918424","full_name":"KelvynAmaral/pdv-mercearia-Spring","owner":"KelvynAmaral","description":" Sistema de Gestão de Vendas - Backend  API RESTful desenvolvida em Spring Boot para gerenciar operações de um sistema de vendas, incluindo autenticação de usuários, controle de estoque, registro de produtos e processamento de vendas.    O projeto utiliza PostgreSQL como banco de dados, Spring Security com JWT para autenticação e autorização","archived":false,"fork":false,"pushed_at":"2025-09-28T22:23:32.000Z","size":36,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-09-28T23:26:38.911Z","etag":null,"topics":["java","jwt","postgresql","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/KelvynAmaral.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-09-28T17:32:44.000Z","updated_at":"2025-09-28T22:30:00.000Z","dependencies_parsed_at":"2025-09-28T23:26:41.101Z","dependency_job_id":"8901a93c-3ba6-4c97-a6e5-29c2f2b963fa","html_url":"https://github.com/KelvynAmaral/pdv-mercearia-Spring","commit_stats":null,"previous_names":["kelvynamaral/pdv-mercearia-spring"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/KelvynAmaral/pdv-mercearia-Spring","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KelvynAmaral%2Fpdv-mercearia-Spring","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KelvynAmaral%2Fpdv-mercearia-Spring/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KelvynAmaral%2Fpdv-mercearia-Spring/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KelvynAmaral%2Fpdv-mercearia-Spring/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KelvynAmaral","download_url":"https://codeload.github.com/KelvynAmaral/pdv-mercearia-Spring/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KelvynAmaral%2Fpdv-mercearia-Spring/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278572004,"owners_count":26008686,"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-10-06T02:00:05.630Z","response_time":65,"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","jwt","postgresql","spring-boot"],"created_at":"2025-10-06T06:56:00.205Z","updated_at":"2025-10-06T06:56:03.781Z","avatar_url":"https://github.com/KelvynAmaral.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛍️ Sistema de Gestão de Vendas - API Backend\n\n## 🚀 Sobre o Projeto\nBackend do **sistema de gestão de vendas**, desenvolvido com **Spring Boot**.  \nExpõe uma **API RESTful** segura e escalável para operações de um Ponto de Venda:  \ncontrole de estoque, registro de vendas e autenticação de usuários.\n\n---\n\n## 🏗️ Arquitetura\n\n```mermaid\nflowchart TD\n    Client[Clientes Web/Mobile] --\u003e API[Spring Boot API]\n    API --\u003e Auth[Spring Security + JWT]\n    API --\u003e Services[Serviços / Regras de Negócio]\n    Services --\u003e DB[(PostgreSQL)]\n```\n\n---\n\n## ⚙️ Como Rodar\n\n### ✅ Pré-requisitos\n- JDK 21  \n- PostgreSQL 14+  \n- Maven 3.8+  \n- IDE (IntelliJ recomendada)\n\n### 🔧 Passos\n```bash\ngit clone https://github.com/KelvynAmaral/pdv-mercearia-Spring.git\ncd pdv-api\n```\n\nCrie o banco `pdv_mercearia` no PostgreSQL.  \nEdite `src/main/resources/application.properties`:\n\n```properties\nspring.datasource.password=SUA_SENHA_DO_POSTGRES\n```\n\nRode a aplicação (`PdvApiApplication.java`).  \nServidor inicia em **http://localhost:8080**.\n\n---\n\n## ▶️ Testando a API\n\n### 1. Registrar Usuário\n```http\nPOST /auth/registrar\n```\n```json\n{\n  \"email\": \"admin@pdv.com\",\n  \"senha\": \"senha123\",\n  \"role\": \"ROLE_ADMIN\"\n}\n```\n\n### 2. Login\n```http\nPOST /auth/login\n```\nResposta: token JWT.\n\n### 3. Criar Produto\n```http\nPOST /produtos\nAuthorization: Bearer SEU_TOKEN\n```\n```json\n{\n  \"codigo\": \"001\",\n  \"nome\": \"Arroz 1kg\",\n  \"precoVenda\": 5.50,\n  \"quantidadeEstoque\": 100\n}\n```\n\n---\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkelvynamaral%2Fpdv-mercearia-spring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkelvynamaral%2Fpdv-mercearia-spring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkelvynamaral%2Fpdv-mercearia-spring/lists"}