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

3.0 KiB
Raw Blame History

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.