# harbour-henflow

Porting **nativo Sailfish OS** dell'app Android *Henflow* (`it.carlobaratto.henflow`).
UI in QML/Silica, calcolo e dati locali, pubblicazione prevista sullo
**store Jolla Harbour**.

Il porting **non** usa il runtime Flutter community (`flutter-sailfishos`):
quello resta una via OpenRepos, non Harbour-safe, e non supporta i plugin nativi
Android (AdMob/File picker/Share). Nessun account, nessun cloud, come l'originale.

## Sorgenti di riferimento

- Flutter (originale): `workspace/henflow-flutter` — export da Nextcloud, repo Gitea `HenFlow`.
- Screenshot dello store usati come riferimento UI.

## Stato

| parte | stato |
|---|---|
| Packaging (spec RPM, desktop SailJail, icone, i18n) | pronto |
| Guscio app (finestra, cover, Settings con lingua) | pronto |
| Motore di calcolo (`qml/js/henflow.js`) | portato e verificato con node |
| Schermate QML | da implementare |

## Struttura

```
harbour-henflow.pro          # QT += quick qml, INSTALLS icone
rpm/harbour-henflow.spec     # lrelease + desktop cercati con find (layout sorgente variabile)
rpm/harbour-henflow.desktop  # profilo [X-Sailjail] esplicito (dati persistenti)
src/main.cpp                 # SailfishApp, context property appSettings, lingua
src/settings.h/.cpp          # QSettings su path esplicito AppConfigLocation + sync()
qml/harbour-henflow.qml      # ApplicationWindow: initialPage + cover
qml/pages/MainPage.qml       # indice dei moduli (segnaposto)
qml/js/henflow.js            # motore di calcolo (ES5, testabile con node)
tests/engine.test.js         # 30 controlli: node tests/engine.test.js
icons/make_icons.py          # icone 86/108/128/172 (PIL)
translations/*.ts            # stringhe sorgente INGLESI + catalogo italiano
```

## Motore di calcolo (portato fedelmente da `lib/main.dart`)

- **Produzione stimata** per razza = galline in deposizione x uova/gallina/giorno
  (catalogo: tutte 1.0). Una gallina conta da **6 mesi** in su (`_ageInMonths`).
- **Magazzino**: all'apertura, i giorni passati dall'ultimo aggiornamento
  aggiungono la produzione giornaliera alle scorte di ogni razza attiva.
- **Coda FIFO**: ordini in ordine di creazione; ognuno consuma le scorte virtuali
  della sua razza, chi le trova consegna oggi, gli altri aspettano
  `ceil(uova_mancanti / produzione)` giorni. Gli ordini gia' consegnati non
  consumano scorte.
- **Stima per un nuovo ordine**: `ceil((pendenti + richieste - scorte) / produzione)`.

Le date sono sempre normalizzate a `YYYY-MM-DD` e le funzioni non mutano l'input.

## Modello dati (fedele a `StorageService`, SharedPreferences + JSON)

| chiave | contenuto |
|---|---|
| `breed_settings_v2` | `[{breedId, hens:[{id, name, birthDate, isLaying}]}]` |
| `reservations_v2` | `[{id, customerName, breedId, eggsRequested, createdAt, deliveryDate, isDelivered}]` |
| `customers_v1` | `[{id, firstName, lastName, phoneNumber}]` |
| `warehouse_stock_v1` | `{breedId: uova}` |
| `last_production_update_v1` | data ISO dell'ultimo accrual |

Nel porting: un unico file JSON in `~/.config/harbour/henflow/` (nessuna
dipendenza extra, nessun driver SQL da verificare sul device) con la stessa
struttura, cosi' il backup/ripristino resta compatibile con l'app Android.

## Schermate mappate (da sorgenti + screenshot)

| schermata Flutter | contenuto | porting |
|---|---|---|
| `OnboardingPage` | 4 passi introduttivi | da fare |
| `ModeSelectionPage` | modalita' allevatore / cliente | da decidere |
| `HomePage` | tab *Orders list* / *Calendar* (+ magazzino), card produzione stimata, card ordini con stato e azioni (condividi/modifica/elimina), FAB *New order* | da fare |
| `SettingsPage` | tab *Available breeds* (catalogo con foto e spunta) / *My coop* (galline registrate, in deposizione, produzione) + backup/ripristino JSON + lingua | da fare |
| `BreedDetailPage` | galline della razza, eta' in mesi, stato deposizione | da fare |
| `CustomersPage` + dialoghi | anagrafica clienti, nuovo ordine | da fare |
| `AboutPage` | info app | da fare |
| `CoopIcon` (CustomPainter) | icona pollaio disegnata a mano | da ridisegnare (Canvas QML o PNG) |

Differenze da tenere presenti: **niente annunci** (AdMob non esiste su Sailfish),
**share/export** via file JSON in Download invece di `share_plus`/`file_picker`.

## Build e deploy

Sul PC con l'SDK Sailfish (qui non c'e' sfdk):

```sh
sfdk target use SailfishOS-5.0.0.62-aarch64   # o il target del tuo device
sfdk build                                    # RPM in build-*/RPMS/
sfdk deploy                                   # oppure Qt Creator
```

Tarball per lo store (con `--prefix`, esclude .git e i file non tracciati):

```sh
git archive --format=tar.gz --prefix=harbour-henflow-0.1.0/ -o harbour-henflow-0.1.0.tar.gz HEAD
```

## Aperti

1. **Asset**: nel materiale di Nextcloud mancano `assets/breeds/*.jpg` (7 foto)
   e `pubspec.yaml`.
2. **Repo Gitea `HenFlow`**: cancellata (era un upload parziale); per ricrearla
   serve un permesso che il token attuale non ha (`write:user`).
3. **Ambito**: modalita' cliente e 4 lingue (EN/IT/FR/DE) da confermare.