🍔 Sistema de Cantina

Sistema completo de gestão para cantinas e lanchonetes. Interface moderna • Responsivo • Fácil de usar

✨ Características

• 🎯 Interface Intuitiva - Design moderno e responsivo
• 📱 Mobile-First - Funciona perfeitamente em dispositivos móveis
• ⚡ Tempo Real - Atualizações automáticas na cozinha
• 📊 Relatórios Completos - Análise de vendas e produtos
• 🔄 Fluxo Otimizado - Gerenciamento completo do pedido à entrega
• 💾 Banco de Dados - Persistência segura com MySQL

🚀 Funcionalidades

📝 Gestão de Produtos

• Cadastro completo com código, nome, preço e estoque
• Controle de quantidade disponível
• Alertas de estoque baixo
• Interface visual para status do produto

💰 Sistema de Caixa

• Seleção rápida de produtos
• Cálculo automático de totais
• Múltiplas formas de pagamento (Dinheiro, Cartão, PIX)
• Nome do cliente obrigatório

👨‍🍳 Painel da Cozinha

Novo Pedido → Preparando → Pronto → Arquivado
     ⬇️           ⬇️          ⬇️        ⬇️
     🆕          ⏳         ✅        🗃️
        

🛠️ Tecnologias Utilizadas

Tecnologia	Versão	Uso
PHP	7.4+	Backend e APIs
MySQL	5.7+	Banco de dados
JavaScript	ES6+	Frontend dinâmico
Bootstrap	5.3.0	Framework CSS
HTML5	-	Estrutura
CSS3	-	Estilos customizados

📁 Estrutura do Projeto

cantina-app/
├── index.php
├── cadastro-produtos.php
├── cardapio.php
├── caixa.php
├── cozinha.php
├── relatorio-vendas.php
├── config/
│   └── database.php
├── api/
│   ├── produtos.php
│   ├── pedidos.php
│   ├── relatorios.php
│   └── relatorio-produtos.php
├── js/
│   ├── produtos.js
│   ├── caixa.js
│   ├── cozinha.js
│   ├── cardapio.js
│   ├── relatorio-vendas.js
│   └── utils.js
├── css/
│   └── style.css
└── sql/
    └── cantina.sql
        

⚙️ Instalação

Pré-requisitos

• XAMPP/WAMP/LAMP ou servidor web com PHP 7.4+
• MySQL 5.7+
• Navegador moderno

Passo a Passo

git clone https://github.com/seu-usuario/sistema-cantina.git
cd sistema-cantina
        

1. Mova os arquivos para a pasta do servidor (htdocs no XAMPP)
2. Inicie Apache e MySQL

Configure o banco de dados

-- Execute no phpMyAdmin ou cliente MySQL
source sql/cantina.sql
        

Configure a conexão

// Edite config/database.php
private $host = 'localhost';
private $db_name = 'cantina_sistema';
private $username = 'root';
private $password = 'sua_senha';
        

Acesse o sistema

http://localhost/sistema-cantina/

🎯 Como Usar

1. Primeiro Acesso
2. Realizando Vendas
3. Gerenciando Pedidos
4. Acompanhando Resultados

📊 Status do Projeto

Módulo	Status	Funcionalidades
Produtos	✅ Completo	CRUD, Estoque, Alertas
Caixa	✅ Completo	Vendas, Pagamentos, Validações
Cozinha	✅ Completo	Fluxo 4 estados, Tempo real
Cardápio	✅ Completo	Visualização responsiva
Relatórios	✅ Completo	Vendas + Produtos, Impressão
Mobile	✅ Responsivo	Todas as telas otimizadas

🔧 Configurações Avançadas

Personalização de Cores

:root {
   --primary-color: #007bff;
   --success-color: #28a745;
   --warning-color: #ffc107;
   --danger-color: #dc3545;
}
        

Configuração de Estoque Baixo

const estoqueClass = produto.quantidade <= 5 ? 'text-danger fw-bold' : 'text-success';
        

Auto-refresh da Cozinha

setInterval(carregarPedidos, 15000); // 15 segundos
        

🤝 Contribuição

1. Fork o projeto
2. Crie uma branch: git checkout -b feature/nova-funcionalidade
3. Commit suas mudanças: git commit -m 'Adiciona nova funcionalidade'
4. Push: git push origin feature/nova-funcionalidade
5. Abra um Pull Request

📝 Roadmap

• [ ] v2.0 - Integração com impressora térmica
• [ ] v2.1 - App mobile nativo
• [ ] v2.2 - Dashboard com gráficos
• [ ] v2.3 - Sistema de usuários e permissões
• [ ] v2.4 - Integração com delivery
• [ ] v2.5 - Backup automático

📜 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

🙋‍♂️ Suporte

📧 Email: contato@sistemacantina.com

🐛 Issues: Crie uma issue no repositório

💬 Discussões: Use as discussões do projeto