Come documentare modifiche e correzioni di bug in modo conforme?
IEC 62304 §6 (manutenzione) · §8 (gestione della configurazione) · §9 (risoluzione dei problemi)
In sintesi
Tutte le modifiche al software di dispositivi medici — incluse le correzioni di bug — devono seguire un processo documentato di controllo delle modifiche. IEC 62304 §6 disciplina la manutenzione del software, §8 la gestione della configurazione e §9 la risoluzione dei problemi. Le correzioni di bug non documentate sono un rilievo di audit garantito.
Tipi di modifiche e come vengono gestite
| Tipo di modifica | Processo |
|---|---|
| Miglioramento pianificato (nuova funzionalità) | Ciclo di vita completo dello sviluppo software: requisiti → architettura → implementazione → verifica → rilascio |
| Risoluzione di problemi (correzione di bug) | Rapporto di problema → analisi dell'impatto → correzione → test di regressione → registrazioni di rilascio |
| Correzione di emergenza (problema critico in produzione) | Stesso processo della correzione di bug — stessa documentazione richiesta; una tempistica compressa non elimina il requisito |
| Aggiornamento SOUP (aggiornamento di libreria di terze parti) | Aggiornamento del registro SOUP → rivalutazione delle anomalie → analisi dell'impatto → test di regressione → registrazioni di rilascio |
Documentazione di modifica richiesta
- Rapporto di problema / Richiesta di modifica: Identifica il problema o la modifica; ID univoco; descrizione; data di segnalazione; priorità/gravità
- Analisi dell'impatto: Questa modifica influisce sulla sicurezza? Cambia la classe di sicurezza del software? Influisce su altri elementi software? Richiede una valutazione della significatività secondo MDCG 2020-3?
- Registrazioni di implementazione: Cosa è stato modificato; quali elementi software sono stati modificati; registrazioni di revisione del codice (Classe B/C)
- Prove di test di verifica/regressione: Test eseguiti; risultati dei test; prove che la correzione funziona e non ha introdotto nuovi problemi
- Registrazioni di rilascio aggiornate: Nuovo numero di versione; cosa era incluso in questo rilascio; chi ha approvato
- Matrice di tracciabilità aggiornata: Se i requisiti sono cambiati, la matrice di tracciabilità deve essere aggiornata per riflettere la modifica
Registrazioni di risoluzione dei problemi (§9)
Le registrazioni di risoluzione dei problemi sono richieste per tutte le classi di sicurezza del software. Il contenuto minimo di ogni registrazione di problema è:
- Identificatore univoco della registrazione del problema
- Descrizione del problema
- Data di identificazione del problema
- Stato attuale (aperto / in corso / risolto / rinviato)
- Descrizione della risoluzione
Per Classe B e C, sono attesi contenuti aggiuntivi: valutazione della gravità, analisi delle cause profonde e prove di test che la risoluzione sia efficace. Una risoluzione che dice "corretto" senza analisi delle cause profonde è insufficiente per la Classe C.
Gestione della configurazione (§8)
La gestione della configurazione fornisce la spina dorsale per il controllo delle modifiche. Requisiti chiave:
- Tutti gli elementi software, le versioni SOUP e le configurazioni di build sotto controllo versione
- Capacità di riprodurre qualsiasi build rilasciato dalla baseline di configurazione
- Documentazione della baseline di rilascio — esattamente quale versione di cosa è stato rilasciato
- Registrazioni di controllo delle modifiche collegate agli elementi di configurazione che sono cambiati
Correzioni di emergenza
Le correzioni di emergenza per i problemi critici in produzione sono soggette agli stessi requisiti di documentazione di qualsiasi altra modifica. In pratica, la tempistica è compressa — la correzione può essere distribuita prima che tutta la documentazione sia completa — ma la documentazione deve essere completata a posteriori, e il processo deve essere definito nel vostro Piano di Sviluppo Software.
Una correzione di emergenza senza analisi dell'impatto è una non conformità, anche se la correzione era tecnicamente corretta. Non saltate l'analisi dell'impatto — documentatela retroattivamente se necessario, ma documentatela.
Domande frequenti
Qual è la differenza tra un hotfix, una patch e un rilascio minore?
IEC 62304 non definisce questi termini — sono convenzioni di versioning interne. Ciò che conta è che ogni modifica, indipendentemente da come è versionata, passi attraverso il processo documentato di controllo delle modifiche. Che la chiamiate hotfix o patch, richiede una registrazione del problema, un'analisi dell'impatto, prove di verifica e registrazioni di rilascio.
Ogni bug richiede una Richiesta di Modifica formale?
Sì — ogni correzione di bug (risoluzione di problema) richiede una registrazione del problema. In pratica, si tratta tipicamente di un ticket nel sistema di tracciamento dei problemi (Jira, GitHub Issues, ecc.) con i campi richiesti compilati. La registrazione del problema non deve essere un documento cartaceo formale — i record elettronici sono accettabili.
I commit GitHub possono servire come registrazioni di modifica?
La cronologia dei commit Git può integrare le registrazioni di modifica ma non le sostituisce. I commit non catturano l'analisi dell'impatto, la valutazione della gravità o i risultati di verifica. Una combinazione di registrazioni del sistema di tracciamento (registrazioni di problemi) collegate a pull request (registrazioni di implementazione) con prove di test CI (registrazioni di verifica) e un tag di rilascio (registrazioni di rilascio) può insieme soddisfare i requisiti.
Quale convenzione di numerazione delle versioni dovrei usare?
IEC 62304 non specifica una convenzione di numerazione delle versioni. Il versioning semantico (major.minor.patch) è ampiamente utilizzato e pratico. Ciò che conta è che il numero di versione sia univoco, tracciabile verso una specifica baseline di configurazione, e utilizzato in modo coerente nella documentazione, nelle etichette e nei record EUDAMED/UDI.