API de gestão para a marca HUM, desenvolvida em Java com Spring Boot.
O objetivo do projeto é controlar produtos, estoque, vendas e futuramente custos e relatórios da loja.
- Java 21
- Spring Boot
- Spring Data JPA
- PostgreSQL
- Swagger / Springdoc OpenAPI
- Maven
- DBeaver
- Cadastro de produtos
- Cadastro de produtos em lote
- Listagem de produtos ativos
- Listagem de produtos inativos
- Busca de produto por ID
- Atualização de produto
- Inativação de produto
- Reativação de produto
- Validação de campos
- Tratamento padronizado de erros
- Controle de SKU único
- Registro automático de data de cadastro e atualização
POST /produtos
POST /produtos/lote
GET /produtos
GET /produtos/inativos
GET /produtos/{id}
PUT /produtos/{id}
PUT /produtos/{id}/reativar
DELETE /produtos/{id}
Configuração do ambiente
Este projeto usa variáveis de ambiente em um arquivo .env.
Crie um arquivo .env na raiz do projeto com base no .env.example:
DB_URL=jdbc:postgresql://localhost:5432/sistema_hum
DB_USERNAME=postgres
DB_PASSWORD=sua_senha_aqui
O arquivo .env não deve ser enviado para o GitHub.
Como executar
No terminal, dentro da pasta do projeto:
./mvnw spring-boot:run
No Windows PowerShell:
.\mvnw spring-boot:run
Swagger
Com a aplicação rodando, acesse:
http://localhost:8080/swagger-ui.html
Status do projeto
Projeto em desenvolvimento.
Próximas etapas previstas:
Movimentação de estoque
Registro de vendas
Controle de custos
Relatórios
Front-end em React
Login e segurança