Import sorgenti Flutter di Henflow (export da Nextcloud: lib/ + documenti di progetto)

2026-10-09 08:51:15 +02:00
commit bfd086c488
14 changed files with 4129 additions and 0 deletions
@@ -0,0 +1,38 @@
+# Henflow - Documento di Progetto
+
+## Panoramica
+**Henflow** è un'applicazione mobile sviluppata in Flutter per la gestione professionale di un piccolo pollaio e delle relative prenotazioni di uova. L'app permette di monitorare la produzione stimata in base alle galline possedute e di organizzare le consegne ai clienti in modo automatizzato.
+
+## Caratteristiche Principali
+- **Gestione Produzione**: Calcolo automatico della produzione giornaliera basato sull'età e sullo stato delle galline.
+- **Coda Prenotazioni**: Gestione FIFO degli ordini con ricalcolo dinamico delle date di consegna.
+- **Anagrafica Clienti**: Rubrica integrata con ricerca rapida durante la creazione degli ordini.
+- **Multilingua**: Supporto completo per Inglese (default), Italiano, Francese e Tedesco.
+- **Backup e Ripristino**: Esportazione e importazione dei dati tramite file JSON compatibile con i principali servizi cloud.
+- **Offline First**: Tutti i dati sono salvati localmente sul dispositivo.
+
+## Schermate dell'Applicazione
+
+### 1. Home Page
+La schermata principale mostra il riepilogo della produzione giornaliera e la lista degli ordini attivi. Ogni ordine indica la data di consegna prevista e lo stato (Oggi, Scaduto, o giorni rimanenti). È possibile condividere i dettagli dell'ordine direttamente con il cliente.
+
+### 2. Gestione Clienti
+Una sezione dedicata alla gestione dell'anagrafica. Permette di registrare Nome, Cognome e Numero di telefono dei clienti per velocizzare l'inserimento degli ordini tramite suggerimenti automatici.
+
+### 3. Configurazione Razze
+In questa sezione l'utente può attivare le razze presenti nel proprio pollaio. Per ogni razza è disponibile una foto rappresentativa e una descrizione delle caratteristiche produttive (colore uova, produttività).
+
+### 4. Il Mio Pollaio
+Mostra un riepilogo delle galline possedute per ogni razza attiva. Da qui è possibile accedere alla gestione analitica di ogni singolo animale.
+
+### 5. Anagrafica Galline
+Scheda di dettaglio per ogni razza dove è possibile registrare le singole galline, impostare la loro data di nascita e monitorare il loro stato di deposizione. L'app calcola automaticamente l'età e determina se la gallina è produttiva (6+ mesi).
+
+### 6. Backup e Ripristino
+Strumento per la messa in sicurezza dei dati. Permette di esportare l'intero database (clienti, ordini, galline) in un unico file JSON condivisibile via email, WhatsApp o salvabile su Google Drive/iCloud.
+
+## Specifiche Tecniche
+- **Identificativo Pacchetto**: `it.carlobaratto.henflow`
+- **Tecnologia**: Flutter SDK
+- **Persistenza**: Shared Preferences / JSON Storage
+- **Integrazioni**: File Picker, Share System API