{"id":23638281,"url":"https://github.com/kauanrodrigues01/sge","last_synced_at":"2026-05-04T08:33:33.494Z","repository":{"id":269105318,"uuid":"906436545","full_name":"Kauanrodrigues01/sge","owner":"Kauanrodrigues01","description":"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.","archived":false,"fork":false,"pushed_at":"2025-02-15T12:56:16.000Z","size":198,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-15T13:35:17.493Z","etag":null,"topics":["bootstrap","django","inteligencia-artificial","python","sge"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Kauanrodrigues01.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-20T22:58:50.000Z","updated_at":"2025-02-15T12:56:20.000Z","dependencies_parsed_at":"2024-12-21T15:27:36.892Z","dependency_job_id":"f387bf8f-ebed-4a8e-b011-941cd5d7918b","html_url":"https://github.com/Kauanrodrigues01/sge","commit_stats":null,"previous_names":["kauanrodrigues01/sistema-de-gerenciamento-de-estoque","kauanrodrigues01/sge"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kauanrodrigues01%2Fsge","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kauanrodrigues01%2Fsge/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kauanrodrigues01%2Fsge/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Kauanrodrigues01%2Fsge/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Kauanrodrigues01","download_url":"https://codeload.github.com/Kauanrodrigues01/sge/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239571582,"owners_count":19661165,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bootstrap","django","inteligencia-artificial","python","sge"],"created_at":"2024-12-28T07:38:39.856Z","updated_at":"2025-10-31T13:03:22.993Z","avatar_url":"https://github.com/Kauanrodrigues01.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SGE - Sistema de Gestão de Estoque\r\n\r\nO **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.\r\n\r\n---\r\n\r\n## **🔍 Menu de Navegação**\r\n- [Principais Funcionalidades](#principais-funcionalidades)\r\n- [Tecnologias Utilizadas](#tecnologias-utilizadas)\r\n- [Integrações](#integrações)\r\n- [Visualização do Sistema](#visualizacao-do-sistema)\r\n- [Como Configurar o Projeto](#como-configurar-o-projeto)\r\n  - [Executando com Docker](#executando-com-docker)\r\n\r\n---\r\n\r\n\u003cspan id=\"principais-funcionalidades\"\u003e\u003c/span\u003e\r\n## **Principais Funcionalidades**\r\n- **Gerenciamento de Estoque**:\r\n  - Controle de produtos, fornecedores, marcas e categorias.\r\n  - Registro de entradas e saídas de estoque.\r\n- **Integração com Inteligência Artificial**:\r\n  - Sugestões de reposição com base em históricos de vendas e consumo.\r\n  - Insights para otimização da gestão de estoque.\r\n- **Gráficos e Métricas**:\r\n  - Gráficos interativos usando Chart.js:\r\n    - Valor de Vendas (últimos 7 dias).\r\n    - Quantidade de Vendas Diárias (últimos 7 dias).\r\n    - Distribuição de produtos por marca e categoria.\r\n  - Métricas gerais:\r\n    - **Produtos**: Quantidade total, custo total, preço de venda total, lucro total.\r\n    - **Vendas**: Total de vendas, total de produtos vendidos, valor total de vendas, lucro total de vendas.\r\n- **Estilização e Front-end**:\r\n  - Design responsivo utilizando **Bootstrap**.\r\n- **Notificações**:\r\n  - Envio de mensagens automáticas via WhatsApp (API da **Evolution**).\r\n  - Envio de e-mails com o próprio Django.\r\n\r\n---\r\n\r\n\u003cspan id=\"tecnologias-utilizadas\"\u003e\u003c/span\u003e\r\n## **Tecnologias Utilizadas**\r\n\u003cp align=\"left\"\u003e\r\n  \u003cimg src=\"https://github.com/Kauanrodrigues01/Kauanrodrigues01/blob/main/icons/backend/python.svg\" width=\"40\" height=\"40\" alt=\"Python\" /\u003e\r\n  \u003cimg src=\"https://github.com/Kauanrodrigues01/Kauanrodrigues01/blob/main/icons/backend/django.svg\" height=\"50\" alt=\"Django\" /\u003e\r\n  \u003cimg src=\"https://github.com/Kauanrodrigues01/Kauanrodrigues01/blob/main/icons/backend/postgresql-light.svg\" width=\"40\" height=\"40\" alt=\"PostgreSQL\" /\u003e\r\n  \u003cimg src=\"https://github.com/Kauanrodrigues01/Kauanrodrigues01/blob/main/icons/frontend/bootstrap.svg\" height=\"35\" alt=\"BootStrap\" /\u003e\r\n  \u003cimg src=\"https://github.com/Kauanrodrigues01/Kauanrodrigues01/blob/main/icons/frontend/chartjs.svg\" width=\"40\" height=\"40\" alt=\"ChartJS\" /\u003e\r\n\u003c/p\u003e\r\n\r\n- **Back-end**:\r\n  - **Django** para o criação do sistema web e gerenciamento do sistema e envio de e-mails.\r\n  - **Gemini** para integração de IA e fornecimento de insights.\r\n- **Front-end**:\r\n  - **Bootstrap** para estilização.\r\n  - **Chart.js** para criação de gráficos interativos.\r\n\r\n---\r\n\r\n\u003cspan id=\"integrações\"\u003e\u003c/span\u003e\r\n## **Integrações**\r\n\r\n\u003cimg src=\"https://github.com/Kauanrodrigues01/Kauanrodrigues01/blob/main/images/evolution-api.png\" width=\"180\" alt=\"Evolution API\" /\u003e\r\n\r\n- Envio de mensagens automáticas pelo WhatsApp.\r\n- Alertas de movimentações e baixo estoque.\r\n\r\n\u003cimg src=\"https://github.com/Kauanrodrigues01/Kauanrodrigues01/blob/main/images/gemini.png\" width=\"150\" alt=\"Evolution API\" /\u003e\r\n\r\n- IA para sugestões de reposição e insights de otimização.\r\n\r\n---\r\n\r\n\u003cspan id=\"visualizacao-do-sistema\"\u003e\u003c/span\u003e\r\n## **Visualização do Sistema**\r\n\r\n### **Gráficos**\r\n\r\n- **Valor de Vendas (últimos 7 dias):**\r\n- **Quantidade de Vendas Diárias (últimos 7 dias):**\r\n- **Produtos por Marca:**\r\n- **Produtos por Categoria:**\r\n\r\n\u003e *Adicionar aqui imagens de exemplos de gráficos gerados.*\r\n\r\n### **Métricas**\r\n\r\n- **Produtos**:\r\n  - Quantidade Total: `total_quantity`\r\n  - Custo Total: `total_cost_price`\r\n  - Preço de Venda Total: `total_selling_price`\r\n  - Lucro Total: `total_profit`\r\n- **Vendas**:\r\n  - Total de Vendas: `total_sales`\r\n  - Total de Produtos Vendidos: `total_products_sold`\r\n  - Valor Total de Vendas: `total_sales_value`\r\n  - Lucro Total de Vendas: `total_sales_profit`\r\n\r\n\u003e *Adicionar aqui imagens de exemplos de visualização de métricas.*\r\n\r\n---\r\n\r\n\u003cspan id=\"como-configurar-o-projeto\"\u003e\u003c/span\u003e\r\n## **🛠️ Como Configurar o Projeto**\r\n\r\n\u003cspan id=\"executando-com-docker\"\u003e\u003c/span\u003e\r\n### **Executando com Docker**\r\n\r\n1. Vá ao site da [Google Ai studio](https://aistudio.google.com/apikey) e gere a sua chave de API gratuitamente.\r\n\r\n1. Inicie os containers da evolution api:\r\n```bash\r\ndocker compose -f docker-compose-evolution.yml up -d\r\n```\r\n\r\n2. 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.\r\n\r\n3. Crie um arquivo `.env` na raiz do projeto e adicione as seguintes variáveis:\r\n```env\r\n# INTEGRATION WITH GEMINI API\r\nGEMINI_API_KEY=api-key\r\nGEMINI_MODEL=gemini-1.5-flash\r\n\r\n# INTEGRATION WITH EVOLUTION API\r\nMY_NUMBER=55*********\r\nINSTANCE_NAME=test\r\nINSTANCE_TOKEN=instance-token\r\n\r\n# EMAIL\r\nEMAIL_HOST=smtp.gmail.com\r\nEMAIL_PORT=587\r\nEMAIL_HOST_USER=example@test.com\r\nEMAIL_HOST_PASSWORD=@Test01020202010\r\nMY_EMAIL=myemail@test.com\r\n\r\n# Credentials for superuser\r\nSUPERUSER_USERNAME=admin\r\nSUPERUSER_EMAIL=admin@gmail.com\r\nSUPERUSER_PASSWORD=admin\r\n```\r\n\r\n4. Construa e inicie os containers da aplicação:\r\n```bash\r\ndocker build -t sge-app:0.0.1 .\r\ndocker compose up -d\r\n```\r\n\r\n5. Agora os seguintes containers estarão rodando:\r\n   - Aplicativo Django\r\n   - Celery Worker\r\n   - Celery Beat\r\n   - RabbitMQ\r\n   - PostgreSQL\r\n\r\n4. Acesse o sistema em: [http://localhost:8000/](http://localhost:8000/)\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkauanrodrigues01%2Fsge","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkauanrodrigues01%2Fsge","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkauanrodrigues01%2Fsge/lists"}