Configurazione Slot e Capacita Prenotazioni
Panoramica
Il servizio capacity gestisce la configurazione degli slot temporali per controllare il flusso delle prenotazioni e degli ordini. Ogni tenant puo definire fasce orarie di operativita, capacita massima per slot, tempo minimo di anticipo e finestra massima di prenotazione anticipata.
Fasce Orarie (Time Periods)
Le fasce orarie definiscono quando il ristorante accetta prenotazioni e quale capacita massima e disponibile per ciascuna fascia. A differenza di un orario unico di apertura/chiusura, il sistema supporta multiple fasce con capacita diverse.
Esempio di configurazione:
| Fascia | Orario Inizio | Orario Fine | Capacita |
|---|---|---|---|
| Pranzo | 11:30 | 14:30 | 15 |
| Pomeriggio | 15:00 | 18:00 | 5 |
| Cena | 19:00 | 23:00 | 20 |
La capacita indica il numero massimo di ordini o prenotazioni che il ristorante puo gestire contemporaneamente in quello slot. Questo valore si applica per slot di durata configurabile (default 15 minuti).
Configurare le Fasce
Dalla console di amministrazione, accedere a Capacita > Configurazione Slot:
- Definire le fasce orarie con orario inizio, orario fine e capacita
- Aggiungere piu fasce per coprire pranzo, cena e altri periodi
- Se non configurate, il sistema usa la fascia default 11:00-23:00 con capacita 10
Parametri di Configurazione
| Parametro | Default | Descrizione |
|---|---|---|
timePeriods | 11:00-23:00, cap. 10 | Array di fasce orarie con capacita |
baseSlotDuration | 15 minuti | Durata di ogni singolo slot (5-60 min) |
minLeadTime | 30 minuti | Anticipo minimo per prenotare |
maxAdvanceDays | 7 giorni | Giorni massimi di anticipo prenotazione |
allowCapacityOverride | true | Consente forzatura superamento capacita |
Durata Slot
La baseSlotDuration determina la granularita del calendario prenotazioni. Con slot da 15 minuti, la fascia 19:00-23:00 genera 16 slot individuali. Ogni slot ha la propria capacita disponibile calcolata sottraendo le prenotazioni gia confermate.
Anticipo e Finestra
- minLeadTime: impedisce prenotazioni troppo ravvicinate. Con 30 minuti di anticipo, una prenotazione per le 20:00 deve essere effettuata entro le 19:30
- maxAdvanceDays: limita quanto in anticipo e possibile prenotare. Con 7 giorni, non si possono fare prenotazioni per la settimana successiva alla corrente
Verifica Disponibilita
Il sistema verifica automaticamente la disponibilita incrociando:
- Tavoli attivi con capacita sufficiente per il numero di persone richiesto
- Prenotazioni esistenti nella stessa fascia oraria (considerando la durata media del pasto, default 90 minuti)
- Sovrapposizione temporale: due prenotazioni si sovrappongono se la fascia dell'una interseca quella dell'altra
La verifica restituisce i tavoli disponibili ordinati per capacita crescente (per assegnare il tavolo piu adatto), la capacita totale disponibile e la fascia temporale calcolata.
Forzatura Capacita
Se allowCapacityOverride e abilitato, un operatore con permessi adeguati puo accettare prenotazioni anche quando la capacita dello slot e esaurita. Il sistema registra la forzatura e puo generare un alert. Questa funzione e utile per gestire situazioni eccezionali senza bloccare il servizio.
Categorie di Produzione
Oltre alla capacita per prenotazioni, il servizio gestisce categorie di produzione (forno, friggitrice, griglia). Ogni categoria ha una propria capacita indipendente che controlla il flusso degli ordini verso la cucina. Questo evita che la cucina riceva piu ordini di quanti ne possa preparare simultaneamente.
FAQ
D: Come imposto orari diversi per giorni diversi della settimana? R: Attualmente le fasce orarie si applicano uniformemente a tutti i giorni. Per differenziare pranzo/cena e sufficiente creare fasce separate. Il supporto per orari settimanali differenziati e previsto in un aggiornamento futuro.
D: Cosa succede se riduco la capacita quando ci sono gia prenotazioni? R: Le prenotazioni esistenti non vengono annullate. La nuova capacita si applica solo alle prenotazioni future. Potrebbe verificarsi un overbooking sugli slot gia pieni.
D: Il lock temporaneo dello slot e diverso dal lock del tavolo? R: Si. Il lock dello slot (via Redis, TTL 5 minuti) riserva temporaneamente la capacita durante il processo di prenotazione. Il lock del tavolo impedisce a piu operatori di servire lo stesso tavolo.
Vedi Anche
- Prenotazioni -- Creare e gestire prenotazioni
- Configurazione Sale e Tavoli -- Impostazione sale e disposizione
- API Tavoli e Prenotazioni -- Endpoint API