davide
ab1a7c18cd
Aggiunge sezione "Aggiornamenti" in docs/guida-utente.md con rimando dalla sezione "Informazioni app". Aggiunge TipCard nella tab Pasti della guida in-app che descrive il controllo automatico all'avvio. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
119 lines
4.1 KiB
Markdown
119 lines
4.1 KiB
Markdown
# 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.
|