📊 Documentação do Sistema PDV

📋 Visão Geral

Este é um sistema de PDV (Ponto de Venda) desenvolvido em PHP que permite o registro de itens através de códigos de barras ou rastreamento, gerenciamento de carrinho de compras e finalização de vendas.

🏗️ Estrutura do Código

1. Inicialização e Dependências

session_start();
include_once "../templates/header_gestor.php";
include_once "../db/database.php";
$db = new Database();
$pdo = $db->getConnection();

Funcionalidade:

• Inicia a sessão PHP para manter estado do carrinho
• Inclui o cabeçalho da interface do gestor
• Conecta ao banco de dados através da classe Database
• Obtém a conexão PDO para consultas SQL

2. Inicialização do Carrinho

if (!isset($_SESSION['itens'])) {
    $_SESSION['itens'] = [];
}

Funcionalidade: Cria array de itens na sessão caso não exista.

3. Processamento de Requisições POST

3.1 Adição de Itens - Busca por Pacote

if (isset($_POST['codigo'])) {
    $codigo = trim($_POST['codigo']);
    
    // Busca por pacote
    $stmt = $pdo->prepare("SELECT c.nome AS cliente_nome, p.id 
                          FROM pacotes p 
                          INNER JOIN clientes c ON p.cliente_id = c.id_cliente 
                          WHERE p.codigo_rastreamento = :codigo");
    $stmt->bindParam(':codigo', $codigo);
    $stmt->execute();
    $pacote = $stmt->fetch(PDO::FETCH_ASSOC);

Funcionalidade:

• Recebe código digitado/bipado
• Primeiro verifica se é um código de rastreamento de pacote
• Faz JOIN com tabela de clientes para obter nome do destinatário
• Se encontrado, adiciona ao carrinho com valor fixo de R$ 2,00

[
    'codigo' => 'código_rastreamento',
    'descricao' => 'Pacote - Nome do Cliente',
    'valor' => 2.00,
    'pacote_id' => id_do_pacote
]

3.2 Busca por Produto (fallback)

else {
    $stmt = $pdo->prepare("SELECT descricao, valor_venda 
                          FROM produtos 
                          WHERE codigo_barras = :codigo");
    $stmt->bindParam(':codigo', $codigo);
    $stmt->execute();
    $produto = $stmt->fetch(PDO::FETCH_ASSOC);

Funcionalidade:

• Se não for pacote, busca na tabela de produtos
• Usa o código de barras para identificação
• Adiciona produto com descrição e valor do cadastro

[
    'codigo' => 'código_barras',
    'descricao' => 'descrição do produto',
    'valor' => valor_venda
]

3.3 Remoção de Itens

if (isset($_POST['remover'])) {
    unset($_SESSION['itens'][$_POST['remover']]);
    $_SESSION['itens'] = array_values($_SESSION['itens']);
}

Funcionalidade:

• Remove item pelo índice do array
• Reorganiza índices do array com array_values() para evitar buracos

4. Cálculo do Total

$total = array_sum(array_column($_SESSION['itens'], 'valor'));
$itens_json = json_encode($_SESSION['itens']);

Funcionalidade:

• Soma todos os valores dos itens no carrinho
• Converte itens para JSON para passar à página de pagamento

🖥️ Interface HTML

5.1 Formulário de Entrada

<form method="POST">
    <input type="text" name="codigo" class="form-control" 
           placeholder="Bipe o código" autofocus>
    <button type="submit" class="btn btn-primary mt-2">Adicionar</button>
</form>

Funcionalidade:

• Campo com autofocus para leitura rápida com leitor de código de barras
• Submit automático quando leitor envia ENTER

5.2 Tabela de Itens

<?php foreach ($_SESSION['itens'] as $index => $item): ?>
    <tr>
        <td><?= htmlspecialchars($item['codigo']) ?></td>
        <td><?= htmlspecialchars($item['descricao']) ?></td>
        <td><?= number_format($item['valor'], 2, ',', '.') ?></td>
        <td>
            <form method="POST" style="display:inline;">
                <input type="hidden" name="remover" value="<?= $index ?>">
                <button type="submit" class="btn btn-danger btn-sm">Remover</button>
            </form>
        </td>
    </tr>
<?php endforeach; ?>

Funcionalidade:

• Lista todos os itens bipados
• htmlspecialchars() previne XSS
• number_format() formata valores monetários (BRL)
• Botão de remoção para cada item

5.3 Finalização

<h3>Total: R$ <?= number_format($total, 2, ',', '.') ?></h3>
<button class="btn btn-success" 
        onclick='abrirPagamento(<?= json_encode($total) ?>, <?= json_encode($itens_json) ?>)'>
    Finalizar Bipagem
</button>

⚙️ JavaScript - Abertura de Janela de Pagamento

function abrirPagamento(valorTotal, itens) {
    let url = `pagamento.php?valor_total=${valorTotal}&itens=${encodeURIComponent(itens)}`;
    window.open(url, 'Pagamento', 'width=600,height=400');
}

Funcionalidade:

• Abre popup com página de pagamento
• Passa valor total e itens via GET (URL)
• Janela de 600x400 pixels

🔄 Fluxo de Operação

1. Usuário bipa/digita código
   ↓
2. Sistema verifica se é pacote
   ↓
3. Se não for, verifica se é produto
   ↓
4. Item é adicionado ao carrinho (sessão)
   ↓
5. Página recarrega e exibe itens
   ↓
6. Usuário pode remover itens ou continuar bipando
   ↓
7. Ao finalizar, abre janela de pagamento

🗄️ Estrutura do Banco de Dados

Tabelas Referenciadas:

💡 Melhorias Sugeridas

🔒 Considerações de Segurança