Quali documenti sono obbligatori per le Classi A, B e C secondo IEC 62304?
IEC 62304 §5, §6, §7, §8, §9
In sintesi
I requisiti documentali aumentano dalla Classe A alla Classe C. La Classe A ha una base definita. La Classe B aggiunge la documentazione dell'architettura e la verifica unitaria. La Classe C aggiunge le specifiche di progettazione per unità e la tracciabilità completa in quattro direzioni. Nessun insieme di documenti è opzionale — ogni documento mancante è un rilievo in qualsiasi audit IEC 62304.
Requisiti documentali per classe
| Documento | Classe A | Classe B | Classe C |
|---|---|---|---|
| Piano di Sviluppo Software (SDP) | Richiesto | Richiesto | Richiesto |
| Specifica dei Requisiti Software (SRS) | Richiesto | Richiesto | Richiesto |
| Record di test di sistema / integrazione | Richiesto | Richiesto | Richiesto |
| Record di rilascio software | Richiesto | Richiesto | Richiesto |
| Registro SOUP (con anomalie note) | Richiesto | Richiesto | Richiesto |
| Record di risoluzione dei problemi | Richiesto | Richiesto | Richiesto |
| Documento di architettura software | — | Richiesto | Richiesto |
| Record di verifica unitaria | — | Richiesto | Richiesto |
| Record di integrazione | — | Richiesto | Richiesto |
| Record di valutazione delle anomalie SOUP | — | Richiesto | Richiesto |
| Matrice di tracciabilità (Req. ↔ Test) | — | Richiesto | Richiesto |
| Specifica di progettazione software (per unità) | — | — | Richiesto |
| Record di implementazione unitaria | — | — | Richiesto |
| Tracciabilità completa (Req. ↔ Arch. ↔ Unità ↔ Test) | — | — | Richiesto |
| Record di revisione indipendente dei test | — | — | Richiesto |
Breve descrizione di ogni documento
- Piano di Sviluppo Software (SDP): Come il software sarà sviluppato e mantenuto; team, metodologia, strumenti, norme di riferimento, deliverable
- Specifica dei Requisiti Software (SRS): Requisiti funzionali, non funzionali e di sicurezza per il sistema software; base per i test
- Documento di architettura software: Partizione del software in elementi software; interfacce tra gli elementi; giustificazione delle decisioni architetturali
- Specifica di progettazione software: Progettazione per unità; decisioni progettuali dettagliate, algoritmi, flussi di dati (solo Classe C)
- Record di verifica unitaria: Prova che ogni unità software soddisfa la sua specifica di progettazione; risultati dei test unitari
- Record di integrazione: Prova che gli elementi software funzionano correttamente quando integrati insieme; test di interfaccia
- Record di test di sistema: Prova che il sistema software completo soddisfa tutti i requisiti SRS
- Matrice di tracciabilità: Collega i requisiti all'architettura, alle unità, ai test; garantisce la completezza
- Registro SOUP: Elenco di tutti i componenti di terze parti con versione, funzione e valutazione delle anomalie
- Record di risoluzione dei problemi: Tracciamento di bug e problemi; tutti i problemi di tutte le fasi di sviluppo
- Record di rilascio: Documenta cosa è stato rilasciato, quale versione, quali test sono stati eseguiti, chi ha approvato il rilascio
Documenti frequentemente mancanti
- Valutazione delle anomalie SOUP mancante: Il registro SOUP esiste ma le anomalie non vengono valutate — solo elencate o ignorate
- Matrice di tracciabilità non mantenuta: Creata una volta, mai aggiornata dopo le modifiche ai requisiti o ai test
- Documento di architettura troppo generico: Mostra solo i blocchi di sistema principali; non suddivide il software in elementi software; insufficiente per la Classe C
- Nessuna cronologia delle versioni software: Rilasci effettuati senza record di rilascio formali; nessuna baseline di build riproducibile
Domande frequenti
I documenti possono essere combinati?
Sì. IEC 62304 specifica il contenuto richiesto, non i titoli dei documenti. È possibile combinare SDP e SRS in un unico documento se tutto il contenuto richiesto è presente. Allo stesso modo, i record di verifica unitaria possono far parte dello stesso documento dei record di integrazione. Ciò che conta è che tutte le informazioni richieste siano documentate e accessibili.
Qual è il set minimo di documentazione per la Classe A?
Minimo Classe A: Piano di Sviluppo Software, Specifica dei Requisiti Software, record di test di sistema (che dimostrano che i requisiti SRS sono stati testati), record di rilascio software, registro SOUP con elenco di anomalie note e record di risoluzione dei problemi. Sei tipi di documenti — nessuno opzionale.
Quanto deve essere granulare una matrice di tracciabilità di Classe C?
La matrice di tracciabilità deve collegare ogni requisito software all'elemento architetturale che lo implementa, alla/alle unità software che lo implementano e al/ai caso/i di test che lo verificano. Non è richiesta la tracciabilità a livello di riga di codice. La tracciabilità a livello di requisito è la granularità attesa.