Produtos

A pagina de Produtos gerencia o catalogo de itens que sua lan house ou centro de jogos vende. Isso inclui alimentos, bebidas, salgadinhos, acessorios e quaisquer outros produtos fisicos oferecidos aos clientes. Cada produto tem preco, categoria, aliquota de imposto e nivel 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 contem as seguintes informacoes:

Campo	Descricao
`name`	O nome do produto exibido na interface de pedidos. Deve ser unico (sem distincao de maiusculas/minusculas).
`category`	Um rotulo de texto agrupando produtos relacionados (por exemplo, "Bebidas", "Salgadinhos", "Acessorios"). Usado para filtragem e relatorios.
`unit`	A unidade de medida para rastreamento de estoque (por exemplo, "unidade", "kg", "litro", "lata", "garrafa").
`barcode`	Um valor de codigo de barras opcional para integracao com leitor. Operadores podem escanear o codigo de barras de um produto para adiciona-lo rapidamente a um pedido.
`sale_price`	O preco de venda em unidades menores de moeda (por exemplo, centavos). Este e 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 tributario de cada venda.
`stock`	O nivel de estoque atual como quantidade decimal. Atualizado automaticamente quando pedidos sao feitos e quando compras de estoque sao registradas.
`active`	Um botao que controla se o produto aparece na interface de pedidos. Produtos inativos ficam ocultos dos operadores mas sao mantidos no banco de dados para relatorios historicos.
`description`	Uma descricao em texto opcional para detalhes adicionais do produto.

Botao 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 incluiram o produto mantem suas referencias para que dados historicos de vendas sejam preservados.

Util para itens sazonais, produtos descontinuados ou itens que estao temporariamente sem estoque e nao devem ser oferecidos aos clientes.

Rastreamento de Estoque

O HandyCafe mantem uma contagem de estoque continua para cada produto. Esse valor e atualizado automaticamente pelo sistema em resposta a:

Vendas: Quando um produto e vendido por um pedido, o estoque diminui pela quantidade pedida.
Compras de estoque: Quando novo estoque e recebido e registrado na pagina de Estoque, o estoque aumenta proporcionalmente.
Ajustes manuais: Operadores ou administradores podem ajustar manualmente o nivel de estoque para contabilizar deterioracao, quebra, contagens erradas ou outras discrepancias.

Log de Estoque do Produto

Cada alteracao no nivel de estoque de um produto e registrada no log de estoque do produto, criando um rastro de auditoria completo:

Motivo	Descricao
`sale`	Estoque diminuiu devido a um pedido de cliente. Vincula ao registro de pedido especifico.
`purchase`	Estoque aumentou devido a uma compra de estoque. Vincula a entrada de estoque especifica.
`adjustment`	Estoque foi ajustado manualmente por um operador ou administrador.
`waste`	Estoque diminuiu devido a deterioracao, quebra ou baixa.
`return`	Estoque aumentou devido a devolucao de cliente ou cancelamento de pedido.

Cada entrada de log registra a mudanca de quantidade (positiva para aumentos, negativa para diminuicoes), o novo nivel de estoque apos a mudanca, quem fez a mudanca e uma nota opcional explicando o motivo.

Categorias de Produto

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

Bebidas (refrigerantes, agua, energeticos)
Bebidas Quentes (cafe, cha, chocolate quente)
Salgadinhos (batatas, doces, barras de chocolate)
Alimentos (sanduiches, wraps, refeicoes quentes)
Acessorios (fones de ouvido, pen drives, mouse pads)

As categorias sao usadas para filtragem na interface de pedidos. Operadores podem alternar rapidamente entre categorias para encontrar o produto certo. As categorias tambem servem para agrupamento em relatorios de vendas.

Nao ha uma interface separada de gerenciamento de categorias. As categorias sao criadas implicitamente quando voce 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 catalogo:

Navegue ate a pagina de Produtos pela barra lateral.
Clique no botao Adicionar Produto na barra de ferramentas.
Insira o nome (deve ser unico).
Selecione ou digite uma categoria.
Escolha a unidade de medida.
Defina o preco de venda (o valor cobrado dos clientes, em unidades menores de moeda).
Defina a aliquota de imposto (como decimal, por exemplo, 0,08 para 8%).
Opcionalmente insira um codigo de barras para suporte a leitor.
Defina o nivel de estoque inicial se aplicavel.
Clique em Salvar.

Editando um Produto

Selecione um produto da lista para abrir sua visualizacao de detalhes. Voce pode atualizar qualquer campo incluindo nome, preco, categoria, aliquota de imposto, nivel de estoque e status ativo. As alteracoes entram em vigor imediatamente. Se voce atualizar o preco, o novo preco se aplica a todos os pedidos futuros.

Pedidos anteriores nao sao afetados por mudancas de preco. Cada item de pedido armazena o preco_unitario no momento da venda como um snapshot.

Integracao com Pedidos

Quando um operador cria um pedido e adiciona um produto:

O preco de venda atual e a aliquota de imposto do produto sao copiados para o item do pedido como snapshots.
O total da linha e calculado como preco_unitario * quantidade.
Quando o pedido e concluido, o nivel de estoque do produto e decrementado pela quantidade pedida.
Uma entrada de log de estoque e 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 devolucao.