Gerenciamento do Menu
A aba Menu da Cafeteria é o local onde você monta o catálogo que os clientes veem em handy.cafe/{slug}. Os menus são formados por categorias e produtos. Os produtos podem ter grupos de variações para escolhas como Tamanho ou Coberturas.
Estrutura
| Nível | Finalidade |
|---|---|
| Categoria | Uma seção do menu, por exemplo "Bebidas Quentes" ou "Hambúrgueres". Cada categoria tem um ícone e uma ordem de classificação. |
| Produto | Um item individual que pode ser pedido dentro de uma categoria. Inclui nome, descrição, foto, preço, taxa de IVA e tempo de preparo. |
| Grupo de Variações | Opcional. Um conjunto de escolhas associado a um produto, por exemplo "Tamanho: Pequeno, Médio, Grande". Cada variação tem um acréscimo de preço. |
Categorias
Cada categoria possui os seguintes campos:
| Campo | Significado |
|---|---|
| Nome | Exibido como cabeçalho de seção no menu do cliente. |
| Ícone | Um nome de MDI (Material Design Icons). Escolha um no seletor de ícones. |
| Ordem de classificação | Inteiro. Os números menores aparecem primeiro. Ajuste com arrastar ou com os controles de mover para cima e mover para baixo. |
| Ativa | Quando desativada, a categoria e todos os seus produtos ficam ocultos do menu do cliente, mas não são excluídos. |
Adicionando uma categoria
- Abra Cafeteria > Menu.
- Clique em Adicionar Categoria.
- Digite um nome.
- Clique na caixa de ícone e selecione um ícone MDI. O seletor abre uma lista pesquisável. Tente palavras-chave como "coffee", "burger" ou "pizza".
- Salve. A categoria aparece no editor do menu.
Reordenando categorias
Arraste a alça em uma linha de categoria para movê-la. A nova posição é salva assim que você solta. Também é possível usar as setas de mover para cima e mover para baixo para um posicionamento mais preciso.
Exclusão suave
Excluir uma categoria que possui produtos dependentes marca a categoria como inativa em vez de remover o registro. Isso preserva o histórico de pedidos que referencia os IDs originais dos produtos. Para restaurar, reative a categoria pela interface administrativa.
Produtos
Cada produto possui os seguintes campos:
| Campo | Significado |
|---|---|
| Categoria | A categoria pai. |
| Nome | Visível ao cliente. |
| Descrição | Suporta Markdown. Aparece na ficha de detalhes do produto quando o cliente toca no item. |
| Ingredientes | Linha curta abaixo da descrição. Use para alergênicos ou destaques de ingredientes. |
| Preço base | O preço antes das variações. Armazenado em unidades menores (por exemplo, centavos), mas informado em unidades inteiras da moeda. |
| Taxa de IVA | Percentual. Aplicado ao exibir totais no recibo do cliente. |
| Unidade | Rótulo opcional como "ml" ou "g". Aparece ao lado do preço. |
| Foto | Imagem do produto. Aceita qualquer formato. WebP de até 2 MB é recomendado para carregar o menu mais rapidamente. |
| Controlar estoque | Quando ativado, o produto passa a ter uma quantidade em estoque que diminui a cada pedido. |
| Em estoque | Quantidade atual em estoque. Os pedidos falham para o cliente quando o estoque chega a zero e o produto é ocultado automaticamente. |
| Ativo | Quando desativado, o produto fica oculto do menu do cliente. |
| Ordem de classificação | Posição dentro da categoria. |
| Tempo de preparo | Estimativa fixa de reserva em minutos. Veja Tempo de Preparo Dinâmico abaixo. |
Enviando uma foto
- Abra o produto.
- Clique na área da foto.
- Selecione uma imagem no computador. O endpoint de upload aceita qualquer formato.
- O servidor processa o arquivo, armazena um ID de ativo, o tipo MIME e o checksum, e devolve uma URL.
- A foto aparece imediatamente no editor e no menu do cliente em poucos segundos.
Substitua a foto clicando na imagem existente e enviando um novo arquivo. O arquivo antigo é substituído.
Markdown nas descrições
As descrições de produto aceitam Markdown. Usos comuns:
- Destacar em negrito com
**strong**. - Quebras de linha para descrições em várias linhas.
- Listas curtas para ingredientes ou combinações.
Evite usar títulos (H1 a H6) nas descrições de produtos. O menu do cliente renderiza a descrição em uma área restrita, e títulos ficam estranhos ali.
Grupos de variações
As variações registram escolhas do cliente que alteram o preço ou a configuração. Um produto pode ter vários grupos de variações, por exemplo Tamanho e Coberturas no mesmo hambúrguer.
Cada variação possui:
| Campo | Significado |
|---|---|
| Nome | Rótulo visível ao cliente, por exemplo "Tamanho" ou "Queijo Extra". |
| Diferença de preço | Valor adicionado ao preço base quando esta variação é selecionada. Pode ser zero ou negativo. |
| Obrigatória | Quando ativada, o cliente precisa escolher pelo menos uma variação desse grupo antes de adicionar ao carrinho. |
| Ordem de classificação | Posição dentro do grupo. |
Criando um grupo de variações
- Abra o produto.
- Role até a seção Variações.
- Clique em Adicionar Variação.
- Digite o nome e a diferença de preço. Ative Obrigatória se a escolha for obrigatória.
- Salve.
Repita para cada opção do grupo. Um grupo de "Tamanho" típico tem três linhas: Pequeno com diferença 0, Médio com diferença +1,00 e Grande com diferença +2,00.
Tempo de preparo dinâmico
O HandyCafe pode calcular em tempo real uma estimativa de tempo de preparo para cada produto com base no desempenho real da cozinha. Isso melhora a precisão do indicador mostrado no menu do cliente e nos pedidos ativos.
| Configuração | Efeito |
|---|---|
| Tempo estático | Armazenado no produto. Usado quando não há histórico suficiente para calcular um valor dinâmico. |
| Estimativa dinâmica | Calculada com base nos últimos 30 dias de histórico de pedidos. O tempo médio de preparo por produto é multiplicado por um fator de movimento obtido a partir do tamanho atual da fila. O multiplicador fica entre 1,0 e 2,0. O valor final fica entre 1 e 120 minutos. |
A configuração "Mostrar tempo de preparo no menu" no perfil do negócio controla se o indicador fica visível para os clientes. A equipe sempre vê a estimativa no painel de Pedidos.
Rastreamento de estoque
Ative Controlar estoque por produto para evitar vender itens esgotados.
- Quando um pedido é feito, a quantidade em estoque diminui pela quantidade pedida.
- Quando o estoque chega a zero, o produto é ocultado automaticamente do menu do cliente até que você atualize a quantidade.
- Para repor, edite o produto e informe o novo valor de Em estoque.
Produtos sem Controlar estoque se comportam como inventário infinito e nunca são ocultados automaticamente.
Reordenando produtos dentro de uma categoria
Arraste a alça para mover um produto para cima ou para baixo. A nova ordem é salva quando você solta. O menu do cliente reflete a nova ordem após a próxima atualização do menu, que acontece a cada carregamento de sessão.
Dicas
- Comece com 6 a 10 categorias. Categorias demais tornam o menu do cliente mais lento para navegar.
- Use fotos com alto contraste e boa iluminação. Fotos escuras ou com muito ruído reduzem a conversão de pedidos.
- Mantenha as descrições com menos de 120 caracteres sempre que possível. Descrições longas empurram o botão Adicionar ao Carrinho para fora da primeira tela nos telefones.
- Defina tempos estáticos de preparo realistas. O sistema dinâmico leva 30 dias para aprender. Até lá, o valor estático é o que os clientes veem.
- Para itens com muitas escolhas, distribua as opções em dois grupos de variações em vez de uma lista enorme. "Tamanho" mais "Leite" é mais limpo do que "Tamanho com Leite".