aggiungi documentazione e changelog
- README.md: panoramica app, stack, avvio dev, build APK, link docs - CHANGELOG.md: standard Keep a Changelog, release 0.1.0-alpha completa - docs/guida-utente.md: istruzioni Piano Pasti, Convertitore, Lista spesa - docs/conversioni.md: tabella coefficienti con fonte alimentinutrizione.it Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
80
docs/guida-utente.md
Normal file
80
docs/guida-utente.md
Normal file
@@ -0,0 +1,80 @@
|
||||
# Guida utente — BitePlan
|
||||
|
||||
## Navigazione
|
||||
|
||||
BitePlan è organizzata in tre sezioni accessibili dalla barra in basso:
|
||||
|
||||
| Icona | Sezione | Funzione |
|
||||
|---|---|---|
|
||||
| Calendario | Piano Pasti | Pianifica i pasti della settimana |
|
||||
| Bilancia | Convertitore | Converti peso crudo/cotto |
|
||||
| Lista | Lista della spesa | Gestisci la spesa |
|
||||
|
||||
---
|
||||
|
||||
## Piano Pasti
|
||||
|
||||
La sezione mostra i sette giorni della settimana. Il giorno corrente è aperto di default.
|
||||
|
||||
### Aggiungere un alimento
|
||||
|
||||
1. Tocca il giorno per espandere la card
|
||||
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.
|
||||
|
||||
### Persistenza
|
||||
|
||||
I dati vengono salvati automaticamente sul dispositivo (LocalStorage). Non è necessario premere nessun pulsante di salvataggio.
|
||||
|
||||
---
|
||||
|
||||
## Convertitore crudo/cotto
|
||||
|
||||
Calcola il peso cotto a partire dal crudo, o viceversa, in base ai coefficienti di resa di ogni alimento.
|
||||
|
||||
### Utilizzo
|
||||
|
||||
1. Cerca l'alimento nel campo di ricerca (es. `pollo`, `riso`)
|
||||
2. Seleziona il metodo di cottura dall'elenco risultati
|
||||
3. Scegli la direzione: **Crudo → Cotto** o **Cotto → Crudo** (pulsante swap)
|
||||
4. Inserisci il peso in grammi
|
||||
5. Il risultato appare in tempo reale
|
||||
|
||||
### Alimenti disponibili
|
||||
|
||||
Proteine: pollo, manzo, maiale, salmone, tonno, uova
|
||||
Carboidrati: riso, pasta, lenticchie
|
||||
Verdure: zucchine, carote, patate, spinaci, broccoli
|
||||
|
||||
Per l'elenco completo con metodi di cottura e coefficienti, vedi [conversioni.md](conversioni.md).
|
||||
|
||||
---
|
||||
|
||||
## Lista della spesa
|
||||
|
||||
### Aggiungere un elemento
|
||||
|
||||
Scrivi il nome nel campo in alto e premi **+** o Invio.
|
||||
|
||||
### Spuntare un elemento
|
||||
|
||||
Tocca la casella a sinistra dell'elemento. Gli elementi completati vengono spostati in fondo 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.
|
||||
Reference in New Issue
Block a user