Modulo Gestione Tavoli & Editor Mappa Sala¶
Il modulo Gestione Tavoli & Mappa Sala governa l'allocazione spaziale delle prenotazioni all'interno della struttura della manifestazione (sala interna, porticato o tendone gastronomico). Comprende sia la gestione tabellare dei posti (/Serate/GestisciTavoli), sia l'algoritmo euristico di Assegnazione Automatica, sia il potente MapEditor 2D (/Serate/MapEditor) per la composizione grafica della piantina.
1. Architettura della Sala e dei Tavoli¶
La struttura dei tavoli in AssegnaPosti unisce i dati di capienza fisica e le coordinate geometriche della piantina:
flowchart TD
subgraph Dimensionamento e Layout
A[Layout di Sala /Serate/MapEditor] -->|Definisce Griglia e Posizioni 2D| B[Elementi Tavolo: X, Y, W, H, Rotazione, Zona]
B -->|Assegna al Layout| C[Serata Attiva Serata.LayoutSalaId]
end
subgraph Allocazione Coperti
D[Prenotazioni Attive] --> E{Algoritmo Assegnazione Posti}
E -->|Considera Capienza e Vicinanze| F[Tavolo Fisico: Numero, PostiMax, Capotavola]
F --> G[Tavolo Occupato vs Posti Disponibili]
end
2. Gestisci Tavoli (/Serate/GestisciTavoli)¶
La schermata Gestisci Tavoli offre una panoramica tabellare e gestionale di tutta la sala, consentendo di monitorare in qualsiasi istante lo stato di riempimento:

┌────────────────────────────────────────────────────────────────────────┐
│ GESTIONE TAVOLI - Sabato Gastronomico │
├────────────────────────────────────────────────────────────────────────┤
│ Azioni Rapide: [ ⚡ Assegnazione Automatica ] [ ➕ Aggiungi Tavolo ] │
├────┬─────────┬──────────┬──────────┬─────────────┬─────────────────────┤
│ N° │ ZONA │ MAX POSTI│ OCCUPATI │ DISPONIBILI │ GRUPPI ASSEGNATI │
├────┼─────────┼──────────┼──────────┼─────────────┼─────────────────────┤
│ 1 │ Centrale│ 12 │ 10 │ 2 │ Rossi (6), Neri (4) │
│ 2 │ Centrale│ 12 │ 12 │ 0 (PIENO) │ Bianchi (12) [🔒] │
│ 3 │ Veranda │ 8 │ 6 │ 2 │ Verdi (6 + 1 segg.) │
│ 4 │ Veranda │ 8 │ 0 │ 8 (LIB)│ -- Disponibile -- │
└────┴─────────┴──────────┴──────────┴─────────────┴─────────────────────┘
Parametri del Tavolo Fisico¶
| Proprietà | Tipo Dato | Descrizione |
|---|---|---|
| Numero | Intero | Identificativo univoco del tavolo mostrato agli ospiti e stampato sugli scontrini. |
| PostiMax | Intero | Capienza massima nominale di sedute disponibili attorno al tavolo. |
| NumeroCapotavola | Intero | Numero di sedute posizionate all'estremità della tavolata (utili per seggioloni). |
| PostiOccupati | Calcolato | Somma dei coperti assegnati delle prenotazioni confermate (Adulti + Bambini - Assenti). |
| PostiDisponibili | Calcolato | Posti ancora liberi (PostiMax - PostiOccupati). Se negativo, il tavolo è in sovrannumero. |
| Zona | Testo | Settore di appartenenza (es. Sala Principale, Tendone Esterno, Veranda). |
3. Algoritmo di Assegnazione Automatica dei Posti¶
L'algoritmo di Assegnazione Automatica distribuisce le prenotazioni non ancora collocate, ottimizzando la capienza ed evitando frammentazioni di posti:
flowchart TD
A[Avvio Algoritmo Assegnazione] --> B[Caricamento Prenotazioni da Allocare]
B --> C{La prenotazione è IsLocked o Asporto?}
C -- Sì --> D[Ignora: Posto e Tavolo Salvaguardati]
C -- No --> E[Raggruppa Comitive con Preferenze di Vicinanza]
E --> F[Ordina Gruppi per Dimensione Decrescente]
F --> G[Cerca Tavolo Ottimale con Capienza Idonea]
G --> H{Preferenza Tavolo Esplicita?}
H -- Sì --> I[Assegna al Tavolo Richiesto se c'è spazio]
H -- No --> J[Assegna a Tavolo con minor spreco di posti]
I & J --> K[Salva Assegnazione e Aggiorna PostiOccupati]
Regole Euridistiche dell'Algoritmo¶
- Priorità ai Gruppi con Preferenza Esplicita: se un gruppo ha indicato un tavolo specifico (es. Tavolo 5), l'algoritmo tenta di posizionarlo prioritariamente su quel tavolo.
- Aggregazione Comitive Vicine: le prenotazioni con preferenze di vicinanza incrociate (es. Rossi e Bianchi) vengono trattate come una comitiva unificata, cercando di allocarle sullo stesso tavolo lungo o su due tavoli adiacenti della stessa zona.
- Ottimizzazione del Riempimento (Best Fit): i gruppi più numerosi vengono collocati per primi, minimizzando i posti vuoti isolati.
- Rispetto Assoluto del Blocco
IsLocked: qualsiasi prenotazione che abbia già registrato un pagamento o che sia stata spostata a mano con blocco attivo non viene mai toccata o modificata dall'elaborazione automatica.
4. Rotazione Tavolo (RotazioneTavolo)¶
Il concetto di Rotazione in AssegnaPosti copre due aspetti fondamentali:
┌────────────────────────────────────────────────────────┐
│ DUPLICE VALENZA DELLA ROTAZIONE TAVOLO │
├──────────────────────────┬─────────────────────────────┤
│ 1. Rotazione Geometrica │ Angolo (0° - 359°) per │
│ (MapEditor 2D) │ allineare i tavoli in sala │
├──────────────────────────┼─────────────────────────────┤
│ 2. Rotazione di Turno │ Gestione del secondo turno │
│ (Multi-turno Serata) │ su tavoli ad alta affluenza │
└──────────────────────────┴─────────────────────────────┘
- Rotazione Angolare Geometrica (
Rotazione):- Valore intero da
0a359memorizzato sull'entitàTavolo. - Consente di posizionare i tavoli in orizzontale (
0°), in verticale (90°) o con qualsiasi angolatura personalizzata per riflettere allestimenti a spina di pesce o a raggio all'interno di tendoni circolari o sale polivalenti.
- Valore intero da
- Rotazione di Turno Serale:
- Nelle manifestazioni ad alta intensità con due turni cena (es. 1° turno 19:30 - 21:15; 2° turno 21:30 - 23:00), consente di liberare il tavolo dopo che il primo gruppo ha concluso la consumazione e riassegnarlo ad un secondo gruppo.
5. MapEditor della Sala (/Serate/MapEditor)¶
Il MapEditor è l'ambiente grafico 2D che consente di disegnare fedelmente la piantina della sala, trascinando i tavoli con il mouse o con il touch.

┌────────────────────────────────────────────────────────────────────────┐
│ MAP EDITOR SALA: "Tendone Principale" [ Salva Mappa 💾 ]│
├────────────────────────────────────────────────────────────────────────┤
│ Zoom: [-][ 100% ][+] | Griglia: [ 1200 x 800 px ] | Snap to Grid: [✓] │
├────────────────────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────┐ ┌───────────────┐ │
│ │ TAVOLO 1 │ (0°) │ TAVOLO 2 │ (0°) │
│ │ 12 Posti │ │ 12 Posti │ │
│ └───────────────┘ └───────────────┘ │
│ │
│ ┌───────┐ ┌───────────┐ │
│ │ TAV 3 │ (90°) │ ZONA BAR │ │
│ │ 8 Pos │ │ E CASSA │ │
│ │ │ └───────────┘ │
│ └───────┘ │
│ │
│ [+ Aggiungi Tavolo] [Ruota Selezionato 90°] [Elimina Tavolo] │
└────────────────────────────────────────────────────────────────────────┘
Proprietà Geometriche Gestite dal MapEditor¶
- Top & Left: coordinate cartesiane $(X, Y)$ in pixel all'interno della griglia di sala.
- Width & Height: larghezza e altezza del tavolo in pixel. Un tavolo da 12 posti viene rappresentato graficamente più lungo rispetto a un tavolino da 4.
- Rotazione (Gradi): angolo di orientamento del tavolo (0° - 359°), con pulsanti di rotazione rapida a 90°.
- Dimensioni Griglia Sala: configurabile liberamente tra un minimo di
400 pxed un massimo di8000 px(MinGridSizeeMaxGridSize), per accogliere sia piccole taverne che enormi padiglioni fieristici. - Multi-Serata con Layout Condivisi (
LayoutSalaId):- È possibile creare template riutilizzabili (es. Layout Sagre Estive, Layout Sala Invernale).
- Una singola piantina può essere associata a serate diverse; modificando il layout, il sistema avvisa quante serate storiche o future utilizzano la stessa disposizione prima di confermare il salvataggio.
Verifica della Piantina da Tablet
Una volta disegnata la sala nel MapEditor, la piantina interattiva è visibile direttamente dalla Dashboard Serata e dallo Scanner Tavoli, offrendo ai camerieri la localizzazione visiva immediata di ogni tavolo.