Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/thejessemartins/sistema-de-gestao-estoque-api

Este é um sistema de gestão de estoque desenvolvido em Go usando o framework Gin e o ORM GORM com SQLite. A API permite gerenciar categorias, fornecedores, produtos e estoques, fornecendo uma solução completa para a gestão de inventário.
https://github.com/thejessemartins/sistema-de-gestao-estoque-api

gin golang gorm sqlite

Last synced: about 1 month ago
JSON representation

Este é um sistema de gestão de estoque desenvolvido em Go usando o framework Gin e o ORM GORM com SQLite. A API permite gerenciar categorias, fornecedores, produtos e estoques, fornecendo uma solução completa para a gestão de inventário.

Awesome Lists containing this project

README

        

## Descrição

Este é um sistema de gestão de estoque desenvolvido em Go usando o framework Gin e o ORM GORM com SQLite. A API permite gerenciar categorias, fornecedores, produtos e estoques, fornecendo uma solução completa para a gestão de inventário.

## Características

- **Gestão de Categorias**: Criação, leitura, atualização e exclusão de categorias.
- **Gestão de Fornecedores**: Criação, leitura, atualização e exclusão de fornecedores.
- **Gestão de Produtos**: Criação, leitura, atualização e exclusão de produtos.
- **Gestão de Estoques**: Criação, leitura, atualização e exclusão de estoques.
- **Automação de Migrações**: Migrações automáticas de banco de dados usando GORM.
- **Documentação de API**: Rotas bem definidas e documentadas para facilitar a integração.

## Tecnologias Utilizadas

- **Linguagem de Programação**: Go
- **Framework**: Gin
- **ORM**: GORM
- **Banco de Dados**: SQLite
- **Gerenciamento de Dependências**: Go Modules

## Estrutura do Projeto

```plaintext
estoque-api/
├── database/
│ └── database.go
├── models/
│ ├── categoria.go
│ ├── fornecedor.go
│ ├── produto.go
│ └── estoque.go
├── routes/
│ └── routes.go
├── controllers/
│ ├── categoria_controller.go
│ ├── fornecedor_controller.go
│ ├── produto_controller.go
│ └── estoque_controller.go
├── main.go
├── go.mod
├── go.sum
├── README.md
└── LICENSE
```

## Pré-requisitos

- Go instalado (versão 1.16 ou superior)
- Git instalado

## Como Executar

1. **Clone o repositório**:

```sh
git clone https://github.com/thejessemartins/sistema-de-gestao-estoque-api.git
cd sistema-de-gestao-estoque-api
```

2. **Instale as dependências**:

```sh
go mod tidy
```

3. **Execute o projeto**:

```sh
go run main.go
```

O servidor será iniciado na porta 8080.

## Rotas da API

### Categorias

- `GET /api/categorias`: Listar todas as categorias.
- `POST /api/categorias`: Criar uma nova categoria.

### Fornecedores

- `GET /api/fornecedores`: Listar todos os fornecedores.
- `POST /api/fornecedores`: Criar um novo fornecedor.

### Produtos

- `GET /api/produtos`: Listar todos os produtos.
- `POST /api/produtos`: Criar um novo produto.

### Estoques

- `GET /api/estoques`: Listar todos os estoques.
- `POST /api/estoques`: Criar um novo estoque.

## Contribuindo

Contribuições são bem-vindas! Por favor, abra uma issue ou envie um pull request.

### Diretrizes de Contribuição

1. **Fork** o projeto.
2. Crie um **branch** para sua feature (`git checkout -b feature/NovaFeature`).
3. Faça o **commit** das suas mudanças (`git commit -m 'Adiciona NovaFeature'`).
4. Faça o **push** para o branch (`git push origin feature/NovaFeature`).
5. Abra um **Pull Request**.

## Detalhes de Contato

- **Mantenedor**: Jessé Martins (jessemartins.programaçã[email protected])

## Licença

Este projeto está licenciado sob a Licença MIT. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.