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,123 @@
+Documento di Progetto
+Feature: Modalità Utente (Produttore / Cliente) + Flusso Ordini Offline
+
+1. Obiettivo
+Implementare un sistema di selezione modalità utente alla prima apertura dell’app, con possibilità di modifica successiva dalle impostazioni.
+
+Due modalità:
+- Produttore
+- Cliente
+
+2. Requisiti Funzionali
+
+2.1 Selezione iniziale
+Alla prima apertura:
+- mostrare schermata di scelta:
+  - "Sono un Produttore"
+  - "Sono un Cliente"
+- salvare scelta in storage locale (user_mode)
+
+2.2 Modifica modalità
+- accessibile da Impostazioni
+- voce: Modalità utente
+- conferma cambio modalità
+
+3. Architettura
+
+Variabile:
+userMode: "producer" | "client"
+
+Persistenza:
+- SharedPreferences / DataStore
+- chiave: user_mode
+
+4. Modalità Cliente
+
+Flusso:
+- selezione tipo uova: Marans / Araucana / Olive
+- inserimento quantità
+- click “Prenota”
+
+Output JSON:
+{
+  "order_id": "uuid",
+  "timestamp": "ISO8601",
+  "egg_type": "marans | araucana | olive",
+  "quantity": 12,
+  "client_note": ""
+}
+
+File:
+ordine_uova_<timestamp>.json
+
+Condivisione:
+- share system (Intent Android)
+
+5. Modalità Produttore
+
+UI:
+- bottone "Importa ordine"
+
+Flusso:
+- apertura file picker
+- selezione file JSON
+- parsing
+
+Validazione:
+- order_id
+- timestamp
+- egg_type
+- quantity
+
+Errori:
+- formato non valido
+- duplicati
+
+Dopo import:
+- calcolo data consegna
+- inserimento in database
+
+6. Struttura dati
+
+{
+  "order_id": "string",
+  "source": "imported | manual",
+  "egg_type": "string",
+  "quantity": "int",
+  "created_at": "datetime",
+  "delivery_date": "datetime"
+}
+
+7. UX
+
+Cliente:
+- semplice
+- focus prenotazione
+
+Produttore:
+- UI esistente + import
+
+8. Edge cases
+
+- cambio modalità
+- file corrotti
+- quantità non valida
+
+9. Non obiettivi
+
+- cloud
+- login
+- notifiche
+
+10. Priorità
+
+1. selettore modalità
+2. flusso cliente
+3. import produttore
+4. validazione
+
+11. KPI
+
+- completamento prenotazioni
+- import corretti
+- tempo creazione ordine