Capitolo 1 — Display da cucina (KDS)

Il display da cucina è una pagina nel browser che si apre su uno schermo in cucina o al bar e mostra le comande in tempo reale. Il personale di cucina lo utilizza per far avanzare gli ordini da «nuovo» a «pronto». È collegato a internet e riceve gli ordini in tempo reale.

⚠️ Lingua dell'applicazione: questa applicazione si apre per impostazione predefinita in tedesco e la traduzione persiana della cucina è incompleta — ovvero, anche se imposta la lingua su persiano, alcune etichette (come Done, Preparing, Refresh) restano in inglese. Le etichette riportate tra parentesi in questo capitolo corrispondono esattamente a ciò che vede realmente sullo schermo.

1-1. Accesso

• Acceda con email e password (lo stesso account della Cassa). L'accesso dispone anche di una scheda telefono e, se la verifica in due passaggi è attiva, si aggiunge anche un passaggio con codice; sono presenti inoltre le opzioni di accesso social e le pagine di registrazione/password dimenticata.
• Schermata di blocco / PIN rapido: come nella Cassa, se l'utente dispone di un PIN può bloccare la bacheca e sbloccarla con il PIN (senza effettuare la disconnessione completa) e, dall'elenco, cambiare utente o aggiungere un altro cassiere.

1-2. Selezione del punto vendita e della postazione (prima della bacheca)

Dopo l'accesso, una pagina separata Le chiede di selezionare il punto vendita (Location) e la postazione (Station) di questo display:

• Ogni postazione già occupata da un altro utente viene mostrata come disattivata.
• Dopo la selezione, una barra di avanzamento percentuale carica i dati iniziali e poi si accede alla bacheca. Se una parte dei dati non viene memorizzata nella cache, compare il messaggio «La bacheca si apre ma…» con un pulsante Riprova.
• In caso di problemi: «La sessione della cucina non è stata caricata» (→ vada all'accesso) oppure «I punti vendita non sono stati caricati» (→ riprovare).

Questo passaggio è diverso dalla selezione della destinazione (Destination) all'interno della bacheca; quest'ultima è illustrata nella sezione 1-3.

1-3. Bacheca degli ordini

La pagina principale è una bacheca con colonne di stato, ciascuna delle quali scorre separatamente:

• Nuovo (New): ordini appena arrivati.
• In preparazione (Preparing): lavori già iniziati.
• Pronto/completato (Completed): lavori terminati.
• Annullato (Cancelled): ordini annullati (in rosso).

In cima a ogni colonna vengono mostrati il numero di comande e il numero di articoli; una colonna vuota ha il proprio messaggio («No new work», «Nothing preparing», «No completed work», «Nothing cancelled»).

Barra superiore della bacheca

• Selezione della destinazione (Destination): consente di scegliere quale monitor/postazione della cucina mostrare su questo display (ad esempio «cucina calda» o «bar»). Se è presente una sola destinazione, viene selezionata automaticamente e la Sua ultima scelta viene memorizzata. Se non è disponibile alcuna destinazione, compare un messaggio informativo ed è necessario selezionare la destinazione prima del caricamento.
• Pulsante di aggiornamento (Refresh), etichetta «Refreshing» durante l'aggiornamento, ora dell'ultima verifica, numero di comande/articoli e ultimo evento in tempo reale.
• Avviso di paginazione: se il server dispone di più elementi di quelli caricati, viene mostrato «Showing X of Y backend orders» — ovvero, dopo aver modificato il filtro/la pagina sul lato server, prema Aggiorna.

Cosa si vede su ogni comanda

• Tipo di origine: Open cart (carrello aperto), Finalized order (ordine finalizzato) o Kitchen dispatch (invio in cucina); numero di revisione («Rev N»).
• Titolo dell'ordine, riga di origine, ora di creazione e di aggiornamento ed etichetta di stato.
• Riga degli articoli: quantità nel formato xN (per i resi, numero negativo), nome dell'articolo, «Note:» per le annotazioni, gli extra e gli articoli complementari nidificati con l'etichetta «Cross-sell for …»; se impostato, lo sfondo colorato di ciascun articolo.

1-4. Avanzamento dell'ordine (Bump)

Su ogni comanda vengono mostrati solo i pulsanti consentiti per quello stato:

• Avvio della preparazione (Start preparing) → solo dallo stato nuovo → passa a «in preparazione».
• Pronto (Done) → solo dallo stato di preparazione → passa a «pronto/completato».
• Annulla (Cancel) → da nuovo o in preparazione → passa a «annullato» (pulsante rosso).

Ogni azione viene registrata sul server e la pagina si aggiorna; durante la registrazione di un'azione, gli altri pulsanti della stessa comanda vengono nascosti. Le azioni non consentite non hanno alcun pulsante (sono nascoste, non disattivate). Se la registrazione dello stato non riesce, viene mostrata una barra rossa separata («Kitchen status could not be updated»).

Stampa della comanda (Print)

• Il pulsante di stampa è presente solo sulle comande stampabili.
• In caso di successo: «Kitchen ticket sent to …».
• Se il modello di stampa non è configurato: avviso «No kitchen print template is configured…».
• Gli errori vengono distinti in base alla causa: problema di modello («…template could not be prepared…») rispetto a problema di hardware («…could not be printed… Check the printer connection»).

1-5. Segnale acustico di avviso

• Per un nuovo lavoro o una modifica viene riprodotto un bip/una sirena, in modo da accorgersene anche senza guardare lo schermo.
• Il suono viene riprodotto solo dopo un'effettiva conferma del server (nuovo lavoro, revisione più recente o cambio di stato) — non all'apertura iniziale della pagina, né durante l'aggiornamento successivo a una riconnessione. Inoltre non si accumula in sequenza (intervallo minimo di 1,5 secondi).
• Barra di autorizzazione audio: finché il browser non ha concesso l'autorizzazione a riprodurre l'audio, viene mostrata in fondo alla pagina una barra gialla («Kitchen alerts need sound permission») con il pulsante «Enable kitchen sound».

💡 Se l'audio non viene riprodotto, lo stesso pulsante «Enable kitchen sound» oppure un tocco sullo schermo risolve il problema.

1-6. Stato della connessione e ripristino

In alto nella pagina è presente un indicatore Live / Stale / Offline («Stale» indica una connessione lenta/in fase di riconnessione). Quando la connessione in tempo reale presenta problemi, compare una barra evidenziata:

• «Live order updates are offline» (disconnesso)
• «Reconnecting to live order updates…» (connessione in corso)
• «Live updates may be behind» (un aggiornamento è andato perso; la bacheca si aggiorna automaticamente da sola)

Se la connessione in tempo reale si interrompe, il metodo sicuro è il pulsante di aggiornamento (Refresh) manuale in alto nella pagina. La bacheca conserva le comande esistenti tra un aggiornamento e l'altro e mostra solo il nuovo stato.

• La modalità «determinazione del punto vendita in corso» dispone di un proprio pulsante dedicato («Retry location»); se la bacheca non viene caricata affatto, compare la schermata di ripristino «Refresh board».
• Le richieste hanno un limite di tempo (se scade, compare il messaggio «request timed out — use Refresh»).

1-7. Impostazioni

Dal menu utente, Impostazioni dell'account con le schede profilo, sicurezza, aspetto (tema), notifiche e connessione — e Disconnessione. ⚠️ La scheda connessione (Integration) è disattivata e non si apre.

Le Impostazioni di sistema dispongono solo di due schede: catalogo e vendite (anche il link «general» porta al catalogo). Se non si dispone dell'autorizzazione di scrittura, si apre con una barra di sola lettura; e se non si dispone dell'autorizzazione di visualizzazione, non si apre affatto.