Vai al contenuto

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 AssegnaPosti

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

  1. Dall'Hub Serata o dalla pagina di riepilogo generale (/Serate/Index), individuare la serata conclusa.
  2. Cliccare sul pulsante Archivia Serata.
  3. Il sistema imposta la proprietà booleana Archiviata = true nel database.
  4. 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.

Resoconto Serata ed Incassi

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

  1. 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.
  2. 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.
  3. 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.

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.