Compare commits
3
Commits
| Author | SHA1 | Date | |
|---|---|---|---|
  davideandClaude Sonnet 5
|
1d7f1ad020 | ||
|
davideandClaude Sonnet 5
|
6eb84a18e5 | ||
|
davideandClaude Sonnet 5
|
b1eb92e83d |
No files matched your search
@@ -19,6 +19,12 @@ test/widget_test.dart
|
|||||||
/macos/
|
/macos/
|
||||||
/windows/
|
/windows/
|
||||||
/web/
|
/web/
|
||||||
|
|
||||||
|
# db_prodotti — dataset generato dallo scraper, rigenerabile con scrape_aldi.py
|
||||||
|
db_prodotti/*.db
|
||||||
|
db_prodotti/*.json
|
||||||
|
db_prodotti/*.log
|
||||||
|
db_prodotti/__pycache__/
|
||||||
/.idea/
|
/.idea/
|
||||||
*.iml
|
*.iml
|
||||||
.metadata
|
.metadata
|
||||||
|
|||||||
@@ -47,6 +47,7 @@ bash docker/build.sh --release # release → dist/biteplan-release.
|
|||||||
- **Emulatore**: Android SDK in `/home/davide/android-sdk`; accelerazione hardware via `/dev/kvm` (WSL2 con KVM abilitato).
|
- **Emulatore**: Android SDK in `/home/davide/android-sdk`; accelerazione hardware via `/dev/kvm` (WSL2 con KVM abilitato).
|
||||||
- **AVD `biteplan`**: dedicato a questo progetto (Pixel 6, Android 14, google_apis/x86_64). Non riutilizzare AVD di altri progetti (es. `palladium_wallet`).
|
- **AVD `biteplan`**: dedicato a questo progetto (Pixel 6, Android 14, google_apis/x86_64). Non riutilizzare AVD di altri progetti (es. `palladium_wallet`).
|
||||||
- **Permessi**: le build Docker girano come root nel volume montato — se `.dart_tool/` o `build/` risultano di proprietà root, serve `sudo chown -R davide:davide .dart_tool build` prima di usare flutter da host.
|
- **Permessi**: le build Docker girano come root nel volume montato — se `.dart_tool/` o `build/` risultano di proprietà root, serve `sudo chown -R davide:davide .dart_tool build` prima di usare flutter da host.
|
||||||
|
- **Setup e uso dell'emulatore Android** (installazione SDK, creazione AVD, comandi `adb`, troubleshooting): [docs/emulatore.md](docs/emulatore.md).
|
||||||
|
|
||||||
## Build e firma
|
## Build e firma
|
||||||
|
|
||||||
@@ -55,6 +56,7 @@ bash docker/build.sh --release # release → dist/biteplan-release.
|
|||||||
- **Keystore**: `docker/biteplan.jks` è in `.gitignore`; da ottenere dall'autore o generare con `keytool`. Password via `BITEPLAN_KEYSTORE_PASS` (mai hardcoded); alias: `biteplan`
|
- **Keystore**: `docker/biteplan.jks` è in `.gitignore`; da ottenere dall'autore o generare con `keytool`. Password via `BITEPLAN_KEYSTORE_PASS` (mai hardcoded); alias: `biteplan`
|
||||||
- **applicationId**: `com.davide.biteplan` — non cambiare, garantisce aggiornamento diretto dalla v1.2.1
|
- **applicationId**: `com.davide.biteplan` — non cambiare, garantisce aggiornamento diretto dalla v1.2.1
|
||||||
- **versionCode**: letto da `pubspec.yaml` (`version: X.Y.Z+BUILD`); BUILD deve essere sempre crescente
|
- **versionCode**: letto da `pubspec.yaml` (`version: X.Y.Z+BUILD`); BUILD deve essere sempre crescente
|
||||||
|
- **kAppVersion**: `lib/core/constants/app_constants.dart` duplica la versione di `pubspec.yaml` a mano (nessuna sincronizzazione automatica) — aggiornarla ad ogni bump di versione, altrimenti l'update checker confronta contro il valore sbagliato
|
||||||
|
|
||||||
## Architettura
|
## Architettura
|
||||||
|
|
||||||
@@ -64,6 +66,7 @@ Feature-first sotto `lib/features/` (meal_planner, converter, shopping_list, gui
|
|||||||
lib/
|
lib/
|
||||||
├── app.dart # MaterialApp + NavigationBar; in initState chiama UpdateService.checkUpdate() e mostra showUpdateDialog()
|
├── app.dart # MaterialApp + NavigationBar; in initState chiama UpdateService.checkUpdate() e mostra showUpdateDialog()
|
||||||
├── core/constants/app_constants.dart # kDayIds, kMealSlots, kStorageKey*, kAppVersion
|
├── core/constants/app_constants.dart # kDayIds, kMealSlots, kStorageKey*, kAppVersion
|
||||||
|
├── core/theme/app_theme.dart # ThemeData Material 3, seed color 0xFF2d6a4f
|
||||||
├── shared/
|
├── shared/
|
||||||
│ ├── services/storage_service.dart # wrapper SharedPreferences (load/save)
|
│ ├── services/storage_service.dart # wrapper SharedPreferences (load/save)
|
||||||
│ ├── services/update_service.dart # checkUpdate() → GitHub API; isNewer(), parseTagName() (@visibleForTesting)
|
│ ├── services/update_service.dart # checkUpdate() → GitHub API; isNewer(), parseTagName() (@visibleForTesting)
|
||||||
@@ -86,7 +89,7 @@ lib/
|
|||||||
|
|
||||||
## Testing
|
## Testing
|
||||||
|
|
||||||
184 test unit + widget in `test/` (rispecchia la struttura di `lib/`), più un integration test in `integration_test/app_test.dart`. I test unit/widget non richiedono device. Coverage ~93% su `lib/` (esclusi per scelta: `main.dart`, il percorso camera di `qr_scan_page`).
|
184 test unit + widget in `test/` (rispecchia la struttura di `lib/`), più un integration test in `integration_test/app_test.dart`. I test unit/widget non richiedono device. Coverage ~93% su `lib/` (esclusi per scelta: `main.dart`, il percorso camera di `qr_scan_page`). Dettaglio di cosa è coperto/escluso e come lanciare la suite: [docs/testing.md](docs/testing.md).
|
||||||
|
|
||||||
- Storage isolato con `SharedPreferences.setMockInitialValues({})`
|
- Storage isolato con `SharedPreferences.setMockInitialValues({})`
|
||||||
- Widget test: estensione `pumpApp` in `test/helpers/pump_app.dart`
|
- Widget test: estensione `pumpApp` in `test/helpers/pump_app.dart`
|
||||||
|
|||||||
@@ -2,9 +2,29 @@
|
|||||||
|
|
||||||
App Android 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à
|
> Un'unica app per pianificare la settimana, sapere quanto pesare crudo o cotto e non dimenticare cosa comprare.
|
||||||
|
|
||||||
### Piano Pasti
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
## Overview
|
||||||
|
|
||||||
|
BitePlan nasce per unire in un'unica app tre attività che di solito richiedono strumenti
|
||||||
|
separati: pianificare i pasti della settimana, convertire i pesi degli alimenti tra crudo e
|
||||||
|
cotto (utile per chi segue una dieta con quantità espresse in una delle due forme), e tenere
|
||||||
|
una lista della spesa sincronizzata con quanto pianificato.
|
||||||
|
|
||||||
|
- **Problema risolto**: evitare di ricalcolare a mano le rese di cottura e di dimenticare
|
||||||
|
ingredienti quando si fa la spesa.
|
||||||
|
- **Perché esiste**: progetto personale dell'autore, pensato per un uso quotidiano reale.
|
||||||
|
- **Limiti noti**: i coefficienti di resa sono medie indicative (vedi
|
||||||
|
[docs/conversioni.md](docs/conversioni.md)); il piano pasti si condivide tra dispositivi
|
||||||
|
solo via QR code, senza account né sincronizzazione cloud; nessuna build iOS.
|
||||||
|
|
||||||
|
## Features
|
||||||
|
|
||||||
|
### Piano pasti
|
||||||
- Pianificazione settimanale su 7 giorni × 3 pasti (colazione, pranzo, cena)
|
- Pianificazione settimanale su 7 giorni × 3 pasti (colazione, pranzo, cena)
|
||||||
- Card accordion per giorno, giorno corrente aperto di default
|
- Card accordion per giorno, giorno corrente aperto di default
|
||||||
- Aggiunta e rimozione di voci per ogni pasto
|
- Aggiunta e rimozione di voci per ogni pasto
|
||||||
@@ -28,7 +48,32 @@ App Android per la gestione della dieta quotidiana — pianificazione pasti, con
|
|||||||
- All'avvio controlla silenziosamente l'ultima release su GitHub
|
- All'avvio controlla silenziosamente l'ultima release su GitHub
|
||||||
- Se disponibile una versione più recente, mostra un dialog con link diretto al download dell'APK
|
- Se disponibile una versione più recente, mostra un dialog con link diretto al download dell'APK
|
||||||
|
|
||||||
## Stack
|
## Architecture
|
||||||
|
|
||||||
|
Feature-first sotto `lib/features/`, ognuna con modelli, provider (state management) e
|
||||||
|
presentation; persistenza su `SharedPreferences`. Dettaglio del flusso dati per feature in
|
||||||
|
[docs/architettura.md](docs/architettura.md).
|
||||||
|
|
||||||
|
```text
|
||||||
|
biteplan/
|
||||||
|
├── lib/
|
||||||
|
│ ├── app.dart # MaterialApp + navigazione
|
||||||
|
│ ├── core/ # costanti, tema
|
||||||
|
│ ├── shared/ # servizi e widget condivisi
|
||||||
|
│ └── features/
|
||||||
|
│ ├── meal_planner/
|
||||||
|
│ ├── converter/
|
||||||
|
│ ├── shopping_list/
|
||||||
|
│ └── guide/
|
||||||
|
├── assets/data/conversions.json
|
||||||
|
├── android/ # progetto nativo (MethodChannel in Kotlin)
|
||||||
|
├── test/ # unit + widget test
|
||||||
|
├── integration_test/
|
||||||
|
├── docs/ # guida utente, architettura, fonti conversioni
|
||||||
|
└── docker/ # build APK headless, test riproducibili
|
||||||
|
```
|
||||||
|
|
||||||
|
## Requisiti e dipendenze
|
||||||
|
|
||||||
| Livello | Tecnologia |
|
| Livello | Tecnologia |
|
||||||
|---|---|
|
|---|---|
|
||||||
@@ -38,19 +83,7 @@ App Android per la gestione della dieta quotidiana — pianificazione pasti, con
|
|||||||
| QR code | qr_flutter + mobile_scanner |
|
| QR code | qr_flutter + mobile_scanner |
|
||||||
| Build APK | Docker (headless) |
|
| Build APK | Docker (headless) |
|
||||||
|
|
||||||
## Sviluppo
|
Requisiti host per lo sviluppo:
|
||||||
|
|
||||||
Sviluppo locale con Flutter installato sull'host e un emulatore Android dedicato — no Docker.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
emulator -avd biteplan &
|
|
||||||
flutter run
|
|
||||||
# hot reload con "r", hot restart con "R"
|
|
||||||
```
|
|
||||||
|
|
||||||
Vedi [docker/README.md](docker/README.md) per test e build APK via Docker.
|
|
||||||
|
|
||||||
### Requisiti host
|
|
||||||
|
|
||||||
- **Linux x86_64** (Ubuntu/Debian o simili; funziona anche su **WSL2** se il kernel espone `/dev/kvm`)
|
- **Linux x86_64** (Ubuntu/Debian o simili; funziona anche su **WSL2** se il kernel espone `/dev/kvm`)
|
||||||
- **KVM** per l'accelerazione hardware — senza, l'emulatore è inutilizzabile. Verifica con:
|
- **KVM** per l'accelerazione hardware — senza, l'emulatore è inutilizzabile. Verifica con:
|
||||||
@@ -62,7 +95,7 @@ Vedi [docker/README.md](docker/README.md) per test e build APK via Docker.
|
|||||||
- **Java 17+** (`sudo apt install openjdk-21-jdk`)
|
- **Java 17+** (`sudo apt install openjdk-21-jdk`)
|
||||||
- Strumenti di base: `git curl unzip` — e ~15 GB di spazio libero
|
- Strumenti di base: `git curl unzip` — e ~15 GB di spazio libero
|
||||||
|
|
||||||
### Installazione passo passo
|
## Installazione
|
||||||
|
|
||||||
**1. Flutter** (versione pinnata `3.41.9`, la stessa di `.flutter-version`):
|
**1. Flutter** (versione pinnata `3.41.9`, la stessa di `.flutter-version`):
|
||||||
|
|
||||||
@@ -116,104 +149,94 @@ flutter run
|
|||||||
> **Nota WSL2**: serve un kernel con KVM abilitato (WSL2 recenti lo hanno di serie —
|
> **Nota WSL2**: serve un kernel con KVM abilitato (WSL2 recenti lo hanno di serie —
|
||||||
> verifica con `ls /dev/kvm`). La finestra dell'emulatore compare tramite WSLg.
|
> verifica con `ls /dev/kvm`). La finestra dell'emulatore compare tramite WSLg.
|
||||||
|
|
||||||
### Installare e testare l'APK di debug sull'emulatore
|
## Utilizzo
|
||||||
|
|
||||||
|
```bash
|
||||||
|
emulator -avd biteplan &
|
||||||
|
flutter run
|
||||||
|
# hot reload con "r", hot restart con "R"
|
||||||
|
```
|
||||||
|
|
||||||
|
Per l'uso dell'app una volta installata, vedi la [guida utente](docs/guida-utente.md).
|
||||||
|
|
||||||
|
### Installare e testare un APK già buildato
|
||||||
|
|
||||||
Una volta creato l'AVD `biteplan` (vedi sopra), per installare e provare un APK di debug
|
Una volta creato l'AVD `biteplan` (vedi sopra), per installare e provare un APK di debug
|
||||||
già buildato (es. `dist/biteplan-debug.apk` generato da `bash docker/build.sh`) senza
|
già buildato (es. `dist/biteplan-debug.apk` generato da `bash docker/build.sh`) senza
|
||||||
passare da `flutter run`:
|
passare da `flutter run`:
|
||||||
|
|
||||||
**1. Avvia l'emulatore e attendi il boot completo:**
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
emulator -avd biteplan &
|
emulator -avd biteplan &
|
||||||
adb wait-for-device
|
adb wait-for-device
|
||||||
# poi attendi che il boot sia terminato (può richiedere 1-2 min al primo avvio):
|
|
||||||
adb shell 'while [ "$(getprop sys.boot_completed)" != "1" ]; do sleep 1; done'
|
adb shell 'while [ "$(getprop sys.boot_completed)" != "1" ]; do sleep 1; done'
|
||||||
```
|
|
||||||
|
|
||||||
**2. Installa l'APK:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
adb install -r dist/biteplan-debug.apk # -r = reinstalla sovrascrivendo se già presente
|
adb install -r dist/biteplan-debug.apk # -r = reinstalla sovrascrivendo se già presente
|
||||||
```
|
|
||||||
|
|
||||||
**3. Avvia l'app:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
adb shell monkey -p com.davide.biteplan -c android.intent.category.LAUNCHER 1
|
adb shell monkey -p com.davide.biteplan -c android.intent.category.LAUNCHER 1
|
||||||
```
|
|
||||||
|
|
||||||
**4. Osserva i log in tempo reale (utile per debug):**
|
# log in tempo reale
|
||||||
|
|
||||||
```bash
|
|
||||||
adb logcat --pid=$(adb shell pidof -s com.davide.biteplan)
|
adb logcat --pid=$(adb shell pidof -s com.davide.biteplan)
|
||||||
```
|
|
||||||
|
|
||||||
**5. Disinstalla quando hai finito:**
|
# disinstalla quando hai finito
|
||||||
|
|
||||||
```bash
|
|
||||||
adb uninstall com.davide.biteplan
|
adb uninstall com.davide.biteplan
|
||||||
```
|
```
|
||||||
|
|
||||||
> Per lo sviluppo iterativo (hot reload) usa invece `flutter run` — questa procedura serve
|
> Per lo sviluppo iterativo (hot reload) usa `flutter run` — questa procedura serve a
|
||||||
> a validare l'APK esatto che verrà distribuito.
|
> validare l'APK esatto che verrà distribuito.
|
||||||
|
|
||||||
## Test
|
## Test
|
||||||
|
|
||||||
La suite copre unit test e widget test. Richiede l'immagine Docker `biteplan-build`
|
Cosa è coperto, cosa no e insidie note: [docs/testing.md](docs/testing.md).
|
||||||
(creata automaticamente al primo `bash docker/build.sh`).
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
# Tutti i test (dalla root del progetto)
|
flutter test # tutta la suite (host)
|
||||||
docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
|
flutter test test/features/meal_planner/qr_test.dart # singolo file
|
||||||
bash -c "flutter pub get && flutter test"
|
|
||||||
|
|
||||||
# Un singolo file
|
# versione riproducibile via Docker (immagine biteplan-build, creata al primo bash docker/build.sh)
|
||||||
docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
|
docker run --rm -v "$(pwd):/workspace" -w /workspace biteplan-build \
|
||||||
bash -c "flutter test test/features/meal_planner/qr_test.dart"
|
bash -c "flutter pub get --enforce-lockfile && flutter test"
|
||||||
```
|
```
|
||||||
|
|
||||||
### Struttura
|
Struttura di `test/` (rispecchia `lib/`):
|
||||||
|
|
||||||
```
|
```text
|
||||||
test/
|
test/
|
||||||
├── helpers/
|
├── helpers/pump_app.dart # estensione pumpApp per widget test
|
||||||
│ └── pump_app.dart # estensione pumpApp per widget test
|
|
||||||
├── features/
|
├── features/
|
||||||
│ ├── converter/
|
│ ├── converter/{models,providers}/
|
||||||
│ │ ├── models/conversion_entry_test.dart
|
│ ├── meal_planner/{models,providers,widgets}/ + qr_test.dart
|
||||||
│ │ └── providers/converter_provider_test.dart
|
│ └── shopping_list/{models,providers,widgets}/
|
||||||
│ ├── meal_planner/
|
└── shared/{services,widgets}/
|
||||||
│ │ ├── 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
|
|
||||||
└── shared/
|
|
||||||
├── services/
|
|
||||||
│ └── update_service_test.dart # parsing versione e confronto semver
|
|
||||||
└── widgets/
|
|
||||||
└── update_dialog_test.dart # widget test dialog aggiornamento
|
|
||||||
```
|
```
|
||||||
|
|
||||||
## Build APK
|
## Build APK
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
bash docker/build.sh # debug → dist/biteplan-debug.apk
|
bash docker/build.sh # debug → dist/biteplan-debug.apk
|
||||||
|
export BITEPLAN_KEYSTORE_PASS=password # richiesto solo per --release
|
||||||
bash docker/build.sh --release # release → dist/biteplan-release.apk
|
bash docker/build.sh --release # release → dist/biteplan-release.apk
|
||||||
```
|
```
|
||||||
|
|
||||||
Vedi [docker/README.md](docker/README.md) per i requisiti della firma release.
|
Vedi [docker/README.md](docker/README.md) per i requisiti della firma release (keystore).
|
||||||
|
|
||||||
|
## Contribuire
|
||||||
|
|
||||||
|
Progetto personale mantenuto da un singolo autore, senza processo di contribuzione formale.
|
||||||
|
Segnalazioni di bug e proposte sono benvenute via [Issues](https://github.com/davide3011/biteplan/issues);
|
||||||
|
per modifiche più ampie apri prima una issue di discussione prima di lavorare a una PR.
|
||||||
|
|
||||||
## Documentazione
|
## Documentazione
|
||||||
|
|
||||||
- [Guida utente](docs/guida-utente.md)
|
- [Guida utente](docs/guida-utente.md)
|
||||||
|
- [Architettura](docs/architettura.md)
|
||||||
- [Fonti e documentazione conversioni](docs/conversioni.md)
|
- [Fonti e documentazione conversioni](docs/conversioni.md)
|
||||||
|
- [Emulatore Android — installazione e uso](docs/emulatore.md)
|
||||||
|
- [Test — cosa è coperto e come lanciarli](docs/testing.md)
|
||||||
- [Changelog](CHANGELOG.md)
|
- [Changelog](CHANGELOG.md)
|
||||||
|
|
||||||
## Licenza
|
## Stato e licenza
|
||||||
|
|
||||||
[EUPL v1.2](LICENSE) — Davide Grilli
|
Versione corrente: vedi [pubspec.yaml](pubspec.yaml) e [CHANGELOG.md](CHANGELOG.md).
|
||||||
|
Distribuito come APK firmato tramite le [release GitHub](https://github.com/davide3011/biteplan/releases);
|
||||||
|
l'app verifica automaticamente la disponibilità di aggiornamenti all'avvio.
|
||||||
|
|
||||||
|
Rilasciato sotto licenza [EUPL v1.2](LICENSE) — Davide Grilli.
|
||||||
@@ -0,0 +1,81 @@
|
|||||||
|
# db_prodotti — catalogo prodotti aldi.it
|
||||||
|
|
||||||
|
Dump del catalogo pubblico su [aldi.it/prodotti](https://www.aldi.it/prodotti), raccolto con
|
||||||
|
uno scraper (`scrape_aldi.py`) perché il sito non espone un'API pubblica ed è protetto da
|
||||||
|
bot-detection (Akamai) che blocca le richieste HTTP dirette — servono un browser reale
|
||||||
|
(Playwright + Chromium headless).
|
||||||
|
|
||||||
|
**Non fa parte dell'app BitePlan** (non è collegato a `lib/` né alla build Flutter): è un
|
||||||
|
dataset a sé, generato una tantum, da usare come riferimento offline (es. prezzi/prodotti per
|
||||||
|
alimentare in futuro il convertitore o la lista spesa).
|
||||||
|
|
||||||
|
## File
|
||||||
|
|
||||||
|
- `aldi_prodotti.db` — SQLite, tabelle `prodotti`, `categorie`, `prodotto_categorie` (join, un prodotto può comparire in più categorie foglia), `metadata` (data di generazione, fonte). Generato, non versionato (vedi `.gitignore`) — rigenerabile con lo script.
|
||||||
|
- `scrape_aldi.py` — script di generazione (Playwright + BeautifulSoup)
|
||||||
|
- `viewer.html` — UI statica per sfogliare il db nel browser (nessun server/dipendenza da installare)
|
||||||
|
|
||||||
|
## Schema SQLite
|
||||||
|
|
||||||
|
```
|
||||||
|
prodotti(sku PK, nome, marca, prezzo_testo, prezzo_scontato, unita_misura,
|
||||||
|
prezzo_comparativo, descrizione, immagine_url, url_prodotto)
|
||||||
|
categorie(slug PK, nome, breadcrumb)
|
||||||
|
prodotto_categorie(sku, categoria_slug)
|
||||||
|
```
|
||||||
|
|
||||||
|
`prezzo_testo` e `prezzo_comparativo` sono stringhe italiane così come mostrate sul sito
|
||||||
|
(es. `"0,75 €"`, `"(1,50 €/1 kg)"`) — non convertite in numero per evitare ambiguità di
|
||||||
|
parsing su formati misti (kg/100g/pezzo).
|
||||||
|
|
||||||
|
## Copertura e limiti
|
||||||
|
|
||||||
|
- **674 prodotti unici**, 90 categorie foglia (su 92 individuate; 2 risultate vuote),
|
||||||
|
generato il 2026-09-20. Include sia alimentari sia non-food (abbigliamento, casa, pet
|
||||||
|
care, elettronica, ecc.) perché il catalogo online ALDI Italia li espone tutti sotto
|
||||||
|
`/prodotti`.
|
||||||
|
- Il catalogo online ALDI Italia è un **volantino digitale**, non un e-commerce completo:
|
||||||
|
le pagine di dettaglio prodotto **non hanno quasi mai** ingredienti, valori nutrizionali o
|
||||||
|
codice EAN. Il campo `descrizione` è popolato solo per ~38% dei prodotti (376/674 vuoti),
|
||||||
|
più spesso su non-food (taglie, materiali) che su alimentari.
|
||||||
|
- I prezzi sono uno snapshot del giorno di generazione: ALDI aggiorna il volantino/le offerte
|
||||||
|
periodicamente, quindi il dato invecchia — va rigenerato se serve aggiornato.
|
||||||
|
|
||||||
|
## Rigenerare il db
|
||||||
|
|
||||||
|
```bash
|
||||||
|
pip install --break-system-packages playwright beautifulsoup4
|
||||||
|
python3 scrape_aldi.py # scraping completo (~20-30 min)
|
||||||
|
python3 scrape_aldi.py --no-detail # salta il dettaglio prodotto (solo elenco, ~2 min)
|
||||||
|
```
|
||||||
|
|
||||||
|
Usa il Chromium di sistema (`/snap/bin/chromium`) via Playwright, nessun download di
|
||||||
|
browser aggiuntivo. Include una pausa (`DELAY` in `scrape_aldi.py`) fra le richieste di
|
||||||
|
listing e fetch in parallelo (`DETAIL_CONCURRENCY = 8`, in `scrape_aldi.py`) per le pagine
|
||||||
|
di dettaglio, il collo di bottiglia principale.
|
||||||
|
|
||||||
|
Ogni run è **riproducibile**: `write_sqlite()` cancella `aldi_prodotti.db` se già esiste
|
||||||
|
(`db_path.unlink()`) e lo ricrea da zero con lo schema e i dati appena raccolti — nessun
|
||||||
|
merge/append tra run, il file rispecchia sempre solo l'ultimo scraping. `metadata.generato_il`
|
||||||
|
viene sovrascritto ad ogni rigenerazione con il timestamp del run corrente.
|
||||||
|
|
||||||
|
## Visualizzare il db (`viewer.html`)
|
||||||
|
|
||||||
|
Pagina statica (HTML + JS, [sql.js](https://sql.js.org) via CDN) che legge `aldi_prodotti.db`
|
||||||
|
direttamente nel browser, senza installazione né build:
|
||||||
|
|
||||||
|
- tabella con miniatura, nome, marca, prezzo (con eventuale prezzo scontato), formato/unità
|
||||||
|
di misura e categorie di appartenenza
|
||||||
|
- ricerca live per nome/marca
|
||||||
|
- filtro per categoria (dropdown popolato dalla tabella `categorie`)
|
||||||
|
- colonne ordinabili al click sull'intestazione (stesso click inverte la direzione)
|
||||||
|
- riepilogo in testa con data/ora di generazione e fonte, letti da `metadata`
|
||||||
|
|
||||||
|
Va **servita via HTTP** (il fetch del `.db` fallisce se apri il file con doppio click /
|
||||||
|
`file://`, per le restrizioni CORS del browser):
|
||||||
|
|
||||||
|
```bash
|
||||||
|
cd db_prodotti
|
||||||
|
python3 -m http.server 8000
|
||||||
|
# poi apri http://localhost:8000/viewer.html
|
||||||
|
```
|
||||||
@@ -0,0 +1,252 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
"""Scraper del catalogo prodotti aldi.it -> sqlite (aldi_prodotti.db) + JSON (aldi_prodotti.json).
|
||||||
|
|
||||||
|
Uso:
|
||||||
|
python3 scrape_aldi.py # scraping completo (categorie + elenco prodotti + dettaglio)
|
||||||
|
python3 scrape_aldi.py --no-detail # salta il fetch delle pagine di dettaglio prodotto
|
||||||
|
|
||||||
|
Richiede: playwright (pip install playwright), un browser chromium disponibile
|
||||||
|
(usa /snap/bin/chromium di sistema via executable_path, nessun download extra).
|
||||||
|
"""
|
||||||
|
import argparse
|
||||||
|
import asyncio
|
||||||
|
import re
|
||||||
|
import sqlite3
|
||||||
|
import sys
|
||||||
|
import time
|
||||||
|
from pathlib import Path
|
||||||
|
from urllib.parse import urljoin
|
||||||
|
|
||||||
|
from bs4 import BeautifulSoup
|
||||||
|
from playwright.async_api import async_playwright
|
||||||
|
from playwright.sync_api import sync_playwright
|
||||||
|
|
||||||
|
BASE = "https://www.aldi.it"
|
||||||
|
UA = ("Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 "
|
||||||
|
"(KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36")
|
||||||
|
OUT_DIR = Path(__file__).parent
|
||||||
|
DELAY = 0.4 # pausa fra le richieste di listing, per non martellare il sito
|
||||||
|
DETAIL_CONCURRENCY = 8 # pagine di dettaglio in parallelo
|
||||||
|
|
||||||
|
|
||||||
|
def slug_to_label(slug: str) -> str:
|
||||||
|
return slug.replace("-", " ").strip().capitalize()
|
||||||
|
|
||||||
|
|
||||||
|
def find_leaf_categories(page) -> list[dict]:
|
||||||
|
page.goto(f"{BASE}/prodotti", timeout=30000)
|
||||||
|
page.wait_for_load_state("networkidle", timeout=15000)
|
||||||
|
soup = BeautifulSoup(page.content(), "html.parser")
|
||||||
|
hrefs = sorted({a["href"] for a in soup.find_all("a", href=True)
|
||||||
|
if re.match(r"^/prodotti/.+/k/\d+$", a["href"])})
|
||||||
|
paths = [h.split("/k/")[0] for h in hrefs]
|
||||||
|
leaves = []
|
||||||
|
for h, p in zip(hrefs, paths):
|
||||||
|
is_leaf = not any(p2 != p and p2.startswith(p + "/") for p2 in paths)
|
||||||
|
if is_leaf:
|
||||||
|
slugs = p.strip("/").split("/")[1:] # rimuove "prodotti"
|
||||||
|
leaves.append({
|
||||||
|
"url": urljoin(BASE, h),
|
||||||
|
"slug_path": "/".join(slugs),
|
||||||
|
"breadcrumb": " > ".join(slug_to_label(s) for s in slugs),
|
||||||
|
"categoria_slug": slugs[-1],
|
||||||
|
"categoria_nome": slug_to_label(slugs[-1]),
|
||||||
|
})
|
||||||
|
return leaves
|
||||||
|
|
||||||
|
|
||||||
|
def parse_product_tiles(html: str) -> list[dict]:
|
||||||
|
soup = BeautifulSoup(html, "html.parser")
|
||||||
|
products = []
|
||||||
|
for tile_wrap in soup.select('[id^="product-tile-"]'):
|
||||||
|
sku = tile_wrap["id"].replace("product-tile-", "")
|
||||||
|
tile = tile_wrap.select_one(".product-tile")
|
||||||
|
if tile is None:
|
||||||
|
continue
|
||||||
|
name_el = tile.select_one(".product-tile__name p")
|
||||||
|
brand_el = tile.select_one(".product-tile__brandname p")
|
||||||
|
price_el = tile.select_one(".base-price__regular span")
|
||||||
|
old_price_el = tile.select_one(".base-price__discount-tag__wrapper")
|
||||||
|
unit_el = tile.select_one('[data-test="product-tile__unit-of-measurement"]')
|
||||||
|
comp_price_el = tile.select_one('[data-test="product-tile__comparison-price"]')
|
||||||
|
link_el = tile.select_one("a.product-tile__link")
|
||||||
|
img_el = tile.select_one("img")
|
||||||
|
|
||||||
|
products.append({
|
||||||
|
"sku": sku,
|
||||||
|
"nome": name_el.get_text(strip=True) if name_el else tile.get("title"),
|
||||||
|
"marca": brand_el.get_text(strip=True).rstrip(",") if brand_el else None,
|
||||||
|
"prezzo_testo": price_el.get_text(strip=True) if price_el else None,
|
||||||
|
"prezzo_scontato": bool(old_price_el and old_price_el.get_text(strip=True)),
|
||||||
|
"unita_misura": unit_el.get_text(strip=True) if unit_el else None,
|
||||||
|
"prezzo_comparativo": comp_price_el.get_text(strip=True) if comp_price_el else None,
|
||||||
|
"url_prodotto": urljoin(BASE, link_el["href"]) if link_el else None,
|
||||||
|
"immagine_url": img_el["src"] if img_el and img_el.get("src") else None,
|
||||||
|
})
|
||||||
|
return products
|
||||||
|
|
||||||
|
|
||||||
|
def max_page(html: str) -> int:
|
||||||
|
soup = BeautifulSoup(html, "html.parser")
|
||||||
|
pages = [int(a.get_text(strip=True)) for a in soup.select(".base-pagination__count")
|
||||||
|
if a.get_text(strip=True).isdigit()]
|
||||||
|
return max(pages) if pages else 1
|
||||||
|
|
||||||
|
|
||||||
|
def scrape_listing(page, leaves: list[dict]) -> dict:
|
||||||
|
"""Ritorna {sku: prodotto} con le categorie aggregate."""
|
||||||
|
products: dict[str, dict] = {}
|
||||||
|
for i, cat in enumerate(leaves, 1):
|
||||||
|
print(f"[{i}/{len(leaves)}] {cat['breadcrumb']}", file=sys.stderr)
|
||||||
|
page.goto(cat["url"], timeout=30000)
|
||||||
|
try:
|
||||||
|
page.wait_for_selector('[id^="product-tile-"], .product-listing-viewer', timeout=15000)
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
html = page.content()
|
||||||
|
n_pages = max_page(html)
|
||||||
|
all_tiles = parse_product_tiles(html)
|
||||||
|
for p in range(2, n_pages + 1):
|
||||||
|
time.sleep(DELAY)
|
||||||
|
page.goto(f"{cat['url']}?page={p}", timeout=30000)
|
||||||
|
page.wait_for_selector('[id^="product-tile-"]', timeout=15000)
|
||||||
|
all_tiles.extend(parse_product_tiles(page.content()))
|
||||||
|
|
||||||
|
for t in all_tiles:
|
||||||
|
existing = products.get(t["sku"])
|
||||||
|
if existing is None:
|
||||||
|
t["categorie"] = [{"slug": cat["categoria_slug"], "nome": cat["categoria_nome"],
|
||||||
|
"breadcrumb": cat["breadcrumb"]}]
|
||||||
|
products[t["sku"]] = t
|
||||||
|
else:
|
||||||
|
if not any(c["slug"] == cat["categoria_slug"] for c in existing["categorie"]):
|
||||||
|
existing["categorie"].append({"slug": cat["categoria_slug"],
|
||||||
|
"nome": cat["categoria_nome"],
|
||||||
|
"breadcrumb": cat["breadcrumb"]})
|
||||||
|
time.sleep(DELAY)
|
||||||
|
return products
|
||||||
|
|
||||||
|
|
||||||
|
async def _scrape_detail_one(context, product: dict, sem: asyncio.Semaphore,
|
||||||
|
progress: list, total: int) -> None:
|
||||||
|
async with sem:
|
||||||
|
page = await context.new_page()
|
||||||
|
try:
|
||||||
|
await page.goto(product["url_prodotto"], timeout=30000)
|
||||||
|
await page.wait_for_load_state("networkidle", timeout=15000)
|
||||||
|
soup = BeautifulSoup(await page.content(), "html.parser")
|
||||||
|
desc_el = soup.select_one(".product-details__information .show-more__content")
|
||||||
|
product["descrizione"] = desc_el.get_text(strip=True) if desc_el else None
|
||||||
|
except Exception as e:
|
||||||
|
print(f" errore su {product['url_prodotto']}: {e}", file=sys.stderr)
|
||||||
|
product["descrizione"] = None
|
||||||
|
finally:
|
||||||
|
await page.close()
|
||||||
|
progress.append(1)
|
||||||
|
print(f"[dettaglio {len(progress)}/{total}] {product['nome']}", file=sys.stderr)
|
||||||
|
|
||||||
|
|
||||||
|
async def scrape_detail_async(products: dict) -> None:
|
||||||
|
"""Fetch delle pagine di dettaglio in parallelo (DETAIL_CONCURRENCY schede alla volta)."""
|
||||||
|
items = [p for p in products.values() if p.get("url_prodotto")]
|
||||||
|
sem = asyncio.Semaphore(DETAIL_CONCURRENCY)
|
||||||
|
progress: list = []
|
||||||
|
|
||||||
|
async with async_playwright() as pw:
|
||||||
|
browser = await pw.chromium.launch(executable_path="/snap/bin/chromium", headless=True,
|
||||||
|
args=["--no-sandbox", "--disable-gpu"])
|
||||||
|
context = await browser.new_context(user_agent=UA)
|
||||||
|
await asyncio.gather(*(_scrape_detail_one(context, p, sem, progress, len(items))
|
||||||
|
for p in items))
|
||||||
|
await browser.close()
|
||||||
|
|
||||||
|
|
||||||
|
def scrape_detail(products: dict) -> None:
|
||||||
|
asyncio.run(scrape_detail_async(products))
|
||||||
|
|
||||||
|
|
||||||
|
def write_sqlite(products: dict, db_path: Path) -> None:
|
||||||
|
if db_path.exists():
|
||||||
|
db_path.unlink()
|
||||||
|
conn = sqlite3.connect(db_path)
|
||||||
|
conn.executescript("""
|
||||||
|
CREATE TABLE categorie (
|
||||||
|
slug TEXT PRIMARY KEY,
|
||||||
|
nome TEXT NOT NULL,
|
||||||
|
breadcrumb TEXT NOT NULL
|
||||||
|
);
|
||||||
|
CREATE TABLE prodotti (
|
||||||
|
sku TEXT PRIMARY KEY,
|
||||||
|
nome TEXT NOT NULL,
|
||||||
|
marca TEXT,
|
||||||
|
prezzo_testo TEXT,
|
||||||
|
prezzo_scontato INTEGER NOT NULL DEFAULT 0,
|
||||||
|
unita_misura TEXT,
|
||||||
|
prezzo_comparativo TEXT,
|
||||||
|
descrizione TEXT,
|
||||||
|
immagine_url TEXT,
|
||||||
|
url_prodotto TEXT
|
||||||
|
);
|
||||||
|
CREATE TABLE prodotto_categorie (
|
||||||
|
sku TEXT NOT NULL REFERENCES prodotti(sku),
|
||||||
|
categoria_slug TEXT NOT NULL REFERENCES categorie(slug),
|
||||||
|
PRIMARY KEY (sku, categoria_slug)
|
||||||
|
);
|
||||||
|
CREATE TABLE metadata (
|
||||||
|
chiave TEXT PRIMARY KEY,
|
||||||
|
valore TEXT NOT NULL
|
||||||
|
);
|
||||||
|
""")
|
||||||
|
conn.execute("INSERT INTO metadata (chiave, valore) VALUES ('generato_il', ?)",
|
||||||
|
(time.strftime("%Y-%m-%dT%H:%M:%S%z"),))
|
||||||
|
conn.execute("INSERT INTO metadata (chiave, valore) VALUES ('fonte', ?)",
|
||||||
|
(f"{BASE}/prodotti",))
|
||||||
|
seen_cat = set()
|
||||||
|
for p in products.values():
|
||||||
|
conn.execute(
|
||||||
|
"INSERT INTO prodotti (sku, nome, marca, prezzo_testo, prezzo_scontato, "
|
||||||
|
"unita_misura, prezzo_comparativo, descrizione, immagine_url, url_prodotto) "
|
||||||
|
"VALUES (?,?,?,?,?,?,?,?,?,?)",
|
||||||
|
(p["sku"], p["nome"], p.get("marca"), p.get("prezzo_testo"),
|
||||||
|
int(p.get("prezzo_scontato", False)), p.get("unita_misura"),
|
||||||
|
p.get("prezzo_comparativo"), p.get("descrizione"), p.get("immagine_url"),
|
||||||
|
p.get("url_prodotto")),
|
||||||
|
)
|
||||||
|
for c in p["categorie"]:
|
||||||
|
if c["slug"] not in seen_cat:
|
||||||
|
conn.execute("INSERT INTO categorie (slug, nome, breadcrumb) VALUES (?,?,?)",
|
||||||
|
(c["slug"], c["nome"], c["breadcrumb"]))
|
||||||
|
seen_cat.add(c["slug"])
|
||||||
|
conn.execute("INSERT OR IGNORE INTO prodotto_categorie (sku, categoria_slug) VALUES (?,?)",
|
||||||
|
(p["sku"], c["slug"]))
|
||||||
|
conn.commit()
|
||||||
|
conn.close()
|
||||||
|
|
||||||
|
|
||||||
|
def main():
|
||||||
|
ap = argparse.ArgumentParser()
|
||||||
|
ap.add_argument("--no-detail", action="store_true", help="salta il fetch delle pagine di dettaglio")
|
||||||
|
args = ap.parse_args()
|
||||||
|
|
||||||
|
with sync_playwright() as pw:
|
||||||
|
browser = pw.chromium.launch(executable_path="/snap/bin/chromium", headless=True,
|
||||||
|
args=["--no-sandbox", "--disable-gpu"])
|
||||||
|
page = browser.new_page(user_agent=UA)
|
||||||
|
|
||||||
|
leaves = find_leaf_categories(page)
|
||||||
|
print(f"{len(leaves)} categorie foglia trovate", file=sys.stderr)
|
||||||
|
|
||||||
|
products = scrape_listing(page, leaves)
|
||||||
|
print(f"{len(products)} prodotti unici trovati", file=sys.stderr)
|
||||||
|
|
||||||
|
browser.close()
|
||||||
|
|
||||||
|
if not args.no_detail:
|
||||||
|
scrape_detail(products) # fase separata: usa l'API async per il fetch in parallelo
|
||||||
|
|
||||||
|
write_sqlite(products, OUT_DIR / "aldi_prodotti.db")
|
||||||
|
print("Fatto: aldi_prodotti.db", file=sys.stderr)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == "__main__":
|
||||||
|
main()
|
||||||
@@ -0,0 +1,160 @@
|
|||||||
|
<!doctype html>
|
||||||
|
<html lang="it">
|
||||||
|
<head>
|
||||||
|
<meta charset="utf-8">
|
||||||
|
<title>Catalogo ALDI — visualizzatore</title>
|
||||||
|
<style>
|
||||||
|
:root { color-scheme: light dark; }
|
||||||
|
body { font-family: system-ui, sans-serif; margin: 0; padding: 1.5rem; background: #f7f7f5; color: #1a1a1a; }
|
||||||
|
h1 { font-size: 1.25rem; margin: 0 0 0.25rem; }
|
||||||
|
#meta { color: #666; font-size: 0.85rem; margin-bottom: 1rem; }
|
||||||
|
#controls { display: flex; gap: 0.75rem; flex-wrap: wrap; margin-bottom: 1rem; }
|
||||||
|
input, select { padding: 0.4rem 0.6rem; font-size: 0.9rem; border: 1px solid #ccc; border-radius: 6px; }
|
||||||
|
input[type="search"] { flex: 1; min-width: 200px; }
|
||||||
|
#count { font-size: 0.85rem; color: #666; margin-bottom: 0.5rem; }
|
||||||
|
#table-wrap { overflow-x: auto; background: #fff; border-radius: 8px; }
|
||||||
|
table { width: 100%; min-width: 780px; border-collapse: collapse; }
|
||||||
|
th, td { text-align: left; padding: 0.5rem 0.6rem; border-bottom: 1px solid #eee; font-size: 0.9rem; vertical-align: middle; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; max-width: 260px; }
|
||||||
|
th:nth-child(2), td:nth-child(2) { min-width: 220px; }
|
||||||
|
th:nth-child(6), td:nth-child(6) { white-space: normal; }
|
||||||
|
th { background: #eee; cursor: pointer; user-select: none; position: sticky; top: 0; }
|
||||||
|
th:hover { background: #e2e2e2; }
|
||||||
|
img.thumb { width: 40px; height: 40px; object-fit: contain; border-radius: 4px; background: #f0f0f0; display: block; }
|
||||||
|
tr:hover { background: #fafafa; }
|
||||||
|
a { color: #2d6a4f; }
|
||||||
|
#error { color: #b00020; white-space: pre-wrap; }
|
||||||
|
</style>
|
||||||
|
</head>
|
||||||
|
<body>
|
||||||
|
<h1>Catalogo ALDI — visualizzatore</h1>
|
||||||
|
<div id="meta">caricamento...</div>
|
||||||
|
<div id="controls">
|
||||||
|
<input type="search" id="q" placeholder="Cerca per nome o marca...">
|
||||||
|
<select id="categoria"><option value="">Tutte le categorie</option></select>
|
||||||
|
</div>
|
||||||
|
<div id="count"></div>
|
||||||
|
<div id="error"></div>
|
||||||
|
<div id="table-wrap">
|
||||||
|
<table id="tabella">
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th></th>
|
||||||
|
<th data-key="nome">Nome</th>
|
||||||
|
<th data-key="marca">Marca</th>
|
||||||
|
<th data-key="prezzo_num">Prezzo</th>
|
||||||
|
<th data-key="unita_misura">Formato</th>
|
||||||
|
<th data-key="categorie">Categorie</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody></tbody>
|
||||||
|
</table>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<script src="https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.10.3/sql-wasm.js"></script>
|
||||||
|
<script>
|
||||||
|
let allRows = [];
|
||||||
|
let sortKey = null, sortDir = 1;
|
||||||
|
|
||||||
|
function parsePrezzo(testo) {
|
||||||
|
if (!testo) return null;
|
||||||
|
const n = testo.replace(/[^\d,]/g, "").replace(",", ".");
|
||||||
|
return n ? parseFloat(n) : null;
|
||||||
|
}
|
||||||
|
|
||||||
|
async function main() {
|
||||||
|
const errEl = document.getElementById("error");
|
||||||
|
try {
|
||||||
|
const SQL = await initSqlJs({ locateFile: f => `https://cdnjs.cloudflare.com/ajax/libs/sql.js/1.10.3/${f}` });
|
||||||
|
const buf = await (await fetch("aldi_prodotti.db")).arrayBuffer();
|
||||||
|
const db = new SQL.Database(new Uint8Array(buf));
|
||||||
|
|
||||||
|
const meta = {};
|
||||||
|
db.exec("SELECT chiave, valore FROM metadata")[0]?.values.forEach(([k, v]) => meta[k] = v);
|
||||||
|
const generatoIl = meta.generato_il
|
||||||
|
? new Date(meta.generato_il).toLocaleString("it-IT", { dateStyle: "long", timeStyle: "short" })
|
||||||
|
: "?";
|
||||||
|
document.getElementById("meta").textContent =
|
||||||
|
`Generato il ${generatoIl} — fonte: ${meta.fonte ?? "?"}`;
|
||||||
|
|
||||||
|
const catStmt = db.exec("SELECT slug, breadcrumb FROM categorie ORDER BY breadcrumb");
|
||||||
|
const catSel = document.getElementById("categoria");
|
||||||
|
(catStmt[0]?.values ?? []).forEach(([slug, breadcrumb]) => {
|
||||||
|
const opt = document.createElement("option");
|
||||||
|
opt.value = slug;
|
||||||
|
opt.textContent = breadcrumb;
|
||||||
|
catSel.appendChild(opt);
|
||||||
|
});
|
||||||
|
|
||||||
|
const res = db.exec(`
|
||||||
|
SELECT p.sku, p.nome, p.marca, p.prezzo_testo, p.unita_misura, p.immagine_url,
|
||||||
|
p.url_prodotto,
|
||||||
|
(SELECT group_concat(c.nome, ', ') FROM prodotto_categorie pc
|
||||||
|
JOIN categorie c ON c.slug = pc.categoria_slug WHERE pc.sku = p.sku) AS categorie,
|
||||||
|
(SELECT group_concat(pc.categoria_slug, ',') FROM prodotto_categorie pc
|
||||||
|
WHERE pc.sku = p.sku) AS categoria_slugs
|
||||||
|
FROM prodotti p
|
||||||
|
`);
|
||||||
|
const cols = res[0].columns;
|
||||||
|
allRows = res[0].values.map(row => {
|
||||||
|
const o = Object.fromEntries(cols.map((c, i) => [c, row[i]]));
|
||||||
|
o.prezzo_num = parsePrezzo(o.prezzo_testo);
|
||||||
|
return o;
|
||||||
|
});
|
||||||
|
|
||||||
|
document.getElementById("q").addEventListener("input", render);
|
||||||
|
catSel.addEventListener("change", render);
|
||||||
|
document.querySelectorAll("th[data-key]").forEach(th => {
|
||||||
|
th.addEventListener("click", () => {
|
||||||
|
const key = th.dataset.key;
|
||||||
|
sortDir = (sortKey === key) ? -sortDir : 1;
|
||||||
|
sortKey = key;
|
||||||
|
render();
|
||||||
|
});
|
||||||
|
});
|
||||||
|
|
||||||
|
render();
|
||||||
|
} catch (e) {
|
||||||
|
errEl.textContent = "Errore nel caricamento del database: " + e.message +
|
||||||
|
"\n\nSe hai aperto questo file direttamente (file://), il browser blocca il fetch " +
|
||||||
|
"del .db per motivi di sicurezza. Avvialo invece con:\n" +
|
||||||
|
" cd db_prodotti && python3 -m http.server 8000\n" +
|
||||||
|
"e apri http://localhost:8000/viewer.html";
|
||||||
|
document.getElementById("meta").textContent = "";
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function render() {
|
||||||
|
const q = document.getElementById("q").value.trim().toLowerCase();
|
||||||
|
const cat = document.getElementById("categoria").value;
|
||||||
|
let rows = allRows.filter(r =>
|
||||||
|
(!q || (r.nome ?? "").toLowerCase().includes(q) || (r.marca ?? "").toLowerCase().includes(q)) &&
|
||||||
|
(!cat || (r.categoria_slugs ?? "").split(",").includes(cat))
|
||||||
|
);
|
||||||
|
if (sortKey) {
|
||||||
|
rows = rows.slice().sort((a, b) => {
|
||||||
|
const av = a[sortKey] ?? "", bv = b[sortKey] ?? "";
|
||||||
|
return av < bv ? -sortDir : av > bv ? sortDir : 0;
|
||||||
|
});
|
||||||
|
}
|
||||||
|
document.getElementById("count").textContent = `${rows.length} / ${allRows.length} prodotti`;
|
||||||
|
|
||||||
|
const tbody = document.querySelector("#tabella tbody");
|
||||||
|
tbody.innerHTML = "";
|
||||||
|
for (const r of rows) {
|
||||||
|
const tr = document.createElement("tr");
|
||||||
|
tr.innerHTML = `
|
||||||
|
<td>${r.immagine_url ? `<img class="thumb" src="${r.immagine_url}" loading="lazy" alt="">` : ""}</td>
|
||||||
|
<td><a href="${r.url_prodotto ?? "#"}" target="_blank" rel="noopener">${r.nome ?? ""}</a></td>
|
||||||
|
<td>${r.marca ?? ""}</td>
|
||||||
|
<td>${r.prezzo_testo ?? ""}</td>
|
||||||
|
<td>${r.unita_misura ?? ""}</td>
|
||||||
|
<td>${r.categorie ?? ""}</td>
|
||||||
|
`;
|
||||||
|
tbody.appendChild(tr);
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
main();
|
||||||
|
</script>
|
||||||
|
</body>
|
||||||
|
</html>
|
||||||
@@ -0,0 +1,83 @@
|
|||||||
|
# Architettura — BitePlan
|
||||||
|
|
||||||
|
Documento tecnico per chi sviluppa o mantiene l'app: come sono strutturati i dati e come
|
||||||
|
scorrono tra UI, provider e persistenza. Per l'elenco file per file vedi [CLAUDE.md](../CLAUDE.md);
|
||||||
|
per l'uso dell'app vedi [guida-utente.md](guida-utente.md).
|
||||||
|
|
||||||
|
## Pattern generale
|
||||||
|
|
||||||
|
Ogni feature (`meal_planner`, `converter`, `shopping_list`) segue lo stesso schema:
|
||||||
|
|
||||||
|
```
|
||||||
|
Widget (presentation/) → Provider (ChangeNotifier) → StorageService / asset → SharedPreferences
|
||||||
|
↑____________________________notifyListeners()____________________________|
|
||||||
|
```
|
||||||
|
|
||||||
|
Ogni provider espone metodi che mutano lo stato immutabile in memoria, chiamano
|
||||||
|
`notifyListeners()` e poi salvano in modo fire-and-forget (senza `await`, l'UI non aspetta
|
||||||
|
la scrittura su disco). `load()` va chiamato una volta all'avvio (in `main.dart`) prima di
|
||||||
|
usare il provider.
|
||||||
|
|
||||||
|
## Piano pasti (`meal_planner`)
|
||||||
|
|
||||||
|
- **Modello**: `MealPlan` è una mappa `dayId → DayPlan`; `DayPlan` ha tre liste di stringhe
|
||||||
|
(`colazione`, `pranzo`, `cena`). Entrambi sono immutabili: ogni modifica passa da
|
||||||
|
`copyWith`/`withUpdatedDay` e ricostruisce l'oggetto.
|
||||||
|
- **Provider**: `MealPlannerProvider` tiene `_plan` in memoria, la inizializza vuota con
|
||||||
|
`MealPlan.empty(kDayIds)`, la carica da `StorageService` (chiave `meals`, JSON via
|
||||||
|
`toJsonString`/`fromJsonString`). Se il JSON salvato è corrotto, torna a un piano vuoto
|
||||||
|
invece di lanciare un'eccezione.
|
||||||
|
- **Condivisione QR** (`qr_codec.dart`): `buildQrPayload` serializza il piano come
|
||||||
|
`{ "v": 1, "meals": {...} }` e restituisce `null` se supera 2953 byte (capienza QR con error
|
||||||
|
correction L) — la UI mostra un errore in quel caso. `parseMealPlanFromQr` valida
|
||||||
|
struttura e versione prima di ricostruire il `MealPlan`, per non far crashare l'app su un
|
||||||
|
QR malformato o generato da una versione futura.
|
||||||
|
- **Generazione lista spesa**: la pagina piano pasti legge `plan.allItems` e chiama
|
||||||
|
`ShoppingListProvider.addAll(...)` — l'aggregazione duplicati avviene lì, non nel meal
|
||||||
|
planner.
|
||||||
|
|
||||||
|
## Convertitore crudo/cotto (`converter`)
|
||||||
|
|
||||||
|
- **Dati**: `assets/data/conversions.json` è una mappa `alimento → metodo → { yield }`,
|
||||||
|
caricata una sola volta in `ConverterProvider.loadDb()` e appiattita in una lista di
|
||||||
|
`ConversionEntry { food, method, yieldFactor }`.
|
||||||
|
- **Calcolo**: `rawToCooked = raw * yieldFactor`, `cookedToRaw = cooked / yieldFactor`.
|
||||||
|
Il provider arrotonda il risultato a un decimale (`(v * 10).roundToDouble() / 10`).
|
||||||
|
- **Ricerca**: `search(query)` filtra `_db` per sottostringa case-insensitive sul nome
|
||||||
|
alimento; non c'è persistenza, lo stato (`selected`, `grams`, `rawToCooked`) vive solo in
|
||||||
|
memoria e si azzera con `reset()`.
|
||||||
|
- I coefficienti e le fonti sono documentati in [conversioni.md](conversioni.md) — per
|
||||||
|
aggiungerne di nuovi si modifica solo il JSON, non serve toccare il provider.
|
||||||
|
|
||||||
|
## Lista della spesa (`shopping_list`)
|
||||||
|
|
||||||
|
- **Modello**: `ShoppingItem { id, name, checked, quantity }`. `id` è generato come
|
||||||
|
`timestamp_contatore` (non un vero UUID) per garantire unicità anche ad aggiunte multiple
|
||||||
|
nello stesso millisecondo.
|
||||||
|
- **Provider**: `ShoppingListProvider` persiste su chiave `shopping_list` come lista JSON.
|
||||||
|
`pendingItems`/`checkedItems` sono getter derivati, non stato separato.
|
||||||
|
- **`addAll(names)`**: raggruppa i nomi per confronto case-insensitive, somma le occorrenze
|
||||||
|
in `quantity` e salta quelli già presenti nella lista (case-insensitive anche lì) — è il
|
||||||
|
meccanismo dietro "zucchine (x2)" e dietro il "senza duplicati" della generazione lista
|
||||||
|
dal piano pasti.
|
||||||
|
|
||||||
|
## Controllo aggiornamenti
|
||||||
|
|
||||||
|
`UpdateService.checkUpdate()` (chiamato da `app.dart` in `initState`) interroga
|
||||||
|
`GET /repos/davide3011/biteplan/releases/latest` su GitHub con `dart:io HttpClient`
|
||||||
|
(nessun package HTTP aggiuntivo), timeout 5s su connessione e risposta. Confronta il
|
||||||
|
`tag_name` (spogliato del prefisso `v`) con `kAppVersion` via confronto semver a tre
|
||||||
|
componenti (`isNewer`); qualsiasi errore di rete, parsing o timeout fa fallire silenziosamente
|
||||||
|
il controllo (ritorna `null`, nessun dialog). Disabilitato su web (`kIsWeb`).
|
||||||
|
|
||||||
|
`kAppVersion` in `app_constants.dart` **non** è sincronizzato automaticamente con
|
||||||
|
`pubspec.yaml` — va aggiornato a mano ad ogni release, altrimenti il confronto versione è
|
||||||
|
sbagliato.
|
||||||
|
|
||||||
|
## MethodChannel nativo
|
||||||
|
|
||||||
|
Il bottone "Scarica" del dialog di aggiornamento e altri link esterni passano da
|
||||||
|
`UrlLauncherService`, che invoca il canale nativo `com.davide.biteplan/launcher`
|
||||||
|
implementato in Kotlin (`android/app/src/main/kotlin/com/davide/biteplan/MainActivity.kt`)
|
||||||
|
con un `Intent.ACTION_VIEW` — scelta per evitare di aggiungere il package `url_launcher`
|
||||||
|
per un solo caso d'uso.
|
||||||
@@ -0,0 +1,121 @@
|
|||||||
|
# Emulatore Android — installazione e uso (Ubuntu)
|
||||||
|
|
||||||
|
Guida per chi sviluppa BitePlan su Ubuntu (nativo o WSL2) e deve installare ed usare
|
||||||
|
l'emulatore Android in locale. Per i requisiti generali del progetto vedi [README](../README.md);
|
||||||
|
per la build via Docker vedi [CLAUDE.md](../CLAUDE.md).
|
||||||
|
|
||||||
|
## 1. Prerequisiti
|
||||||
|
|
||||||
|
- **KVM** per l'accelerazione hardware: senza, l'emulatore è troppo lento per essere usabile.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
ls /dev/kvm # deve esistere
|
||||||
|
groups | grep kvm # il tuo utente deve essere nel gruppo kvm
|
||||||
|
```
|
||||||
|
|
||||||
|
Se il gruppo manca:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sudo usermod -aG kvm $USER
|
||||||
|
# poi rilogin (o riavvia la sessione) perché il gruppo sia effettivo
|
||||||
|
```
|
||||||
|
|
||||||
|
Su **WSL2** serve un kernel con KVM abilitato (le versioni recenti lo hanno di serie).
|
||||||
|
La finestra dell'emulatore compare tramite WSLg.
|
||||||
|
|
||||||
|
- **Java 17+**: `sudo apt install openjdk-21-jdk`
|
||||||
|
- Strumenti di base: `git curl unzip`, e ~15 GB di spazio libero per SDK + system image.
|
||||||
|
|
||||||
|
## 2. Installare Android SDK command-line tools
|
||||||
|
|
||||||
|
```bash
|
||||||
|
mkdir -p ~/android-sdk/cmdline-tools
|
||||||
|
cd ~/android-sdk/cmdline-tools
|
||||||
|
curl -O https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip
|
||||||
|
unzip commandlinetools-linux-11076708_latest.zip && mv cmdline-tools latest
|
||||||
|
rm commandlinetools-linux-11076708_latest.zip
|
||||||
|
|
||||||
|
cat >> ~/.bashrc <<'EOF'
|
||||||
|
export ANDROID_HOME="$HOME/android-sdk"
|
||||||
|
export PATH="$ANDROID_HOME/cmdline-tools/latest/bin:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator:$PATH"
|
||||||
|
EOF
|
||||||
|
source ~/.bashrc
|
||||||
|
```
|
||||||
|
|
||||||
|
## 3. Installare i pacchetti SDK e accettare le licenze
|
||||||
|
|
||||||
|
```bash
|
||||||
|
sdkmanager "platform-tools" "emulator" \
|
||||||
|
"platforms;android-34" "build-tools;34.0.0" \
|
||||||
|
"system-images;android-34;google_apis;x86_64"
|
||||||
|
yes | sdkmanager --licenses
|
||||||
|
```
|
||||||
|
|
||||||
|
## 4. Creare l'AVD `biteplan`
|
||||||
|
|
||||||
|
Il progetto usa un AVD dedicato (Pixel 6, Android 14, `google_apis`/x86_64) — non riusare
|
||||||
|
AVD di altri progetti.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
echo "no" | avdmanager create avd -n biteplan \
|
||||||
|
-k "system-images;android-34;google_apis;x86_64" -d pixel_6
|
||||||
|
```
|
||||||
|
|
||||||
|
Verifica che tutto sia a posto con `flutter doctor` (la voce "Android toolchain" deve
|
||||||
|
risultare ✓).
|
||||||
|
|
||||||
|
## 5. Avviare l'emulatore
|
||||||
|
|
||||||
|
```bash
|
||||||
|
emulator -avd biteplan &
|
||||||
|
```
|
||||||
|
|
||||||
|
Il primo boot richiede 1-2 minuti; quelli successivi sono più veloci grazie allo snapshot
|
||||||
|
automatico dello stato. Per lo sviluppo con hot reload, dalla root del progetto:
|
||||||
|
|
||||||
|
```bash
|
||||||
|
flutter run # r = hot reload, R = hot restart
|
||||||
|
```
|
||||||
|
|
||||||
|
### Opzioni utili
|
||||||
|
|
||||||
|
```bash
|
||||||
|
emulator -list-avds # elenca gli AVD disponibili
|
||||||
|
emulator -avd biteplan -no-snapshot-load # forza un cold boot (ignora lo stato salvato)
|
||||||
|
emulator -avd biteplan -wipe-data # resetta l'AVD allo stato di fabbrica
|
||||||
|
```
|
||||||
|
|
||||||
|
## 6. Comandi `adb` quotidiani
|
||||||
|
|
||||||
|
```bash
|
||||||
|
adb devices # emulatori/device collegati
|
||||||
|
adb wait-for-device # attende che l'emulatore sia raggiungibile
|
||||||
|
adb shell 'while [ "$(getprop sys.boot_completed)" != "1" ]; do sleep 1; done' # attende il boot completo
|
||||||
|
|
||||||
|
adb install -r dist/biteplan-debug.apk # installa/reinstalla un APK già buildato
|
||||||
|
adb shell monkey -p com.davide.biteplan -c android.intent.category.LAUNCHER 1 # avvia l'app
|
||||||
|
|
||||||
|
adb logcat --pid=$(adb shell pidof -s com.davide.biteplan) # log in tempo reale dell'app
|
||||||
|
|
||||||
|
adb uninstall com.davide.biteplan # disinstalla
|
||||||
|
```
|
||||||
|
|
||||||
|
> Per lo sviluppo iterativo usa `flutter run` (hot reload); la sequenza `adb install` sopra
|
||||||
|
> serve a validare l'APK esatto che verrà distribuito, senza passare da `flutter run`.
|
||||||
|
|
||||||
|
## 7. Chiudere l'emulatore
|
||||||
|
|
||||||
|
```bash
|
||||||
|
adb -s emulator-5554 emu kill # spegnimento pulito (salva lo snapshot)
|
||||||
|
# oppure chiudi la finestra dell'emulatore
|
||||||
|
```
|
||||||
|
|
||||||
|
## Troubleshooting
|
||||||
|
|
||||||
|
| Sintomo | Causa probabile | Soluzione |
|
||||||
|
|---|---|---|
|
||||||
|
| `emulator: ERROR: x86_64 emulation currently requires hardware acceleration` | KVM non accessibile | Verifica `/dev/kvm` e l'appartenenza al gruppo `kvm` (§1) |
|
||||||
|
| Emulatore lentissimo, UI a scatti | KVM non attivo, o system image ARM su host x86_64 | Usa una system image `x86_64` come da §3, verifica KVM |
|
||||||
|
| Boot bloccato su logo Android per minuti | Cold boot dopo `-wipe-data`, oppure macchina sotto carico | Attendi, è normale al primo avvio; se persiste prova `-no-snapshot-load` |
|
||||||
|
| Finestra emulatore non compare su WSL2 | WSLg non attivo o kernel senza supporto grafico | Aggiorna WSL (`wsl --update`), verifica `echo $DISPLAY` |
|
||||||
|
| `adb: no devices/emulators found` | Emulatore non ancora avviato o non ancora bootato | `adb wait-for-device`, poi ricontrolla con `adb devices` |
|
||||||
@@ -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.
|
||||||
Reference in new issue
Block a user