docs: allinea CLAUDE.md, README e docker/README al codice reale

CLAUDE.md: rimossi riferimenti a noVNC/Vue3/sop.md, aggiornata
architettura reale (features/*/presentation/), rimossi file fantasma
(checkbox_item.dart, conversion_service.dart), aggiunta feature guide,
corretta struttura test, aggiornati comandi Docker.

README.md: riscritto per Flutter (rimosso stack Vue3/Node.js), aggiunta
sezione test con comandi e struttura cartelle, link docs/.

docker/README.md: aggiunta sezione test completa con comandi per tutti
i test, singolo file e singola feature; aggiornato flusso completo.

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

README.md

@@ -1,6 +1,6 @@
 # BitePlan
 
-App mobile-first per la gestione della dieta quotidiana — pianificazione pasti, conversione crudo/cotto e lista della spesa.
+App Android per la gestione della dieta quotidiana — pianificazione pasti, conversione crudo/cotto e lista della spesa.
 
 ## Funzionalità
 
@@ -8,15 +8,16 @@ App mobile-first per la gestione della dieta quotidiana — pianificazione pasti
 - Pianificazione settimanale su 7 giorni × 3 pasti (colazione, pranzo, cena)
 - Card accordion per giorno, giorno corrente aperto di default
 - Aggiunta e rimozione di voci per ogni pasto
-- Generazione automatica della lista della spesa dai pasti pianificati
-- Persistenza automatica su LocalStorage
+- Generazione automatica della lista della spesa con aggregazione duplicati (es. "zucchine (x2)")
+- Condivisione del piano via QR code tra dispositivi
+- Persistenza automatica su SharedPreferences
 
 ### Convertitore crudo/cotto
 - Conversione bidirezionale del peso (crudo → cotto e cotto → crudo)
 - Ricerca alimento in tempo reale
 - Oltre 50 voci tra cereali, legumi, verdure, carni, pesce e uova
 - Fino a 4 metodi di cottura per alimento: bollitura, padella, forno, friggitrice ad aria
-- Coefficienti di resa documentati con fonti (CREA, SINU, Istituto Muzzone, USDA)
+- Coefficienti di resa documentati con fonti — vedi [docs/conversioni.md](docs/conversioni.md)
 
 ### Lista della spesa
 - Checklist con aggiunta manuale o importazione dai pasti pianificati
@@ -27,36 +28,75 @@ App mobile-first per la gestione della dieta quotidiana — pianificazione pasti
 
 | Livello | Tecnologia |
 |---|---|
-| Frontend | Vue 3 + Vite |
-| Persistenza | LocalStorage |
-| UI | CSS mobile-first (max 480px) |
-| Mobile | Capacitor Android |
-| Build APK | Docker |
+| Framework | Flutter 3.x / Dart 3.x |
+| State management | Provider |
+| Persistenza | shared_preferences |
+| QR code | qr_flutter + mobile_scanner |
+| Build APK | Docker (headless) |
 
-## Requisiti per lo sviluppo
+## Sviluppo
 
-| Strumento | Versione minima | Note |
-|---|---|---|
-| Node.js | >= 20.x LTS | testato con v24 |
-| npm | 9.x | incluso con Node.js |
-| Git | 2.x | |
-| Browser | Chrome / Edge / Firefox recente | DevTools modalità mobile consigliati |
-
-Per la build APK Android sono necessari requisiti aggiuntivi — vedi [docker/README.md](docker/README.md).
-
-## Avvio in sviluppo
+Il container dev avvia un web server Flutter accessibile dal browser, con hot reload.
 
 ```bash
-npm install
-npm run dev
+cd docker/dev
+docker compose up
+# → http://localhost:5173
 ```
 
-Aprire [http://localhost:5173](http://localhost:5173) in Chrome con DevTools in modalità mobile (viewport 360×640).
-Da un dispositivo mobile sulla stessa rete, aprire `http://<ip-host>:5173`.
+Con il container attivo, in un altro terminale:
 
-## Build APK Android
+```bash
+docker compose attach dev
+# r → hot reload  |  R → hot restart  |  q → esci
+```
 
-Vedi [docker/README.md](docker/README.md) per i requisiti e i dettagli della pipeline.
+Vedi [docker/README.md](docker/README.md) per i dettagli e la build APK.
+
+## Test
+
+La suite copre unit test e widget test. Richiede l'immagine Docker `biteplan-build`
+(creata automaticamente al primo `bash docker/build/build.sh`).
+
+```bash
+# Tutti i test (dalla root del progetto)
+docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
+  bash -c "flutter pub get && flutter test"
+
+# Un singolo file
+docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
+  bash -c "flutter test test/features/meal_planner/qr_test.dart"
+```
+
+### Struttura
+
+```
+test/
+├── helpers/
+│   └── pump_app.dart                     # estensione pumpApp per widget test
+└── features/
+    ├── converter/
+    │   ├── models/conversion_entry_test.dart
+    │   └── providers/converter_provider_test.dart
+    ├── meal_planner/
+    │   ├── models/meal_plan_test.dart
+    │   ├── providers/meal_planner_provider_test.dart
+    │   ├── widgets/meal_card_test.dart
+    │   └── qr_test.dart
+    └── shopping_list/
+        ├── models/shopping_item_test.dart
+        ├── providers/shopping_list_provider_test.dart
+        └── widgets/shopping_item_tile_test.dart
+```
+
+## Build APK
+
+```bash
+bash docker/build/build.sh           # debug  → dist/biteplan-debug.apk
+bash docker/build/build.sh --release # release → dist/biteplan-release.apk
+```
+
+Vedi [docker/README.md](docker/README.md) per i requisiti della firma release.
 
 ## Documentazione