SAGRA-Manager

SAGRA-Manager è un ecosistema digitale enterprise riadattato per la frenesia delle Sagre Paesane. Il suo scopo è sradicare i vecchi blocchetti cartacei e l’inefficiente comunicazione verbale, digitalizzando e automatizzando l’intero ciclo vitale di un ordine: dalla Cassa, all’assegnazione del tavolo, fino agli schermi in Cucina e al vassoio del Cameriere.

Tutto si muove in tempo reale, senza mai richiedere una connessione Internet.

Architettura “Resilient & Offline-First”

Il cuore pulsante del sistema è stato ingegnerizzato per dominare scenari operativi dove la connessione alla rete esterna è inesistente o instabile (campi aperti, tensostrutture):

• Server Centralizzato LAN: Un unico PC server funge da Single Source of Truth. Tutti i dispositivi mobili dei volontari si collegano alla rete WiFi Locale senza mai uscire sul web. Nessun dato critico viene mai salvato sui singoli client.
• Motore Event-Driven e WebSocket: Il core backend, sviluppato in Node.js/Express con TypeScript, propaga istantaneamente e simultaneamente i cambi di stato (es. “Ordine #142 Pagato”) con latenze inferiori al secondo verso tutti inodi connessi tramite WebSocket.
• Macchina a Stati Rigida: Sotto il cofano, un database relazionale gestito via Prisma ORM assicura l’integrità del flusso di lavoro tracciando con precisione i 13 stati operativi di un ordine (Da pagare -> In Attesa -> Assegnato Tavolo -> In Preparazione -> Pronto -> Consegnato).

I Moduli del Sistema

L’infrastruttura è frammentata in micro-interfacce disegnate attorno al ruolo del volontario (Zero-Training Design):

1. Modulo Cassa & Finanze: Interfaccia touch per la rapida emissione di scontrini, gestione di varianti (“No Cipolla”, “Allergia Lattosio”) e sofisticati split-payment (divisione conto equa o per singolo piatto).
2. Sistema di Stampa Modulare: Routing intelligente TCP/USB dei ticket. Stampa dinamica e smistata: lo scontrino completo rimane in cassa, i ticket di preparazione viaggiano smembrati verso le diverse postazioni cucina (es: Griglia, Friggitoria), sopprimendo logiche inutili come “Asporto: Falso”.
3. Display Cucina (KDS): Schermi dedicati per ogni singola stazione. I cuochi visualizzano in base alle code solo ciò che è di loro competenza, con riepiloghi aggregati intuitivi.
4. Logistica di Sala: Moduli dedicati per gli Associatori (che legano rapidamente su tablet o lettore l’Ordine al Tavolo fisico scannerizzando il QR Code) e per i Camerieri (che compongono ritirando in stile mensa e chiamando il cliente).

SAGRA-Manager è la dimostrazione pratica di come pattern ingegneristici complessi possano risolvere in modo elegante sfide logistiche collaudate in ambienti ad alto stress.