Ordini

La scheda Ordini è il dashboard live per ogni ordine effettuato dai tuoi clienti nella caffetteria. Interroga il cloud ogni 3 secondi e mostra nuove attività con una notifica desktop, un avviso audio e un badge di conteggio in sospeso nell'intestazione della scheda.

Layout

La pagina Ordini è suddivisa in due aree:

Area	Scopo
Schede di Stato	Filtra per stato dell'ordine: tutti, effettuati, confermati, in preparazione, pronti, serviti. Gli ordini annullati e rimborsati sono filtrati di default.
Elenco Ordini	Una scheda per ordine, raggruppata dal più recente. Ogni scheda mostra il codice del tavolo, il telefono del cliente se fornito, gli articoli, i totali e i pulsanti di azione.

Polling Live

Il dashboard Ordini interroga /v1/cafeteria/admin/orders/poll ogni 3 secondi. Ogni nuovo ordine attiva:

Una notifica desktop con il codice del tavolo e il numero di articoli.
Un avviso audio sugli altoparlanti del server se le notifiche sonore sono abilitate in Impostazioni > Caffetteria.
Un incremento del badge di conteggio in sospeso sulla scheda Ordini.
Una stampa automatica della ricevuta se la stampante è configurata con Stampa Automatica su Nuovo Ordine.

Il badge rimane visibile finché ogni ordine con stato effettuato o confermato non viene avanzato a uno stato successivo o eliminato. Il badge è visibile globalmente nella sezione Caffetteria della barra laterale; non è necessario tenere aperta la scheda Ordini per vederlo.

Ciclo di Vita dell'Ordine

Ogni ordine attraversa una sequenza definita di stati.

Stato	Significato
effettuato	Il cliente ha inviato l'ordine. Nessuna azione del personale ancora.
confermato	Il personale ha preso in carico l'ordine.
in preparazione	La cucina sta lavorando sull'ordine.
pronto	L'ordine è pronto per il servizio o il ritiro.
servito	L'ordine è stato consegnato al cliente.
annullato	L'ordine è stato annullato dal personale. Viene rimosso dalle viste live ma conservato per la cronologia.
rimborsato	È stato emesso un rimborso post-pagamento.

La barra delle azioni su ogni scheda ordine mostra il prossimo stato disponibile. L'avanzamento richiede un solo clic. L'interfaccia utente utilizza un modello di aggiornamento ottimistico: il nuovo stato viene visualizzato immediatamente. Se il server rifiuta la modifica, lo stato torna indietro e appare una notifica di errore.

Stato Per Articolo

Alcuni ordini contengono più articoli che finiscono in momenti diversi. Ad esempio, un hamburger è pronto prima di una pizza. Lo stato per articolo ti consente di monitorare ogni linea in modo indipendente.

Ogni articolo ha il proprio menu a tendina con cinque opzioni: effettuato, in preparazione, pronto, servito, annullato. Ogni articolo porta anche tre timestamp:

created_at viene impostato quando l'ordine arriva.
ready_at viene impostato la prima volta che l'articolo entra in pronto.
served_at viene impostato quando l'articolo entra in servito.

Il menu del cliente mostra un badge accanto a ciascuna linea in modo che il cliente possa vedere quali articoli sono pronti o in arrivo.

Annullamento di un Ordine

Apri la scheda dell'ordine.
Clicca su Annulla.
Conferma nella finestra di dialogo che appare.
L'ordine passa a annullato. Rimane nella cronologia ma scompare dalla vista live predefinita.

L'annullamento è un'azione per l'intero ordine. Per annullare una singola linea, cambia lo stato per articolo di quella linea in annullato.

Chiusura (Settle Check)

La chiusura chiude ogni ordine aperto su un tavolo in un solo passaggio. Usalo quando il cliente sta per andarsene e vuole pagare l'intero conto.

Apri il tavolo dalla pagina Tavoli o dal menu azioni del Piano.
Clicca su Settle Check.
La finestra modale elenca ogni ordine sul tavolo che non è già servito.
Scegli un metodo di pagamento. Le opzioni sono: Contanti, Carta, Online, Altro.
Conferma.

Il server esegue le seguenti azioni in modo atomico:

Ogni ordine aperto sul tavolo passa a servito con payment_status=paid.
Viene creato un record cafeteria_settlements con l'importo totale, il metodo di pagamento e l'ora di creazione.
Una traccia di audit degli ordini di chiusura registra quali ordini appartengono a questa chiusura.
Il codice di sicurezza del tavolo scade, rendendo il QR non valido.
Il tavolo torna a idle.

Se hai scelto Online come metodo di pagamento, il record di chiusura è contrassegnato come pagato online. Nessun addebito Stripe viene attivato da questa azione. Il pagamento online dal lato cliente viene gestito al momento dell'ordine; l'azione di chiusura registra il flusso di cassa per la tua contabilità.

Timer di Apertura

Ogni tavolo ha un timestamp opened_at impostato quando il cliente si siede. Le pagine Piano e Tavoli mostrano un timer live da quel momento. Questo aiuta il personale a individuare i tavoli che sono attivi da molto tempo senza ordinare, o tavoli che potrebbero avvicinarsi alla fine di una sessione.

Il timer si azzera a zero su Chiudi Tavolo o Settle Check.

Visualizzazione Dinamica del Tempo di Preparazione

Quando il tempo di preparazione dinamico è attivo per un prodotto, la scheda dell'ordine mostra la stima accanto al nome dell'articolo. Il personale vede la stima anche quando l'opzione Mostra Tempo di Preparazione nel Menu è disattivata per i clienti.

La stima si aggiorna ogni volta che viene effettuato un nuovo ordine e ogni volta che un ordine viene completato. Il sistema apprende dal ritmo effettivo della tua cucina.

Comportamento delle Notifiche di Nuovo Ordine

Le notifiche vengono attivate a livello di app, non per scheda. Ciò significa che ricevi avvisi quando stai navigando in un'altra parte del server HandyCafe, ad esempio nel Pannello di Amministrazione o nelle Impostazioni. L'avviso audio è abilitato o disabilitato da Impostazioni > Caffetteria > Notifica Sonora.

Le notifiche desktop richiedono che il sistema operativo abbia concesso l'autorizzazione alle notifiche a HandyCafe. Se non vedi una notifica dopo un nuovo ordine, controlla le impostazioni delle notifiche del tuo sistema operativo.

Consigli

Usa le Schede di Stato per dividere il carico di lavoro. Uno schermo filtrato su in preparazione mostra la coda della cucina. Un altro schermo su pronto mostra cosa deve essere consegnato.
Settle Check è il modo più veloce per chiudere un tavolo. Usa Annulla su ordini individuali solo per errori espliciti.
Forma il personale a far avanzare lo stato in modo coerente. Il tempo di preparazione dinamico impara da questi segnali, quindi saltare stati ne riduce l'accuratezza.
Controlla periodicamente gli ordini annullati e rimborsati dal punto di accesso amministrativo per individuare eventuali errori del personale.