Revisione Project Work Pegaso L-31: documentare correttamente un progetto digitale
Un elaborato di Informatica per le Aziende Digitali può descrivere l'analisi di un processo, la progettazione di un sistema, la valutazione di una soluzione digitale o una diversa attività prevista dalla traccia. Un rischio comune è utilizzare molti termini tecnici senza spiegare il problema a cui la tecnologia deve rispondere. La revisione del Project Work Pegaso L-31 verifica la continuità fra requisiti, scelte, rappresentazioni e risultati descritti.
Problema e requisiti: non sono la stessa cosa
Il problema indica la necessità iniziale; i requisiti chiariscono quali funzioni o caratteristiche debba offrire la soluzione. Quando un testo parla genericamente di “digitalizzare un'attività”, serve comprendere quale fase sia coinvolta e quale miglioramento ci si proponga di ottenere. I requisiti possono essere organizzati per priorità e descritti con esempi; devono però rimanere compatibili con la traccia e con il livello di approfondimento richiesto.
Diagrammi e flussi di processo
Se sono presenti diagrammi di flusso, schemi di dati o rappresentazioni dell'architettura, ogni figura dovrebbe avere una funzione precisa. La revisione controlla che il testo spieghi cosa rappresenta lo schema, che le denominazioni siano coerenti e che le relazioni tra passaggi non contraddicano la descrizione. Un diagramma complesso privo di legenda può risultare meno utile di una rappresentazione essenziale ma ben commentata.
Test, risultati e limiti della proposta
È importante distinguere i test effettivamente svolti dalle verifiche previste. Se si presenta un prototipo, vanno chiariti il perimetro dell'implementazione e i limiti di quanto è stato realizzato. Un elenco di benefici generici non documenta automaticamente una riduzione dei costi o dei tempi. Dove la traccia lo richiede, può essere opportuno illustrare anche rischi relativi a qualità dei dati, accessi e protezione delle informazioni, senza attribuire al lavoro verifiche di sicurezza mai effettuate.
Un esempio di incoerenza da evitare
Supponiamo che un Project Work proponga un modulo per le richieste dei clienti. Se nei requisiti viene prevista la conferma via email ma la sezione sui test non descrive né una prova né una simulazione di tale funzione, rimane un vuoto fra progettazione e verifica. Il controllo evidenzia questo passaggio e aiuta a distinguere funzionalità realizzate, ipotizzate e ancora da sviluppare.
Checklist L-31
- È chiaro il problema organizzativo o informatico affrontato?
- I requisiti dichiarati trovano corrispondenza nella proposta?
- Diagrammi e tabelle sono leggibili e richiamati nel testo?
- La documentazione distingue progetto, prototipo e realizzazione?
- Eventuali test sono descritti senza attribuire risultati non misurati?
Consulta il controllo del template per gli aspetti formali e la pagina sulla revisione specialistica per il controllo complessivo dell'elaborato.