Modulo Serate & Hub Operativo¶
L'Hub Serata costituisce la cabina di regia principale di AssegnaPosti. Da questo cruscotto l'amministratore e i coordinatori possono inizializzare una nuova data dell'evento, governare i listini, accedere istantaneamente a tutte le postazioni operative (Cassa, Sala, Dashboard, Scanner) e chiudere l'evento con l'estrazione dei resoconti contabili e l'archiviazione storica.
1. Architettura del Modulo Serata¶
Il ciclo di vita di una serata all'interno del sistema connette tutte le aree operative e segue un flusso lineare e controllato:
flowchart TD
A[Elenco Serate /Serate/Index] -->|Crea o Modifica| B[Configurazione Serata /Serate/Edit]
B -->|Imposta Parametri e Listino| C[Hub Centrale Serata /Serate/Hub]
C --> D[Cassa Rapida /Serate/CassaRapida]
C --> E[Gestione Tavoli /Serate/GestisciTavoli]
C --> F[Editor Mappa Sala /Serate/MapEditor]
C --> G[Dashboard Monitor /Serate/Dashboard]
C --> H[Scanner Accessi /Serate/ScannerTavoli]
C --> I[Resoconto e Statistiche /Serate/ResocontoSerata]
I -->|Chiusura Contabile| J[Archiviazione Serata Archiviata=true]
J -->|Consultazione Storica| A
2. Hub della Serata (/Serate/Hub)¶
L'Hub è il punto di convergenza per tutti gli operatori abilitati (Admin e Cassiere). Si raggiunge selezionando una serata dall'elenco generale o cliccando sul logo/nome serata nella barra superiore di navigazione.

┌────────────────────────────────────────────────────────────────────────┐
│ HUB SERATA: Sabato Gastronomico - 12 Ottobre 2026 │
├────────────────────────────────────────────────────────────────────────┤
│ Data: 12/10/2026 | Orario Inizio: 19:30 | Servizio: Servito │
├───────────────────┬───────────────────┬────────────────────────────────┤
│ 🛒 CASSA RAPIDA │ 🪑 GESTIONE TAVOLI│ 🗺️ MAP EDITOR │
│ Apri postazione │ Assegna e controlla│ Disposizione grafica sala │
├───────────────────┼───────────────────┼────────────────────────────────┤
│ 📺 DASHBOARD REGIA│ 📷 SCANNER QR │ 📊 RESOCONTO INCASSI │
│ Monitor sala full │ Segna arrivi sala │ Quadratura e cassa contabile │
└───────────────────┴───────────────────┴────────────────────────────────┘
Strumenti e Collegamenti Rapidi Disponibili nell'Hub¶
| Sezione / Pulsante | Percorso Web | Ruoli Abilitati | Finalità Operativa |
|---|---|---|---|
| Cassa Rapida | /Serate/CassaRapida?serataId={id} |
Admin, Cassiere |
Riscossione quote, sconti, stampa scontrini ESC/POS e apertura cassetto. |
| Gestisci Tavoli | /Serate/GestisciTavoli?serataId={id} |
Admin, Cassiere |
Assegnazione posti, controllo capienza, rotazione e tavoli occupati. |
| MapEditor | /Serate/MapEditor?serataId={id} |
Admin |
Editor visuale 2D interattivo con coordinate e rotazione tavoli. |
| Dashboard Serata | /Serate/Dashboard?serataId={id} |
Tutti (AllowAnonymous) |
Schermo intero a dark theme con avanzamento arrivi e auto-refresh 15s. |
| Scanner Tavoli | /Serate/ScannerTavoli?serataId={id} |
Admin, Cassiere |
Lettura ottica da fotocamera smartphone/tablet dei QR sugli scontrini. |
| Resoconto Serata | /Serate/ResocontoSerata?serataId={id} |
Admin |
Statistiche incassi (Contanti/POS/Satispay), dettaglio sconti e storni. |
| Modifica Parametri | /Serate/Edit?id={id} |
Admin |
Modifica listino, orari, intestazioni scontrino e categorie sconto. |
| Archivia Serata | Azione POST (OnPostArchivia) |
Admin |
Sposta la serata nell'archivio storico chiudendo le modifiche di routine. |
3. Creazione e Configurazione Serata (/Serate/Edit)¶
La configurazione di una serata stabilisce le regole di business che governeranno i calcoli in cassa, l'algoritmo di allocazione tavoli e la stampa degli scontrini fiscali o di comanda.
Parametri di Configurazione¶
┌────────────────────────────────────────────────────────┐
│ IMPOSTAZIONI GENERALI │
├───────────────────────┬────────────────────────────────┤
│ Nome Serata │ Es. "Sagra del Fungo - Sabato" │
│ Data Evento │ Giorno di svolgimento │
│ Orario Inizio │ Orario nominale d'inizio cena │
│ Tipo di Servizio │ Servito al tavolo / Self-service│
│ Tipo di Menu │ Fisso a quota / Alla Carta │
├───────────────────────┴────────────────────────────────┤
│ LISTINO BASE │
├───────────────────────┬────────────────────────────────┤
│ Prezzo Adulto (€) │ Quota standard a persona │
│ Prezzo Bambino (€) │ Quota ridotta bambini │
├───────────────────────┴────────────────────────────────┤
│ DISPOSITIVI E INTESTAZIONI │
├───────────────────────┬────────────────────────────────┤
│ Stampa Scontrino │ Abilita/Disabilita invio comanda│
│ Intestazione 1 / 2 │ Dicitura fiscale / Nome Sagra │
│ Indirizzo / Telefono │ Recapiti stampati sullo scontr.│
└────────────────────────────────────────────────────────┘
Dettaglio dei Parametri¶
- Nome Serata: denominazione identificativa mostrata nel cruscotto e stampata a caratteri giganti nello scontrino cassa.
- Data e Orario Inizio: l'orario di inizio (es.
19:30) è fondamentale per il motore di intelligenza statistica: il sistema confronta l'orario della prima transazione con l'orario di inizio per calcolare automaticamente ritardi medi e identificare ritardatari. - Prezzo Adulto e Prezzo Bambino: quote di riferimento. Moltiplicate in tempo reale durante l'inserimento o la riscossione in cassa.
- Tipo Servizio:
Servito: attiva la logica di assegnazione tavoli, capienza posti, seggioloni e piantina sala.Self-service: disattiva l'obbligo di tavolo fisso; la Dashboard monitora direttamente i flussi di persone senza vincolo di mappa.
- Categorie Prezzo Extra (Pulsanti Sconto Rapidi JSON): consente di configurare categorie speciali (es. Bambino sotto i 3 anni: 0.00€, Staff Organizzativo: -10.00€, Volontario Pro Loco: 5.00€). Tali categorie vengono presentate come bottoni ad un click nella Cassa Rapida e possono essere pre-assegnate in fase di prenotazione.
Intestazioni Scontrino Personalizzate
Compilare attentamente i campi Intestazione 1, Intestazione 2, Indirizzo, Telefono e Indirizzo Email: queste informazioni vengono trasferite direttamente nella testata dello scontrino termico inviato alle stampanti ESC/POS.
4. Archiviazione e Ripristino Serate¶
Al termine della manifestazione, la serata viene chiusa per evitare modifiche involontarie ai dati storici di incasso e presenze.
┌───────────────────────────────────────────────────────────┐
│ STATI DELLA SERATA │
├───────────────────┬───────────────────────────────────────┤
│ Attiva │ Visibile nell'Hub principale, │
│ (Archiviata = false) aperta alle casse e alle prenotazioni│
├───────────────────┼───────────────────────────────────────┤
│ Archiviata │ Protetta in sola lettura, visibile │
│ (Archiviata = true) solo attivando il filtro 'Archiviate' │
└───────────────────┴───────────────────────────────────────┘
Procedura di Archiviazione¶
- Dall'Hub Serata o dalla pagina di riepilogo generale (
/Serate/Index), individuare la serata conclusa. - Cliccare sul pulsante Archivia Serata.
- Il sistema imposta la proprietà booleana
Archiviata = truenel database. - La serata viene nascosta dalla vista ordinaria dell'indice serate per mantenere pulita e focalizzata l'interfaccia degli operatori.
Consultazione e Ripristino di una Serata Archiviata¶
Se occorre consultare lo storico di una serata passata o riaprirla per apportare correzioni contabili:
1. Accedere a /Serate/Index.
2. Attivare il toggle Mostra Serate Archiviate.
3. La serata archiviata comparirà contrassegnata con un badge grigio Archiviata.
4. Per riattivarla completamente, cliccare su Ripristina Serata (OnPostRipristina): la serata tornerà immediatamente operativa con tutte le sue prenotazioni e transazioni intatte.
5. Resoconto Serata e Statistiche Globali (/Serate/ResocontoSerata)¶
Il modulo Resoconto Serata è il cuore della rendicontazione economica e operativa dell'evento. Raccoglie i flussi finanziari di tutti i punti cassa attivi, depura i dati da eventuali storni ed esegue la quadratura.

Indicatori Chiave e Statistiche¶
┌────────────────────────────────────────────────────────────────────────┐
│ QUADRO ECONOMICO E CONTABILE DELLA SERATA │
├───────────────────┬───────────────────┬────────────────────────────────┤
│ INCASSO TOTALE │ COPERTI TOTALI │ SCONTI TOTALI APPLICATI │
│ € 14.850,00 │ 742 persone │ € 420,00 (34 gruppi) │
├───────────────────┼───────────────────┼────────────────────────────────┤
│ CONTANTI CASSETTO │ CARTE / POS │ SATISPAY BUSINESS │
│ € 8.920,00 │ € 4.130,00 │ € 1.800,00 │
├───────────────────┼───────────────────┼────────────────────────────────┤
│ STORNI E RIMBORSI │ COPERTI ATTESI │ COPERTI MANCANTI / NO-SHOW │
│ € 120,00 (2 trans)│ 760 prenotati │ 18 assenti segnalati │
└───────────────────┴───────────────────┴────────────────────────────────┘
Sezioni del Resoconto¶
- Ripartizione per Metodo di Pagamento:
- Contanti: importo totale atteso all'interno dei cassetti rendiresto fisici.
- POS Bancario: totale delle transazioni elettroniche, da confrontare con lo scontrino di chiusura del terminale POS fisico (Totalizzatore POS).
- Satispay: volume delle transazioni transitate tramite il canale API / QR Satispay Business.
- Registro degli Storni e Annullamenti:
- Qualsiasi pagamento cancellato tramite la funzione di storno (
OnPostCancelPaymentAsync) viene escluso dai totali contabili per evitare duplicazioni, ma viene rigorosamente catalogato nella tabella Storni della Serata. - Vengono registrati: Data e ora dello storno, Importo restituito, Numero ricevuta originaria, Nome dell'operatore che ha autorizzato lo storno e Motivazione obbligatoria.
- Qualsiasi pagamento cancellato tramite la funzione di storno (
- Bilancio Presenze e Coperti:
- Calcolo esatto dei coperti:
Prenotati - Assenti (No-Show) = Effettivi a Tavolo. - Percentuale di occupazione della sala rispetto alla capienza massima teorica dei tavoli allestiti.
- Calcolo esatto dei coperti:
Esportazione e Archiviazione Fiscale
Dal Resoconto è possibile generare la stampa riassuntiva di chiusura cassa tramite la combinazione Ctrl + P. La stampa include le firme del cassiere e del responsabile di cassa per l'archiviazione cartacea del fondo cassa.