Produtos

A página de Produtos gerencia o catálogo de itens que sua lan house ou centro de jogos vende. Isso inclui alimentos, bebidas, salgadinhos, acessórios e quaisquer outros produtos físicos oferecidos aos clientes. Cada produto tem preço, categoria, alíquota de imposto e nível de estoque definidos. Os produtos se integram com o sistema de pedidos, permitindo que operadores criem pedidos, rastreiem vendas e gerenciem estoque.

Campos do Produto

Cada registro de produto contém as seguintes informações:

Campo	Descrição
`name`	O nome do produto exibido na interface de pedidos. Deve ser único (sem distinção de maiúsculas/minúsculas).
`category`	Um rótulo de texto agrupando produtos relacionados (por exemplo, "Bebidas", "Salgadinhos", "Acessórios"). Usado para filtragem e relatórios.
`unit`	A unidade de medida para rastreamento de estoque (por exemplo, "unidade", "kg", "litro", "lata", "garrafa").
`barcode`	Um valor de código de barras opcional para integração com leitor. Operadores podem escanear o código de barras de um produto para adicioná-lo rapidamente a um pedido.
`sale_price`	O preço de venda em unidades menores de moeda (por exemplo, centavos). Este é o valor cobrado do cliente por unidade.
`vat_rate`	A porcentagem de imposto aplicada a este produto (por exemplo, 18 para 18%). Usada para calcular o componente tributário de cada venda.
`stock`	O nível de estoque atual como quantidade decimal. Atualizado automaticamente quando pedidos são feitos e quando compras de estoque são registradas.
`active`	Um botão que controla se o produto aparece na interface de pedidos. Produtos inativos ficam ocultos dos operadores mas são mantidos no banco de dados para relatórios históricos.
`description`	Uma descrição em texto opcional para detalhes adicionais do produto.

Botão Ativo / Inativo

Produtos podem ser alternados entre estados ativo e inativo:

Produtos ativos aparecem na interface de pedidos e podem ser adicionados a novos pedidos.
Produtos inativos ficam ocultos da interface de pedidos mas permanecem no banco de dados. Pedidos anteriores que incluíram o produto mantêm suas referências para que dados históricos de vendas sejam preservados.

Útil para itens sazonais, produtos descontinuados ou itens que estão temporariamente sem estoque e não devem ser oferecidos aos clientes.

Rastreamento de Estoque

O HandyCafe mantém uma contagem de estoque contínua para cada produto. Esse valor é atualizado automaticamente pelo sistema em resposta a:

Vendas: Quando um produto é vendido por um pedido, o estoque diminui pela quantidade pedida.
Compras de estoque: Quando novo estoque é recebido e registrado na página de Estoque, o estoque aumenta proporcionalmente.
Ajustes manuais: Operadores ou administradores podem ajustar manualmente o nível de estoque para contabilizar deterioração, quebra, contagens erradas ou outras discrepâncias.

Log de Estoque do Produto

Cada alteração no nível de estoque de um produto é registrada no log de estoque do produto, criando um rastro de auditoria completo:

Motivo	Descrição
`sale`	Estoque diminuiu devido a um pedido de cliente. Vincula ao registro de pedido específico.
`purchase`	Estoque aumentou devido a uma compra de estoque. Vincula à entrada de estoque específica.
`adjustment`	Estoque foi ajustado manualmente por um operador ou administrador.
`waste`	Estoque diminuiu devido a deterioração, quebra ou baixa.
`return`	Estoque aumentou devido a devolução de cliente ou cancelamento de pedido.

Cada entrada de log registra a mudança de quantidade (positiva para aumentos, negativa para diminuições), o novo nível de estoque após a mudança, quem fez a mudança e uma nota opcional explicando o motivo.

Categorias de Produto

Os produtos são agrupados por categoria usando um campo de texto livre. Categorias comuns incluem:

Bebidas (refrigerantes, água, energéticos)
Bebidas Quentes (café, chá, chocolate quente)
Salgadinhos (batatas, doces, barras de chocolate)
Alimentos (sanduíches, wraps, refeições quentes)
Acessórios (fones de ouvido, pen drives, mouse pads)

As categorias são usadas para filtragem na interface de pedidos. Operadores podem alternar rapidamente entre categorias para encontrar o produto certo. As categorias também servem para agrupamento em relatórios de vendas.

Não há uma interface separada de gerenciamento de categorias. As categorias são criadas implicitamente quando você atribui um nome de categoria a um produto. Para renomear uma categoria, atualize o campo de categoria em todos os produtos que usam o nome antigo.

Criando um Produto

Para adicionar um novo produto ao catálogo:

Navegue até a página de Produtos pela barra lateral.
Clique no botão Adicionar Produto na barra de ferramentas.
Insira o nome (deve ser único).
Selecione ou digite uma categoria.
Escolha a unidade de medida.
Defina o preço de venda (o valor cobrado dos clientes, em unidades menores de moeda).
Defina a alíquota de imposto (como decimal, por exemplo, 0,08 para 8%).
Opcionalmente insira um código de barras para suporte a leitor.
Defina o nível de estoque inicial se aplicável.
Clique em Salvar.

Editando um Produto

Selecione um produto da lista para abrir sua visualização de detalhes. Você pode atualizar qualquer campo incluindo nome, preço, categoria, alíquota de imposto, nível de estoque e status ativo. As alterações entram em vigor imediatamente. Se você atualizar o preço, o novo preço se aplica a todos os pedidos futuros.

Pedidos anteriores não são afetados por mudanças de preço. Cada item de pedido armazena o preco_unitario no momento da venda como um snapshot.

Integração com Pedidos

Quando um operador cria um pedido e adiciona um produto:

O preço de venda atual e a alíquota de imposto do produto são copiados para o item do pedido como snapshots.
O total da linha é calculado como preco_unitario * quantidade.
Quando o pedido é concluído, o nível de estoque do produto é decrementado pela quantidade pedida.
Uma entrada de log de estoque é criada com motivo = 'venda' vinculando ao pedido.

Se o pedido for posteriormente cancelado ou reembolsado, o estoque pode ser restaurado por uma entrada de log de estoque de devolução.