https://github.com/kauanrodrigues01/sge
SGE (Sistema de Gestão de Estoque) que gerencia produtos, fornecedores, marcas, categorias, entradas e saídas de estoque. Envia notificações automáticas por WhatsApp e e-mail ao administrador sobre movimentações e alertas de baixo estoque. Integrado com IA, oferece sugestões de reposição e insights para otimizar a gestão de estoque.
https://github.com/kauanrodrigues01/sge
bootstrap django inteligencia-artificial python sge
Last synced: 3 months ago
JSON representation
SGE (Sistema de Gestão de Estoque) que gerencia produtos, fornecedores, marcas, categorias, entradas e saídas de estoque. Envia notificações automáticas por WhatsApp e e-mail ao administrador sobre movimentações e alertas de baixo estoque. Integrado com IA, oferece sugestões de reposição e insights para otimizar a gestão de estoque.
- Host: GitHub
- URL: https://github.com/kauanrodrigues01/sge
- Owner: Kauanrodrigues01
- Created: 2024-12-20T22:58:50.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2025-02-15T12:56:16.000Z (4 months ago)
- Last Synced: 2025-02-15T13:35:17.493Z (4 months ago)
- Topics: bootstrap, django, inteligencia-artificial, python, sge
- Language: Python
- Homepage:
- Size: 193 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# SGE - Sistema de Gestão de Estoque
O **SGE (Sistema de Gestão de Estoque)** é uma solução completa para o gerenciamento de estoque. Ele oferece ferramentas para controlar produtos, fornecedores, marcas, categorias, entradas e saídas de estoque, com um sistema de notificações automáticas e insights baseados em inteligência artificial.
---
## **🔍 Menu de Navegação**
- [Principais Funcionalidades](#principais-funcionalidades)
- [Tecnologias Utilizadas](#tecnologias-utilizadas)
- [Integrações](#integrações)
- [Visualização do Sistema](#visualizacao-do-sistema)
- [Como Configurar o Projeto](#como-configurar-o-projeto)
- [Executando com Docker](#executando-com-docker)
---
## **Principais Funcionalidades**
- **Gerenciamento de Estoque**:
- Controle de produtos, fornecedores, marcas e categorias.
- Registro de entradas e saídas de estoque.
- **Integração com Inteligência Artificial**:
- Sugestões de reposição com base em históricos de vendas e consumo.
- Insights para otimização da gestão de estoque.
- **Gráficos e Métricas**:
- Gráficos interativos usando Chart.js:
- Valor de Vendas (últimos 7 dias).
- Quantidade de Vendas Diárias (últimos 7 dias).
- Distribuição de produtos por marca e categoria.
- Métricas gerais:
- **Produtos**: Quantidade total, custo total, preço de venda total, lucro total.
- **Vendas**: Total de vendas, total de produtos vendidos, valor total de vendas, lucro total de vendas.
- **Estilização e Front-end**:
- Design responsivo utilizando **Bootstrap**.
- **Notificações**:
- Envio de mensagens automáticas via WhatsApp (API da **Evolution**).
- Envio de e-mails com o próprio Django.
---
## **Tecnologias Utilizadas**
- **Back-end**:
- **Django** para o criação do sistema web e gerenciamento do sistema e envio de e-mails.
- **Gemini** para integração de IA e fornecimento de insights.
- **Front-end**:
- **Bootstrap** para estilização.
- **Chart.js** para criação de gráficos interativos.
---
## **Integrações**
- Envio de mensagens automáticas pelo WhatsApp.
- Alertas de movimentações e baixo estoque.
- IA para sugestões de reposição e insights de otimização.
---
## **Visualização do Sistema**
### **Gráficos**
- **Valor de Vendas (últimos 7 dias):**
- **Quantidade de Vendas Diárias (últimos 7 dias):**
- **Produtos por Marca:**
- **Produtos por Categoria:**
> *Adicionar aqui imagens de exemplos de gráficos gerados.*
### **Métricas**
- **Produtos**:
- Quantidade Total: `total_quantity`
- Custo Total: `total_cost_price`
- Preço de Venda Total: `total_selling_price`
- Lucro Total: `total_profit`
- **Vendas**:
- Total de Vendas: `total_sales`
- Total de Produtos Vendidos: `total_products_sold`
- Valor Total de Vendas: `total_sales_value`
- Lucro Total de Vendas: `total_sales_profit`
> *Adicionar aqui imagens de exemplos de visualização de métricas.*
---
## **🛠️ Como Configurar o Projeto**
### **Executando com Docker**
1. Vá ao site da [Google Ai studio](https://aistudio.google.com/apikey) e gere a sua chave de API gratuitamente.
1. Inicie os containers da evolution api:
```bash
docker compose -f docker-compose-evolution.yml up -d
```
2. Acesse a evolution na url: [http://localhost:8080/manager/](http://localhost:8080/manager/) e crie uma instância para o whatsApp e conecte-se através do QR code.
3. Crie um arquivo `.env` na raiz do projeto e adicione as seguintes variáveis:
```env
# INTEGRATION WITH GEMINI API
GEMINI_API_KEY=api-key
GEMINI_MODEL=gemini-1.5-flash
# INTEGRATION WITH EVOLUTION API
MY_NUMBER=55*********
INSTANCE_NAME=test
INSTANCE_TOKEN=instance-token
# EMAIL
EMAIL_HOST=smtp.gmail.com
EMAIL_PORT=587
[email protected]
EMAIL_HOST_PASSWORD=@Test01020202010
[email protected]
# Credentials for superuser
SUPERUSER_USERNAME=admin
[email protected]
SUPERUSER_PASSWORD=admin
```
4. Construa e inicie os containers da aplicação:
```bash
docker build -t sge-app:0.0.1 .
docker compose up -d
```
5. Agora os seguintes containers estarão rodando:
- Aplicativo Django
- Celery Worker
- Celery Beat
- RabbitMQ
- PostgreSQL
4. Acesse o sistema em: [http://localhost:8000/](http://localhost:8000/)