biteplan/docs/guida-utente.md

# Guida utente — BitePlan

## Navigazione

BitePlan è organizzata in tre sezioni accessibili dalla barra in basso:

| Icona | Tab | Funzione |
|---|---|---|
| Calendario | Pasti | Pianifica i pasti della settimana |
| Frecce | Converti | Converti peso crudo/cotto |
| Carrello | Spesa | Gestisci la lista della spesa |

---

## Pasti

La sezione mostra i sette giorni della settimana. Il giorno corrente è espanso di default.

### Aggiungere un alimento

1. Tocca il giorno per espandere la card (se non è già aperta)
2. Vai al pasto desiderato (Colazione, Pranzo o Cena)
3. Scrivi il nome dell'alimento nel campo di testo
4. Premi **+** o il tasto Invio per aggiungerlo

### Rimuovere un alimento

Tocca il pulsante **×** a destra dell'elemento.

### Generare la lista della spesa

Premi il pulsante **Genera lista della spesa** in fondo alla pagina. Tutti gli alimenti pianificati vengono aggiunti alla lista della spesa, senza duplicati rispetto a quelli già presenti. L'app passa automaticamente alla tab Spesa.

### Condividere il piano con un altro dispositivo

1. Premi **Condividi** in fondo alla pagina — viene generato un QR code con l'intero piano settimanale
2. Sull'altro dispositivo apri BitePlan, vai alla tab **Pasti** e premi **Scansiona QR**
3. Inquadra il codice con la fotocamera — il piano viene importato automaticamente

> **Nota:** il dispositivo che scansiona deve concedere il permesso di accesso alla fotocamera quando richiesto.

> **Limite:** se il piano contiene un numero molto elevato di alimenti, il QR code potrebbe non essere generabile. In quel caso riduci le voci inserite.

### Persistenza

I dati vengono salvati automaticamente sul dispositivo. Non è necessario premere nessun pulsante di salvataggio.

---

## Converti

Calcola il peso cotto a partire dal crudo, o viceversa, in base ai coefficienti di resa di ogni alimento e metodo di cottura.

### Utilizzo

1. Cerca l'alimento nel campo di ricerca (es. `pollo`, `riso`, `zucchine`)
2. Seleziona dall'elenco la combinazione alimento + metodo di cottura
3. Inserisci il peso in grammi
4. Il risultato appare in tempo reale
5. Per invertire la direzione (cotto → crudo), premi il pulsante **⇄** al centro

### Alimenti e metodi disponibili

Il database copre oltre 50 voci suddivise per categoria:

| Categoria | Esempi |
|---|---|
| Cereali e pasta | Riso (4 varietà), pasta, farro, orzo, quinoa, cous cous |
| Legumi secchi | Ceci, fagioli, lenticchie |
| Verdure | Carote, zucchine, patate, spinaci, broccoli, cavolfiore, asparagi, carciofi, finocchi e altri |
| Carni | Pollo petto, tacchino fesa, hamburger, vitello |
| Pesce | Tonno, merluzzo, spigola, sogliola |
| Uova | Uovo al tegamino, frittata |

I metodi di cottura disponibili variano per alimento: **bollitura**, **padella**, **forno**, **friggitrice ad aria**.

Per l'elenco completo con coefficienti e fonti, vedi [conversioni.md](conversioni.md).

---

## Spesa

### Aggiungere un elemento

Scrivi il nome nel campo in alto e premi **+** o Invio.

### Importare dal piano pasti

Vai alla tab **Pasti** e premi **Genera lista della spesa** — gli alimenti pianificati vengono aggiunti automaticamente.

### Spuntare un elemento

Tocca la casella a sinistra dell'elemento. Gli elementi completati vengono spostati in una sezione separata con testo barrato.

### Rimuovere un elemento

Tocca il pulsante **×** a destra dell'elemento.

### Svuotare la lista

Premi **Svuota lista** in fondo alla pagina. Viene richiesta conferma prima di procedere.

---

## Informazioni app

Tocca il pulsante **ⓘ** in alto a destra per visualizzare la versione dell'app, l'autore e la licenza. La verifica degli aggiornamenti avviene automaticamente all'avvio.

---

## Aggiornamenti

All'avvio l'app verifica automaticamente se è disponibile una nuova versione. Se sì, compare un dialog con il numero della versione disponibile e due opzioni:

- **Scarica** — apre il browser sulla pagina delle release GitHub da cui scaricare il nuovo APK
- **Più tardi** — chiude il dialog; il controllo verrà ripetuto al prossimo avvio

Il controllo richiede una connessione internet. In assenza di rete viene saltato silenziosamente.