Skip to content

Trazabilidad de Controles de Riesgo

Proyecto: {{PROJECT_NAME}} · Clase SaMD: {{SAMD_CLASS}} · Versión: vX.Y · Fecha: YYYY-MM-DD

Vista de una página que cierra el lazo ISO 14971 §6-7 (control de riesgo) ↔ IEC 62304 §5.7 (verificación). Cada riesgo identificado debe rastrearse hasta un control implementado (ruta/archivo.py::símbolo), un requisito (REQ-XXX), un test que lo verifica y un riesgo residual evaluado. Una fila sin las cinco columnas pobladas NO se considera trazable y bloquea el release.


1. Propósito y alcance

Este documento es el artefacto de cierre del lazo de control de riesgo. Cruza, en una sola tabla auditable:

  • Riesgo (R-XXX): entrada del registro de ISO_14971_RISK_MATRIX.md.
  • Control (ruta/archivo.py::símbolo): medida de control de riesgo implementada en el código (ISO 14971 §6.2).
  • REQ: requisito de software/sistema que materializa el control (TRACEABILITY_MATRIX_SAMD.md).
  • Test: evidencia de verificación que demuestra que el control funciona (IEC 62304 §5.7).
  • Riesgo residual: evaluación tras el control (ISO 14971 §6.4 / §7).

Toda modificación de un control clínico o de seguridad obliga a revisar la fila correspondiente en la misma pasada (análisis de impacto, IEC 62304 §5.6).


2. Convenciones

Campo Regla
ID de riesgo R-XXX (clínico), R-SEC-XX (seguridad), R-IA-XX (IA/algoritmo). Debe existir en la matriz ISO 14971.
Control ruta/archivo.py::símbolo verificable HOY; nunca una frase genérica sin path.
REQ REQ-XXX existente en la matriz de trazabilidad.
Test Nombre de test que existe HOY (test_...) + ruta.
Riesgo residual ACEPTABLE / ALARP / INACEPTABLE (criterio de la política de aceptabilidad).
Estado del control Implementado / En curso / Pendiente / Verificado.

3. Matriz de trazabilidad de controles

Riesgo (R-XXX) Peligro / situación peligrosa Control de riesgo (ruta/archivo.py::símbolo) REQ Test de verificación (ruta/test_archivo.py::test_nombre) Riesgo inicial Riesgo residual Estado
R001 app/services/<...>.py::<símbolo> REQ-CLN-01 tests/<...>.py::test_<...>_failsafe INACEPTABLE ALARP Verificado
R002 identidad solo del token app/core/security.py::get_current_user_id REQ-SEC-02 tests/test_hard_rules.py::test_identity_comes_from_token_not_from_body INACEPTABLE Aceptable Verificado
R005 validador + disclaimer + fallback app/services/<...>.py::<símbolo> REQ-AI-01 tests/<...>.py::test_<...>_validator INACEPTABLE ALARP Implementado
R-SEC-01 redacción de errores app/main.py::unhandled_exception_handler y app/main.py::_resumen_de_errores (los logs de validación llevan campo y motivo, no el valor) REQ-UX-01 tests/test_hard_rules.py::test_internal_error_never_leaks_a_traceback, tests/test_hard_rules.py::test_validation_failure_does_not_log_the_submitted_text, tests/test_hard_rules.py::test_unhandled_validation_error_does_not_log_the_value INACEPTABLE Aceptable Verificado
R-SEC-03 cifrado en reposo app/core/encryption.py::encrypt REQ-SEC-01 tests/test_hard_rules.py::test_encryption_roundtrip_and_nonce_uniqueness, tests/test_hard_rules.py::test_tampered_ciphertext_is_rejected INACEPTABLE Aceptable Verificado
R-IA-01 guard "sin dato" app/services/<...>.py::<símbolo> REQ-AI-02 tests/<...>.py::test_<...>_no_data INACEPTABLE ALARP En curso

4. Controles sin verificación (gap activo)

Lista viva de controles declarados pero aún sin test que los verifique. Cada entrada bloquea el cierre de release hasta que su fila en la §3 quede Verificado.

Riesgo Control declarado (ruta/archivo.py::símbolo) Test faltante Responsable Fecha objetivo
R0XX <...> <test pendiente> {{OWNER}} YYYY-MM-DD

5. Riesgos sin control implementado (gap activo)

Riesgo Peligro Decisión Justificación Fecha objetivo
R0XX <...> Diferido / En diseño <...> YYYY-MM-DD

6. Declaración de cierre del lazo

Cuando todas las filas de la §3 estén en estado Verificado, las §4 y §5 vacías, y el riesgo residual global aceptado en ISO_14971_RISK_MATRIX.md §4, el responsable de gestión de riesgo firma el cierre del lazo de control para esta versión.

Versión cerrada Fecha Responsable Riesgos trazados Gaps abiertos
vX.Y YYYY-MM-DD {{OWNER}} NN NN

7. Control de cambios del documento

Versión Fecha Autor Cambio
v1.0 YYYY-MM-DD {{OWNER}} Versión inicial de plantilla.

Navegación: Índice del DHF · Master Map