Vai al contenuto

Modulo Prenotazioni & Anagrafica Ospiti

Il modulo Prenotazioni governa la registrazione, la profilazione e l'assegnazione iniziale dei gruppi partecipanti alle manifestazioni di AssegnaPosti. Integra strumenti per il dimensionamento degli spazi, la gestione di attrezzature dedicate all'infanzia, preferenze di vicinanza tra comitive e un motore di rilevamento dello Storico Cliente.


1. Architettura della Prenotazione

Ogni prenotazione contiene le informazioni anagrafiche, la composizione del nucleo, le esigenze logistiche speciali e lo stato di avanzamento:

flowchart TD
    A[Richiesta Ospite] --> B[Inserimento Form /Serate/AggiungiPrenotazione]
    B --> C{Verifica Telefono}
    C -->|Normalizzazione Prefisso| D[Rilevamento Storico Cliente Issue 48]
    D --> E[Storico Presenze / Disdette / Ritardi]
    B --> F[Configurazione Attrezzature: Seggioloni e Passeggini]
    B --> G[Pre-assegnazione Sconti Convenzionati Issue 51]
    B --> H[Preferenze di Vicinanza Gruppi Sincronizzate]
    E & F & G & H --> I[Salvataggio Prenotazione e Assegnazione Tavolo]

2. Inserimento e Modifica Prenotazione (/Serate/AggiungiPrenotazione)

La schermata di gestione prenotazione raccoglie tutti i dati necessari per consentire sia il calcolo dei corrispettivi sia la corretta disposizione in piantina.

Inserimento Nuova Prenotazione

┌────────────────────────────────────────────────────────────────────────┐
│ DETTAGLI PRENOTAZIONE                                                  │
├──────────────────────────┬─────────────────────────────────────────────┤
│ Nome Referente *         │ Cognome e Nome del capogruppo               │
│ Numero di Telefono *     │ Recapito cellulare per notifiche e storico  │
│ Numero Adulti *          │ Numero di persone con quota adulto          │
│ Numero Bambini           │ Numero di persone con quota ridotta         │
├──────────────────────────┴─────────────────────────────────────────────┤
│ ATTREZZATURE SPECIALI E SPAZI INGOMBRANTI                              │
├──────────────────────────┬─────────────────────────────────────────────┤
│ Seggioloni               │ Richiesta seggiolone al tavolo (0 - N)      │
│ Passeggini               │ Ingombro a bordo tavolo / corsia (0 - N)    │
├──────────────────────────┴─────────────────────────────────────────────┤
│ ASSEGNAZIONE E PREFERENZE                                              │
├──────────────────────────┬─────────────────────────────────────────────┤
│ Preferenza Tavolo        │ Numero tavolo specifico desiderato          │
│ Vicino al Gruppo         │ Selezione automatica altri gruppi amici     │
│ Asporto                  │ Flag per ordini da ritirare senza tavolo    │
├──────────────────────────┴─────────────────────────────────────────────┤
│ PRE-ASSEGNAZIONE SCONTI CONVENZIONATI                                  │
├────────────────────────────────────────────────────────────────────────┤
│ [✓] Staff Sagra (-10€)   [ ] Volontari (-5€)   [ ] Bambino O-3 (0€)    │
└────────────────────────────────────────────────────────────────────────┘

Specifica dei Campi

Parametro Tipo Dato Obbligatorio Descrizione e Vincoli
Nome Referente Testo (max 200) Sì Nominativo del capogruppo. Utilizzato nelle ricerche rapide di cassa e stampato sullo scontrino.
Telefono Testo (max 50) Sì Numero di cellulare. Usato per l'invio del promemoria WhatsApp e per l'interrogazione dello storico cliente cross-serata.
Adulti Intero (≥ 0) Sì Numero di ospiti adulti paganti la tariffa intera stabilita nel listino serata.
Bambini Intero (≥ 0) No (default 0) Numero di bambini paganti la tariffa ridotta.
Seggioloni Intero (≥ 0) No (default 0) Richiesta di seggioloni fisici per bambini piccoli. Occupa un posto al tavolo.
Passeggini Intero (≥ 0) No (default 0) Ingombro di passeggini o carrozzine a bordo tavolo. Rilevante per non bloccare le corsie di servizio dei camerieri.
Preferenza Tavolo Intero No Numero esplicito del tavolo richiesto dal cliente. L'algoritmo di allocazione rispetterà prioritariamente questo vincolo.
Vicinanza Gruppi Elenco stringhe No Nominativi di altri referenti con cui il gruppo desidera sedere vicino.
Sconti Pre-assegnati Array JSON No Tipologie di sconto convenzionato associate a monte della serata.
Importo Personalizzato Decimale (€) No Se valorizzato, sostituisce il calcolo standard (Adulti * PrezzoAdulto) + (Bambini * PrezzoBambino).

3. Gestione Attrezzature Speciali: Seggioloni e Passeggini

Durante manifestazioni gastronomiche e sagre popolari, l'ingombro di passeggini e la necessità di seggioloni possono congestionare i passaggi tra i tavoli se non previsti in anticipo.

     ┌───────────────────────────────────────────────┐
     │ TAVOLO 12 (Capienza: 8 Posti)                 │
     ├───────────────────────────────────────────────┤
     │  [Ad]   [Ad]   [Ad]   [Seggiolone]            │
     │  ┌──────────────────────────────┐             │
     │  │                              │ [Passeggino]│  <-- Ingombro esterno
     │  └──────────────────────────────┘             │
     │  [Ad]   [Ad]   [Bambino] [Ad]                 │
     └───────────────────────────────────────────────┘
  1. Seggioloni:
    • Ciascun seggiolone impegna fisicamente una seduta del tavolo.
    • Nella schermata Gestione Tavoli e sulla piantina visuale, i tavoli con seggioloni mostrano un'icona dedicata per consentire ai camerieri di predisporre il seggiolone prima dell'apertura dei cancelli.
  2. Passeggini:
    • I passeggini non consumano una sedia formale ma richiedono spazio perimetrale libero. L'algoritmo predilige assegnare le prenotazioni con passeggini a capotavola o su tavoli posizionati lungo i corridoi perimetrali della sala.

4. Preferenze di Tavolo e Sincronizzazione Bidirezionale

Quando una comitiva si iscrive separatamente (es. Famiglia Rossi e Famiglia Bianchi che vogliono mangiare insieme):

  1. Nel campo Vicino a, l'operatore seleziona il nominativo dell'altra prenotazione.
  2. Il sistema esegue una sincronizzazione bidirezionale automatica:
    • Se Rossi indica che desidera sedere vicino a Bianchi, il motore inserisce automaticamente Rossi tra le preferenze di Bianchi.
    • Se la preferenza viene cancellata su uno dei due gruppi, la sincronizzazione provvede ad aggiornare simmetricamente anche la prenotazione collegata.
  3. L'algoritmo automatico di allocazione analizzerà i due gruppi considerandoli come un blocco logico unico, assegnandoli allo stesso tavolo o a tavoli fisicamente contigui.

5. Pre-assegnazione Bottoni Sconto (Issue 51)

In molte manifestazioni le agevolazioni (sponsor, organizzatori, tesserati o omaggi) vengono concordate già all'atto della prenotazione telefonica o via email.

┌────────────────────────────────────────────────────────┐
│ PRE-ASSEGNAZIONE SCONTO                                │
├────────────────────────────────────────────────────────┤
│ Inserimento Prenotazione:                              │
│   Selezionato: [✓ Staff Sagra - €10.00]               │
│                        │                               │
│                        ▼ salvataggio su DB             │
│   Prenotazione.ScontiPreassegnatiJson =                │
│   '["Staff Sagra"]'                                   │
│                        │                               │
│                        ▼ apertura in cassa             │
│ Schermata Cassa Rapida:                                │
│   Il pulsante "Staff Sagra" risulta GIÀ ATTIVO         │
│   ed il subtotale è immediatamente scontato!           │
└────────────────────────────────────────────────────────┘
  • Gli sconti configurati per la serata vengono mostrati con checkbox selezionabili.
  • All'arrivo della persona in cassa rapida, il cassiere non deve cercare manualmente la convenzione o ricordare l'accordo preso: il pulsante dello sconto risulterà già evidenziato e calcolato nel subtotale.
  • L'operatore di cassa mantiene comunque la facoltà di deselezionare lo sconto qualora la persona non esibisca il tesserino o titolo richiesto.

6. Motore Storico Cliente (Issue 48)

Il motore di Storico Cliente analizza il comportamento pregresso del cliente attraverso il suo recapito telefonico, interrogando l'intero database storico delle edizioni precedenti e delle serate archiviate.

flowchart LR
    A[Digitazione Numero di Telefono] --> B[Normalizzazione: rimozione spazi, simboli e prefisso +39]
    B --> C[Ricerca su Prenotazioni Storiche AssegnaPosti]
    C --> D{Trovate Prenotazioni Precedenti?}
    D -- No --> E[Badge: Nuovo Cliente]
    D -- Sì --> F[Calcolo Indici di Affidabilità]
    F --> G[Disdette Passate]
    F --> H[No-Show / Assenze non comunicate]
    F --> I[Ritardi Abituali vs Orario Inizio]

Normalizzazione Numerica Intelligente

Il sistema pulisce automaticamente il numero eliminando caratteri non numerici (spazi, trattini, barre) e trattando uniformemente i numeri con o senza prefisso internazionale italiano (+39 o 0039).

Indicatori Rilevati dal Sistema

  1. Presenze Regolari: numero di serate a cui il cliente ha partecipato saldando regolarmente i coperti.
  2. Disdette Passate: conteggio delle prenotazioni cancellate in precedenza (Stato = Disdetta).
  3. No-Show Passati: prenotazioni per le quali il cliente non si è mai presentato senza avvisare (Stato = NoShow).
  4. Ritardi Abituali: se nelle serate passate l'orario della prima transazione di cassa ha superato di oltre 30 minuti l'orario nominale di inizio serata (Serata.OrarioInizio), il cliente viene contrassegnato con un avviso di potenziale ritardatario.

Avvisi in Cassa e Regia

Quando si apre una prenotazione con storico critico (più disdette o no-show passati), l'interfaccia evidenzia un banner arancione con il riassunto dell'affidabilità, consentendo al responsabile di confermare telefonicamente l'effettivo arrivo prima di bloccare posti pregiati.


7. Stati della Prenotazione e Blocco IsLocked

Ogni prenotazione attraversa diversi stati operativi:

┌────────────────────────────────────────────────────────┐
│ STATI PRENOTAZIONE                                     │
├───────────────────┬────────────────────────────────────┤
│ 1. Attiva         │ Gruppo confermato in attesa        │
│    (Stato = 0)    │ di arrivo e riscossione al varco   │
├───────────────────┼────────────────────────────────────┤
│ 2. Disdetta       │ Annullata prima dell'evento. Posti │
│    (Stato = 1)    │ immediatamente liberati in sala    │
├───────────────────┼────────────────────────────────────┤
│ 3. No-Show        │ Serata iniziata, cliente assente.  │
│    (Stato = 2)    │ Segnato tramite 'Segna Assenti'    │
└───────────────────┴────────────────────────────────────┘

Il Meccanismo di Protezione IsLocked

La proprietà IsLocked salvaguarda l'integrità delle disposizioni dei tavoli contro riscritture involontarie:

  • Quando si attiva:
    1. Automaticamente non appena viene emesso il primo pagamento o acconto in cassa.
    2. Quando il responsabile sposta manualmente il gruppo su un tavolo specifico tramite la pagina Gestisci Tavoli o il MapEditor.
  • Effetto:
    • Qualsiasi successiva esecuzione dell'algoritmo di assegnazione automatica dei posti salterà la prenotazione bloccata (IsLocked = true), garantendo che gli ospiti già seduti o con esigenze concordate non vengano mai spostati ad un altro tavolo.
    • Per modificare il tavolo di un gruppo bloccato è necessario l'intervento esplicito del responsabile con sblocco manuale (vedere Cambio Tavolo Imprevisto).