https://github.com/kelvynamaral/pdv-mercearia-spring
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
https://github.com/kelvynamaral/pdv-mercearia-spring
java jwt postgresql spring-boot
Last synced: 2 months ago
JSON representation
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
- Host: GitHub
- URL: https://github.com/kelvynamaral/pdv-mercearia-spring
- Owner: KelvynAmaral
- Created: 2025-09-28T17:32:44.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-09-28T22:23:32.000Z (9 months ago)
- Last Synced: 2025-09-28T23:26:38.911Z (9 months ago)
- Topics: java, jwt, postgresql, spring-boot
- Language: Java
- Homepage:
- Size: 35.2 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🛍️ Sistema de Gestão de Vendas - API Backend
## 🚀 Sobre o Projeto
Backend do **sistema de gestão de vendas**, desenvolvido com **Spring Boot**.
Expõe uma **API RESTful** segura e escalável para operações de um Ponto de Venda:
controle de estoque, registro de vendas e autenticação de usuários.
---
## 🏗️ Arquitetura
```mermaid
flowchart TD
Client[Clientes Web/Mobile] --> API[Spring Boot API]
API --> Auth[Spring Security + JWT]
API --> Services[Serviços / Regras de Negócio]
Services --> DB[(PostgreSQL)]
```
---
## ⚙️ Como Rodar
### ✅ Pré-requisitos
- JDK 21
- PostgreSQL 14+
- Maven 3.8+
- IDE (IntelliJ recomendada)
### 🔧 Passos
```bash
git clone https://github.com/KelvynAmaral/pdv-mercearia-Spring.git
cd pdv-api
```
Crie o banco `pdv_mercearia` no PostgreSQL.
Edite `src/main/resources/application.properties`:
```properties
spring.datasource.password=SUA_SENHA_DO_POSTGRES
```
Rode a aplicação (`PdvApiApplication.java`).
Servidor inicia em **http://localhost:8080**.
---
## ▶️ Testando a API
### 1. Registrar Usuário
```http
POST /auth/registrar
```
```json
{
"email": "admin@pdv.com",
"senha": "senha123",
"role": "ROLE_ADMIN"
}
```
### 2. Login
```http
POST /auth/login
```
Resposta: token JWT.
### 3. Criar Produto
```http
POST /produtos
Authorization: Bearer SEU_TOKEN
```
```json
{
"codigo": "001",
"nome": "Arroz 1kg",
"precoVenda": 5.50,
"quantidadeEstoque": 100
}
```
---