Guida a SpesaFast

1 Cos'è SpesaFast

SpesaFast è un'app Android pensata per velocizzare la spesa al supermercato. Si usa in tre passaggi: si tengono le proprie liste della spesa, si disegna la mappa di uno o più supermercati con gli scaffali e le categorie di prodotto che contengono, e quando si va a fare la spesa l'app calcola un percorso ordinato che permette di passare una sola volta da ogni scaffale necessario, nell'ordine più breve.

I prodotti aggiunti a una lista vengono classificati automaticamente nella categoria giusta (es. "Latticini", "Ortofrutta") da un dizionario interno che impara dalle correzioni dell'utente; facoltativamente, questo dizionario può essere affiancato da un motore di intelligenza artificiale per i prodotti che non riconosce (vedi la sezione 4).

Tutti i dati — liste, supermercati, categorie — restano salvati sul telefono. Un backup facoltativo su Google Drive permette di conservarli o spostarli su un altro dispositivo (vedi l'informativa sulla privacy).

2 Le sezioni dell'app

L'app è organizzata in cinque schede, in basso:

2.1 🛒 Spesa

La schermata iniziale. Si scelgono la lista e il supermercato da usare, poi si tocca "Inizia la spesa" per avviare il percorso. Durante la spesa, una mini-mappa in alto mostra dove ci si trova e quale scaffale raggiungere; i prodotti vengono spuntati come "presi" uno a uno. Se una spesa è già in corso, questa scheda mostra un banner per riprenderla o concluderla; l'icona della scheda cambia per segnalarlo.

Se un prodotto è finito nella categoria sbagliata (e quindi nello scaffale sbagliato), si può correggerlo al volo toccando il pulsante 🏷 sulla sua riga: si apre il selettore di categoria e, tornando indietro, il percorso viene ricalcolato. Questa correzione vale solo per la spesa in corso e non modifica il dizionario di classificazione.

2.2 📋 Liste

Elenco delle liste della spesa. Si crea una lista, le si danno un nome e si aggiungono i prodotti: digitando il nome, l'app suggerisce prodotti già usati in passato e li assegna automaticamente alla categoria corretta. Da qui si può anche avviare direttamente la spesa per una lista specifica.

Oltre a digitare i prodotti uno a uno, dentro una lista sono disponibili due scorciatoie:

• 🎤 Dettatura: si pronuncia a voce l'elenco dei prodotti (es. "latte, pane, pomodori") e l'app li riconosce singolarmente.
• 📷 Importa da foto: si scatta una foto o si scegli un'immagine già salvata (es. una lista scritta a mano o fotografata su un foglio) e l'app ne legge il testo per estrarne i prodotti.

In entrambi i casi i prodotti riconosciuti vengono mostrati in un elenco di revisione, dove si può deselezionare quelli non voluti prima di confermarli: nessun prodotto viene aggiunto automaticamente senza conferma. Queste due funzioni richiedono che sia configurato almeno un motore di intelligenza artificiale (sezione 4), perché serve a interpretare la frase pronunciata o il testo letto nella foto.

Se la categoria assegnata a un prodotto non è quella giusta, si può cambiarla toccando ⋮ sulla sua riga → Categoria: nella schermata che si apre, se è configurato un motore AI, compare anche un pulsante ✨ Suggerisci un'alternativa che chiede al motore una categoria diversa compatibile col prodotto (si può toccare più volte per ottenere altri suggerimenti). A differenza della correzione fatta durante la spesa (sezione 2.1), una scelta fatta da qui viene anche imparata come regola nel dizionario, così la prossima volta il prodotto verrà classificato subito nel modo corretto.

2.3 🏬 Supermercati

Elenco dei supermercati salvati. Toccando un supermercato si apre la sua pagina con tre pulsanti: Modifica (nome e indirizzo), Scaffali (elenco degli scaffali e delle categorie che contengono) e Mappa (disposizione fisica degli scaffali sulla pianta del negozio). La guida completa è nella sezione 3.

2.4 🏷️ Categorie

L'albero delle categorie di prodotto usate dall'app (es. macro-categoria "Latticini" con le sotto-categorie "Latte", "Formaggi", ecc.). Si possono creare nuove categorie, rinominarle, cambiarne l'icona o il colore. Sono le stesse categorie che si assegnano agli scaffali di un supermercato.

2.5 🛠️ Utilità

Pagina di impostazioni e strumenti, divisa in blocchi:

• Backup e strumenti: esporta/importa tutti i dati in un file (per conservarli o spostarli manualmente) e consulta il dizionario di classificazione.
• Backup su Google Drive: accesso facoltativo con un account Google per salvare e ripristinare un backup completo (vedi l'informativa sulla privacy).
• Lingua e tema: italiano/inglese e chiaro/scuro/automatico.
• Classificazione AI: dove si collegano, in modo facoltativo, i motori di intelligenza artificiale usati come aiuto per classificare i prodotti che il dizionario interno non riconosce (vedi la sezione 4).

3 Configurare un supermercato con i suoi scaffali

Per ottenere un percorso utile, un supermercato va impostato una sola volta: si crea, si definiscono gli scaffali con le categorie che contengono, poi (facoltativo ma consigliato) si dispongono sulla mappa.

3.1 Creare il supermercato

Nella scheda Supermercati, tocca il pulsante ＋ in basso e dai un nome al negozio (es. "Esselunga Via Roma"). Indirizzo e note sono facoltativi e si inseriscono poi da "Modifica".

3.2 Aggiungere gli scaffali e assegnare le categorie

Apri il supermercato e tocca Scaffali. Con ＋ si aggiunge uno scaffale (es. "Latticini", "Surgelati", "Casse"): il nome è libero, serve solo a riconoscerlo sulla mappa.

Per ogni scaffale si toccano le sue categorie: si scelgono una o più categorie di prodotto tra quelle definite nella scheda Categorie (es. lo scaffale "Latticini" conterrà le categorie "Latte", "Formaggi", "Yogurt"). Quando un prodotto di una di quelle categorie è in lista, l'app saprà che si trova su quello scaffale.

Uno scaffale può anche avere categorie diverse sui suoi quattro lati (Alto/Destra/Basso/Sinistra), utile per uno scaffale a doppia faccia accessibile da corsie diverse; per la maggior parte dei casi basta assegnare le categorie al lato "Tutto".

3.3 Disporre gli scaffali sulla mappa

Dalla pagina del supermercato tocca Mappa. Si apre in sola lettura, per evitare di spostare qualcosa per sbaglio mentre la si consulta: tocca 🔒 Modifica in alto per attivare la modifica (un pulsante Chiudi la disattiva di nuovo).

In modifica, si vede una griglia che rappresenta la pianta del negozio: toccando una cella vuota si piazza lì uno scaffale non ancora posizionato (o si usa "Auto-disponi" per sistemarli tutti in automatico come punto di partenza). Toccando uno scaffale già piazzato compaiono i comandi per spostarlo, ridimensionarlo o modificarlo (rinominarlo, cambiarne le categorie, rimuoverlo dalla mappa). I pulsanti 🔍−/🔍+ regolano lo zoom (disponibili anche in sola lettura); Col±/Riga± cambiano le dimensioni della griglia.

Per far calcolare all'app un percorso realistico, posiziona anche i due riferimenti speciali con i pulsanti 🚪 (ingresso) e 💳 (casse) — bastano una volta, nella posizione corretta rispetto agli scaffali.

La mappa è facoltativa: senza di essa l'app propone comunque un ordine di visita degli scaffali, semplicemente senza disegnare un percorso passo-passo sulla pianta.

3.4 Verificare il risultato

Per controllare che tutto sia impostato correttamente, vai nella scheda Spesa, scegli una lista di prova e il supermercato appena configurato, poi avvia la spesa: la mini-mappa in alto deve mostrare un percorso che collega gli scaffali giusti nell'ordine giusto.

4 Collegare un motore di intelligenza artificiale (facoltativo)

Il dizionario interno dell'app riconosce da solo la maggior parte dei prodotti comuni e impara dalle correzioni. Per i prodotti che non riconosce, si può collegare — gratuitamente — uno o più motori di intelligenza artificiale esterni che suggeriscono la categoria giusta. Non è necessario per usare l'app: è un aiuto in più.

Si configurano dalla scheda Utilità → Classificazione AI, inserendo una "chiave API" (una stringa di caratteri che identifica il proprio account sul servizio) nell'apposito campo e toccando Salva. Il pulsante Test verifica subito che la chiave funzioni. Se è configurato più di un motore, l'app li prova nell'ordine Aigway → Gemini → Groq, passando al successivo solo se il precedente non è disponibile o non trova una categoria.

4.1 Generare una chiave API Gemini (Google AI)

1. Apri aistudio.google.com/app/apikey dal browser del telefono o del computer.
2. Accedi con un account Google (lo stesso o un altro, non è legato all'account usato per il backup su Drive).
3. Tocca Create API key (o "Crea chiave API"), scegli o crea un progetto quando richiesto.
4. Copia la chiave generata (una stringa che inizia con AIza…).
5. In SpesaFast: Utilità → Classificazione AI → Gemini → Chiave API, incollala e tocca Salva, poi Test per verificare.

Il livello gratuito di Gemini ha un limite di richieste giornaliere più che sufficiente per l'uso personale dell'app; non richiede una carta di credito.

4.2 Generare una chiave API Groq

1. Apri console.groq.com dal browser e crea un account gratuito (o accedi con un account Google/GitHub già esistente).
2. Nel menu laterale apri API Keys.
3. Tocca Create API Key, dai un nome a piacere alla chiave (es. "SpesaFast") e confermala.
4. Copia subito la chiave mostrata: Groq la mostra per intero una sola volta.
5. In SpesaFast: Utilità → Classificazione AI → Groq → Chiave API, incollala e tocca Salva, poi Test per verificare.

Il livello gratuito di Groq non richiede una carta di credito e consente un numero di richieste giornaliere ampiamente sufficiente per l'uso personale dell'app.