Un plan de prueba es una selección duradera y con nombre de casos de prueba que defines una vez y reutilizas en distintos releases, sprints o ciclos de prueba repetidos. Ejemplos habituales son “Smoke”, “Regresión de Release” o “Ruta Crítica” — selecciones que ejecutas una y otra vez sin tener que recomponerlas cada vez.
Los planes de prueba se encuentran en /projects/:projectId/plans, en la sección TESTS de la barra lateral del proyecto. Cada plan acumula su propio historial de ejecuciones generadas a lo largo del tiempo, independientemente del repositorio de pruebas.
Cómo llegar a la pantalla
Abre un proyecto y haz clic en Plans en la sección TESTS de la barra lateral del proyecto. La URL es /projects/:projectId/plans.
La lista de planes de prueba
La lista muestra todos los planes de prueba activos del proyecto en una tabla con las siguientes columnas:
| Columna | Descripción |
|---|---|
| # | Número de plan asignado automáticamente, único dentro del proyecto |
| Nombre | Nombre del plan |
| Casos | Cantidad actual de casos de prueba seleccionados |
| Creado por | El usuario que creó el plan |
| Creado | Fecha de creación |
La lista está paginada. La búsqueda no está disponible en la v1 — usa el número de plan o desplázate para encontrar un plan.
Crear un plan
- Haz clic en Nuevo plan (visible para miembros y roles superiores; los viewers ven la lista en modo solo lectura).
- Escribe un Nombre para el plan — por ejemplo,
SmokeoRegresión de Release. - Opcionalmente agrega una Descripción.
- Haz clic en Crear plan.
Reglas de nombre: los nombres de plan deben ser únicos entre los planes activos del proyecto. Si el nombre ya está en uso, aparece un error en línea “Este nombre ya está en uso” en el campo de nombre y el diálogo permanece abierto.
Editar un plan
Haz clic en la acción Editar plan en la fila del plan para abrir el diálogo de edición. También puedes abrir el mismo diálogo desde la vista de detalle del plan haciendo clic en el botón Editar plan en el encabezado del detalle. Cambia el nombre o la descripción y haz clic en Guardar cambios.
La misma regla de unicidad aplica al editar: cambiar el nombre de un plan por uno que ya usa otro plan activo muestra un error en línea y mantiene el diálogo abierto.
Eliminar un plan
Haz clic en la acción Eliminar plan en la fila del plan. Un diálogo de confirmación muestra el nombre del plan e indica que las ejecuciones generadas anteriormente no se ven afectadas. Haz clic en Eliminar para confirmar, o en Cancelar para volver sin cambios.
La eliminación es permanente y no se puede deshacer desde la interfaz. Las ejecuciones generadas desde el plan antes de eliminarlo permanecen intactas.
Vista de detalle del plan — diseño con pestañas
Haz clic en el nombre de un plan para abrir su vista de detalle en /projects/:projectId/plans/:planUlid. La vista de detalle está compuesta por:
- Un encabezado con el nombre y la descripción del plan, y los botones de acción.
- Un área principal con pestañas con tres pestañas: Selección, Matriz de configuración y Progreso.
- Un panel lateral a la derecha que muestra el donut de progreso, los conteos de resultados, el estado, el hito y los metadatos del plan.
La pestaña activa se persiste en la URL (?tab=selection, ?tab=matrix o ?tab=progress), por lo que puedes enlazar directamente a una pestaña específica y la vista se conserva al refrescar el navegador.
Pestaña Selección
La pestaña Selección muestra los casos seleccionados del plan agrupados en bandas de suite plegables. Los casos sin suite aparecen en una banda sin grupo. Cada fila muestra el ID del caso, el título y el responsable.
Haz clic en el encabezado de una banda de suite para plegar o expandir ese grupo.
Si el plan aún no tiene casos, la pestaña Selección muestra un estado de selección vacía con la acción Editar selección para comenzar.
Pestaña Matriz de configuración
La pestaña Matriz de configuración muestra los selectores de valores por dimensión y la grilla de combinaciones. Consulta la sección Matriz de configuración más adelante para más detalles.
Pestaña Progreso
La pestaña Progreso muestra la tabla de desglose por configuración con los conteos de resultados para cada combinación que ha generado ejecuciones.
Editar la selección de casos
Para editar la selección:
- Haz clic en Editar selección en el encabezado (visible para miembros y roles superiores).
- El selector de casos se abre con la selección actual del plan ya marcada, mostrando el responsable guardado de cada caso. Es el mismo selector que se usa al iniciar una ejecución desde el repositorio.
- Agrega o elimina casos según sea necesario. Para cada caso también puedes establecer o cambiar el campo Responsable en el selector.
- Haz clic en Confirmar para reemplazar la selección del plan por el conjunto completo que tienes marcado, incluyendo todos los responsables.
La nueva selección — incluidos todos los responsables por caso — se refleja de inmediato en la vista de detalle. Las ejecuciones generadas anteriormente desde el plan no se ven afectadas — una ejecución toma una instantánea de la lista de casos y los responsables en el momento en que se genera.
Responsables por caso en la selección
Cada fila de la pestaña Selección muestra una columna Responsable. Los miembros ven un selector interactivo de Responsable (combobox) en cada fila; los viewers ven el nombre del responsable o ”—” como texto solo lectura.
Cambiar un responsable en línea
Para cambiar el responsable de un caso sin abrir el selector de casos:
- Abre la pestaña Selección en el detalle del plan.
- Haz clic en el combobox Responsable de la fila que deseas actualizar.
- Selecciona un miembro del equipo en el desplegable, o selecciona Sin asignar para quitar el responsable actual.
- El cambio se guarda de inmediato — no se requiere confirmación adicional.
Solo una fila puede estar actualizándose a la vez. Mientras se guarda, el combobox de esa fila se deshabilita para evitar envíos dobles. La fila refleja el valor devuelto por el servidor una vez que la actualización se completa.
Importante: semántica de instantánea
Cambiar el responsable de un caso en línea actualiza únicamente el responsable almacenado en el plan para ese caso. No se propaga a ninguna ejecución ya generada desde el plan. Los casos de ejecución existentes conservan el responsable que tenían en el momento en que se generó la ejecución.
Esto es intencional — una ejecución es una instantánea. Si necesitas que el responsable de una ejecución ya existente refleje un cambio, utiliza los controles de responsable propios de esa ejecución.
Asignar durante Editar selección
También puedes establecer o cambiar responsables en bloque al editar la selección de casos:
- Abre Editar selección en el encabezado.
- Establece el campo Responsable en los casos deseados dentro del selector.
- Haz clic en Confirmar. Todos los responsables se guardan junto con la selección completa en una sola operación.
Los responsables son opcionales — cualquier cantidad de casos puede quedar sin responsable.
Crear una ejecución desde un plan
Un plan puede acumular varias ejecuciones a lo largo del tiempo, pero cada acción crea exactamente una ejecución — un plan nunca genera varias ejecuciones de un solo clic. Una ejecución creada desde un plan toma una instantánea de la selección de casos actual y sus responsables por caso, de modo que editar la selección o los responsables después no altera las ejecuciones ya creadas.
Para crear una ejecución desde la vista de detalle del plan:
- Abre el detalle del plan.
- Haz clic en Nueva ejecución. El botón está deshabilitado cuando la selección está vacía — agrega casos primero.
- Se abre el modal Nueva ejecución de prueba con el plan ya seleccionado. Ajusta el nombre, el entorno, el hito, los responsables y las configuraciones según necesites.
- Envía el formulario. Se crea una ejecución y la aplicación navega a su vista de ejecución.
Cómo se transfieren los responsables a la ejecución generada
Al generar una ejecución desde un plan, los responsables por caso almacenados en el plan se transfieren automáticamente a los casos de ejecución correspondientes. No necesitas reasignar personas en cada ejecución.
La precedencia completa de responsables (para cada caso de ejecución, gana la primera coincidencia):
- Override por caso — un responsable que asignas explícitamente en el modal “Nueva ejecución de prueba” para ese caso específico
- Responsable almacenado en el plan — el responsable guardado en ese caso del plan
- Responsable por defecto — el campo “Responsable por defecto” del modal (se aplica a todos los casos sin fuente de mayor prioridad)
- Sin responsable — si ninguno de los anteriores aplica, el caso de ejecución queda sin responsable
Responsables desactualizados
Si un miembro del equipo que estaba asignado a un caso del plan más adelante abandona la organización, generar una ejecución desde ese plan sigue teniendo éxito. El caso de ejecución se crea simplemente sin responsable (—) — el responsable desactualizado se descarta silenciosamente en lugar de causar un error.
Generar una ejecución desde el modal de nueva ejecución
También puedes iniciar una ejecución desde un plan directamente desde el modal Nueva ejecución de prueba, sin necesidad de abrir el detalle del plan:
- Haz clic en Nuevo run desde la lista de ejecuciones.
- Selecciona la pestaña Desde plan de prueba.
- Elige un plan en el desplegable. El modal prellena los responsables por caso desde la selección almacenada del plan.
- Opcionalmente establece un Responsable por defecto para los casos sin responsable a nivel de plan, o ajusta los responsables de casos individuales.
- Haz clic en Crear ejecución. La aplicación crea la ejecución y navega a la vista de ejecución.
La pestaña Desde repositorio sigue funcionando como antes — permite construir una selección de casos manual para una ejecución puntual.
Cómo se relacionan los planes con las ejecuciones
- Un plan es reutilizable: puedes generar tantas ejecuciones como quieras desde él en cualquier momento.
- Cada ejecución es una instantánea: captura los casos seleccionados en el momento de la generación. Los cambios futuros en el plan no afectan las ejecuciones pasadas.
- Eliminar un plan no elimina sus ejecuciones. Las ejecuciones permanecen en el historial de ejecuciones del proyecto; el vínculo desde cada ejecución hacia el plan simplemente se borra.
Estado del plan
Cada plan de prueba tiene un estado que defines y cambias manualmente. Los tres estados disponibles son:
| Estado | Significado |
|---|---|
| Borrador | El plan está siendo preparado — se están curando los casos y las configuraciones |
| Activo | El plan está en uso y generando ejecuciones |
| Completado | El ciclo ha terminado; el plan queda archivado en su lugar |
Cómo funciona el estado
- Un plan nuevo comienza en Borrador a menos que elijas un estado diferente al crearlo.
- Las transiciones son libres: puedes pasar de cualquier estado a cualquier otro en cualquier momento. No hay estados terminales — un plan Completado puede reabrirse como Activo o revertirse a Borrador.
- El estado es estrictamente manual en la v1. El plan nunca avanza automáticamente a Completado cuando sus ejecuciones se cierran; esa decisión siempre te corresponde a ti.
- Un PATCH con el mismo valor de estado (sin cambio real) se acepta sin error ni evento.
- Un valor de estado inválido devuelve
422 validation_failed.
Cambiar el estado
Abre el detalle del plan. Los miembros ven un selector de Estado en el panel lateral derecho. Selecciona el estado deseado en el desplegable; el cambio se guarda de inmediato. Los viewers ven el estado actual como un chip de solo lectura en el panel lateral.
Progreso
El panel lateral a la derecha del detalle del plan muestra un donut de progreso (porcentaje ejecutado + conteo ejecutado/total) y un resumen de resultados (Pasados, Fallidos, Bloqueados, Omitidos, Sin probar) calculados a partir de los mismos contadores de resultados que la pestaña Progreso. Estos datos son un resumen en vivo calculado en el momento de la lectura.
La pestaña Progreso muestra la tabla de desglose por configuración. Consulta Pestaña Progreso más arriba.
Conteos de resultados generales
La parte superior de la sección Progreso muestra los totales de todas las ejecuciones del plan:
| Métrica | Significado |
|---|---|
| Total de ejecuciones | Número de ejecuciones generadas desde este plan (abiertas o cerradas) |
| Ejecuciones cerradas | Cantidad de esas ejecuciones que han sido cerradas |
| Pasadas | Suma de resultados pasados en todas las ejecuciones |
| Fallidas | Suma de resultados fallidos |
| Bloqueadas | Suma de resultados bloqueados |
| Omitidas | Suma de resultados omitidos |
| Sin probar | Suma de resultados sin probar (pendientes) |
Los conteos de resultados reutilizan los mismos contadores por estado que se mantienen en cada ejecución. No se hace un re-análisis de los resultados individuales en el momento de la lectura.
Un plan sin ejecuciones muestra conteos en cero y un desglose vacío.
Desglose por configuración
Cuando el plan ha generado ejecuciones usando la matriz de configuraciones, la sección Por configuración agrupa esas ejecuciones por combinación y muestra los conteos de resultados por grupo. Cada fila del desglose corresponde a una combinación de configuración (por ejemplo, Chrome / Windows) e incluye sus propios totales de ejecuciones y conteos de resultados.
Las ejecuciones que se generaron sin etiquetas de configuración — ya sea porque el plan no tenía selección de configuración en ese momento, o porque se crearon manualmente — aparecen en un único grupo Sin configuración. La suma de los conteos de todas las filas del desglose es igual a los conteos generales que se muestran arriba.
Vínculo de hito
Un plan de prueba puede vincularse de forma opcional a un hito del mismo proyecto. Esta asociación es exclusivamente para el seguimiento de releases y contexto — no afecta la generación de ejecuciones ni la ejecución de pruebas.
Vincular un plan a un hito
Abre el detalle del plan. Los miembros ven un selector de Hito en el panel lateral derecho. Selecciona un hito del desplegable para vincularlo al plan; selecciona Sin hito para borrar el vínculo. El cambio se guarda de inmediato.
Los hitos disponibles son los hitos activos del proyecto del plan. No se puede seleccionar un hito de otro proyecto.
Los viewers ven el nombre del hito vinculado (o ”—”) como texto de solo lectura en el panel lateral.
Cuando se elimina un hito
Si se elimina un hito vinculado, el vínculo del plan se borra automáticamente. El plan en sí se conserva.
Independencia respecto de los hitos de las ejecuciones
El vínculo de hito del plan es independiente del hito que se establece en las ejecuciones creadas desde él. Crear una ejecución desde un plan que tiene un hito vinculado no transfiere automáticamente ese hito a la nueva ejecución. El hito de cada ejecución se establece por separado en el modal Nueva ejecución de prueba.
Permisos
| Acción | Viewer | Member |
|---|---|---|
| Ver la lista de planes | Sí | Sí |
| Ver el detalle de un plan | Sí | Sí |
| Ver la selección de casos | Sí | Sí |
| Ver los responsables por caso | Sí | Sí |
| Ver estado, progreso e hito | Sí | Sí |
| Crear un plan | No | Sí |
| Editar un plan | No | Sí |
| Eliminar un plan | No | Sí |
| Editar la selección de casos | No | Sí |
| Asignar responsables en Editar selección | No | Sí |
| Cambiar el responsable en línea desde la pestaña Selección | No | Sí |
| Cambiar el estado del plan | No | Sí |
| Establecer o borrar el vínculo de hito | No | Sí |
| Crear una ejecución | No | Sí |
Matriz de configuraciones
La matriz de configuraciones declara qué combinaciones de configuración pretende cubrir este plan. Es una lista de cobertura, no un generador: nunca crea ejecuciones por sí sola. Cuando seleccionas valores de varios grupos — por ejemplo, Chrome y Firefox del grupo Navegador, más Windows y macOS del grupo OS —, el plan calcula una grilla de combinaciones, y tú creas una ejecución para cada combinación cuando estés listo para probarla.
Si no hay valores de configuración seleccionados el plan sigue funcionando: las ejecuciones creadas desde él simplemente no llevan configuración.
Consulta Configuraciones para saber cómo definir grupos y valores de configuración en tu proyecto.
Seleccionar valores por grupo
La pestaña Matriz de configuración en la vista de detalle del plan muestra todos los grupos de configuración definidos en el proyecto. Para cada grupo, usa las casillas de verificación para seleccionar qué valores quieres que cubra este plan.
- Marcar un valor lo agrega a la selección de configuración del plan para ese grupo.
- Desmarcarlo lo elimina. La grilla de combinaciones se actualiza de inmediato.
- Los grupos en los que no se selecciona ningún valor no participan en el producto cartesiano.
La grilla de combinaciones
Una vez que se selecciona al menos un valor, aparece una grilla de Combinaciones debajo de los selectores de valores. Cada fila de la grilla representa una combinación candidata — el producto cartesiano de todos los valores seleccionados en todos los grupos participantes.
| Columna | Descripción |
|---|---|
| Combinación | El conjunto de valores para esta combinación (uno por grupo participante) |
| Ejecución | Un vínculo a la ejecución más reciente que cubre esta combinación, más un contador ×N de solo lectura cuando hay varias. Pendiente cuando aún no hay ninguna, — cuando está excluida |
| Incluir / Excluir | Alternar si esta combinación forma parte de la cobertura prevista del plan |
El contador ×N es solo informativo — no es un vínculo ni un botón, y al pulsarlo no ocurre nada. Para ver el desglose de resultados por combinación, usa la pestaña Progreso.
Cada combinación comienza como incluida. La grilla muestra solo las combinaciones que resultan de tu selección de valores actual; se actualiza en tiempo real al agregar o quitar valores.
Excluir combinaciones específicas
Para declarar que una combinación no se va a probar, haz clic en Excluir en esa fila. La fila queda marcada como excluida, su columna Ejecución muestra — y no ofrece acción de creación. Haz clic en Incluir en la misma fila para restaurarla.
Puedes excluir tantas combinaciones como quieras. El recuento de cobertura que se muestra debajo de la grilla refleja solo las combinaciones incluidas.
El recuento de cobertura
Debajo de la grilla de combinaciones el plan muestra el tamaño de su cobertura prevista:
- N combinaciones por cubrir — las combinaciones incluidas.
- Sin configuración seleccionada — las ejecuciones de este plan no llevan configuración — se muestra cuando no hay valores marcados.
- Ninguna combinación por cubrir — incluye al menos una — se muestra cuando todas las combinaciones están excluidas.
Crear una ejecución para una combinación
Cada fila pendiente ofrece una acción Nueva ejecución. Al pulsarla se abre el modal Nueva ejecución de prueba con el plan y esa combinación ya rellenados, de modo que la ejecución que creas queda etiquetada exactamente con esa configuración. Una fila que ya tiene ejecución conserva también su acción Nueva ejecución — volver a probar una combinación después de un arreglo es un flujo normal, y la fila pasa a mostrar la ejecución más reciente junto al contador ×N.
Crear una ejecución nunca ocurre de forma implícita: la matriz declara la intención, y tú decides cuándo se ejecuta realmente cada combinación.
Cada ejecución toma una instantánea de la selección de casos actual del plan. Los cambios futuros en el plan — cambiar valores, excluir combinaciones o actualizar la selección de casos — no afectan las ejecuciones que ya existen.