Hoe documenteer ik wijzigingen en bugfixes op conforme wijze?
IEC 62304 §6 (onderhoud) · §8 (configuratiebeheer) · §9 (probleemoplossing)
Kort antwoord
Alle wijzigingen aan software voor medische hulpmiddelen — inclusief bugfixes — moeten een gedocumenteerd wijzigingsbeheerproces doorlopen. IEC 62304 §6 regelt softwareonderhoud, §8 configuratiebeheer en §9 probleemoplossing. Niet-gedocumenteerde bugfixes zijn een gegarandeerde auditbevinding.
Wijzigingstypes en hoe ze worden behandeld
| Wijzigingstype | Proces |
|---|---|
| Geplande verbetering (nieuwe functie) | Volledige levenscyclus van softwareontwikkeling: eisen → architectuur → implementatie → verificatie → release |
| Probleemoplossing (bugfix) | Probleemrapport → impactanalyse → oplossing → regressietests → releaseregistraties |
| Noodfix (kritiek productieprobleem) | Hetzelfde proces als bugfix — zelfde documentatie vereist; een verkorte tijdlijn heft de eis niet op |
| SOUP-update (upgrade van bibliotheek van derden) | SOUP-registerupdate → hernieuwde anomalie-evaluatie → impactanalyse → regressietests → releaseregistraties |
Vereiste wijzigingsdocumentatie
- Probleemrapport / Wijzigingsverzoek: Identificeert het probleem of de wijziging; uniek ID; beschrijving; datum van melding; prioriteit/ernst
- Impactanalyse: Beïnvloedt deze wijziging de veiligheid? Verandert het de veiligheidsklasse van de software? Beïnvloedt het andere software-items? Vereist het een significantiebeoordeling onder MDCG 2020-3?
- Implementatieregistraties: Wat werd gewijzigd; welke software-items werden aangepast; codebeoordelingsregistraties (Klasse B/C)
- Bewijs van verificatie-/regressietests: Uitgevoerde tests; testresultaten; bewijs dat de fix werkt en geen nieuwe problemen heeft geïntroduceerd
- Bijgewerkte releaseregistraties: Nieuw versienummer; wat in deze release was opgenomen; wie heeft goedgekeurd
- Bijgewerkte traceerbaarheidmatrix: Als eisen zijn gewijzigd, moet de traceerbaarheidmatrix worden bijgewerkt om de wijziging te weerspiegelen
Probleemoplossingsregistraties (§9)
Probleemoplossingsregistraties zijn vereist voor alle veiligheidsklassen van software. De minimale inhoud van elke probleemregistratie is:
- Unieke identificatie van de probleemregistratie
- Beschrijving van het probleem
- Datum waarop het probleem werd geïdentificeerd
- Huidige status (open / in behandeling / opgelost / uitgesteld)
- Beschrijving van de oplossing
Voor Klasse B en C wordt aanvullende inhoud verwacht: ernstigheidsbeordeling, analyse van de grondoorzaak en testbewijs dat de oplossing effectief is. Een oplossing die "opgelost" zegt zonder grondoorzaakanalyse is onvoldoende voor Klasse C.
Configuratiebeheer (§8)
Configuratiebeheer vormt de ruggengraat van wijzigingsbeheer. Belangrijkste eisen:
- Alle software-items, SOUP-versies en buildconfiguraties onder versiebeheer
- Mogelijkheid om elke uitgebrachte build te reproduceren vanuit de configuratiebaseline
- Documentatie van de releasebaseline — precies welke versie van wat is uitgebracht
- Wijzigingsbeheerregistraties gekoppeld aan de configuratie-items die zijn gewijzigd
Noodfixes
Noodfixes voor kritieke productieproblemen zijn onderworpen aan dezelfde documentatievereisten als elke andere wijziging. In de praktijk is de tijdlijn verkorte — de fix kan worden geïmplementeerd voordat alle documentatie compleet is — maar de documentatie moet achteraf worden voltooid, en het proces moet zijn gedefinieerd in uw Softwareontwikkelplan.
Een noodfix zonder impactanalyse is een niet-conformiteit, ook als de fix technisch correct was. Sla de impactanalyse niet over — documenteer deze achteraf indien nodig, maar documenteer hem.
Veelgestelde vragen
Wat is het verschil tussen een hotfix, patch en minor release?
IEC 62304 definieert deze termen niet — het zijn interne versiebeheerconventies. Wat telt is dat elke wijziging, ongeacht hoe deze is geversioneerd, het gedocumenteerde wijzigingsbeheerproces doorloopt. Of u het een hotfix of patch noemt, het vereist een probleemregistratie, impactanalyse, verificatiebewijs en releaseregistraties.
Heeft elke bug een formeel Wijzigingsverzoek nodig?
Ja — elke bugfix (probleemoplossing) vereist een probleemregistratie. In de praktijk is dit doorgaans een ticket in uw probleemvolgsysteem (Jira, GitHub Issues, enz.) met de vereiste velden ingevuld. De probleemregistratie hoeft geen formeel papieren document te zijn — elektronische registraties zijn prima.
Kunnen GitHub-commits dienen als wijzigingsregistraties?
Git-commitgeschiedenis kan wijzigingsregistraties aanvullen maar vervangt ze niet. Commits leggen geen impactanalyse, ernstigheidsbeordeling of verificatieresultaten vast. Een combinatie van probleemvolgsysteemregistraties (probleemregistraties) gekoppeld aan pull requests (implementatieregistraties) met CI-testbewijs (verificatieregistraties) en een releasetag (releaseregistraties) kan samen aan de eisen voldoen.
Welke versienummeringsconventie moet ik gebruiken?
IEC 62304 specificeert geen versienummeringsconventie. Semantische versienummering (major.minor.patch) is wijdverbreid en praktisch. Wat telt is dat het versienummer uniek is, traceerbaar naar een specifieke configuratiebaseline, en consistent wordt gebruikt in documentatie, etiketten en EUDAMED/UDI-registraties.