RistoKiosk – Manuale d'Uso

1. Introduzione a RistoKiosk

RistoKiosk è un sistema completo per la gestione degli ordini in locale: il cliente può ordinare da un chiosco (kiosk), la cucina e il bar vedono solo le righe di loro competenza, e la cassa raggruppa il conto per tavolo.

L'obiettivo è ridurre gli errori, velocizzare il servizio e avere un flusso di lavoro chiaro: dall'ordine, alla preparazione, alla consegna, fino alla chiusura del conto.

2. Ruoli e schermate principali

2.1 Ruolo Cliente

Cliente Utilizza il totem / kiosk per:

• selezionare il tavolo (se previsto)
• sfogliare il menu (prodotti attivi)
• inserire l'ordine
• procedere al pagamento (online o “paga dopo” se attivo)
• visualizzare lo stato del proprio ordine tramite un link dedicato

2.2 Ruolo Cucina / Bar

Cucina Bar
Gli operatori lavorano su cucina.php con una view specifica:

• ?view=cucina → vede solo prodotti assegnati alla vista “cucina”
• ?view=bar → vede solo prodotti assegnati alla vista “bar”
• eventuali altre view (pizzeria, dessert, ecc.) possono essere aggiunte in base alle categorie

Da questa schermata è possibile:

• vedere i nuovi ordini (pagati o con “paga dopo”)
• segnare IN PREPARAZIONE / ORDINE PRONTO per la propria view
• visualizzare note del cliente
• modificare il menu (prodotti disponibili/esauriti)

2.3 Ruolo Cassa

Cassa
L'operatore di cassa utilizza cassa.php per:

• vedere gli ordini da incassare, raggruppati per tavolo
• modificare quantità e togliere articoli non serviti
• incassare e chiudere l'ordine (pagamento finale)

2.4 Ruolo Amministratore / Gestore

Admin
Il gestore si occupa di:

• configurare menu e categorie (file prodotti e categorie)
• definire per ogni categoria a quale view appartiene (cucina, bar, ecc.)
• impostare i metodi di pagamento disponibili
• monitorare il corretto funzionamento del sistema

3. Flusso di lavoro dall'ordine alla consegna

1. Il cliente ordina al kiosk e conferma l'ordine.
2. Se il pagamento è online, lo stato di pagamento diventa paid; altrimenti viene marcato come PAGA DOPO.
3. L'ordine appare in cucina.php e viene fisicamente “spezzato” per view: cucina vede solo piatti cucina, bar vede solo bevande, ecc.
4. Ogni reparto imposta lo stato della propria parte come IN PREPARAZIONE o ORDINE PRONTO.
5. Quando almeno una parte è pronta ma non tutte, lo stato globale diventa PARZIALMENTE_PRONTO (CI SIAMO QUASI!).
6. Quando tutti i reparti coinvolti sono su ORDINE PRONTO, lo stato globale dell'ordine passa a ORDINE PRONTO.
7. Il cliente vede l'avanzamento sulla pagina stato_ordine.php e legge messaggi chiari come: “Il tuo ordine è in preparazione”, “Ci siamo quasi!”, “Il tuo ordine è pronto!”.
8. Alla cassa, l'ordine può essere incassato e chiuso, con eventuali modifiche a quantità e righe non servite.
9. Una volta chiuso definitivamente, l'ordine passa allo stato: ORDINE_CHIUSO.

4. Guida per il cliente (Totem / Kiosk)

4.1 Come funziona il kiosk per il cliente

Il kiosk è pensato per essere semplice e intuitivo. Un possibile flusso per il cliente:

1. Seleziona il tavolo, oppure conferma il servizio da asporto (se previsto).
2. Scorre il menu per categorie (antipasti, primi, bevande, dessert...).
3. Aggiunge prodotti al carrello, modificando quantità se necessario.
4. Conferma il riepilogo dell'ordine.
5. Procede al pagamento (online o “paga dopo”).
6. Riceve un numero ordine e un link per seguire lo stato.

4.2 Messaggi importanti per il cliente

Al termine dell'ordine, è consigliato mostrare chiaramente:

• Numero ordine (es. 20251121-0005)
• QR code o link per aprire la pagina di stato
• Messaggio che invita a tenere aperta la pagina di stato sullo smartphone

Non chiudere questa pagina per vedere quando il tuo ordine sarà pronto!

5. Pagina stato ordine per il cliente (stato_ordine.php)

La pagina stato_ordine.php permette al cliente di seguire in tempo reale il proprio ordine. Viene aperta da un link del tipo:

stato_ordine.php?oid=NUMERO_ORDINE&t=TOKEN

5.1 Stati visualizzati

Il cliente può vedere principalmente tre stati:

• IN PREPARAZIONE
  L'ordine è in lavorazione, cucina e/o bar stanno preparando i prodotti.
• CI SIAMO QUASI!
  Corrisponde allo stato tecnico PARZIALMENTE_PRONTO: una parte dell'ordine è pronta, ma non tutto (es. bar pronto, cucina ancora in preparazione).
• ORDINE PRONTO
  Tutte le parti dell'ordine sono pronte. Il cliente può recarsi al banco con il numero ordine.

5.2 Messaggi automatici

La pagina mostra testi esplicativi, ad esempio:

• IN PREPARAZIONE: “Il tuo ordine è in preparazione...”
• CI SIAMO QUASI!: “Una parte del tuo ordine è già pronta, stiamo completando il resto.”
• ORDINE PRONTO: “Il tuo ordine è pronto! Puoi recarti al banco con il numero ordine.”

6. Schermata Cucina / Bar (cucina.php)

La pagina cucina.php è la schermata operativa per cucina, bar e altri reparti. La view viene scelta passando un parametro nell'URL:

cucina.php?view=cucina – per la cucina
cucina.php?view=bar – per il bar

6.1 Cosa mostra la schermata

• Solo gli ordini pagati o con flag PAGA DOPO.
• Solo gli ordini con order_status diverso da ORDINE_CHIUSO.
• Solo le righe di prodotto che appartengono alla view corrente (cucina, bar, ecc.).
• Gli ordini più vecchi in alto.

6.2 Comandi principali per l'operatore

• Badge stato (per view): tappando il badge, si alterna IN PREPARAZIONE / ORDINE PRONTO solo per la view corrente.
• Stato globale: in base alle view (cucina, bar, ecc.) il sistema calcola automaticamente se l'ordine è IN_PREPARAZIONE, PARZIALMENTE_PRONTO o ORDINE_PRONTO.
• Pulsante “Modifica menu”: apre un overlay dove è possibile marcare i prodotti come Disponibile o Esaurito.
• Pulsante X (chiusura definitiva): visibile solo quando l'ordine è completamente pronto in tutte le sue parti (stato globale ORDINE_PRONTO).

7. Schermata Cassa (cassa.php)

La schermata cassa.php è dedicata alla gestione dell'incasso e della chiusura del conto.

7.1 Funzioni principali

• Elenco degli ordini da incassare, raggruppati per tavolo.
• Possibilità di modificare quantità di una riga prima del conto.
• Possibilità di eliminare righe non servite (es. prodotto ordinato ma non consegnato).
• Calcolo automatico del totale aggiornato.
• Registrazione del pagamento finale e chiusura dell'ordine.

8. Configurazione menu e categorie (Admin)

L'amministratore si occupa della configurazione dei prodotti e dell'associazione alle view (cucina, bar, ecc.).

8.1 Categorie e view

Ogni categoria può avere una proprietà view, ad esempio:

• view = "cucina" → piatti che appaiono in cucina.php?view=cucina
• view = "bar" → bevande che appaiono in cucina.php?view=bar
• view = "" (vuoto) → prodotto visibile in tutte le view

8.2 Prodotti

Per ogni prodotto, sono definiti almeno:

• Nome prodotto
• Prezzo
• Categoria
• Stato attivo / non attivo (disponibile / esaurito)

8.3 Modifica veloce dal front-end

Dalla schermata cucina.php è possibile usare il pulsante “Modifica menu” per:

• vedere l'elenco dei prodotti
• segnare rapidamente un prodotto come Disponibile o Esaurito

9. Significato degli stati dell'ordine

Oltre agli stati globali, esistono gli stati per view, memorizzati in view_status[view], usati da cucina.php per gestire cucine, bar, ecc.

10. Buone pratiche operative

10.1 Per la cucina / bar

• Aggiorna sempre lo stato della view: quando inizi a preparare, imposta IN PREPARAZIONE, quando hai finito passa a ORDINE PRONTO.
• Verifica lo stato globale (indicazioni “CI SIAMO QUASI!” o “ORDINE PRONTO”) per coordinarti con gli altri reparti.
• Usa note cliente per piatti personalizzati (senza sale, aggiunta ingredienti, ecc.).

10.2 Per la cassa

• Prima di chiudere un ordine, chiedi “È arrivato tutto correttamente?” e adegua righe e quantità in cassa.php.
• Verifica che lo stato globale sia coerente con il servizio (di solito ORDINE PRONTO prima dell'incasso finale).

10.3 Per l'amministratore

• Mantieni il menu pulito: disattiva i prodotti non disponibili tramite “Modifica menu”.
• Controlla periodicamente che le categorie siano associate alla view corretta (cucina, bar, ecc.).
• Fai test con ordini di prova per verificare flusso kiosk → cucina/bar → cassa.

11. Risoluzione problemi comuni

11.1 Un prodotto non appare nella view corretta

• Controllare la categoria del prodotto.
• Verificare che la categoria abbia il campo view corretto (es. “cucina” o “bar”).
• Verificare di aver aperto la pagina giusta: es. cucina.php?view=bar.

11.2 Il cliente non vede aggiornarsi lo stato

• Verificare che cucina/bar stiano aggiornando lo stato delle view.
• Verificare che il cliente tenga aperta la pagina di stato sul proprio smartphone.
• Controllare la connessione internet del locale.

11.3 L'ordine non si può chiudere (X non visibile)

• Controlla che tutte le view coinvolte abbiano lo stato ORDINE_PRONTO.
• Se anche una sola parte è ancora IN_PREPARAZIONE, lo stato globale sarà IN_PREPARAZIONE o PARZIALMENTE_PRONTO e la X non apparirà.

12. Appendice – Esempi di schermate

12.1 Schermata cliente – Riepilogo ordine

12.2 Schermata cucina – Ordini da preparare

12.3 Schermata stato ordine – Cliente