🍷 La Mia Cantina — Manuale v4.4

Questo manuale descrive tutte le funzionalità dell'app: come gestire i vini, tenere traccia delle bottiglie, ritrovarle in cantina e farsi consigliare l'abbinamento giusto.

💡 Nota
La Mia Cantina funziona direttamente sul telefono o sul computer, senza bisogno di installare nulla. I tuoi dati restano sul tuo dispositivo e, se vuoi, puoi tenerli allineati su più dispositivi (vedi capitolo Sincronizzazione).

1. Schermata principale

La home mostra l'elenco dei vini in cantina. In alto trovi:

In basso, la barra con le viste: Vista per Tipo, Vista per Zona, Vista Posizione, Movimenti e Consigli. Il pulsante + aggiunge un nuovo vino.


2. Gestione Archivio Vini

Aggiungere un vino

  1. Premere il pulsante + in basso a destra nella schermata home
  2. Compilare almeno i campi obbligatori: Cantina e Nome del Vino
  3. Opzionale: aggiungere una foto dalla fotocamera o dalla galleria
  4. Premere Aggiungi

Campi disponibili

CampoDescrizione
Cantina *Nome del produttore — obbligatorio
Nome Vino *Nome commerciale del vino — obbligatorio
Nazione / RegioneProvenienza del vino, scelta da un elenco personalizzabile
AnnataAnno di produzione (4 cifre)
TipologiaRosso, Bianco, Rosé, Spumante, Passito, Grappa, Altro
Vitigno / UvaggioVarietà principale o composizione
Gradi AlcoliciPercentuale vol. (es. 13.5)
FormatoBottiglia, Magnum, Altro
N° BottiglieQuantità disponibile in cantina
PrezzoPrezzo di acquisto in €
Data AcquistoQuando hai acquistato il vino
Data LimiteScadenza consigliata per il consumo
Posizione / ScaffaleCollocazione fisica in cantina
Acquistato PressoNome del negozio o fornitore
PunteggioValutazione personale da 0 a 5 stelle (anche mezze stelle)
NoteDegustazione, abbinamenti, annotazioni personali
⭐ Punteggio Stelle
Le stelle cambiano colore in base al voto: ★★★ Giallo fino a 3,0 — ★★★★ Arancione da 3,1 a 4,5 — ★★★★★ Verde sopra 4,5.

Scheda dettaglio

Toccando un vino dell'elenco si apre la sua scheda completa. Da qui puoi:

Duplicare un vino

Entrando in modifica di un vino compare il pulsante Duplica Vino: crea una copia da ritoccare (ad esempio per cambiare la posizione) senza dover reinserire tutti i dati. La copia viene creata solo quando premi Salva; se torni indietro non viene salvato nulla.

Assaggiati / Wishlist

Nel form puoi scegliere tra 🍾 In cantina e 🥂 Assaggiato / Wishlist. I vini assaggiati o desiderati non fanno parte della cantina: non hanno bottiglie e non generano movimenti. Per questi vini puoi indicare anche il campo Bevuto Presso (ristorante, enoteca…). Per consultarli usa l'icona a forma di occhio in alto a sinistra nella home.


3. Movimenti di Cantina

Ogni variazione di quantità viene registrata automaticamente nel registro movimenti, che si consulta dal pulsante Movimenti nella barra in basso. Puoi filtrare tra Tutti, Carichi e Scarichi.

Tipi di movimento

⬆ Carico Acquisto o aggiunta di bottiglie — registra negozio, prezzo e note.
⬇ Scarico Consumo o rimozione di bottiglie — registra solo la nota.

Registrare o correggere un movimento

Dalla pagina Movimenti, il pulsante + permette di inserire un movimento a mano; toccando un movimento esistente puoi modificarlo o eliminarlo.

Scarico rapido

Direttamente nella lista home ogni scheda con bottiglie disponibili mostra il pulsante — Scarica. Premi per togliere 1 bottiglia con una nota opzionale.


4. Viste dell'archivio

Vista per Tipo

Raggruppa i vini per tipologia (rossi, bianchi, spumanti…), con il totale delle bottiglie.

Vista per Zona

Raggruppa i vini per provenienza: Nazione → Regione.

Vista Posizione

Mostra i vini raggruppati per Posizione → Scaffale, con totali per ogni sezione. I vini senza collocazione sono elencati nella sezione Senza posizione.

Per spostare un vino in un'altra posizione: trascina la riga sullo scaffale di destinazione. Su telefono usa il tocco prolungato, su computer il mouse.


5. Ricerca

La barra di ricerca compare quando ci sono più di 2 vini. Cerca su tutti i campi: nome, cantina, annata, tipologia, posizione, scaffale, note.

Durante la ricerca ogni scheda mostra anche la posizione e lo scaffale. La Vista Posizione mostra solo i vini filtrati, con un banner dorato che indica il filtro attivo.


6. Dashboard

L'icona della Dashboard (in alto a destra nella home) mostra il quadro d'insieme della cantina:


7. Consigli — Il Sommelier

Il pulsante 🍽 Consigli ti aiuta a scegliere il vino giusto per quello che stai cucinando.

  1. Apri Consigli dalla barra in basso
  2. Descrivi il piatto (es. «risotto ai funghi porcini» o «tagliata di manzo con rucola»)
  3. Premi il pulsante per chiedere il consiglio

Il sommelier sceglie tra i vini che hai davvero in cantina, spiega il motivo dell'abbinamento e propone alcune alternative. Toccando una alternativa si apre la scheda del vino.

Nelle impostazioni puoi scegliere quale servizio di intelligenza artificiale usare: una versione premium oppure una completamente gratuita.


8. Lettura etichetta dalla foto

Dopo aver caricato una foto della bottiglia nel form, appare il pulsante Leggi dati dalla foto.

  1. Carica la foto dell'etichetta (fotocamera o galleria)
  2. Premi Leggi dati dalla foto
  3. L'app legge il testo dell'etichetta e propone i dati riconosciuti
  4. Premi ✓ per applicare i campi singolarmente oppure ✓ Applica tutti
📷 Consiglio
Per un buon risultato fotografa l'etichetta con buona luce, ben a fuoco e di fronte. Controlla sempre i dati proposti prima di salvare.

9. Promemoria scadenze

Dalle impostazioni puoi indicare quanti giorni prima della Data Limite vuoi essere avvisato (default: 60 giorni).

📱 iPhone
Per ricevere le notifiche sul telefono, su iPhone aggiungi prima l'app alla schermata Home (richiede iOS 16.4 o successivo).

10. Sincronizzazione tra dispositivi

Se usi l'app su più dispositivi (ad esempio telefono e tablet) puoi tenerli allineati. Nelle impostazioni, sezione Sincronizzazione Cloud, inserisci la stessa chiave di condivisione su ogni dispositivo e premi Sincronizza ora.


11. Impostazioni e manutenzione

Si aprono con l'icona ⚙ in alto a destra.

VoceA cosa serve
Forza AggiornamentoScarica l'ultima versione dell'app, senza perdere i dati
Elenco TerritoriAggiungi o modifica nazioni e regioni disponibili nel form
Ricostruisci SaldiRicalcola le quantità delle bottiglie a partire dai movimenti, utile se i numeri non tornano
TemaAspetto Chiaro o Scuro
Provider ConsigliScelta del servizio usato dal sommelier
PromemoriaGiorni di preavviso, email e notifiche (vedi capitolo 9)
Come aggiornareIstruzioni per aggiornare l'app in sicurezza

12. Backup e Ripristino

Tutti i comandi si trovano in Impostazioni (⚙) → Backup / Restore. Fai un backup regolarmente, e sempre prima di un aggiornamento.

FunzioneCosa produce / legge
Esporta in cartellaFile dei vini e dei movimenti (cantina_vini_DATA.csv, cantina_movimenti_DATA.csv) più una foto per ogni vino
Ripristina da cartellaLegge i file sopra — scelta separata: vini, movimenti, foto
Esporta JSONBackup completo in un unico file (con foto e movimenti)
Importa JSONRipristino completo da questo file
Esporta CSV + fotoFoglio apribile con Excel o Fogli Google, con foto e movimenti
Importa CSVCarica vini da un foglio Excel / Fogli Google
📁 Cartella Backup
Imposta la cartella di destinazione con il pulsante Cambia… nella sezione Backup. La scelta viene ricordata per i backup successivi. Default: Download.

La Mia Cantina

Contatta lo sviluppatore: ivotaffarel@gmail.com

Manuale La Mia Cantina · Versione 4.4 · Sviluppo Ivo e AI