Vai al contenuto

Modulo Scanner & Segna Seduti

Il modulo Scanner & Segna Seduti è il punto di controllo per il personale di sala e i volontari addetti all'accoglienza. Tramite fotocamera di tablet o smartphone, permette di scansionare il QR code stampato sugli scontrini di cassa e registrare in tempo reale l'arrivo e l'occupazione fisica dei posti a tavola, con tracciamento per singolo scontrino introdotto con l'Issue 51.


1. Architettura del Flusso Accoglienza

Il flusso si attiva non appena gli ospiti ricevono la ricevuta dalla cassa ed entrano nell'area ristorazione:

flowchart TD
    A[Ospite con Scontrino Cassa] --> B[Arrivo al Varco Sala]
    B --> C[Scanner Tavoli /Serate/ScannerTavoli]
    C -->|Lettura Ottica QR Code| D[Pagina Segna Seduti /Serate/SegnaSeduti?transazioneId=X]
    D --> E[Visualizzazione Tavolo e Dettagli Gruppo]
    E --> F{Tutti Presenti o Arrivo Parziale?}
    F -- Tutti Presenti --> G[Conferma Arrivo Completo Scontrino]
    F -- Parziale --> H[Imposta Adulti e Bambini Effettivi]
    G & H --> I[Salvataggio Presenze e Orario Seduti]
    I --> J[Aggiornamento Dashboard Regia in Tempo Reale]

2. Scanner Tavoli (/Serate/ScannerTavoli)

L'interfaccia Scanner Tavoli è specificamente studiata per dispositivi mobili (smartphone Android/iOS e tablet):

Scanner QR Scontrini Varchi

┌────────────────────────────────────────────────────────┐
│ SCANNER TAVOLI SALA                   [📷 Camera ON]   │
├────────────────────────────────────────────────────────┤
│ Inquadra il QR Code stampato sullo scontrino di cassa  │
│                                                        │
│               ┌───────────────────────┐                │
│               │   ┌───────────────┐   │                │
│               │   │   [QR CODE]   │   │  <-- Mirino    │
│               │   └───────────────┘   │      Ottico    │
│               │  Posiziona al centro  │                │
│               └───────────────────────┘                │
│                                                        │
│ [ Inverti Fotocamera 🔄 ]         [ Attiva Flash 💡 ]  │
├────────────────────────────────────────────────────────┤
│ Inserimento Manuale di Emergenza:                      │
│ ID Transazione o Ricevuta: [__________] [ Convalida ]  │
└────────────────────────────────────────────────────────┘

Caratteristiche Tecniche dello Scanner

  • Lettore QR Web-based: sfrutta le API HTML5 getUserMedia del browser moderno, operando senza dover installare applicazioni native dall'app store.
  • Supporto Fotocamera Posteriore e Flash: seleziona automaticamente la fotocamera grandangolare posteriore con messa a fuoco automatica e comando per illuminazione torcia in ambienti con luce soffusa.
  • Fallback Manuale: se lo scontrino cartaceo risulta sgualcito, bagnato o con il codice a barre illeggibile, l'addetto può digitare manualmente il numero della ricevuta o l'ID transazione nel campo sottostante per accedere alla schermata di convalida.

3. Gestione Presenze: Segna Seduti (/Serate/SegnaSeduti)

Quando il QR code viene scansionato, il browser apre istantaneamente la pagina Segna Seduti contestualizzata per la specifica ricevuta:

Conferma Ospiti Seduti al Tavolo

┌────────────────────────────────────────────────────────────────────────┐
│ SEGNA SEDUTI - RICEVUTA N. 1042                                        │
├────────────────────────────────────────────────────────────────────────┤
│ Tavolo di Destinazione:  >>> TAVOLO 14 <<< (Zona Centrale)             │
│ Referente Prenotazione:  Rossi Marco (Tel: 333.1234567)                │
├────────────────────────────────────────────────────────────────────────┤
│ SITUAZIONE GRUPPO                                                      │
│ Coperti Totali Prenotati:   6 (4 Adulti, 2 Bambini)                    │
│ Coperti Saldati in Cassa:   6 (4 Adulti, 2 Bambini)                    │
│ Già Seduti al Tavolo:       2 Adulti                                   │
│ Rimasti da Sedere:          2 Adulti, 2 Bambini                        │
├────────────────────────────────────────────────────────────────────────┤
│ REGISTRAZIONE ARRIVO CORRENTE                                          │
│ Adulti da far sedere:   [-] [ 2 ] [+]  (max 2 mancanti)                │
│ Bambini da far sedere:  [-] [ 2 ] [+]  (max 2 mancanti)                │
├────────────────────────────────────────────────────────────────────────┤
│ [ ✓ SEGNA TUTTI I RIMANENTI ]     [ 💾 REGISTRA PARZIALE ]             │
└────────────────────────────────────────────────────────────────────────┘

Funzionamento Dettagliato (Issue 51)

Prima dell'Issue 51, l'arrivo al tavolo veniva gestito unicamente a livello di intera prenotazione. Con l'introduzione della gestione per singolo scontrino:

  1. Riconoscimento delle Transazioni Multiple: se una comitiva di 20 persone paga con 4 scontrini separati, ciascuno scontrino ha il proprio QR code dedicato.
  2. Accompagnamento Frazionato: quando arrivano i primi 5 amici, l'operatore scansiona la loro ricevuta e segna i loro 5 coperti. Il sistema:
    • Imposta AdultiSeduti e BambiniSeduti sulla specifica transazione.
    • Salva il timestamp OrarioSeduti = DateTime.Now.
    • Aggiorna lo stato del tavolo indicando che 5 posti su 20 sono fisicamente occupati.
  3. Distribuzione Automatica Eccedenze (DistributeSeduti): se per errore viene scansionato uno scontrino ma il gruppo arrivato comprende persone appartenenti ad un secondo scontrino della stessa comitiva, l'algoritmo distribuisce logicamente i coperti eccedenti sulle altre transazioni valide non stornate.

4. Statistiche in Tempo Reale Sala vs Cassa

Il modulo Segna Seduti alimenta costantemente i cruscotti di monitoraggio:

┌────────────────────────────────────────────────────────────────────────┐
│ TAVOLO 14 - STATO AVANZAMENTO SEDUTI                                   │
├───────────────────────────────────┬────────────────────────────────────┤
│ Capacità Tavolo: 8 posti          │ Coperti Prenotati: 6 posti         │
│ Coperti Saldati: 6 / 6 (100%)     │ Coperti Seduti:    4 / 6 (66%)     │
├───────────────────────────────────┴────────────────────────────────────┤
│ [████████████████████████████████░░░░░░░░░░░░░░░░] 66% Completato      │
│ In attesa di: 2 Bambini                                                │
└────────────────────────────────────────────────────────────────────────┘
  • Trasparenza per la Cucina e i Camerieri: i camerieri vedono immediatamente se un tavolo è "in attesa del resto della comitiva" prima di servire le portate o se il tavolo è al completo.
  • Identificazione Tavoli Abbandonati: se un tavolo ha coperti saldati ma nessun arrivo registrato a tarda ora, la regia può verificare se gli ospiti si sono accomodati senza passare dal varco.