HandyCafe Docs
owner

Gestione del Menu

La scheda Menu sotto Caffetteria è dove costruisci il catalogo che i clienti vedono su handy.cafe/{slug}. I menu sono composti da categorie e prodotti. I prodotti possono avere gruppi di varianti per scelte come Dimensione o Condimenti.

Struttura

Livello Scopo
Categoria Una sezione del menu, ad esempio "Bevande Calde" o "Hamburger". Ogni categoria ha un'icona e un ordine di visualizzazione.
Prodotto Un singolo articolo ordinabile all'interno di una categoria. Include nome, descrizione, foto, prezzo, aliquota IVA e tempo di preparazione.
Gruppo di Varianti Facoltativo. Un insieme di scelte associato a un prodotto, ad esempio "Dimensione: Piccola, Media, Grande". Ogni variante ha un prezzo incrementale.

Categorie

Ogni categoria ha i seguenti campi:

Campo Significato
Nome Visualizzato come intestazione di sezione nel menu cliente.
Icona Un nome MDI (Material Design Icons). Scegli una dall'elenco delle icone.
Ordine di Visualizzazione Numero intero. I numeri più bassi appaiono per primi. Regola con trascinamento o con i controlli di spostamento su e giù.
Attiva Quando disattivata, la categoria e tutti i suoi prodotti sono nascosti dal menu cliente ma non eliminati.

Aggiungere una Categoria

  1. Apri Caffetteria > Menu.
  2. Clicca su Aggiungi Categoria.
  3. Inserisci un nome.
  4. Clicca sulla casella dell'icona e seleziona un'icona MDI. Il selettore apre un elenco ricercabile. Prova parole chiave come "caffè", "hamburger" o "pizza".
  5. Salva. La categoria appare nell'editor del menu.

Riordinare le Categorie

Trascina la maniglia su una riga di categoria per spostarla. La nuova posizione viene salvata non appena rilasci. Puoi anche usare le frecce di spostamento su e giù per un posizionamento preciso.

Eliminazione Temporanea

Eliminare una categoria con prodotti dipendenti segna la categoria come inattiva invece di rimuovere il record. Questo preserva la cronologia degli ordini che fa riferimento agli ID dei prodotti originali. Per ripristinare, riattiva la categoria dall'interfaccia amministrativa.

Prodotti

Ogni prodotto ha i seguenti campi:

Campo Significato
Categoria La categoria principale.
Nome Visibile al cliente.
Descrizione Supporta Markdown. Appare sul foglio dei dettagli del prodotto quando il cliente tocca l'articolo.
Ingredienti Breve riga sotto la descrizione. Usala per allergeni o ingredienti principali.
Prezzo Base Il prezzo prima delle varianti. Memorizzato in unità minori (ad esempio centesimi) ma inserito in unità di valuta intere.
Aliquota IVA Percentuale. Applicata quando si visualizzano i totali sulla ricevuta del cliente.
Unità Etichetta opzionale come "ml" o "g". Appare accanto al prezzo.
Foto Immagine del prodotto. È accettato qualsiasi formato. WebP fino a 2 MB è consigliato per caricamenti del menu più veloci.
Traccia Stock Quando attivato, il prodotto ha una quantità in stock che diminuisce ad ogni ordine.
In Stock Il conteggio attuale delle scorte. Gli ordini falliscono per il cliente quando le scorte raggiungono zero e il prodotto si nasconde automaticamente.
Attivo Quando disattivato, il prodotto è nascosto dal menu cliente.
Ordine di Visualizzazione Posizione all'interno della categoria.
Tempo di Preparazione Stima statica di fallback in minuti. Vedi Tempo di Preparazione Dinamico sotto.

Caricare una Foto

  1. Apri il prodotto.
  2. Clicca sull'area della foto.
  3. Seleziona un'immagine dal tuo computer. Qualsiasi formato è accettato dal punto di caricamento.
  4. Il server elabora il file, memorizza un ID asset, tipo MIME e checksum, e restituisce un URL.
  5. La foto appare immediatamente nell'editor e nel menu cliente entro pochi secondi.

Sostituisci una foto cliccando sull'immagine esistente e caricando un nuovo file. Il vecchio file viene sostituito.

Markdown nelle Descrizioni

Le descrizioni dei prodotti supportano Markdown. Usi comuni:

  • Evidenziazioni in grassetto con **strong**.
  • Interruzioni di linea per descrizioni su più righe.
  • Brevi elenchi per ingredienti o abbinamenti.

Evita intestazioni (H1 a H6) nelle descrizioni dei prodotti. Il menu cliente rende la descrizione in un foglio limitato e le intestazioni appaiono sgraziate.

Gruppi di Varianti

Le varianti catturano le scelte del cliente che cambiano il prezzo o la configurazione. Un prodotto può avere più gruppi di varianti, ad esempio Dimensione e Condimenti sullo stesso hamburger.

Ogni variante ha:

Campo Significato
Nome L'etichetta visibile al cliente, ad esempio "Dimensione" o "Formaggio Extra".
Delta Prezzo L'importo aggiunto al prezzo base quando questa variante è selezionata. Può essere zero o negativo.
Obbligatorio Quando attivato, il cliente deve scegliere almeno una variante da questo gruppo prima di aggiungere al carrello.
Ordine di Visualizzazione Posizione all'interno del gruppo.

Creare un Gruppo di Varianti

  1. Apri il prodotto.
  2. Scorri fino alla sezione Varianti.
  3. Clicca su Aggiungi Variante.
  4. Inserisci il nome e il delta prezzo. Abilita Obbligatorio se la scelta è obbligatoria.
  5. Salva.

Ripeti per ogni opzione nel gruppo. Un tipico gruppo "Dimensione" ha tre righe: Piccola con delta 0, Media con delta +1.00, Grande con delta +2.00.

Tempo di Preparazione Dinamico

HandyCafe può calcolare una stima del tempo di preparazione in tempo reale per ogni prodotto basata sulle effettive prestazioni della cucina. Questo migliora l'accuratezza della stima mostrata nel menu cliente e sugli ordini attivi.

Impostazione Effetto
Tempo Statico Memorizzato sul prodotto. Usato quando non c'è abbastanza cronologia per calcolare un valore dinamico.
Stima Dinamica Calcolata dagli ultimi 30 giorni di cronologia degli ordini. Il tempo medio di preparazione per prodotto è moltiplicato per un fattore di occupazione derivato dalla lunghezza attuale della coda. Il moltiplicatore è limitato tra 1.0 e 2.0. Il valore finale è limitato tra 1 e 120 minuti.

L'impostazione "Mostra Tempo di Preparazione nel Menu" nel profilo aziendale controlla se la stima è visibile ai clienti. Il personale vede sempre la stima sulla dashboard degli Ordini.

Tracciamento delle Scorte

Abilita Traccia Stock per prodotto per evitare di vendere articoli esauriti.

  • Quando viene effettuato un ordine, il conteggio delle scorte diminuisce della quantità ordinata.
  • Quando le scorte raggiungono zero, il prodotto viene automaticamente nascosto dal menu cliente fino a quando non aggiorni il conteggio.
  • Per rifornire, modifica il prodotto e inserisci il nuovo valore In Stock.

I prodotti senza Traccia Stock si comportano come inventario infinito e non si nascondono mai automaticamente.

Riordinare i Prodotti all'interno di una Categoria

Trascina la maniglia per spostare un prodotto su o giù. Il nuovo ordine di visualizzazione viene salvato al rilascio. Il menu cliente riflette il nuovo ordine dopo il prossimo aggiornamento del menu, che avviene ad ogni caricamento della sessione.

Consigli

  • Inizia con 6-10 categorie. Troppe categorie rendono il menu cliente lento da sfogliare.
  • Usa foto ad alto contrasto e ben illuminate. Foto scure o rumorose riducono la conversione degli ordini.
  • Mantieni le descrizioni sotto i 120 caratteri quando possibile. Descrizioni lunghe spingono il pulsante Aggiungi al Carrello fuori dal primo schermo sui telefoni.
  • Imposta tempi di preparazione statici realistici. Il sistema dinamico impiega 30 giorni per apprendere. Fino ad allora, il numero statico è ciò che i clienti vedono.
  • Per articoli con molte scelte, dividili in due gruppi di varianti invece di un'unica lista enorme. "Dimensione" più "Latte" è più chiaro di "Dimensione con Latte".