📦 STOCK_BOX – Sistema de Gestão de Estoque

Sistema web simples e eficiente para controle de produtos em estoque com visualização em tempo real, leitura de QR Code e painel administrativo completo.

---

📁 Estrutura do Projeto

STOCK_BOX/
│
├── public/ # Arquivos acessíveis externamente
│ ├── assets/
│ │ ├── css/ # CSS modular por página
│ │ │ ├── global.css
│ │ │ ├── dashboard.css
│ │ │ ├── form.css
│ │ │ ├── index.css
│ │ │ └── superadmin.css
│ │ ├── js/ # Scripts JavaScript separados
│ │ │ ├── dashboard.js
│ │ │ ├── qr-reader.js
│ │ │ └── superadmin.js
│ │ └── imagens/ # Logos, ícones, etc.
│ ├── leitura-qr-code.html # Leitor de QR Code (sem PHP)
│ └── index.php # Tela inicial de login
│
├── src/ # Código-fonte principal
│ ├── pages/ # Páginas de sistema
│ │ ├── dashboard.php
│ │ ├── editar_produto.php
│ │ ├── superadmin.php
│ │ ├── relatorios.php
│ │ ├── movimentacoes.php
│ │ └── usuarios.php # (futura implementação)
│ ├── components/ # Partes reutilizáveis
│ │ ├── header.php
│ │ ├── footer.php
│ │ └── menu.php
│ ├── api/ # Endpoints internos
│ │ ├── api_produtos.php
│ │ ├── api_estoque.php
│ │ ├── baixa_estoque.php
│ │ ├── dashboard_stats.php
│ │ ├── editar_produto.php
│ │ ├── exclui_produto.php
│ │ └── listar_produtos.php
│ ├── services/ # Integrações externas / regras de negócio
│ │ └── supabase_service.php
│ └── helpers/ # Funções utilitárias (futura expansão)
│ └── utils.php
│
├── config/
│ ├── config.php # Chaves de API e variáveis
│ ├── textos.php # Rótulos e mensagens
│ └── bd.sql # Estrutura inicial do banco
│
└── README.md
        

---

⚙️ Tecnologias Utilizadas

• PHP 8+
• HTML5 + CSS3 + JS (Vanilla)
• Supabase (banco de dados + API REST)
• AJAX / Fetch API para atualização dinâmica
• QR Code Scanner com html5-qrcode

🚀 Funcionalidades

• 📋 Cadastro, edição e exclusão de produtos
• 📦 Controle de estoque com movimentações (entrada e saída)
• 📉 Relatórios em tempo real com alertas visuais
• 🔄 Atualização automática de dados (AJAX)
• 📱 Leitura de QR Code por webcam ou imagem
• 👤 Painel de superadmin com permissões exclusivas
• 🧾 Integração com automações externas (n8n)
• 🕓 Registro de histórico de movimentações (em desenvolvimento)

🧪 Como Rodar Localmente

1. Clone o repositório:

   git clone https://github.com/seuusuario/STOCK_BOX.git

2. Configure o arquivo config/config.php com as variáveis:

   define('SUPABASE_URL', 'https://xxx.supabase.co');
   define('SUPABASE_API_KEY', 'sua-api-key-aqui');
   define('PERFIL_ID', 'perfil-unico-do-estabelecimento');

3. Importe o arquivo bd.sql no seu banco de dados (Sugestão: Supabase).
4. Suba um servidor local (como XAMPP, Laragon ou Docker) e acesse:

   http://localhost/STOCK_BOX/public/index.php

🧭 Principais Páginas do Sistema

• 🔐 Tela de Login
• 📊 Dashboard
• 🧑‍💼 Painel do Superadmin
• 📝 Editar Produto
• 📈 Relatórios
• 📋 Lista de Movimentações
• 📷 Leitor QR Code

🛠️ Endpoints da API

• /src/api/api_produtos.php → Lista todos os produtos
• /src/api/api_estoque.php → Controla movimentações
• /src/api/dashboard_stats.php → Gera dados de relatório
• /src/api/editar_produto.php → Atualiza produtos
• /src/api/exclui_produto.php → Remove um produto
• /src/api/listar_produtos.php → Atualização em tempo real
• /src/api/baixa_estoque.php → Processa baixa por QR Code

🧠 Sugestões Futuras

• 🔒 Autenticação com permissões por usuário
• 📉 Histórico completo de movimentações
• 📤 Exportar dados (PDF/Excel)
• 📊 Gráficos com Chart.js
• ☁️ Backup automático na nuvem

📬 Contato

Desenvolvido por Estevão Ferreira

📧 estevaoferreira@dominio.com.br

🌐 www.estevaoferreira.com.br