Componenti principali di una descrizione testuale Use-Case
Una descrizione testuale use-case è una narrazione strutturata che cattura una specifica interazione tra un attore (utente o sistema esterno) e il sistema in design. I componenti essenziali, seguendo pratica standard UML e requirements engineering, sono:
- Attori / Ruoli: Identificare gruppi utenti o sistemi esterni che avviano l'uso. Documentare loro obiettivi, responsabilità, caratteristiche rilevanti.
- Descrizione dell'Obiettivo: Dichiarazione concisa, specifica, idealmente quantificabile di cosa l'attore mira a raggiungere.
- Precondizioni: Condizioni che devono essere vere prima che l'uso possa iniziare — stato sistema, disponibilità dati, azioni prior completate.
- Postcondizioni: Stato sistema dopo completamento con successo — cambiamenti fatti, risultati prodotti, garanzie assicurate.
- Flusso Principale (Basic Flow): Sequenza step-by-step di interazioni (azione attore → risposta sistema → info scambiate) che raggiunge obiettivo in condizioni normali.
- Flussi Alternativi (Estensioni / Eccezioni): Scenari ramificati innescati da condizioni specifiche (errori, alternative, edge case). Ognuno include: trigger, step, e merge point back to main flow o terminazione.
- Regole di Business: Vincoli, regole validazione, policy, o calcoli che governano questo use case — es. "Utente deve essere 18+", "Limite transazione $5.000/giorno".
Elementi opzionali aggiuntivi: Priorità, Frequenza, Assunzioni, Requisiti Non-Funzionali, Link Tracciabilità. Un use case ben scritto è leggibile da stakeholder, testabile da QA, implementabile da sviluppatori — colma gap tra intent business e specifica tecnica.