¿Cómo documento los cambios y correcciones de errores de forma conforme?
IEC 62304 §6 (mantenimiento) · §8 (gestión de la configuración) · §9 (resolución de problemas)
Respuesta breve
Todos los cambios en el software de productos sanitarios — incluyendo las correcciones de errores — deben pasar por un proceso documentado de control de cambios. IEC 62304 §6 regula el mantenimiento del software, §8 la gestión de la configuración y §9 la resolución de problemas. Las correcciones de errores no documentadas son un hallazgo de auditoría garantizado.
Tipos de cambios y cómo se gestionan
| Tipo de cambio | Proceso |
|---|---|
| Mejora planificada (nueva funcionalidad) | Ciclo de vida completo del desarrollo de software: requisitos → arquitectura → implementación → verificación → publicación |
| Resolución de problemas (corrección de errores) | Informe de problema → análisis de impacto → corrección → pruebas de regresión → registros de publicación |
| Corrección de emergencia (problema crítico en producción) | Mismo proceso que la corrección de errores — misma documentación requerida; una línea de tiempo comprimida no elimina el requisito |
| Actualización de SOUP (actualización de biblioteca de terceros) | Actualización del registro de SOUP → reevaluación de anomalías → análisis de impacto → pruebas de regresión → registros de publicación |
Documentación de cambio requerida
- Informe de problema / Solicitud de cambio: Identifica el problema o cambio; ID único; descripción; fecha de comunicación; prioridad/gravedad
- Análisis de impacto: ¿Este cambio afecta a la seguridad? ¿Cambia la clase de seguridad del software? ¿Afecta a otros elementos de software? ¿Requiere una evaluación de significancia según MDCG 2020-3?
- Registros de implementación: Qué se cambió; qué elementos de software se modificaron; registros de revisión de código (Clase B/C)
- Evidencia de pruebas de verificación/regresión: Pruebas realizadas; resultados de las pruebas; evidencia de que la corrección funciona y no introdujo nuevos problemas
- Registros de publicación actualizados: Nuevo número de versión; qué se incluyó en esta publicación; quién aprobó
- Matriz de trazabilidad actualizada: Si los requisitos cambiaron, la matriz de trazabilidad debe actualizarse para reflejar el cambio
Registros de resolución de problemas (§9)
Los registros de resolución de problemas son obligatorios para todas las clases de seguridad del software. El contenido mínimo de cada registro de problema es:
- Identificador único del registro de problema
- Descripción del problema
- Fecha en que se identificó el problema
- Estado actual (abierto / en progreso / resuelto / aplazado)
- Descripción de la resolución
Para Clase B y C, se espera contenido adicional: evaluación de gravedad, análisis de causa raíz y evidencia de pruebas de que la resolución es efectiva. Una resolución que dice "corregido" sin causa raíz es insuficiente para la Clase C.
Gestión de la configuración (§8)
La gestión de la configuración proporciona la columna vertebral para el control de cambios. Requisitos clave:
- Todos los elementos de software, versiones de SOUP y configuraciones de compilación bajo control de versiones
- Capacidad de reproducir cualquier compilación publicada desde la línea base de configuración
- Documentación de la línea base de publicación — exactamente qué versión de qué se publicó
- Registros de control de cambios vinculados a los elementos de configuración que cambiaron
Correcciones de emergencia
Las correcciones de emergencia para problemas críticos en producción están sujetas a los mismos requisitos de documentación que cualquier otro cambio. En la práctica, la línea de tiempo está comprimida — la corrección puede desplegarse antes de que toda la documentación esté completa — pero la documentación debe completarse después del hecho, y el proceso debe estar definido en su Plan de Desarrollo de Software.
Una corrección de emergencia sin análisis de impacto es una no conformidad, incluso si la corrección era técnicamente correcta. No omita el análisis de impacto — documéntelo retroactivamente si es necesario, pero documéntelo.
Preguntas frecuentes
¿Cuál es la diferencia entre un hotfix, un parche y una versión menor?
IEC 62304 no define estos términos — son convenciones internas de versionado. Lo que importa es que cada cambio, independientemente de cómo esté versionado, pase por el proceso documentado de control de cambios. Ya sea que lo llame hotfix o parche, requiere un registro de problema, análisis de impacto, evidencia de verificación y registros de publicación.
¿Necesita cada error una Solicitud de Cambio formal?
Sí — cada corrección de error (resolución de problema) requiere un registro de problema. En la práctica, esto es típicamente un ticket en su sistema de seguimiento de incidencias (Jira, GitHub Issues, etc.) con los campos requeridos completados. El registro de problema no necesita ser un documento formal en papel — los registros electrónicos son válidos.
¿Pueden los commits de GitHub servir como registros de cambio?
El historial de commits de Git puede complementar los registros de cambio pero no los reemplaza. Los commits no capturan el análisis de impacto, la evaluación de gravedad o los resultados de verificación. Una combinación de registros del sistema de seguimiento (registros de problemas) vinculados a pull requests (registros de implementación) con evidencia de pruebas CI (registros de verificación) y una etiqueta de publicación (registros de publicación) puede juntos satisfacer los requisitos.
¿Qué convención de numeración de versiones debería usar?
IEC 62304 no especifica una convención de numeración de versiones. El versionado semántico (mayor.menor.parche) es ampliamente utilizado y práctico. Lo que importa es que el número de versión sea único, rastreable a una línea base de configuración específica, y utilizado de manera coherente en la documentación, las etiquetas y los registros EUDAMED/UDI.