Wie dokumentiere ich Änderungen und Bugfixes normkonform?

IEC 62304 §6 (Wartung) · §8 (Konfigurationsmanagement) · §9 (Problemlösung)

Kurze Antwort

Alle Änderungen an Medizinprodukte-Software — einschließlich Bugfixes — müssen einen dokumentierten Änderungskontrollprozess durchlaufen. IEC 62304 §6 regelt die Software-Wartung, §8 das Konfigurationsmanagement und §9 die Problemlösung. Undokumentierte Bugfixes sind ein garantierter Audit-Befund.

Änderungstypen und ihre Handhabung

ÄnderungstypProzess
Geplante Erweiterung (neues Feature)Vollständiger Software-Entwicklungslebenszyklus: Anforderungen → Architektur → Implementierung → Verifikation → Release
Problemlösung (Bugfix)Problembericht → Auswirkungsanalyse → Behebung → Regressionstests → Release-Aufzeichnungen
Notfall-Fix (kritisches Produktionsproblem)Gleicher Prozess wie Bugfix — gleiche Dokumentationsanforderungen; ein verkürzter Zeitplan hebt die Anforderung nicht auf
SOUP-Update (Drittanbieter-Bibliotheks-Upgrade)SOUP-Register-Aktualisierung → Anomalie-Neubewertung → Auswirkungsanalyse → Regressionstests → Release-Aufzeichnungen

Erforderliche Änderungsdokumentation

  1. Problembericht / Änderungsantrag: Identifiziert das Problem oder die Änderung; eindeutige ID; Beschreibung; Datum der Meldung; Priorität/Schweregrad
  2. Auswirkungsanalyse: Beeinflusst diese Änderung die Sicherheit? Ändert sie die Software-Sicherheitsklasse? Beeinflusst sie andere Software-Items? Erfordert sie eine Signifikanzbewertung gemäß MDCG 2020-3?
  3. Implementierungsaufzeichnungen: Was wurde geändert; welche Software-Items wurden modifiziert; Code-Review-Aufzeichnungen (Klasse B/C)
  4. Verifikations-/Regressionstestnachweis: Durchgeführte Tests; Testergebnisse; Nachweis, dass die Behebung funktioniert und keine neuen Probleme eingeführt hat
  5. Aktualisierte Release-Aufzeichnungen: Neue Versionsnummer; was in diesem Release enthalten war; wer genehmigt hat
  6. Aktualisierte Rückverfolgbarkeitsmatrix: Wenn Anforderungen geändert wurden, muss die Rückverfolgbarkeitsmatrix aktualisiert werden

Problemlösungsaufzeichnungen (§9)

Problemlösungsaufzeichnungen sind für alle Software-Sicherheitsklassen erforderlich. Der Mindestinhalt jeder Problemaufzeichnung umfasst:

  • Eindeutiger Problemaufzeichnungs-Bezeichner
  • Beschreibung des Problems
  • Datum der Problemidentifikation
  • Aktueller Status (offen / in Bearbeitung / gelöst / zurückgestellt)
  • Lösungsbeschreibung

Für Klasse B und C werden zusätzliche Inhalte erwartet: Schweregradeinschätzung, Ursachenanalyse und Nachweis der Wirksamkeit der Lösung durch Tests. Eine Lösung, die nur "behoben" sagt ohne Ursachenanalyse, ist für Klasse C unzureichend.

Konfigurationsmanagement (§8)

Das Konfigurationsmanagement bildet das Rückgrat der Änderungskontrolle. Schlüsselanforderungen:

  • Alle Software-Items, SOUP-Versionen und Build-Konfigurationen unter Versionskontrolle
  • Fähigkeit, jeden freigegebenen Build aus der Konfigurationsbaseline zu reproduzieren
  • Release-Baseline-Dokumentation — genau welche Version was freigegeben wurde
  • Änderungskontrollaufzeichnungen, verknüpft mit den geänderten Konfigurationselementen

Notfall-Fixes

Notfall-Fixes für kritische Produktionsprobleme unterliegen denselben Dokumentationsanforderungen wie jede andere Änderung. In der Praxis ist der Zeitrahmen komprimiert — die Behebung kann vor Abschluss der gesamten Dokumentation deployed werden — aber die Dokumentation muss nachträglich vervollständigt werden, und der Prozess muss in Ihrem Software-Entwicklungsplan definiert sein.

Ein Notfall-Fix ohne Auswirkungsanalyse ist eine Abweichung, auch wenn die Behebung technisch korrekt war. Überspringen Sie die Auswirkungsanalyse nicht — dokumentieren Sie sie nachträglich wenn nötig, aber dokumentieren Sie sie.

Häufig gestellte Fragen

Was ist der Unterschied zwischen einem Hotfix, Patch und Minor Release?

IEC 62304 definiert diese Begriffe nicht — es sind interne Versionierungskonventionen. Entscheidend ist, dass jede Änderung, unabhängig von ihrer Versionierung, den dokumentierten Änderungskontrollprozess durchläuft. Ob Sie es Hotfix oder Patch nennen, es erfordert einen Problembericht, eine Auswirkungsanalyse, Verifikationsnachweise und Release-Aufzeichnungen.

Benötigt jeder Bug einen formalen Änderungsantrag?

Ja — jeder Bugfix (Problemlösung) erfordert eine Problemaufzeichnung. In der Praxis ist dies typischerweise ein Ticket in Ihrem Issue-Tracker (Jira, GitHub Issues usw.) mit den ausgefüllten Pflichtfeldern. Die Problemaufzeichnung muss kein formales Papierdokument sein — elektronische Aufzeichnungen sind in Ordnung.

Können GitHub-Commits als Änderungsaufzeichnungen dienen?

Git-Commit-History kann Änderungsaufzeichnungen ergänzen, ersetzt sie aber nicht. Commits erfassen keine Auswirkungsanalyse, Schweregradeinschätzung oder Verifikationsergebnisse. Eine Kombination aus Issue-Tracker-Aufzeichnungen (Problemaufzeichnungen), verknüpft mit Pull Requests (Implementierungsaufzeichnungen) mit CI-Testnachweis (Verifikationsaufzeichnungen) und einem Release-Tag (Release-Aufzeichnungen) kann zusammen die Anforderungen erfüllen.

Welche Versionsnummerierungskonvention sollte ich verwenden?

IEC 62304 schreibt keine Versionsnummerierungskonvention vor. Semantische Versionierung (major.minor.patch) ist weit verbreitet und praktisch. Entscheidend ist, dass die Versionsnummer eindeutig ist, auf eine spezifische Konfigurationsbaseline zurückverfolgbar ist und in Dokumentation, Labels und EUDAMED/UDI-Aufzeichnungen konsistent verwendet wird.

Kostenloses IEC 62304-Klassifizierungstool

Bestimmen Sie Ihre Software-Sicherheitsklasse in wenigen Minuten.

Software klassifizieren →