Files

T

davide ca875d29c4 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>

2026-05-17 23:39:00 +02:00

3.3 KiB

Raw Blame History

BitePlan

App Android per la gestione della dieta quotidiana — pianificazione pasti, conversione crudo/cotto e lista della spesa.

Funzionalità

Piano 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 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 — vedi docs/conversioni.md

Lista della spesa

Checklist con aggiunta manuale o importazione dai pasti pianificati
Separazione visiva tra elementi da completare e completati
Rimozione singola e svuota lista con conferma

Stack

Livello	Tecnologia
Framework	Flutter 3.x / Dart 3.x
State management	Provider
Persistenza	shared_preferences
QR code	qr_flutter + mobile_scanner
Build APK	Docker (headless)

Sviluppo

Il container dev avvia un web server Flutter accessibile dal browser, con hot reload.

cd docker/dev
docker compose up
# → http://localhost:5173

Con il container attivo, in un altro terminale:

docker compose attach dev
# r → hot reload  |  R → hot restart  |  q → esci

Vedi 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).

# 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 docker/build/build.sh           # debug  → dist/biteplan-debug.apk
bash docker/build/build.sh --release # release → dist/biteplan-release.apk

Vedi docker/README.md per i requisiti della firma release.

Documentazione

Licenza

EUPL v1.2 — Davide Grilli

3.3 KiB Raw Blame History Unescape Escape