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 e categoria.
• Puoi riordinare i prodotti dentro la categoria.
• Il flag "solo magazzino" nasconde il prodotto dalla cassa: utile per voci che servono solo a scalare le scorte (vedi sotto).

Magazzino e scorte

La sezione Magazzino tiene sotto controllo le scorte e ti avvisa quando un prodotto sta per finire. Più prodotti possono pescare da un'unica voce di magazzino condivisa: ad esempio diverse varianti di sgabeo che scalano tutte dallo stesso impasto. Imposti la voce condivisa e i prodotti collegati la consumano.

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 scontrini e comande: logo, intestazione, QR. Il logo viene stampato a inizio scontrino.

Report e chiusura

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

• Incasso totale, numero ordini e scontrino medio.
• Prodotti più venduti con quantità e totali.
• Riepilogo per cassa (quanto ha fatto ogni postazione).
• Stampa del report giornaliero e chiusura di cassa.

Nello Storico Ordini puoi cliccare un ordine e rivederne lo scontrino completo, con nome cliente e tavolo.

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.
• Aggiungi nome cliente e tavolo se richiesti.
• Applichi sconti rapidi (es. -10%, 3x2) prima del pagamento.
• Confermi il pagamento: parte lo scontrino e le comande ai reparti.
• Puoi ristampare l'ultimo scontrino e fare storni in caso di errore.

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.

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.

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.

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.

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.

Ho modificato le scorte ma la cassa non le vede

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