Files
HenFlow/DOCUMENTO_PROGETTO.md

39 lines
2.6 KiB
Markdown

# 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