Documentazione SagraGo

Introduzione

SagraGo è un gestionale offline-first per sagre e feste: cassa, comande, magazzino, menu QR e stampa termica in un unico sistema che gira sulla tua rete locale, anche senza internet. Questa documentazione è organizzata per ruolo: chi installa, chi sta in cassa, chi è in cucina.

Se è la prima volta, segui le tre sezioni di Iniziare nell'ordine. Puoi sempre provare tutto dal vivo nella demo online.

Installazione e primo avvio

SagraGo si installa sul computer che farà da server (un mini-PC o un normale PC Windows). Le altre postazioni — casse, cucina, tablet — vi si collegano via browser.

1. Copia la cartella di SagraGo sul PC server (di solito sul Desktop).
2. Avvia il programma con l'icona SagraGO (che lancia Avvia_Sagra.bat). Al primo avvio crea il database e apre la dashboard di amministrazione.
3. Inserisci la licenza: è legata all'hardware del server (HWID), quindi va attivata su quella macchina.
4. Lascia il programma aperto sul server per tutta la durata dell'evento: è lui a tenere insieme tutte le postazioni.

Collegare i dispositivi

Casse, cucina e tablet si collegano al server tramite il suo indirizzo IP sulla rete locale, nella forma http://192.168.1.x:3001. L'indirizzo esatto è mostrato nella dashboard (riquadro "Accesso Mobile") e nelle impostazioni.

• Collega tutti i dispositivi allo stesso router/rete del server (Wi-Fi o cavo).
• Sui tablet e smartphone apri il browser e digita l'indirizzo del server, oppure inquadra il QR mostrato in dashboard.
• Puoi installare SagraGo come app (PWA) dal browser per averlo a schermo intero.

Funzionamento offline

SagraGo non ha bisogno di internet. Il server crea una rete locale dove tutte le postazioni comunicano tra loro: gli ordini, le comande e gli incassi viaggiano sulla LAN, non sul cloud. Tutti gli elementi del programma (caratteri, icone, librerie) sono inclusi in locale, quindi funziona anche in piazza o al campo sportivo dove la linea manca.

Per approfondire perché conta, vedi la guida software per sagra senza internet.

Multicassa e sincronizzazione

Puoi aprire quante postazioni vuoi: ogni cassa collegata appare tra i terminali e gli ordini si sincronizzano in tempo reale tra tutte le postazioni. Il monitoraggio live in dashboard mostra ordini e incassi aggiornati istantaneamente.

La sincronizzazione avviene via WebSocket sulla rete locale: quando una cassa batte un ordine, le altre e la cucina lo vedono subito. La sezione Multicassa (Sync) in amministrazione elenca i terminali collegati.

Postazioni e ruoli

SagraGo ha tre interfacce principali, che apri dalla dashboard:

• POS Cassa — dove si battono gli ordini e si incassa.
• KDS Cucina — il monitor che mostra le comande da preparare.
• Admin / Dashboard — configurazione, prodotti, stampanti, report.

Ogni dispositivo può fare una cosa sola (una cassa, un monitor cucina) o più cose, a seconda di come lo apri.

Ciclo dell'ordine

1. Il cassiere batte l'ordine al POS e incassa.
2. SagraGo smista le righe ai reparti: il cibo va alla stampante/monitor della cucina, le bevande al bar.
3. La cucina vede la comanda sul KDS (o la riceve stampata) e prepara.
4. Quando è pronto, si segna "pronto"; se usi il ritiro, il cliente viene chiamato.
5. L'incasso è registrato e visibile in tempo reale nei report.

Architettura di stampa

Ogni reparto stampa solo ciò che lo riguarda. Assegni le categorie di prodotti alle stampanti (cibo → cucina, bevande → bar) e da lì le comande partono in automatico. SagraGo gestisce una coda per stampante con ritentativi: se una stampante è occupata, il lavoro riprova invece di perdersi.

Supporta stampanti termiche di rete (via IP:porta) e stampanti condivise di Windows. Vedi Stampanti di rete per la configurazione.

Prodotti e categorie

Dalla sezione Prodotti in amministrazione gestisci il menù.

Categorie

• Crea le categorie (es. Cibo, Bevande, Sgabei) e assegna a ognuna un colore: in cassa i pulsanti colorati fanno trovare il prodotto a colpo d'occhio.
• Riordina le categorie con le frecce per metterle nell'ordine che preferisci.

Prodotti

• Per ogni prodotto imposti nome, prezzo, categoria e (facoltativo) costo d'acquisto.
• Puoi riordinare i prodotti dentro la categoria.
• Allergeni: spunti i 14 allergeni UE (glutine, latte, uova…) direttamente sulla scheda prodotto. Compaiono in cassa, sul menu QR e sul menu stampabile.
• Soglia scorta minima: sotto questo valore il prodotto viene segnalato "in esaurimento" nel Magazzino. Lascia 0 per non ricevere avvisi.
• Il flag "solo magazzino" nasconde il prodotto dalla cassa: utile per voci che servono solo a scalare le scorte (es. impasto usato dalle ricette).

Magazzino e scorte

La sezione Magazzino tiene sotto controllo le scorte e ti avvisa quando qualcosa sta per finire.

• Avviso in cima: un banner elenca subito i prodotti esauriti e quelli in esaurimento (sotto la soglia minima impostata sul prodotto).
• Ricarica rapida: i pulsanti −1 / +1 / +10 aggiornano la scorta al volo, senza aprire finestre. Il tasto ∓ imposta un valore preciso.
• Ricerca e ordinamento: cerchi un prodotto per nome/categoria e ordini la lista A→Z, per categoria o per scorta crescente — comodo con menù lunghi.
• La colonna scorta è colorata: arancio = in esaurimento, rosso = finito.

Multi-prodotti (combo e ricette)

Un prodotto può essere composto da più componenti tramite una ricetta: ad esempio un "Menù panino" che scala 1 panino + 1 salsiccia dal magazzino, o diverse varianti di sgabeo che pescano tutte dallo stesso impasto. Imposti i componenti dalla scheda prodotto (Ricetta/Ingredienti).

• Per le combo il Magazzino non mostra una scorta propria (non avrebbe senso) ma quante se ne possono ancora realizzare dai componenti disponibili — es. "≈ 3 realizzabili".
• Se una combo è in esaurimento, viene indicato il componente che la limita ("manca: …"); il tooltip mostra tutta la composizione.
• La scorta delle combo si gestisce quindi sui componenti: appena rifornisci l'ingrediente, le combo realizzabili risalgono da sole.

Stampanti di rete

In Stampanti di Rete aggiungi e configuri le stampanti.

1. Aggiungi una stampante indicando l'indirizzo: IP:porta per le termiche di rete (es. 192.168.1.50:9100), oppure il percorso di una stampante condivisa di Windows (es. \\PC\stampante).
2. Assegna a ogni stampante i reparti/categorie di sua competenza (la cucina riceve il cibo, il bar le bevande).
3. Attiva il ritiro selettivo sulle stampanti che devono emettere i ticket di ritiro per il cliente.

La coda di stampa con ritentativi gestisce automaticamente le stampanti occupate. Per i dettagli pratici sulle comande vedi gestione comande.

Designer di stampa

Da Designer Stampa personalizzi l'aspetto di scontrino cliente, comanda cucina e ticket di ritiro, trascinando i blocchi (logo, intestazione, dati ordine, prodotti, totale, QR, piè di pagina).

• Anteprima dal vivo con 3 schede (Scontrino / Comanda / Ritiro): vedi subito il risultato mentre modifichi.
• Stampa di prova per ciascun tipo: mandi un esempio alla stampante per controllare resa e taglio prima della serata.
• Lo scontrino mostra prezzo unitario, subtotale/sconto, numero pezzi, metodo di pagamento con resto, operatore e numero progressivo. Opzione TOTALE in cornice e preset di stile.
• La comanda ha ora orario e numero grandi e leggibili; puoi (opzionale) raggruppare gli articoli per reparto e mostrare gli allergeni sotto ogni piatto.
• Il ticket di ritiro è ora personalizzabile come gli altri (nome reparto, numero grande, piè di pagina). Se non lo tocchi, resta il formato standard.
• Menu stampabile: dalla sezione Prodotti generi un menù/listino brandizzato pronto da appendere, con prezzi e legenda allergeni.

Report e chiusura

La sezione Report e Chiusura ti dà il quadro della serata:

• Incasso totale, numero ordini e scontrino medio.
• Incassi per metodo di pagamento (contanti, carta, voucher) e importo stornato.
• Prodotti più venduti con quantità e totali, con ricerca e ordinamento (più venduti, ricavo, A→Z).
• Riepilogo per cassa, per operatore e per reparto (categoria).
• Stampa del report di fine serata in formato A4 (salvabile anche in PDF) e chiusura di cassa.

Nello Storico Ordini puoi cliccare un ordine e rivederne lo scontrino completo, con nome cliente, tavolo e orario. Da qui l'amministratore può ristampare lo scontrino o (solo admin) ri-lanciare la comanda in cucina.

Impostazioni

Dalle Impostazioni (master) regoli il comportamento del sistema, ad esempio:

• Rendere nome cliente e tavolo obbligatori o facoltativi all'ordine.
• Scegliere la scheda di rete / l'IP del server.
• Altri flag operativi (le scelte vengono salvate e mantenute).

Cassa (POS)

Il POS è la schermata di vendita.

• Scegli la categoria (pulsanti a colori) e tocca i prodotti: il totale si aggiorna da solo.
• Il carrello mostra un contatore pezzi e scorre all'ultimo articolo aggiunto; sconti rapidi e dati cliente stanno in un pannello a scomparsa per lasciare più spazio alla lista quando gli articoli sono tanti.
• Nome cliente e tavolo si possono inserire/correggere anche nella schermata di pagamento, senza chiudere e riaprire.
• Controllo scorte prima di pagare: se un prodotto (o un suo ingrediente) è finito, la cassa lo segnala prima del pagamento indicando cosa manca.
• Pagamenti: contanti (con calcolo resto), carta (SumUp), voucher, tessera prepagata (cashless) e misto.
• Più lettori carte: puoi collegare più lettori SumUp, uno per cassa. Ogni postazione manda il pagamento al proprio lettore (Cassa 1 → suo lettore, Cassa 2 → il suo).
• Tasti rapidi: F12 apre il pagamento, Invio conferma, Esc chiude, Tab naviga i campi.
• Puoi ristampare lo scontrino e fare storni in caso di errore.

Pagamenti carta SumUp: configurazione semplice

• Rileva account: con la sola Chiave API, SagraGO compila da solo il Codice Commerciante e mostra il negozio — meno errori di battitura.
• Più lettori, uno per cassa: i lettori del tuo account SumUp compaiono già in elenco, con lo stato (pronto/scaduto), rinominabili (es. "Cassa 1", "Cassa 2"). Poi su ogni cassa scegli il suo lettore in Impostazioni locali.
• Diagnostica pagamenti: un tasto che controlla in pochi secondi chiave, commerciante, lettori e tunnel, con esito verde/rosso e cosa sistemare.
• Messaggi chiari: se il lettore è spento o senza rete, la cassa te lo dice con parole semplici; puoi sempre incassare in contanti.
• Ogni cassa può scegliere se stampare o no lo scontrino cliente.

Approfondimento: come evitare le code in cassa.

Cassa bar

Una postazione può funzionare come cassa bar mostrando solo alcuni prodotti (es. le bevande). La selezione dei prodotti visibili è per postazione: imposti su quel dispositivo quali categorie e prodotti mostrare, senza toccare le altre casse. Così il barista vede solo ciò che gli serve e va più veloce.

Cucina (KDS)

Il KDS (Kitchen Display System) è il monitor della cucina. Mostra gli ordini in arrivo con i prodotti da preparare; quando un piatto è pronto lo segni con un tocco e l'ordine avanza. È l'alternativa (o l'aggiunta) alla comanda stampata: niente fogli che si perdono o si bagnano.

Cashless (tessere prepagate)

Con il cashless il cliente ricarica una tessera (QR o codice) e poi consuma a ogni stand senza contanti: code più veloci e cassa più sicura.

• Ricarica la tessera in cassa per l'importo desiderato; il saldo è gestito lato server in modo sicuro (niente doppi addebiti).
• Al pagamento scegli Tessera e scansioni il QR o digiti il codice: l'importo viene scalato. Se il saldo non basta, l'ordine non parte.
• A fine sagra puoi rimborsare il residuo (attivabile/disattivabile dal Designer Stampa) e consultare i report del cashless con export CSV.

Ritiro

Se gestisci il ritiro al banco, SagraGo può stampare un ticket di ritiro per il cliente dalle stampanti che hai abilitato (vedi Stampanti). Il cliente attende la chiamata e ritira quando il suo numero è pronto, riducendo la ressa al bancone. Il layout del ticket è personalizzabile dal Designer di stampa.

Menu QR

SagraGo genera un menu QR collegato al gestionale: i clienti inquadrano il codice e consultano il menù dal telefono, sempre aggiornato. Se cambi un prezzo o segni un prodotto esaurito, il menu si aggiorna da solo. Vedi la pagina Menu QR.

Preordine online

Con il modulo Preordine online i clienti ordinano in anticipo dal telefono su una pagina web dedicata (eventi.sagrago.it/nome-sagra), anche da casa. Gli ordini arrivano direttamente nella coda della cassa, pronti da preparare e incassare.

1. Il preordine viaggia su un servizio cloud dedicato (relay), separato dal tuo gestionale: funziona anche se la tua rete di sagra è offline, e si sincronizza quando il server ha internet.
2. In cassa, i nuovi preordini compaiono con notifica sonora e badge: li apri con un clic e li completi come un ordine normale.
3. Attivazione e link/slug si configurano dal tuo fornitore (incluso nel piano Pro o come add-on).

La pagina evento pubblica

Ogni sagra ha una pagina web dedicata (eventi.sagrago.it/nome-sagra) che è insieme vetrina e menu. La personalizzi dall'amministrazione in Online (o dal pannello del tuo fornitore), senza competenze tecniche:

• Modalità vetrina: finché il preordine non è aperto, il menu si mostra senza prezzi con l'invito a ordinare allo stand. Quando apri il preordine, prezzi e pulsanti di ordinazione compaiono da soli. Puoi anche scegliere di mostrare sempre i prezzi con l'apposito interruttore ("Mostra i prezzi nel menu").
• Menu attivabile: puoi mostrare o nascondere del tutto il menu online dalla lista delle sezioni della pagina.
• Grafica: temi di colore pronti, categorie con i loro colori, foto ed eventuali descrizioni dei piatti. Il menu si legge bene su telefono e su desktop (griglia a più colonne).
• Ricerca e filtri: barra di ricerca, scorrimento rapido per categoria e filtri Vegetariano e "senza glutine / senza lattosio". I filtri compaiono quando contrassegni i piatti come vegetariani e indichi gli allergeni sulla scheda prodotto.
• Condividi e stampa: il cliente può condividere il menu su WhatsApp o scaricarlo in PDF con un tocco.
• Info stand, countdown e meteo: orari di apertura, indicazioni e parcheggio in evidenza in cima, stato Aperto/Chiuso automatico dagli orari, conto alla rovescia all'apertura e previsioni meteo dei giorni dell'evento.
• QR e statistiche: scarichi il QR della pagina da stampare; nel pannello vedi visite, scansioni QR e preordini della pagina.

Buoni Ritiro (voucher)

Dall'amministrazione puoi generare buoni ritiro stampabili con codice QR (es. per prevendite o convenzioni): imposti data e luogo e li stampi. Sono documenti cartacei, pensati per essere ritirati e consegnati allo stand.

Accesso rapido con PIN

Oltre a utente e password, ogni operatore può avere un PIN per accedere velocemente alla cassa durante la serata (utile con i cambi turno). Imposti il PIN in Gestione Utenti; l'operatore poi entra con "Accedi con PIN". Puoi anche collegare una nuova postazione inquadrando il QR in Rete & Terminali.

Assistenza remota

Se hai bisogno di aiuto, dall'amministrazione puoi segnalare un problema al team SagraGo (la richiesta arriva direttamente a noi con la versione e l'ID del tuo sistema). Durante l'assistenza:

• Puoi ricevere messaggi/avvisi a schermo dal supporto.
• Su tua autorizzazione, un tecnico può accedere da remoto al gestionale per aiutarti (con il tuo consenso e per sessioni temporanee).
• Serve internet sul server per queste funzioni; senza rete restano disponibili le funzioni offline abituali.

Aggiornamenti

All'apertura dell'amministrazione, SagraGo ti avvisa se è disponibile un aggiornamento. Gli aggiornamenti sono firmati e si applicano al riavvio del programma tramite il launcher. Tieni il server aggiornato tra un evento e l'altro, non durante la serata.

FAQ e risoluzione problemi

Le casse segnano "0 terminali" o non si sincronizzano

Quasi sempre è la rete: verifica che tutti i dispositivi siano sulla stessa rete del server e che l'IP usato sia quello giusto (vedi Collegare i dispositivi). Ricarica le postazioni dopo aver corretto l'indirizzo.

L'indirizzo IP sembra sbagliato

Se il PC server ha più schede di rete, in Impostazioni seleziona quella della rete delle casse (es. 192.168.1.x e non un'altra sottorete).

La stampante salta delle stampe

Controlla indirizzo e porta della stampante e che sia accesa e raggiungibile. La coda con ritentativi recupera le stampanti momentaneamente occupate; se una stampa non parte mai, è un problema di indirizzo o di rete.

Un ticket (spesso il ritiro) esce tagliato a metà

Succede su alcune termiche economiche col buffer piccolo quando c'è un logo: SagraGo invia i dati "a bande" con micro-pause per evitarlo. Se capita ancora, riduci l'altezza del logo o toglilo dal layout del ticket di ritiro nel Designer di stampa.

Il logo sullo scontrino esce distorto

È un limite di alcune termiche economiche: riduci l'altezza del logo nel Designer di stampa o disattivalo per quella stampante.

Il controllo pre-sagra segna una stampante offline che invece funziona

Alcune termiche di rete rispondono lente al primo tentativo. Il controllo ora attende più a lungo e ripete il test; se la stampa di prova funziona, la stampante è a posto.

Ho modificato le scorte ma la cassa non le vede

Ricarica la postazione: la sincronizzazione riparte e i valori si allineano.