docs: aggiunge guide per emulatore Android e test

Nuovi docs/emulatore.md e docs/testing.md; CLAUDE.md e README.md
aggiornati con i riferimenti.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

docs/testing.md

@@ -0,0 +1,78 @@
+# Test — BitePlan
+
+Cosa copre la suite di test, cosa no, e come lanciarla. Per l'architettura del codice
+testato vedi [architettura.md](architettura.md).
+
+## Come lanciare i test
+
+```bash
+flutter test                                            # tutta la suite unit + widget (host)
+flutter test test/features/meal_planner/qr_test.dart    # singolo file
+
+# versione riproducibile via Docker (immagine biteplan-build, creata da bash docker/build.sh)
+docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
+  bash -c "flutter pub get --enforce-lockfile && flutter test"
+
+# integration test — richiede un emulatore avviato (vedi docs/emulatore.md)
+flutter test integration_test/app_test.dart
+```
+
+## Struttura
+
+```text
+test/
+├── coverage_helper_test.dart             # importa tutta lib/ perché lcov copra anche i file non testati
+├── helpers/pump_app.dart                 # estensione pumpApp per i widget test
+├── features/
+│   ├── converter/{models,pages,providers}/
+│   ├── meal_planner/{models,pages,providers,widgets}/ + qr_test.dart
+│   ├── shopping_list/{models,pages,providers,widgets}/
+│   └── guide/{pages,widgets}/
+└── shared/{services,widgets}/
+```
+
+184 test unit + widget, coverage ~93% su `lib/`, più `integration_test/app_test.dart`
+(navigazione tra tab, flussi end-to-end su un emulatore/device reale).
+
+## Cosa è coperto
+
+- **Modelli**: serializzazione/deserializzazione, `copyWith`, edge case (`MealPlan`,
+  `DayPlan`, `ConversionEntry`, `ShoppingItem`).
+- **Provider**: mutazioni di stato, persistenza (fire-and-forget) tramite
+  `StorageService` con `SharedPreferences.setMockInitialValues({})` isolato per test.
+- **Conversione crudo/cotto**: `rawToCooked`/`cookedToRaw` in `ConversionEntry`.
+- **QR**: `buildQrPayload`/`parseMealPlanFromQr` in `qr_codec.dart` (payload valido,
+  troppo grande, malformato).
+- **Update checker**: `isNewer()`, `parseTagName()` (`@visibleForTesting`), dialog di
+  aggiornamento con `MethodChannel` mockato.
+- **Widget/pagine**: rendering, interazioni utente (tap, form) via `pumpApp`, per tutte
+  le feature (meal_planner, converter, shopping_list, guide).
+- **Integration test**: navigazione fra i tab e flussi che attraversano più feature,
+  su un device/emulatore reale (non richiesto per lo sviluppo quotidiano).
+
+## Cosa NON è coperto (per scelta)
+
+- **`main.dart`**: bootstrap dell'app (setup provider, `runApp`), poco valore nel
+  testarlo isolatamente — è coperto indirettamente dall'integration test.
+- **Percorso camera di `qr_scan_page`**: l'uso reale della fotocamera per scansionare un
+  QR richiede hardware/permessi non simulabili in un widget test; la logica di parsing
+  (`qr_codec.dart`) è invece testata a parte.
+- **`UrlLauncherService`**: wrapper sottile sul `MethodChannel` nativo
+  (`com.davide.biteplan/launcher`) che apre un URL nel browser — l'effetto (apertura
+  browser) non è verificabile senza un device reale.
+
+## Insidie note
+
+- **Non chiamare `loadDb()`/`load()` dei provider nel body di `testWidgets`**: l'async
+  reale eseguito nella zona `FakeAsync` di `flutter_test` può bloccare la suite (timeout
+  10 min). Vanno chiamati nel `setUp()` — vedi
+  [test/features/converter/pages/converter_page_test.dart](../test/features/converter/pages/converter_page_test.dart).
+- **Storage isolato**: ogni test che tocca `StorageService`/i provider deve chiamare
+  `SharedPreferences.setMockInitialValues({})` prima di caricare lo stato, altrimenti i
+  test si influenzano a vicenda.
+- **MethodChannel nei test**: va mockato con
+  `TestDefaultBinaryMessengerBinding.instance.defaultBinaryMessenger.setMockMethodCallHandler`
+  — vedi [test/shared/widgets/update_dialog_test.dart](../test/shared/widgets/update_dialog_test.dart).
+- **Nuovi file in `lib/`**: aggiungerli all'import di
+  [test/coverage_helper_test.dart](../test/coverage_helper_test.dart), altrimenti lcov
+  li esclude dal report di coverage anche se non hanno bisogno di test dedicati.