Files
bruno/app/docs/Manuale_Utente.md
2026-02-18 21:04:57 +01:00

73 lines
3.0 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Manuale utente (BRUNO Frontend)
## Panoramica
Questa applicazione guida lutente 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** lupload 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 unintroduzione 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 lupload 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, 12 pagine) oppure una versione “operatore” con esempi di documenti da allegare per ogni step.