Μενού Πελάτη

Το customer menu είναι η δημόσια web σελίδα στο handy.cafe/{your-slug}. Οι πελάτες το ανοίγουν σκανάροντας το QR code στο τραπέζι τους. Αυτή η σελίδα περιγράφει τη ροή του πελάτη από την αρχή έως το τέλος, ώστε να μπορείτε να την εξηγήσετε στο προσωπικό και να σχεδιάσετε την ανάπτυξη.

Δομή URL

Κάθε τραπέζι έχει ένα μοναδικό URL της μορφής handy.cafe/{cafe-slug}/{table-code}. Το QR code κωδικοποιεί αυτό το URL μαζί με ένα σύντομης διάρκειας token που αποδεικνύει ότι το αυτοκόλλητο είναι αυθεντικό. Όταν ο πελάτης σκανάρει το QR:

1. Το τηλέφωνό του ανοίγει το URL στο προεπιλεγμένο browser.
2. Η σελίδα επιλύει το slug και το table code μέσω του cloud API.
3. Αν το τραπέζι είναι out_of_order, εμφανίζεται μήνυμα ότι δεν είναι διαθέσιμο.
4. Αν το τραπέζι είναι idle, η σελίδα εξηγεί ότι το προσωπικό δεν έχει ακόμη καθίσει τον πελάτη και του ζητά να καλέσει για βοήθεια.
5. Αν το τραπέζι είναι in_use, η σελίδα ζητά τον 6ψήφιο κωδικό ασφαλείας.

Επαλήθευση Κωδικού Ασφαλείας

Ο κωδικός ασφαλείας διασφαλίζει ότι μόνο ο πελάτης που κάθεται εκείνη τη στιγμή στο τραπέζι μπορεί να κάνει παραγγελία. Αποτρέπει κάποιον που είδε το QR από φωτογραφία ή από έξω από το cafe να υποβάλει δόλιες παραγγελίες.

Αφού ο πελάτης εισαγάγει τον κωδικό:

1. Το API επικυρώνει τον κωδικό με την hashed τιμή που είναι αποθηκευμένη στο τραπέζι.
2. Αν είναι έγκυρος, δημιουργείται συνεδρία και επιστρέφεται token.
3. Το token αποθηκεύεται σε cookie (hc_menu_session). Ένα Bearer token fallback αποθηκεύεται επίσης στο local storage της συσκευής. Αυτό είναι απαραίτητο στο iPhone Safari, το οποίο μπορεί να μπλοκάρει third-party cookies σε ορισμένες διαμορφώσεις.
4. Ο πελάτης ανακατευθύνεται στο μενού.

Η συνεδρία ισχύει για 24 ώρες από την έκδοσή της. Αν ο πελάτης κλείσει τον browser και επιστρέψει στην ίδια συσκευή, η συνεδρία εξακολουθεί να λειτουργεί και μπορεί να ξαναμπεί χωρίς νέα επαλήθευση.

Γλώσσες

Το μενού υποστηρίζει 24 γλώσσες: Αραβικά, Γερμανικά, Ελληνικά, Αγγλικά, Ισπανικά, Φαρσί, Γαλλικά, Χίντι, Ινδονησιακά, Ιταλικά, Ιαπωνικά, Κορεατικά, Μαλαισιανά, Πολωνικά, Πορτογαλικά, Ρουμανικά, Ρωσικά, Ταϊλανδικά, Ταγκαλόγκ, Τουρκικά, Ουκρανικά, Ουρντού, Βιετναμέζικα και Κινέζικα.

Στην πρώτη επίσκεψη, η σελίδα εξετάζει το header Accept-Language του browser και επιλέγει την καλύτερη αντιστοίχιση. Ο πελάτης μπορεί να αλλάξει γλώσσα οποιαδήποτε στιγμή με τον επιλογέα στην κορυφή του μενού. Η επιλεγμένη γλώσσα θυμάται για τη διάρκεια της συνεδρίας.

Τα ονόματα προϊόντων, οι περιγραφές και τα συστατικά δεν μεταφράζονται αυτόματα· εμφανίζονται στη γλώσσα που εισαγάγατε στον επεξεργαστή μενού. Οι ετικέτες του UI όπως "Add to Cart", "Checkout" και τα μηνύματα ροής πληρωμής είναι πλήρως τοπικοποιημένες.

Θέμα

Το μενού υποστηρίζει ανοιχτό και σκούρο θέμα. Η προεπιλογή είναι device-aware: αν το λειτουργικό σύστημα του πελάτη είναι σε dark mode, το μενού ανοίγει σε σκούρο θέμα. Ένα toggle θέματος στην κορυφή επιτρέπει την εναλλαγή.

Κεφαλίδα με Branding

Η κεφαλίδα στο επάνω μέρος του μενού εμφανίζει:

Προσαρμόστε αυτά τα πεδία για την καλύτερη εντύπωση στον πελάτη. Οι πελάτες αναγνωρίζουν το brand όταν το μενού μοιάζει με τη φυσική σήμανση του χώρου σας.

Περιήγηση στο Μενού

Το μενού ομαδοποιείται ανά κατηγορία. Μέσα σε κάθε κατηγορία, τα προϊόντα εμφανίζονται με thumbnail, όνομα, σύντομη περιγραφή και τιμή.

Το πάτημα σε ένα προϊόν ανοίγει το product sheet. Το sheet δείχνει:

• Τη πλήρη φωτογραφία.
• Περιγραφή σε Markdown.
• Γραμμή συστατικών.
• Chip χρόνου προετοιμασίας (μόνο όταν το Show Prep Time on Menu είναι ενεργό).
• Unit label αν έχει ρυθμιστεί (για παράδειγμα "250 ml").
• Selectors παραλλαγών για κάθε ομάδα παραλλαγών που συνδέεται με το προϊόν.
• Quantity stepper.
• Κουμπί Add to Cart.

Οι υποχρεωτικές ομάδες παραλλαγών μπλοκάρουν το κουμπί Add to Cart μέχρι ο πελάτης να επιλέξει επιλογή.

Καλάθι

Το εικονίδιο του καλαθιού βρίσκεται σε σταθερή θέση ώστε οι πελάτες να μπορούν να το προσεγγίσουν από οποιαδήποτε οθόνη. Το περιεχόμενο του καλαθιού διατηρείται κατά την πλοήγηση μέσα στο site· η μετάβαση από καλάθι σε μενού και πίσω δεν χάνει items.

Το καλάθι επιτρέπει στον πελάτη:

• Να αλλάζει ποσότητα ανά γραμμή.
• Να αφαιρεί μια γραμμή.
• Να προσθέτει προαιρετική σημείωση.
• Να δηλώνει προαιρετικά αριθμό τηλεφώνου.

Το subtotal, ο VAT και το total εμφανίζονται σε πραγματικό χρόνο.

Υποβολή της Παραγγελίας

Το βήμα Checkout προσφέρει μία ή δύο μεθόδους πληρωμής ανάλογα με τη ρύθμισή σας:

Cash

Αν η online πληρωμή είναι απενεργοποιημένη στις ρυθμίσεις σας, εμφανίζεται μόνο το Cash. Ο πελάτης επιβεβαιώνει την παραγγελία και αυτή υποβάλλεται αμέσως. Ο πελάτης πληρώνει τον ταμία όταν φτάσει η παραγγελία.

Online (Stripe Checkout)

Αν η online πληρωμή είναι ενεργή, το Online εμφανίζεται ως επιλογή. Κατά την υποβολή:

1. Η παραγγελία δημιουργείται σε κατάσταση pending.
2. Επιστρέφεται client secret του Stripe Checkout.
3. Το embedded Stripe UI ανοίγει inline. Ο πελάτης εισάγει στοιχεία κάρτας.
4. Με επιτυχή εξουσιοδότηση, το Stripe επιβεβαιώνει τη χρέωση και η παραγγελία μεταβαίνει σε paid.
5. Ο πελάτης βλέπει τη σελίδα επιτυχίας.

Αποτυχημένες ή εγκαταλελειμμένες πληρωμές αφήνουν την παραγγελία σε pending κατάσταση. Μπορεί να γίνει δεύτερη προσπάθεια από την ίδια συνεδρία ή το προσωπικό μπορεί να ακυρώσει την παραγγελία από το Orders dashboard.

Σελίδα Επιτυχίας

Μετά από επιτυχή υποβολή, ο πελάτης μεταφέρεται σε σελίδα απόδειξης που δείχνει:

• Αριθμό παραγγελίας και ώρα.
• Κάθε γραμμή με ποσότητα, παραλλαγές και line total.
• Subtotal, VAT και grand total.
• Μέθοδο πληρωμής.
• Εικονίδιο κατάστασης πληρωμής (pending για cash, paid για online).
• CTA "Place Another Order" που επιστρέφει στο μενού με τη συνεδρία άθικτη.
• Σύνδεσμο "Back to Menu".

Έλεγχος Κατάστασης Παραγγελίας

Μετά την υποβολή, η προβολή του πελάτη για την παραγγελία κάνει polling στο status endpoint για να αποτυπώνει τις ενημερώσεις από την κουζίνα. Αν το προσωπικό προχωρήσει ένα item από preparing σε ready, ο πελάτης βλέπει το badge στη γραμμή να ενημερώνεται αυτόματα μέσα σε λίγα δευτερόλεπτα.

Αυτό είναι χρήσιμο για self-service pickup σε πάγκο. Ο πελάτης μπορεί να χαλαρώσει στο τραπέζι μέχρι το μενού να του δείξει ότι η παραγγελία είναι έτοιμη.

Τι Δεν Μπορούν να Κάνουν οι Πελάτες

• Οι πελάτες δεν μπορούν να περιηγηθούν στο μενού χωρίς τον κωδικό ασφαλείας. Το βήμα επαλήθευσης είναι πάντα υποχρεωτικό.
• Οι πελάτες δεν μπορούν να κάνουν παραγγελίες για τραπέζια που είναι idle ή out_of_order.
• Οι πελάτες δεν μπορούν να επεξεργαστούν ή να ακυρώσουν παραγγελία αφού αυτή έχει υποβληθεί. Η ακύρωση είναι ενέργεια του προσωπικού από το Orders dashboard.

Συμβουλές για Καθαρή Εμπειρία Πελάτη

• Τυπώστε QR stickers με το όνομα του cafe και μια σαφή οδηγία όπως "Scan to order. Ask staff for the code." Οι πελάτες μερικές φορές παραλείπουν το βήμα επαλήθευσης αλλιώς.
• Κρατήστε σύντομα τα ονόματα κατηγοριών και προϊόντων. Τα μεγάλα ονόματα κάνουν wrap στα κινητά και σπρώχνουν τις εικόνες κάτω από το fold.
• Μεταφορτώστε τουλάχιστον μία φωτογραφία ανά προϊόν. Τα μενού με πολλές εικόνες μετατρέπουν καλύτερα από τα text-only μενού.
• Ενεργοποιήστε το Show Prep Time on Menu μόνο αφού το δυναμικό estimate έχει εκπαιδευτεί. Για τις πρώτες 30 ημέρες η στατική τιμή μπορεί να είναι υπερβολικά γενναιόδωρη ή πολύ χαμηλή και οι πελάτες το παρατηρούν.
• Δοκιμάστε ολόκληρη τη ροή μόνοι σας από κινητό πριν ανοίξετε στους πελάτες. Σκανάρετε ένα πραγματικό QR, εισάγετε τον κωδικό, κάντε μια δοκιμαστική παραγγελία και επαληθεύστε ότι εμφανίζεται στο dashboard σας.