first commit

app/docs/Manuale_Utente.md

@@ -0,0 +1,72 @@
+# Manuale utente (BRUNO – Frontend)
+
+## Panoramica
+Questa applicazione guida l’utente nella compilazione di un questionario a step (passi). Ogni step raccoglie dati e, dove previsto, permette di allegare documenti.
+
+## Navigazione
+- Nel menu laterale sinistro trovi la lista degli step.
+- In alto a destra (negli step che lo prevedono) trovi i pulsanti **Indietro** / **Avanti** per muoverti nel flusso.
+- Alcuni step non hanno ancora una schermata dedicata: in quel caso viene mostrato un contenuto “placeholder”.
+
+## Validazione dei campi
+- I campi obbligatori vengono validati tramite il pulsante **Avanti**.
+- Se un campo è obbligatorio e mancante, viene mostrato un messaggio di errore.
+
+## Allegati (componenti “CommentAttachment”)
+In alcune sezioni puoi inserire:
+- un campo **Commenti**
+- una lista di **Allegati**
+
+Funzionalità disponibili:
+- Selezione file tramite pulsante (picker).
+- Upload con **barra di progresso**.
+- Possibilità di **annullare** l’upload in corso.
+- Lista degli allegati già caricati.
+- Eliminazione di un allegato con **conferma**.
+
+Formati file ammessi:
+- `.pdf`, `.docx`, `.txt`, `.md`
+
+Nota: gli allegati vengono associati a una “sessione” (lo step/contesto in cui stai caricando) e a un identificativo utente interno.
+
+## Step disponibili
+
+### 1) Benvenuto
+- Mostra un’introduzione e consente di proseguire allo step successivo.
+
+### 2) Dati contribuente e dichiarazione precedente
+- Toggle: **Preparata da noi?**
+- Sezione **Dichiarazione precedente** (allegati + commenti) quando disponibile.
+- Dati anagrafici del contribuente:
+  - Nome, Cognome, Data di nascita
+  - Indirizzo (tramite editor indirizzo)
+
+### 3) Stato civile
+- Selezione stato civile.
+- Campi relativi al coniuge/partner quando applicabili.
+- Gestione indirizzo del coniuge/partner tramite editor indirizzo.
+
+### 4) Figli
+- Toggle: **Hai figli?**
+- Gestione lista figli (massimo 5):
+  - Aggiunta/modifica tramite finestra (dialog)
+  - Eliminazione dalla lista
+- Dati figlio:
+  - Nome, Cognome, Data di nascita
+  - Toggle **Stesso nucleo familiare**
+  - Se NON nello stesso nucleo: possibilità di indicare alimenti e inserire un indirizzo dedicato
+  - Campo **Scuola**
+  - Toggle **Spese di cura**: se attivo, si sblocca la sezione allegati/commenti per le spese di cura
+- Pulsante rapido (icona) per **copiare il cognome** dal contribuente nel dialog del figlio.
+- Se raggiungi 5 figli, compare una nota testuale per indicare “più di cinque figli”.
+
+## Salvataggio dati
+I dati inseriti vengono mantenuti localmente (persistenza) per evitare perdite durante la compilazione.
+
+## Risoluzione problemi
+- **Non riesco a caricare allegati**: verifica che il server di upload sia attivo e raggiungibile (es. ambiente locale). Se l’upload resta bloccato, annulla e riprova.
+- **Messaggi di validazione**: completa i campi richiesti e riprova con **Avanti**.
+
+---
+
+Se vuoi, posso anche generare una versione “stampabile” (più sintetica, 1–2 pagine) oppure una versione “operatore” con esempi di documenti da allegare per ogni step.