Produtos

O catálogo de produtos lista os 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.

Os produtos são gerenciados na aba Produtos da página Estoque na navegação principal. A aba oferece uma visualização em tabela e uma visualização em grade. Os cartões da grade mostram a foto do produto, o preço e um selo Em Estoque ou Sem 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 recebimentos de estoque são registrados. O estoque não é editado no próprio produto. Use a aba Status do Estoque da página Estoque.
`min_stock`	O limite de reposição. Quando o nível de estoque cai para esse valor ou abaixo dele, o produto é sinalizado como crítico na aba Status do Estoque. Zero significa sem limite.
`description`	Uma descrição em texto opcional para detalhes adicionais do produto.
`photo`	Uma foto opcional do produto exibida na visualização em grade e no cardápio da cafeteria.

Removendo um Produto da Venda

Um produto que não deve mais ser oferecido é removido com a ação Remover da Venda na aba Produtos. Uma confirmação explica que isso exclui o produto do catálogo e não pode ser desfeito. Os pedidos anteriores que incluíram o produto mantêm os snapshots de suas linhas, para que os dados históricos de vendas sejam preservados.

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.
Recebimentos de estoque: Quando novo estoque é recebido e registrado na aba Recebimento de Estoque da página Estoque, o estoque aumenta proporcionalmente.
Ajustes manuais: A aba Status do Estoque oferece as ações Corrigir estoque, Desperdício e Contagem para contabilizar deterioração, quebra, contagens erradas ou outras discrepâncias.

O estoque não pode ser editado no editor de produtos. Todas as alterações de estoque passam pela aba Status do Estoque, para que cada alteração entre no histórico de movimentações.

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:

Abra a página Estoque pela barra lateral e vá para a aba Produtos.
Clique no botão Novo Produto.
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).
Defina a alíquota de imposto.
Opcionalmente insira um código de barras para suporte a leitor e adicione uma foto.
Clique em Salvar.

O estoque inicial não é definido aqui. Registre a quantidade inicial com um recebimento de estoque ou com a ação Contagem na aba Status do Estoque. Um produto também pode ser criado diretamente a partir de uma linha de recebimento quando uma entrega contém um item que ainda não está no catálogo.

Editando um Produto

Selecione um produto da lista para abrir seu editor. Você pode atualizar qualquer campo incluindo nome, preço, categoria, alíquota de imposto, código de barras e foto. As alterações entram em vigor imediatamente. Se você atualizar o preço, o novo preço se aplica a todos os pedidos futuros. A ação Remover da Venda exclui o produto do catálogo após uma confirmação.

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.