Guida completa versione 1.2

guida_gelato_ai_hub.md

Guida completa a Gelato AI Hub

Versione guida: 1.1 — Maggio 2026
Aggiornata per: Gelato AI Hub v1.2


Indice

  1. Introduzione
  2. Primi passi
  3. Gestione Ingredienti
  4. Gestione Ricette
  5. Calcolatore Brix
  6. Hub Allergeni
  7. Produzione
  8. Modulo Finanziario
  9. Fornitori
  10. Importazione Fatture
  11. Account e Abbonamento
  12. Impostazioni
  13. Domande frequenti (FAQ)

1. Introduzione

Cos’è Gelato AI Hub

Gelato AI Hub è l’app pensata per i gelatieri artigianali che vogliono unire la tradizione della gelateria alla precisione della tecnologia moderna. Con Gelato AI Hub puoi:

  • Creare e bilanciare ricette in modo scientifico, basandoti sui parametri PAC e POD
  • Gestire il tuo archivio di ingredienti con composizioni dettagliate, allergeni e prezzi
  • Tenere traccia dei costi di produzione — ingredienti, macchinari e manodopera
  • Analizzare i dati finanziari della tua gelateria con dashboard chiare e consigli AI
  • Generare etichette conformi al Reg. UE 1169/2011
  • Importare i prezzi direttamente dalle tue fatture elettroniche

L’app è disponibile su iPhone, iPad, Android e Web.


A chi è rivolto

Gelato AI Hub è stato progettato per:

  • Gelatieri artigianali che vogliono bilanciare le ricette con metodo scientifico
  • Laboratori che hanno bisogno di controllare i costi di produzione
  • Titolari che vogliono monitorare la redditività della gelateria

Non serve essere esperti di tecnologia: l’app guida passo dopo passo in ogni operazione.


Come leggere questa guida

  • Le funzioni contrassegnate con ⭐ Premium richiedono un abbonamento Professional o Advanced.
  • I riquadri 📝 Nota contengono informazioni utili ma non indispensabili.
  • I riquadri ⚠️ Attenzione segnalano azioni irreversibili o punti critici.
  • I segnaposto ![Screenshot: ...] indicano dove inserire le immagini prima della pubblicazione.

2. Primi passi

2.1 Scaricare e aprire l’app

Gelato AI Hub è disponibile su:

Schermata di benvenuto con logo Gelato AI Hub

2.2 Registrazione e accesso

Quando apri l’app per la prima volta, puoi scegliere tra due modalità:

Modalità Ospite (senza registrazione)

Puoi usare l’app subito, senza creare un account. I dati vengono salvati solo sul tuo dispositivo.

Limitazioni modalità Ospite:

  • Massimo 15 ingredienti
  • Massimo 3 ricette
  • Nessun accesso alle funzioni Premium
  • I dati non vengono sincronizzati su altri dispositivi

Account registrato

Con un account puoi:

  • Sincronizzare i dati su tutti i tuoi dispositivi
  • Salvare in cloud in modo sicuro
  • Accedere alle funzioni Premium (con abbonamento)

Per registrarti:

  1. Tocca Crea account
  2. Inserisci il tuo indirizzo email e una password
  3. Conferma la registrazione tramite il link ricevuto via email

Per accedere con un account esistente:

  1. Tocca Accedi
  2. Inserisci email e password
Schermata di accesso con opzioni registrazione e ospite

2.3 Panoramica dell’interfaccia

L’app è organizzata con una barra di navigazione in basso con quattro sezioni principali:

Icona Sezione Contenuto
🏠 Dashboard Panoramica e accessi rapidi
🧪 Ingredienti Archivio ingredienti
🍦 Ricette Archivio ricette
💰 Finanze Modulo finanziario (Premium)
Altro Strumenti aggiuntivi e impostazioni
Barra di navigazione principale con le quattro tab

2.4 Piani di abbonamento

Funzione Gratuito Professional Advanced
Ingredienti max 15 Illimitati Illimitati
Ricette max 3 Illimitate Illimitate
Bilanciamento PAC/POD
Esportazione PDF ricette
Macchinari e costi produzione
Modulo finanziario
Importazione fatture
Hub Allergeni
Fornitori
Crediti AI mensili 100 300
Analisi AI finanziaria

📝 Nota: Puoi passare da un piano all’altro in qualsiasi momento. Se esegui il downgrade, i tuoi dati restano accessibili in sola lettura per 7 giorni.


3. Gestione Ingredienti

3.1 Lista ingredienti

La scheda Ingredienti mostra l’elenco completo dei tuoi ingredienti.

Lista ingredienti con barra di ricerca e filtri

Funzioni disponibili:

  • Cerca per nome con la barra di ricerca in alto
  • Filtra per categoria (latticini, zuccheri, grassi, ecc.)
  • Ordina per nome o data di creazione
  • Tocca un ingrediente per vederne i dettagli
  • Scorri a sinistra su un ingrediente per eliminarlo

3.2 Creare un nuovo ingrediente

Tocca il pulsante + in alto a destra per aprire il modulo di creazione.

Modulo creazione ingrediente — sezione informazioni base

Informazioni base

Campo Descrizione
Nome Nome dell’ingrediente (obbligatorio)
Categoria Tipologia compositiva (es. Latticini, Zuccheri, Grassi…)
Funzione Ruolo nella ricetta (es. Base, Dolcificante, Stabilizzante…)
Unità di misura Grammi, ml, kg, litri
Allergeni Uno o più allergeni tra i 14 EU

3.3 Composizione dell’ingrediente

La composizione è il cuore di ogni ingrediente: definisce come si comporta nella ricetta.

Modulo composizione ingrediente con i campi percentuali
Campo Significato
Acqua % di acqua sull’ingrediente totale
Zuccheri totali % di zuccheri (tutti i tipi)
Grassi % di grassi
Proteine % di proteine
MSNF Solidi del latte non grassi (Milk Solids Non-Fat)
Lattosio % di lattosio
Altri solidi Fibre, minerali e altro

⚠️ Attenzione: La somma di tutti i componenti deve essere compresa tra 99% e 101%. L’app segnala automaticamente eventuali incongruenze.

PAC e POD

Due parametri fondamentali per il bilanciamento del gelato:

  • PAC (Potere Anti Congelante): indica quanto l’ingrediente abbassa il punto di congelamento. Più alto è il PAC, più morbido sarà il gelato.
  • POD (Potere Dolcificante): indica la percezione della dolcezza rispetto al saccarosio (riferimento: saccarosio = 100).

📝 Nota: Se non conosci i valori PAC e POD di un ingrediente, usa il pulsante Stima con AI — l’intelligenza artificiale calcolerà i valori approssimati dalla composizione indicata.


3.4 Dettaglio zuccheri (opzionale)

Per un bilanciamento ancora più preciso, puoi specificare la composizione dettagliata degli zuccheri:

  • Saccarosio
  • Destrosio
  • Fruttosio
  • Maltosio
  • Lattosio
  • Altri zuccheri

Questo livello di dettaglio è opzionale, ma consigliato per i dolcificanti speciali.


3.5 Prezzi e costo standard

Per calcolare il food cost delle ricette, imposta il costo standard dell’ingrediente (€/kg).

Sezione prezzi ingrediente con costo standard e ultimo prezzo fattura
  • Costo standard: inserito manualmente, usato come base di calcolo
  • Ultimo prezzo da fattura: aggiornato automaticamente se utilizzi l’importazione fatture

3.6 Stima AI della composizione ⭐ Premium

Se non disponi di tutti i dati compositivi, l’app può stimarli automaticamente tramite intelligenza artificiale.

  1. Inserisci il nome dell’ingrediente e i dati che conosci
  2. Tocca Stima con AI
  3. L’AI propone i valori mancanti con un livello di confidenza (Alto / Medio / Basso)
  4. Controlla i valori e conferma o modifica

📝 Nota: Questa funzione utilizza i crediti AI mensili del tuo piano.


3.7 Allergeni

Per ogni ingrediente puoi indicare uno o più allergeni tra i 14 allergeni EU:

Cereali contenenti glutine, Crostacei, Uova, Pesce, Arachidi, Soia, Latte, Frutta a guscio, Sedano, Senape, Semi di sesamo, Anidride solforosa e solfiti, Lupini, Molluschi.

Puoi aggiungere anche allergeni personalizzati per le esigenze specifiche della tua gelateria.


3.8 Pacchetti ingredienti

Per iniziare rapidamente, puoi installare i pacchetti ingredienti precaricati — collezioni di ingredienti comuni già con composizioni verificate.

  1. Vai su Ingredienti → Pacchetti
  2. Sfoglia i pacchetti disponibili
  3. Tocca Installa per aggiungere gli ingredienti al tuo archivio
Schermata pacchetti ingredienti

4. Gestione Ricette

4.1 Lista ricette

La scheda Ricette mostra l’elenco di tutte le tue ricette.

Lista ricette con indicatori di bilanciamento colorati

Ogni ricetta mostra:

  • Nome, categoria ed eventuale immagine
  • Stato di bilanciamento (verde = ottimale, giallo = da rivedere, rosso = sbilanciato)
  • Data di modifica

Funzioni disponibili:

  • Cerca per nome
  • Filtra per categoria, tipo, allergeni
  • Tocca una ricetta per aprirla
  • Selezione multipla — premi a lungo su una ricetta (oppure tocca il pulsante di selezione nella toolbar) per entrare in modalità multi-selezione
  • Con più ricette selezionate puoi: eliminare in blocco, esportare o generare il Cartello per tutti i gusti selezionati

4.2 Creare una nuova ricetta

Tocca + per aprire il modulo di creazione ricetta.

Modulo nuova ricetta — informazioni base

Informazioni base

Campo Opzioni
Nome Testo libero
Categoria Crema, Frutta, Sorbetto
Tipo Base crema, Cioccolato, Vegano, Senza lattosio, ecc.
Peso totale In grammi (default: 1000g)
Macchinario Multimacchina o Macchina combinata
Immagine Foto del gusto (dalla galleria o dalla fotocamera)
Note Testo libero per istruzioni di preparazione

Immagine della ricetta

Puoi aggiungere una foto al gusto toccando Aggiungi immagine nella scheda di modifica. L’immagine viene salvata su cloud e appare:

  • Nell’anteprima della lista ricette
  • Nel dettaglio della ricetta
  • Nel PDF del Cartello (opzionale)

Per rimuovere un’immagine esistente, tocca la foto e scegli Rimuovi immagine.

Modulo ricetta con campo immagine e anteprima foto

4.3 Aggiungere ingredienti

  1. Tocca Aggiungi ingrediente
  2. Cerca l’ingrediente desiderato
  3. Inserisci la quantità in grammi
  4. Tocca Conferma
Ricerca e aggiunta ingrediente nella ricetta Lista ingredienti nella ricetta

Puoi modificare l’ordine degli ingredienti trascinandoli o assegnando un numero d’ordine. Per ogni ingrediente vengono mostrati in tempo reale la percentuale sul totale e il contributo al food cost.


4.4 Sub-ricette (Basi di preparazione)

Le sub-ricette ti permettono di usare una preparazione (ad esempio una base di crema pasticcera) come ingrediente all’interno di un’altra ricetta.

  1. Crea la ricetta-base normalmente
  2. Nell’altra ricetta, tocca Aggiungi sub-ricetta
  3. Seleziona la ricetta-base dalla lista
  4. Inserisci la quantità

📝 Nota: Il bilanciamento della ricetta principale incorpora automaticamente la composizione della sub-ricetta.


4.5 Il sistema di bilanciamento

Man mano che aggiungi ingredienti, l’app calcola in tempo reale i parametri di bilanciamento.

Pannello di bilanciamento con indicatori colorati PAC, POD, grassi, zuccheri

Parametri monitorati

Parametro Significato
PAC totale Potere Anti Congelante della ricetta
POD totale Potere Dolcificante della ricetta
Grassi % Percentuale di grassi sul totale
Proteine % Percentuale di proteine
Zuccheri % Percentuale di zuccheri totali
Solidi totali % 100% meno l’acqua
MSNF % Solidi del latte non grassi
Temperatura di servizio Calcolata con la formula di Leighton

Indicatori visivi

  • 🟢 Verde — parametro nel range ottimale
  • 🟡 Giallo — parametro leggermente fuori range, attenzione
  • 🔴 Rosso — parametro significativamente sbilanciato

I range ottimali variano per categoria: crema, frutta e sorbetto hanno target differenti.


4.6 Consigli AI per il bilanciamento ⭐ Premium

Se la ricetta risulta sbilanciata, tocca Chiedi all’AI per ricevere suggerimenti personalizzati.

Schermata consigli AI con suggerimenti per la ricetta Schermata modifica con AI Schermata modifica con AI: risultato

L’AI analizza i parametri e propone:

  • Aggiustamenti alle quantità degli ingredienti esistenti
  • Ingredienti alternativi da considerare
  • Spiegazioni delle problematiche riscontrate

📝 Nota: Tra una richiesta e l’altra è previsto un breve intervallo di attesa. Questa funzione utilizza i crediti AI mensili del tuo piano.


4.7 Storico versioni

Ogni volta che salvi una ricetta con modifiche significative, puoi creare una nuova versione con note di modifica.

Storico versioni ricetta con lista cronologica

Funzioni disponibili:

  • Visualizza tutte le versioni precedenti
  • Ripristina qualsiasi versione passata
  • Confronta due versioni fianco a fianco
  • Aggiungi note di modifica per ogni versione

4.8 Passaggi di produzione e costi

Nella sezione Produzione della ricetta puoi definire i passaggi del processo produttivo.

Passaggi di produzione con macchinari e costi associati

Per ogni passaggio puoi specificare:

  • Titolo e istruzioni
  • Durata (minuti) e temperatura (°C)
  • Macchinario utilizzato (con calcolo automatico del costo)
  • Operazione manuale (con costo manodopera)

Il food cost totale della ricetta viene calcolato sommando:

  • Costo degli ingredienti
  • Costo di utilizzo dei macchinari
  • Costo della manodopera

4.9 Esportazione PDF e CSV ⭐ Premium

Puoi esportare ogni ricetta in formato:

  • PDF — scheda ricetta professionale con composizione, bilanciamento, passaggi e food cost
  • CSV — dati grezzi per elaborazioni in foglio di calcolo
Anteprima PDF ricetta

Per esportare: apri la ricetta → tocca l’icona di condivisione → scegli il formato.


4.10 Il Cartello ⭐ Premium

Il Cartello è l’etichetta degli ingredienti e allergeni conforme al Reg. UE 1169/2011, pensata per essere esposta in gelateria o allegata al prodotto.

Generazione cartello con lista ingredienti e allergeni Generazione cartello con lista ingredienti e allergeni

Come generare un cartello:

  1. Dalla lista ricette, attiva la selezione multipla (premi a lungo su una ricetta o usa il pulsante toolbar)
  2. Seleziona una o più ricette e tocca Genera Cartello
  3. Inserisci il nome del gusto e verifica i dati
  4. Spunta "Ho verificato la correttezza dei dati" per rimuovere il timbro BOZZA dal PDF stampato
  5. Esporta in PDF o DOCX

L’app consolida automaticamente tutti gli ingredienti e gli allergeni di tutte le ricette selezionate in un unico cartello.

Contenuto del cartello PDF:

  • Logo della tua gelateria (se caricato nel profilo)
  • Immagine del gusto (se presente nella ricetta)
  • Lista ingredienti consolidata in ordine decrescente di peso
  • Dichiarazione allergeni conforme al Reg. UE 1169/2011

📝 Nota: Il logo viene caricato dal tuo profilo (vedi sezione 12). Caricarlo una volta è sufficiente: apparirà automaticamente in tutti i cartelli futuri.


4.11 Duplicare una ricetta

Per creare una variante di una ricetta esistente:

  1. Premi a lungo sulla ricetta nella lista
  2. Tocca Duplica
  3. La copia viene creata con lo stesso nome seguito da "(copia)"
  4. Apri la copia e modifica ciò che desideri

5. Calcolatore Brix

Il Calcolatore Brix è uno strumento rapido per convertire i gradi Brix della frutta fresca nei valori PAC e POD corrispondenti.

Calcolatore Brix con campo input e risultato

Come si usa:

  1. Vai su Altro → Calcolatore Brix
  2. Inserisci i gradi Brix della frutta (misurati con un rifrattometro)
  3. L’app calcola automaticamente PAC e POD

Questo è particolarmente utile quando la frutta varia di zuccheri a seconda della stagione o della varietà.


6. Hub Allergeni ⭐ Premium

L’Hub Allergeni è il centro di controllo per la gestione degli allergeni della tua gelateria.

Hub allergeni con i 14 allergeni EU e filtri

Funzioni disponibili:

  • Visualizza tutti i 14 allergeni EU
  • Per ogni allergene, vedi quali ingredienti lo contengono
  • Per ogni allergene, vedi quali ricette sono interessate
  • Crea allergeni personalizzati per esigenze specifiche (es. "senza nichel")
  • Filtra le ricette per allergene specifico

Come accedere: Vai su Altro → Allergeni


7. Produzione ⭐ Premium

La sezione Produzione ti permette di configurare macchinari, operazioni manuali e modelli di produzione riutilizzabili.

Come accedere: Vai su Altro → Produzione


7.1 Macchinari

Configura ogni macchinario del tuo laboratorio con i costi reali di esercizio.

Lista macchinari con costo orario calcolato

Per ogni macchina puoi configurare:

Categoria Parametri
Ammortamento Prezzo di acquisto, vita utile (anni), valore residuo, ore annue di lavoro
Energia elettrica Potenza assorbita (kW) e tariffa (€/kWh)
Acqua Litri/ora e tariffa (€/m³)
Manutenzione Costo annuo di manutenzione (€)
Consumabili Costo annuo dei materiali di consumo (€)
Altro Altri costi annui

Il sistema calcola automaticamente il costo orario totale della macchina, che viene poi usato nelle ricette e nei report di produzione.

Modulo configurazione macchinario con i dettagli di costo

7.2 Operazioni manuali e costo manodopera

Le operazioni manuali sono attività del processo produttivo che richiedono lavoro umano (es. lavorazione a mano, tempera, stagionatura).

Lista operazioni manuali

Impostazione del costo della manodopera:

  1. Vai su Produzione → Costo Manodopera
  2. Inserisci il tuo costo orario (€/ora)
  3. Questo valore verrà applicato automaticamente a tutte le operazioni manuali

Puoi creare una libreria di operazioni riutilizzabili e assegnarle ai passaggi delle ricette.


7.3 Modelli di produzione

I modelli di produzione sono sequenze predefinite di macchinari e operazioni che puoi riutilizzare in più ricette.

Esempio: "Processo Gelato Standard" → Pastorizzatore (30 min) → Raffreddamento (15 min) → Mantecatrice (10 min)

Crea il modello una sola volta e applicalo a tutte le ricette che seguono lo stesso processo.


8. Modulo Finanziario ⭐ Premium

Il Modulo Finanziario ti permette di monitorare la redditività della tua gelateria. Tutti i dati finanziari sono crittografati e protetti da un PIN personale.

Come accedere: Tocca la tab Finanze nella barra di navigazione


8.1 Impostazione PIN e crittografia

Al primo accesso ti verrà chiesto di creare un PIN a 6 cifre per proteggere i tuoi dati finanziari.

Schermata impostazione PIN finanziario

⚠️ Attenzione: Il PIN non è recuperabile. Conservalo in un posto sicuro. I dati finanziari sono cifrati con crittografia AES-256-GCM e nessun altro, incluso il team di Gelato AI Hub, può accedervi.


8.2 Dashboard finanziaria

La dashboard mostra i principali indicatori economici per il periodo selezionato.

Dashboard finanziaria con KPI principali

Puoi navigare tra periodi: Giorno / Settimana / Mese

Indicatori principali:

  • Ricavi totali del periodo
  • Costo materie prime (ingredienti + macchinari + manodopera)
  • Margine di contribuzione = Ricavi − Costo materie prime
  • Spese fisse del periodo
  • Risultato operativo = Margine di contribuzione − Spese fisse

8.3 Registrazione ricavi giornalieri

Per ogni giorno di apertura, inserisci il totale delle vendite.

  1. Vai su Finanze → Ricavi
  2. Tocca Aggiungi ricavo
  3. Inserisci la data, l’importo e (opzionale) una nota
  4. Tocca Salva
Modulo inserimento ricavo giornaliero

8.4 Spese fisse

Le spese fisse sono i costi ricorrenti della tua gelateria (affitto, utenze, personale, ecc.).

Lista spese fisse con categorie e frequenza

Per aggiungere una spesa fissa:

  1. Vai su Finanze → Spese fisse → +
  2. Compila: nome, categoria, importo, frequenza
  3. Salva

Frequenze disponibili: Giornaliera, Settimanale, Mensile, Annuale

Il sistema converte automaticamente ogni spesa in costo giornaliero per includere il dato corretto nella dashboard.


8.5 Inserimento produzione

Ogni volta che produci un lotto di gelato, registra la produzione per ottenere il costo reale.

Modulo inserimento produzione con ricetta e kg prodotti

Come registrare una produzione:

  1. Vai su Finanze → Produzione → +
  2. Seleziona la ricetta prodotta
  3. Inserisci i kg prodotti
  4. Seleziona i macchinari utilizzati
  5. Il sistema calcola automaticamente il costo totale

Il costo viene suddiviso in:

  • Costo ingredienti (al prezzo standard o da fattura)
  • Costo macchinari (basato sul tempo di utilizzo)
  • Costo manodopera

8.6 Analisi scostamenti

La schermata Analisi Scostamenti confronta il costo effettivo degli ingredienti (da fattura importata) con il prezzo standard per ogni ricetta prodotta nel periodo.

Schermata analisi scostamenti prezzi per ricetta

Identifica facilmente:

  • Quali ricette hanno i maggiori scostamenti di costo
  • Se i prezzi degli ingredienti stanno aumentando nel tempo
  • Dove è possibile ottimizzare i costi

Esportazione PDF: Tocca l’icona PDF (🖨) nell’angolo in alto a destra per esportare il report. Il documento include:

  • Riepilogo periodo: kg prodotti totali, costo ingredienti effettivo e standard, scostamento totale (evidenziato in verde o arancione)
  • Tabella per ricetta: costo ingredienti effettivo e standard, macchinari, manodopera, totale e varianza (€ e %)

8.7 Analisi AI finanziaria ⭐ Advanced

Con il piano Advanced, puoi chiedere all’AI di analizzare i dati finanziari del periodo.

Schermata analisi AI finanziaria con consenso e risultati

L’AI elabora i dati in modo aggregato (i dati rimangono sempre cifrati sul tuo dispositivo) e produce un report con:

  • Punti di forza del periodo
  • Criticità identificate
  • Raccomandazioni prioritarie

📝 Nota: Prima di ogni analisi, ti viene chiesto un consenso esplicito. Nessun dato sensibile lascia il tuo dispositivo in forma leggibile.

Esportazione PDF: Dopo aver completato l’analisi, tocca l’icona PDF (🖨) nell’angolo in alto a destra. Il documento include il sommario, le tre sezioni dell’analisi (con intestazioni colorate), l’indice di confidenza e il disclaimer sull’uso del report come supporto decisionale.


9. Fornitori ⭐ Premium

Gestisci l’anagrafica dei tuoi fornitori e consulta i prodotti e prezzi importati dalle fatture.

Come accedere: Vai su Altro → Fornitori

Lista fornitori

Toccando un fornitore nella lista si apre la scheda dettaglio, divisa in due sezioni.


9.1 Info fornitore

Visualizza i dati anagrafici del fornitore in modalità lettura. Per modificarli tocca l’icona matita (✏️) nell’angolo in alto a destra.

Dati principali

Campo Descrizione
Nome Ragione sociale del fornitore
Categoria Tipo di fornitura (es. Latticini, Frutta, Additivi…)
P.IVA Partita IVA
Indirizzo Sede del fornitore
Telefono Numero principale
Email Email generale
Sito web Indirizzo web

Referente

Campo Descrizione
Nome referente Persona di riferimento per gli ordini
Telefono referente Contatto diretto
Email referente Email diretta
Scheda dettaglio fornitore con info e prodotti

9.2 Prodotti da fatture

La sezione Prodotti da fatture elenca tutti gli ingredienti del tuo archivio il cui ultimo prezzo è stato importato da quel fornitore. Per ogni prodotto vengono mostrati:

  • Nome ingrediente
  • Prezzo (€/kg) dell’ultima fattura importata
  • Data della fattura da cui proviene il prezzo

Nota: vengono mostrati solo i dati dell’ultima fattura importata per ciascun ingrediente. La sezione è vuota finché non importi almeno una fattura di quel fornitore.

Collegare un fornitore agli ingredienti tramite l’importazione fatture permette all’app di identificare automaticamente l’origine delle righe e di popolare questa sezione automaticamente.


10. Importazione Fatture ⭐ Premium

L’importazione fatture ti permette di aggiornare automaticamente i prezzi degli ingredienti direttamente dalle fatture dei tuoi fornitori.

Come accedere: Vai su Ingredienti → Importa fattura


10.1 Formati supportati

Formato Descrizione
XML FatturaPA in formato elettronico standard
P7M FatturaPA con firma digitale
PDF Fattura scansionata o digitale

10.2 Il processo di importazione

Schermata importazione fattura — selezione file

Step 1 — Carica la fattura

  1. Tocca Importa fattura
  2. Seleziona il file dal tuo dispositivo o dal cloud
  3. L’app analizza la fattura e ne estrae le righe

Step 2 — Analisi AI L’intelligenza artificiale confronta ogni riga della fattura con gli ingredienti del tuo archivio e propone un’associazione.

📝 Nota: Questa operazione utilizza 3 crediti AI dal tuo piano mensile.

Schermata revisione matching ingredienti da fattura

Step 3 — Revisione e conferma Per ogni riga della fattura:

  • Vedi l’associazione proposta dall’AI
  • Conferma, modifica o salta l’associazione
  • Puoi scegliere se aggiornare anche il costo standard dell’ingrediente

Step 4 — Applicazione Tocca Applica per aggiornare i prezzi. Il sistema salva:

  • Il prezzo da fattura (€/kg)
  • La data della fattura
  • Il nome del fornitore

11. Account e Abbonamento

11.1 Gestire il profilo

Vai su Altro → Impostazioni → Profilo per:

  • Modificare il nome e l’email
  • Cambiare la password
  • Visualizzare lo stato dell’abbonamento

11.2 Abbonarsi

Per accedere alle funzioni Premium:

  1. Vai su Altro → Abbonamento (oppure tocca il banner Premium quando lo vedi)
  2. Scegli il piano: Professional o Advanced
  3. Scegli la cadenza: mensile o annuale
  4. Completa il pagamento tramite App Store, Google Play o carta di credito (web)
Schermata paywall con confronto piani e prezzi

📝 Nota: L’abbonamento annuale offre un risparmio significativo rispetto al mensile.


11.3 Crediti AI

I crediti AI sono il numero di operazioni AI disponibili ogni mese. Si azzerano e si rinnovano automaticamente all’inizio di ogni periodo di abbonamento.

Piano Crediti mensili Utilizzo tipico
Gratuito 0
Professional 100 ~30 consigli ricetta + qualche fattura
Advanced 300 Uso intensivo di tutte le funzioni AI

Le operazioni AI consumano crediti:

  • Stima composizione ingrediente: 1 credito
  • Consigli bilanciamento ricetta: 1 credito
  • Importazione fattura: 3 crediti

11.4 Annullare l’abbonamento

Puoi annullare il rinnovo automatico in qualsiasi momento:

  • iOS: App Store → Il tuo account → Abbonamenti
  • Android: Play Store → Account → Abbonamenti
  • Web: Altro → Abbonamento → Gestisci abbonamento

Dopo la cancellazione, l’abbonamento rimane attivo fino alla scadenza del periodo già pagato.


12. Impostazioni

Vai su Altro → Impostazioni per configurare le preferenze dell’app.

Schermata impostazioni principali

Opzioni disponibili:

Impostazione Descrizione
Profilo Nome, email, password e logo gelateria
Tema Chiaro / Scuro / Sistema
Lingua Italiano (altre lingue in arrivo)
Esporta dati Backup di ingredienti e ricette
Importa dati Ripristino da backup
Elimina account Rimozione permanente di tutti i dati

Logo della gelateria

Dalla scheda Profilo puoi caricare il logo della tua gelateria toccando Carica logo.

Schermata profilo con sezione upload logo gelateria

Il logo viene salvato su cloud e incluso automaticamente in:

  • I PDF delle ricette esportati
  • I Cartelli allergeni generati

📝 Nota: Formati supportati: JPG e PNG. Per una resa ottimale usa un’immagine quadrata con sfondo trasparente o bianco.

⚠️ Attenzione: L’eliminazione dell’account è irreversibile. Tutti i dati vengono cancellati definitivamente.


13. Domande frequenti (FAQ)

Posso usare l’app senza connessione internet? Sì. I dati sono sincronizzati quando sei online, ma puoi consultare e modificare ricette e ingredienti anche offline. I dati verranno sincronizzati automaticamente alla prossima connessione.


Cosa succede se supero il limite di ingredienti del piano gratuito? Puoi visualizzare e modificare gli ingredienti esistenti, ma non puoi aggiungerne di nuovi finché non passi a un piano Premium o elimini alcuni ingredienti.


Posso recuperare una ricetta eliminata? No. L’eliminazione di una ricetta è definitiva. Prima di eliminare, considera di archiviare la ricetta: rimarrà nell’archivio senza occupare spazio nella lista principale.


Ho perso il PIN del modulo finanziario. Cosa faccio? Purtroppo non è possibile recuperare il PIN, poiché la chiave di crittografia è derivata dal PIN stesso e non è memorizzata da nessuna parte. Se hai perso il PIN, dovrai reimpostare il modulo finanziario (i dati finanziari precedenti andranno persi).


I miei dati sono al sicuro? Sì. I dati delle ricette sono protetti da Firebase con accesso esclusivo al tuo account. I dati finanziari sono ulteriormente protetti da crittografia AES-256-GCM con il tuo PIN personale. Le chiamate all’AI avvengono in modalità enterprise: i dati non vengono usati per addestrare i modelli.


Posso usare l’app su più dispositivi? Sì, con un account registrato i dati si sincronizzano su tutti i dispositivi associati al tuo account (fino a 5 dispositivi per il piano Professional e Advanced).


Come faccio ad aggiornare i prezzi degli ingredienti in blocco? Usa la funzione di importazione fatture: carica la fattura del fornitore e l’AI aggiorna automaticamente i prezzi di tutti gli ingredienti presenti nella fattura.


L’app funziona anche per granite e semifreddi? L’app supporta le categorie crema, frutta e sorbetto. Granite e semifreddi possono essere gestiti usando la categoria più vicina. Le categorie aggiuntive sono in programma per le prossime versioni.


Come contatto il supporto? Vai su Altro → Aiuto e supporto per accedere alle FAQ in-app, inviare una segnalazione o richiedere assistenza diretta.


Gelato AI Hub — L’app che porta la precisione in gelateria.


Nota per la pubblicazione: Sostituire tutti i segnaposto ![Screenshot: ...] con le immagini reali prima di pubblicare sul sito o generare il PDF. Le immagini devono essere salvate nella cartella docs/screenshots/. Per generare il PDF da questo file Markdown si consiglia Pandoc con un template personalizzato oppure uno strumento come Markdown to PDF.