Skip to content

Kauanrodrigues01/sge

Repository files navigation

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

  • 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

Python Django PostgreSQL BootStrap ChartJS

  • 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

Evolution API

  • Envio de mensagens automáticas pelo WhatsApp.
  • Alertas de movimentações e baixo estoque.

Evolution API

  • 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 e gere a sua chave de API gratuitamente.

  2. Inicie os containers da evolution api:

docker compose -f docker-compose-evolution.yml up -d
  1. Acesse a evolution na url: http://localhost:8080/manager/ e crie uma instância para o whatsApp e conecte-se através do QR code.

  2. Crie um arquivo .env na raiz do projeto e adicione as seguintes variáveis:

# 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_HOST_USER=example@test.com
EMAIL_HOST_PASSWORD=@Test01020202010
MY_EMAIL=myemail@test.com

# Credentials for superuser
SUPERUSER_USERNAME=admin
SUPERUSER_EMAIL=admin@gmail.com
SUPERUSER_PASSWORD=admin
  1. Construa e inicie os containers da aplicação:
docker build -t sge-app:0.0.1 .
docker compose up -d
  1. Agora os seguintes containers estarão rodando:

    • Aplicativo Django
    • Celery Worker
    • Celery Beat
    • RabbitMQ
    • PostgreSQL
  2. Acesse o sistema em: http://localhost:8000/

About

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.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors