Manuale d'uso | Taccuino di Degustazione

1. Cos'è l'applicazione

Il Taccuino di Degustazione è un archivio personale online per le schede di degustazione di vino e birra e per gli abbinamenti cibo-vino e cibo-birra. Ogni utente vede e gestisce solo i propri dati: schede complete, punteggio finale su 100, bersaglio AIS dell'abbinamento e una fotografia per ogni assaggio.

2. Accesso

Registrati o accedi con email e password dalla pagina di accesso.
In alternativa puoi entrare con Google.
Il pulsante di uscita si trova in alto a destra nelle pagine Vino e Birra.

3. Navigazione

Home: presentazione dell'app e collegamenti rapidi.
Vino e Birra: le due sezioni principali dell'archivio.
Dentro ogni sezione ci sono due schede: Degustazioni e Abbinamenti, con elenchi, ricerca e import separati.
In alto trovi i tasti Home, il passaggio all'altra categoria e il Manuale.

4. Creare una degustazione

Apri la scheda «Degustazioni» nella pagina Vino o Birra e premi «Nuova».
Compila i dati della scheda: ID, data, informazioni di base (produttore, annata, vitigni o stile) e la parte analitico-descrittiva.
Esame visivo, olfattivo e gusto-olfattivo: scegli i descrittori dai menu e dai chip; le voci disponibili sono le stesse della scheda originale.
Aggiungi la scheda giornalistica e l'abbinamento.
Salva: la degustazione compare subito nell'elenco.

5. Punteggio

La scheda di valutazione a punti calcola automaticamente il totale su 100 applicando i pesi previsti alle voci selezionate (aspetto, odore, gusto e armonia). Il totale si aggiorna mentre compili e viene salvato con la scheda.

6. Fotografie

Carica una foto dal pannello «Immagine» della scheda.
L'immagine viene ridotta automaticamente (max 1280 px, JPEG) e convertita in Base64.
La foto è salvata insieme alla degustazione ed è visibile nell'elenco.

7. Import ed export JSON

«Scarica JSON» nella scheda esporta la degustazione completa, immagine Base64 inclusa.
«Importa JSON» nell'elenco accetta un singolo file, un array di schede o un oggetto con la chiave degustazioni; le immagini Base64 presenti nel file vengono importate.
Le schede in formato precedente vengono convertite automaticamente.

8. Abbinamenti cibo-vino e cibo-birra

Nella scheda «Abbinamenti» crei le schede di abbinamento sul bersaglio AIS.

Premi «Nuovo» e indica il titolo (bevanda) e il piatto.
Puoi collegare l'abbinamento a una degustazione già salvata della stessa categoria: il titolo viene compilato in automatico.
Assegna a ogni caratteristica un valore da 2 a 10 (il trattino «—» significa non valutata):
- Vino: dolcezza, rotondità, intensità e persistenza gusto-olfattiva, sapidità, acidità/effervescenza, alcolicità, tannicità.
- Birra: le caratteristiche previste dalla scheda birra (fra cui frizzantezza e secchezza).
- Cibo: tendenza dolce, grassezza/pastosità, succulenza, untuosità, intensità e persistenza gusto-olfattiva, sapidità, piccantezza, tendenza amarognola, tendenza acida, dolcezza.
Il bersaglio disegna in tempo reale il poligono della bevanda e quello del cibo.

Aree e lettura del grafico

Area bevanda e area cibo: superficie dei rispettivi poligoni.
Area sovrapposta: parte in comune, con la percentuale di sovrapposizione. Più è alta, più le due strutture si corrispondono.
Le aree vengono salvate insieme alla scheda e mostrate nell'elenco.

Valutazione e allegati

Struttura del cibo e struttura della bevanda, affinità aromatica e giudizio finale sull'abbinamento si scelgono con i chip.
Puoi aggiungere osservazioni sulla struttura, sull'abbinamento e note libere.
Anche l'abbinamento accetta una fotografia, compressa e salvata in Base64.
«Scarica JSON» esporta l'abbinamento completo; «Importa JSON» accetta un file singolo, un array oppure un oggetto con la chiave abbinamenti, convertendo i formati precedenti.
La ricerca filtra per titolo e per piatto.

9. Ricerca, modifica ed eliminazione

La barra di ricerca filtra per nome, produttore, numero e punteggio.
Clic sulla scheda: apre la vista di dettaglio in sola lettura.
«Modifica» riapre il modulo, l'icona cestino elimina la degustazione.

10. Personalizzare vitigni, aromi e testi

Vitigni e descrittori: src/data/degustazioni_master.json (vino) e src/data/degustazioni_birra_master.json (birra).
Punti del bersaglio AIS: src/data/bersaglio_vino_punti.json e src/data/bersaglio_birra_punti.json.
Testo di questo manuale: src/content/manuale.md.
Testo della sezione «Come funziona» in home: src/content/manuale-breve.md.

11. Privacy dei dati

Degustazioni e abbinamenti sono protetti da regole di accesso: ogni utente può leggere, modificare ed eliminare solo le proprie schede. Le fotografie sono salvate nel database insieme alla scheda.