Visión y Gobernanza¶
Proyecto: {{PROJECT_NAME}} · Clase SaMD: {{SAMD_CLASS}} · Versión: v0.1 · Fecha: 2026-01-01
Plantilla del SaMD Starter Kit. Reemplazá todos los marcadores
{{...}}y borrá las notas en bloque>antes de publicar.
0. Regla 0 — El cumplimiento SaMD es la prioridad absoluta¶
Este software está regulado como Software as a Medical Device (SaMD) Clase {{SAMD_CLASS}} bajo IEC 62304 + ISO 14971 + WCAG 2.1 AA + el marco de privacidad aplicable (GDPR/HIPAA según mercado).
Toda decisión técnica se subordina al cumplimiento SaMD. Cuando una conveniencia de desarrollo entre en conflicto con una obligación regulatoria, gana siempre el cumplimiento.
Consecuencias prácticas (no son reglas opcionales):
- Trazabilidad obligatoria (IEC 62304 §5.1, §5.7): todo cambio en algoritmo clínico, esquema de datos, regla de negocio o flujo de seguridad se registra en el resumen de deuda técnica, en la matriz de riesgos (cuando aplique) y en el Master Map.
- No alucinar arquitectura ni reglas clínicas. Ante la duda, leer la documentación maestra antes de codear.
- No eliminar documentación de arquitectura o algoritmos clínicos sin reporte de trazabilidad.
- Verificación demostrable (IEC 62304 §5.7): ninguna tarea se declara "lista" sin correr los tests vinculados y reportar números.
- Fail-safe explícito (ISO 14971): ante fallo de un módulo clínico (red, BD, IA), el sistema degrada de forma segura, predecible y visible — nunca en silencio, nunca exponiendo tracebacks al usuario.
- Análisis de impacto antes de fixear (IEC 62304 §5.6): un bug se considera arreglado solo tras revisar TODOS los consumidores del símbolo modificado.
1. Visión del producto¶
| Campo | Valor |
|---|---|
| Nombre | {{PROJECT_NAME}} |
| Uso previsto (intended use) | {{INTENDED_USE}} |
| Población objetivo | |
| Problema clínico que resuelve | |
| Lo que el producto NO hace | |
| Propietario / legal manufacturer | {{OWNER}} |
| Stack frontend | {{FRONTEND_STACK}} |
| Stack backend | {{BACKEND_STACK}} |
| Stack de datos | {{DB_STACK}} |
| Plataforma cloud | {{CLOUD_STACK}} |
| Idioma de trabajo | {{CHAT_LANG}} |
1.1 Declaración de uso previsto¶
Redactar en una frase verificable: a quién va dirigido, qué función clínica cumple, en qué contexto de uso, y con qué grado de autonomía (informa / impulsa / dirige / diagnostica). Este texto fija la Clase SaMD y es la frontera de todos los claims.
{{INTENDED_USE}}
2. Gobernanza del proyecto¶
2.1 Roles y responsabilidades¶
| Rol | Responsable | Responsabilidad principal |
|---|---|---|
| Propietario del producto | {{OWNER}} | Decisión final, intended use, autorización de release |
| Responsable regulatorio (QA/RA) | DHF, matriz de riesgos, trazabilidad, auditorías | |
| Líder técnico | Arquitectura, estándares de código, integridad técnica | |
| Responsable clínico | Validez de algoritmos clínicos, evidencia | |
| Responsable de seguridad | Cifrado, gestión de claves, control de acceso, SAST/DAST | |
| DPO / privacidad | GDPR/HIPAA, minimización de PII/PHI, derechos del titular |
2.2 Toma de decisiones¶
- Decisiones de arquitectura, schema, regla clínica o flujo de seguridad se documentan vía RFC (ver
docs/05_design_decisions/RFC-TEMPLATE.md) y se trazan a REQ/Risk. - Cambios destructivos (datos, ramas, infraestructura) requieren OK explícito del propietario.
- Release a producción: lo autoriza el propietario tras Definition of Done y cierre de bloque (ver protocolo de auditoría).
2.3 Equipo de auditoría asistida¶
| Agente | Capa | Función |
|---|---|---|
samd-audit-trace |
Regulatorio (audita) | Detecta gaps de trazabilidad IEC 62304 §5.1/§5.7 + ISO 14971. No los escribe. |
docs-dhf |
Regulatorio (escribe) | Materializa Master Map, deuda técnica, matriz de riesgos, RFCs. Verifica ruta/archivo.py::símbolo + tests reales. |
3. Estrategia regulatoria¶
| Decisión | Valor |
|---|---|
| Clasificación objetivo | SaMD Clase {{SAMD_CLASS}} |
| Norma de ciclo de vida | IEC 62304 |
| Gestión de riesgos | ISO 14971 |
| Accesibilidad | WCAG 2.1 AA |
| Privacidad | |
| Mercados objetivo | |
| Vía regulatoria | |
| Sistema de gestión de calidad |
3.1 Hitos regulatorios¶
| Hito | Estado | Fecha objetivo |
|---|---|---|
| Definición de intended use y Clase | YYYY-MM-DD | |
| DHF base completo | YYYY-MM-DD | |
| Matriz de riesgos ISO 14971 cerrada | YYYY-MM-DD | |
| Evaluación de usabilidad IEC 62366 | YYYY-MM-DD | |
| Evidencia clínica | YYYY-MM-DD | |
| Sumisión regulatoria | YYYY-MM-DD |
Detalle de la ruta de certificación: docs/07_regulatory_and_compliance/CERTIFICATION_HOWTO.md.
4. Versionado de este documento¶
| Versión | Fecha | Autor | Cambio |
|---|---|---|---|
| v0.1 | 2026-01-01 | {{OWNER}} | Plantilla inicial |
Navegación: Índice del DHF · Master Map