En un proyecto real, una prueba de integración no debería existir como un elemento aislado. Debe poder relacionarse con un requisito, una regla de negocio, una interfaz, un contrato, un riesgo o un defecto conocido.
La trazabilidad permite responder por qué existe una prueba, qué cubre, qué componente protege y qué impacto tendría si falla.
En este tema veremos cómo relacionar requisitos, interfaces y pruebas de integración para mantener claridad y evitar suites difíciles de entender.
La trazabilidad es la capacidad de seguir la relación entre distintos elementos del desarrollo y testing. En integración, nos interesa conectar pruebas con aquello que justificó su existencia.
Puede relacionar:
Las pruebas de integración suelen cubrir colaboraciones importantes. Si no sabemos qué requisito o contrato cubre cada prueba, la suite se vuelve difícil de mantener.
La trazabilidad ayuda a:
Un requisito describe una necesidad o comportamiento esperado. Desde un requisito podemos derivar integraciones que deben verificarse.
Ejemplo de requisito:
De este requisito pueden surgir pruebas de integración para:
Una interfaz define cómo se comunican componentes. Desde una interfaz podemos identificar contratos que deben probarse.
Ejemplos:
Una prueba trazable indica qué interfaz verifica y qué aspecto del contrato está cubriendo.
Algunas pruebas existen porque cubren un riesgo importante, aunque el requisito sea amplio. Por ejemplo, riesgo de duplicar pagos, dejar stock negativo o procesar dos veces un evento.
Riesgos que pueden generar pruebas de integración:
Relacionar pruebas con riesgos ayuda a justificar por qué ciertos escenarios merecen prioridad.
Cuando se encuentra un defecto de integración, conviene preguntarse si debe quedar una prueba que evite su repetición.
Ejemplo:
Esta trazabilidad permite saber que la prueba protege una falla real ya observada.
Una matriz de trazabilidad es una tabla que relaciona requisitos, interfaces, riesgos y pruebas. No tiene que ser compleja para ser útil.
| Requisito o riesgo | Interfaz | Prueba de integración | Resultado esperado |
|---|---|---|---|
| Compra con pago aprobado. | Servicio de compras y pagos. | Confirmar compra aprobada. | Orden pagada y stock descontado. |
| Pago rechazado no confirma compra. | Servicio de pagos. | Pago rechazado no descuenta stock. | Orden no confirmada y stock intacto. |
| Notificar orden creada. | Evento orden_creada. | Orden creada publica evento válido. | Evento con campos obligatorios. |
No siempre hace falta una matriz formal. En equipos pequeños, la trazabilidad puede mantenerse de forma liviana.
Opciones simples:
La clave es que la información sea útil y se mantenga actualizada. Una documentación pesada y abandonada pierde valor rápidamente.
Cuando cambia una interfaz, la trazabilidad permite identificar qué pruebas revisar. Esto es muy importante en integración, porque un cambio pequeño puede afectar varios consumidores.
Si cambia un evento, podemos buscar:
Sin trazabilidad, el equipo puede descubrir impactos recién cuando una prueba amplia falla o cuando aparece un defecto.
La trazabilidad ayuda a entender cobertura, pero cobertura no significa cantidad de pruebas. Significa qué riesgos, requisitos e interfaces están protegidos.
Preguntas útiles:
Una suite de pruebas crece con el tiempo. Sin trazabilidad, pueden acumularse pruebas que nadie entiende o que ya no cubren un comportamiento relevante.
La trazabilidad ayuda a decidir:
Supongamos una funcionalidad que importa clientes desde un archivo CSV.
| Elemento | Relación trazable |
|---|---|
| Requisito | El sistema debe importar clientes desde un archivo CSV válido. |
| Interfaz | Archivo CSV con columnas nombre, email y documento. |
| Prueba positiva | CSV válido crea clientes en la base de datos. |
| Prueba negativa | CSV sin columna email rechaza importación. |
| Riesgo | Crear clientes incompletos o duplicados. |
Para un evento de orden creada, la trazabilidad puede mostrar:
orden_creada.Si el contrato del evento cambia, sabemos qué pruebas y consumidores revisar.
Al trabajar con trazabilidad, suelen aparecer errores como:
Para revisar trazabilidad en pruebas de integración, podemos preguntar:
La trazabilidad convierte una suite de pruebas en una fuente de información útil. Permite saber qué requisitos, interfaces y riesgos están protegidos, y qué impacto tiene una falla o un cambio.
En pruebas de integración, donde varias partes colaboran, esta claridad es especialmente valiosa para mantener el sistema bajo control a medida que evoluciona.
En el próximo tema veremos diagnóstico de fallas de integración.