Sales Record System💻

Tecnologias • Começando • Endpoints da API • Colaboradores • Contribuindo • Licença

O Sales Record System é uma aplicação REST desenvolvida em Java utilizando o framework Spring Boot. Este sistema permite o registro, atualização, exclusão e pesquisa de vendas. A aplicação é configurada para utilizar um banco de dados PostgreSQL e fornece uma API para interagir com os registros de vendas.

💻 Tecnologias

• Java
• Spring Boot 3
• PostgreSQL
• Gradle
• FlyWay Migrations

🚀 Começando

Pre-Requisitos

• Java 17+
• Gradle
• Postgres

Clonando o projeto

Cole a url abaixo para clonar o projeto

git clone https://github.com/CristianoMends/sales-record-system

Configure as variaveis de ambiente

   url: ${DATABASE_URL}
   username: ${DATABASE_USERNAME}
   password: ${DATABASE_PASSWORD}

📍 Endpoints da API

​

Route	Description
POST /sales	Registra uma venda. Consulte detalhes da resposta
DELETE /sales/{id}	Exclui uma venda pelo ID. Consulte detalhes da resposta
PATCH /sales/{id}	Atualiza parcialmente uma venda. Consulte detalhes da resposta
GET /sales	Lista todas as vendas registradas. Consulte detalhes da resposta
POST /sales/search	Pesquisa vendas com base em filtros. Consulte detalhes da resposta

POST /sales

REQUEST

{
  "price": 100.0,
  "description": "Venda de Produto X",
  "paymentMethod": "CREDIT"
}

RESPONSE

sale registered successfully

DELETE /sales/{id}

RESPONSE

sale deleted successfully

PATCH /sales/{id}

REQUEST

{
  "description": "Venda Atualizada",
  "price": 150.0,
  "paymentMethod": "DEBIT"
}

RESPONSE

sale updated successfully

GET /sales

RESPONSE

[
  {
    "price": 100.0,
    "description": "Venda de Produto X",
    "paymentMethod": "CREDIT",
    "date": "2024-08-21T14:45:00"
  },
  {
    "price": 50.0,
    "description": "Venda de Produto Y",
    "paymentMethod": "DEBIT",
    "date": "2024-08-21T15:00:00"
  }
]

POST /sales/search

REQUEST

{
  "description": "Produto X",
  "minPrice": 50.0,
  "maxPrice": 200.0,
  "startDate": "2024-08-01T00:00:00",
  "endDate": "2024-08-31T23:59:59",
  "paymentMethod":"PIX"
}

RESPONSE

[
  {
    "price": 100.0,
    "description": "Venda de Produto X",
    "paymentMethod": "PIX",
    "date": "2024-08-21T14:45:00"
  }
]

🤝 Colaboradoes

Cristiano Mendes

📫 Contribuindo

1. git clone https://github.com/CristianoMends/sales-record-system
2. git checkout -b feature/NOME-DA-FUNCIONALIDADE
3. Siga os padrões de commit.
4. Abra um Pull Request explicando o problema resolvido ou recurso realizado, se existir, anexe screenshot das modificações visuais e aguarde a revisão!

Licença

Este projeto é licenciado sob os termos da MIT Licence.