Documentação - Sistema de Gestão de Salgados Premium

Visão Geral

O Sistema de Gestão de Salgados Premium é uma solução completa e moderna para gerenciamento de negócios de salgados, desenvolvida com foco em usabilidade, performance e segurança.

Projetado para atender desde pequenos empreendedores até empresas de médio porte, o sistema oferece uma interface intuitiva tanto para o painel administrativo quanto para o catálogo público de produtos.

Rápido e Eficiente

Interface otimizada com carregamento instantâneo

100% Responsivo

Funciona perfeitamente em todos os dispositivos

Seguro

Proteção contra ataques e dados criptografados

Tecnologias Utilizadas

Backend

PHP 7.4+ MySQL 5.7+ / MariaDB 10.3+ Apache 2.4+

Frontend

Tailwind CSS 3.0 JavaScript Vanilla HTML5

Recursos Adicionais

Font Awesome 6.0 WhatsApp API Sistema de Relatórios

Funcionalidades Principais

Gestão de Produtos

Cadastro completo de produtos
Upload de imagens otimizadas
Múltiplas unidades de venda (cento/unidade/kg)
Sistema de promoções com tarja visual
Categorização inteligente

Gestão de Pedidos

Controle de status (pendente/confirmado/entregue)
Alerta sonoro para novos pedidos
Integração com WhatsApp
Histórico completo de pedidos
Cálculo automático de totais

Gestão de Clientes

Cadastro completo de clientes
Histórico de pedidos por cliente
Dados de contato e endereço
Busca rápida e filtros

Relatórios e Dashboard

Dashboard com métricas em tempo real
Relatório de vendas por período
Produtos mais vendidos
Análise de faturamento

Configurações do Sistema

Upload de logo personalizada
Configuração de footer
Integração WhatsApp
Gerenciamento de usuários

Catálogo Público

Design moderno e responsivo
Filtro por categorias
Botão de pedido via WhatsApp
SEO otimizado

Requisitos do Sistema

Servidor

PHP 7.4 ou superior
MySQL 5.7+ ou MariaDB 10.3+
Apache 2.4+ com mod_rewrite
Extensões PHP: PDO, GD, cURL, mbstring
Mínimo 256MB de RAM
50MB de espaço em disco

Navegadores Suportados

Google Chrome (últimas 2 versões)
Mozilla Firefox (últimas 2 versões)
Safari (últimas 2 versões)
Microsoft Edge (últimas 2 versões)
Navegadores mobile (iOS/Android)

Guia de Instalação

1

Fazer Upload dos Arquivos

Faça upload de todos os arquivos do sistema para o diretório raiz do seu servidor via FTP ou painel de controle.

/public_html/
├── admin/
├── classes/
├── config/
├── database/
├── uploads/
├── index.php
├── install.php
└── .htaccess

2

Criar Banco de Dados

Crie um banco de dados MySQL/MariaDB através do painel de controle (cPanel, Plesk, aaPanel, etc.).

Dica: Anote o nome do banco, usuário e senha. Você precisará dessas informações no próximo passo.

3

Executar o Instalador

Acesse o instalador através do navegador:

https://seudominio.com.br/install.php

Preencha os dados solicitados:

Host do banco (geralmente localhost)
Nome do banco de dados
Usuário do banco
Senha do banco
Nome do site
Número do WhatsApp

4

Primeiro Acesso ao Admin

Após a instalação, acesse o painel administrativo:

https://seudominio.com.br/admin/

Credenciais padrão:

Importante: Altere a senha padrão imediatamente após o primeiro login!

Email: admin@admin.com
Senha: admin123

5

Configurações Iniciais

Configure o sistema através do menu Configurações:

Faça upload da logo da empresa
Configure informações do footer
Adicione categorias de produtos
Cadastre os primeiros produtos

Configuração do Sistema

Configurações Gerais

Acesse: Admin → Configurações

Logo: Faça upload da logo (PNG/JPG, máx 2MB)
WhatsApp: Configure o número para receber pedidos
Contato: Email e telefone da empresa
Endereço: Localização e horários de funcionamento

Gestão de Usuários

Acesse: Admin → Usuários

Tipos de usuário:

Admin: Acesso total ao sistema
Funcionário: Acesso limitado (sem relatórios e configurações)

Categorias de Produtos

Acesse: Admin → Categorias

Organize seus produtos em categorias para facilitar a navegação dos clientes. Exemplos: Salgados Fritos, Assados, Doces, Bebidas, etc.

Como Usar o Sistema

Cadastrar Produtos

1 Acesse Admin → Produtos → Novo Produto
2 Preencha os dados: nome, descrição, categoria
3 Configure os preços (cento, unidade ou kg)
4 Faça upload de uma imagem atrativa do produto
5 Marque "Produto em Promoção" se aplicável
6 Clique em Criar Produto

Dica: Produtos marcados como "Em Promoção" aparecem com uma tarja vermelha destacada no site!

Gerenciar Pedidos

O sistema possui alerta sonoro automático para novos pedidos. Quando um pedido chega:

1 Um som de alerta toca automaticamente
2 Banner vermelho aparece indicando novos pedidos
3 Acesse Admin → Pedidos para visualizar
4 Edite o pedido e altere o status conforme necessário
5 Use o botão WhatsApp para enviar confirmação ao cliente

Status dos Pedidos:

Pendente Aguardando confirmação
Confirmado Pedido aceito e em preparo
Entregue Pedido finalizado
Cancelado Pedido cancelado

Acessar Relatórios

Acesse: Admin → Relatórios

Vendas por Período

Visualize o faturamento total em qualquer período personalizado

Produtos Mais Vendidos

Identifique quais produtos têm melhor performance

Análise de Clientes

Veja quais clientes mais compram e seu ticket médio

Dashboard em Tempo Real

Métricas atualizadas: pedidos hoje, faturamento mensal, etc.

Estrutura de Arquivos

salgados/
│
├── admin/                      # Painel administrativo
│   ├── js/                     # Scripts JavaScript
│   │   └── alert-sound-v2.js   # Sistema de alerta sonoro
│   ├── categorias.php          # Gestão de categorias
│   ├── clientes.php            # Gestão de clientes
│   ├── configuracoes.php       # Configurações do sistema
│   ├── dashboard.php           # Dashboard principal
│   ├── login.php               # Autenticação
│   ├── pedidos.php             # Gestão de pedidos
│   ├── pedidos_ajax.php        # API AJAX para pedidos
│   ├── produtos.php            # Gestão de produtos
│   ├── relatorios.php          # Relatórios e análises
│   └── usuarios.php            # Gestão de usuários
│
├── classes/                    # Classes PHP (POO)
│   ├── Auth.php                # Autenticação e sessões
│   ├── Categoria.php           # Lógica de categorias
│   ├── Cliente.php             # Lógica de clientes
│   ├── Configuration.php       # Configurações do sistema
│   ├── Pedido.php              # Lógica de pedidos
│   ├── Produto.php             # Lógica de produtos
│   └── Usuario.php             # Lógica de usuários
│
├── config/                     # Arquivos de configuração
│   ├── config.php              # Configurações gerais
│   ├── database.php            # Conexão com banco
│   └── installed.lock          # Flag de instalação
│
├── database/                   # Scripts SQL
│   ├── schema.sql              # Estrutura do banco
│   └── add_promocao.sql        # Adicionar campo promoção
│
├── uploads/                    # Arquivos enviados
│   ├── config/                 # Logo e configs
│   └── produtos/               # Imagens de produtos
│
├── .htaccess                   # Configurações Apache
├── index.php                   # Página pública (catálogo)
└── install.php                 # Instalador do sistema

Segurança

Medidas de Segurança Implementadas

Senhas criptografadas com bcrypt
Proteção contra SQL Injection (PDO Prepared Statements)
Proteção contra XSS (Cross-Site Scripting)
Proteção contra CSRF (Cross-Site Request Forgery)
Sanitização de inputs do usuário
Sessões seguras com HttpOnly cookies
Bloqueio de acesso direto a pastas sensíveis via .htaccess
Validação de tipos de arquivo em uploads

Recomendações de Segurança

Altere a senha padrão do admin imediatamente
Use senhas fortes (mín. 8 caracteres, letras, números e símbolos)
Mantenha o PHP e MySQL sempre atualizados
Configure SSL/HTTPS no seu domínio
Faça backups regulares do banco de dados
Limite o acesso FTP apenas a IPs confiáveis
Delete o arquivo install.php após a instalação

Permissões de Arquivos Recomendadas

# Pastas
uploads/          → 0755
uploads/config/   → 0755
uploads/produtos/ → 0755

# Arquivos
.htaccess         → 0644
config/config.php → 0644
Arquivos PHP      → 0644
Imagens           → 0644