# 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.