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>
4.1 KiB
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
- Tocca il giorno per espandere la card (se non è già aperta)
- Vai al pasto desiderato (Colazione, Pranzo o Cena)
- Scrivi il nome dell'alimento nel campo di testo
- 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
- Premi Condividi in fondo alla pagina — viene generato un QR code con l'intero piano settimanale
- Sull'altro dispositivo apri BitePlan, vai alla tab Pasti e premi Scansiona QR
- 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
- Cerca l'alimento nel campo di ricerca (es.
pollo,riso,zucchine) - Seleziona dall'elenco la combinazione alimento + metodo di cottura
- Inserisci il peso in grammi
- Il risultato appare in tempo reale
- 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.
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.