Vai al contenuto

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 e Capienza

┌────────────────────────────────────────────────────────────────────────┐
│ 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

  1. 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.
  2. 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.
  3. Ottimizzazione del Riempimento (Best Fit): i gruppi più numerosi vengono collocati per primi, minimizzando i posti vuoti isolati.
  4. 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 │
└──────────────────────────┴─────────────────────────────┘
  1. Rotazione Angolare Geometrica (Rotazione):
    • Valore intero da 0 a 359 memorizzato 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.
  2. 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.

MapEditor Piantina Sala 2D

┌────────────────────────────────────────────────────────────────────────┐
│ 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 px ed un massimo di 8000 px (MinGridSize e MaxGridSize), 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.