Documentación · Guías

Proyectos

Un proyecto es un repositorio independiente de suites, casos de prueba, ejecuciones, hitos y defectos. La pantalla Projects es la página de inicio de tu organización: un directorio de cada proyecto al que tienes acceso, con métricas de salud de un vistazo y navegación rápida hacia cada uno.

Cómo llegar a la pantalla

Inicia sesión y llegarás a /projects. También puedes hacer clic en Projects en la navegación superior desde cualquier parte de la aplicación.

Dos modos de vista

El directorio muestra el mismo conjunto paginado de proyectos en dos diseños, que se alternan con el conmutador de vista en la esquina superior derecha:

  • List — una fila compacta por proyecto. Es el modo por defecto en tu primera visita.
  • Cards — una cuadrícula adaptable de tarjetas de proyecto, con más detalle de métricas y del equipo.

Tu elección se recuerda por navegador (persiste tras recargar) y se aplica tanto al directorio como a sus estados de carga, vacío y sin resultados. Cambiar de modo nunca vuelve a pedir datos — solo redibuja los proyectos que ya están en la página.

En una pantalla angosta (ancho de teléfono) tu modo elegido se sigue respetando — el conmutador de vista permanece visible y cambiar de modo sigue funcionando. List se reorganiza como una tarjeta por proyecto (el mismo nombre, id, métricas, equipo y acciones de favorito/menú que la fila, solo que apiladas en vez de en columnas); Cards se reorganiza en una sola columna en vez de una cuadrícula de varias columnas. Desde el ancho de tablet en adelante, ambos modos se ven exactamente como se describe arriba.

Métricas por proyecto

Cada proyecto muestra las mismas cuatro métricas de salud en ambos modos, calculadas en vivo a partir de los datos del proyecto:

MétricaSignificado
CasesCasos de prueba activos (no archivados) del proyecto
RunsTodas las ejecuciones de prueba, con un calificador “{n} en curso” para las que siguen abiertas
DefectsDefectos sin resolver (abiertos o en progreso). Esta métrica se resalta como advertencia cuando es mayor que cero, y el conteo siempre se muestra como número, de modo que la advertencia nunca depende solo del color
MilestonesHitos vigentes (no eliminados) del proyecto

La pila de avatares del equipo

Cada proyecto muestra una pequeña pila de avatares de miembros superpuestos — el equipo del proyecto — con un indicador “+N” cuando el equipo es mayor que los avatares mostrados.

Qué refleja el equipo hoy. Por defecto todo proyecto es público: cada miembro de tu organización tiene acceso, y la pila de equipo de cada proyecto muestra toda la organización activa. Un proyecto puede pasar a privado desde la pestaña Control de acceso en la configuración del proyecto, o mediante la API para integradores; una vez privado, la pila de equipo se reduce automáticamente a la lista de acceso de ese proyecto — Control de acceso — Miembros individuales más abajo es donde administras exactamente quién está en ella. La aplicación del control de acceso sigue a los datos, no a la forma de la URL: un caso de prueba, una ejecución o una entidad similar alcanzada por su propio ULID quedan protegidos igual que el proyecto mismo, de modo que el contenido de un proyecto privado tampoco es alcanzable por esa vía. Aplica una limitación documentada: los tokens de API de la organización siempre siguen alcanzando todos los proyectos sin importar el modo — “privado” aplica solo a quienes llaman como humanos.

Filtrado

La fila de filtros ofrece:

  • Search — escribe para filtrar proyectos por nombre. El término se refleja en la URL, de modo que una vista filtrada se puede compartir y sobrevive a una recarga.
  • Member — filtra el directorio a los proyectos a los que un miembro seleccionado tiene acceso. La selección se codifica en la URL como un conjunto memberUlid, así que un enlace filtrado reproduce la misma vista al abrirlo desde cero.

El filtro de miembro hoy. En un proyecto público el filtro de miembro se comporta como antes. Un proyecto privado que no está en tu lista de acceso queda excluido por completo del directorio (coincida o no con tu selección de filtro) — los propietarios y administradores de la organización siempre ven todos los proyectos sin importar el modo.

  • Ejecuciones — filtra a proyectos sin ejecuciones (Sin ejecuciones), con al menos una ejecución en curso (Con ejecuciones en curso), o con al menos una ejecución de cualquier estado (Con alguna ejecución).
  • Defectos — filtra a proyectos con al menos un defecto sin resolver (Con defectos) o sin defectos sin resolver (Sin defectos).
  • Hitos — filtra a proyectos con al menos un hito (Con hitos) o sin hitos (Sin hitos).
  • Casos — filtra a proyectos con al menos un caso de prueba (Con casos) o sin casos de prueba (Sin casos).
  • Status — un filtro permanente (siempre visible, nunca se puede quitar) con dos opciones: Active y Archived. El directorio muestra proyectos activos por defecto — un proyecto archivado queda oculto en ambos modos de vista y en el contador/paginador hasta que marques Archived (o ambas opciones, para ver todo). Dejarlo vacío equivale a seleccionar Active sola, no es un tercer estado. Tu selección se codifica en la URL como status, así que un enlace filtrado (por ejemplo ?status=archived) reproduce la misma vista al abrirlo desde cero.

Estos filtros se combinan entre sí, con el filtro de miembro y con el término de búsqueda — todas las condiciones activas se aplican juntas (AND entre filtros, OR dentro de las opciones seleccionadas de un filtro). Cada selección se codifica en la URL, por lo que las vistas filtradas son compartibles y sobreviven a una recarga.

Cuando una búsqueda, un filtro de miembro o el filtro Status no coinciden con ningún proyecto, el directorio muestra un estado de sin resultados con una acción Clear filters que elimina a la vez el término de búsqueda, la selección de miembro y la selección de Status (el chip de Status permanece visible, solo que vacío después, devolviéndote a la vista activa por defecto). Esto es distinto del estado vacío que aparece cuando tu organización simplemente aún no tiene proyectos, que ofrece una acción Create first project (para propietarios y administradores de la organización).

Favoritos

Haz clic en la estrella de cualquier proyecto para agregarlo a tus favoritos. Los proyectos favoritos suben al principio de la página que estás viendo, manteniendo por lo demás su orden relativo. Los favoritos se guardan por usuario y por organización en tu navegador.

Los favoritos ordenan solo dentro de la página actual. Un favorito que vive en otra página de un directorio grande no se trae a la primera página. Para el portafolio típico de una sola página esto es invisible; solo importa cuando un directorio es lo bastante grande como para paginar.

Paginación

Cuando tu organización tiene menos de diez proyectos, no se muestra paginador — el directorio es una sola página. Con diez o más, el paginador aparece debajo del directorio: el selector de filas por página y el resumen del rango siempre se muestran, y los controles de anterior/siguiente y de número de página solo aparecen cuando el directorio ocupa más de una página. Cambiar de página solicita esa página de proyectos.

En las pantallas de lista de Probara que se muestran como tabla — ejecuciones de pruebas, miembros del workspace y otras — toda fila que abre un detalle se puede alcanzar sin ratón: pulsa Tab hasta enfocar la fila y luego Enter o Espacio para abrirla, igual que al hacer clic. Los controles propios de la fila (un menú de acciones, un botón de quitar) siguen funcionando de forma independiente y nunca disparan la navegación de la fila.

Crear un proyecto

Los propietarios y administradores de la organización ven un botón New project en el encabezado (y una acción Create first project en el estado vacío). Los miembros y observadores pueden explorar el directorio pero no ven la acción de crear.

Configuración del proyecto

Abre Configuración en la barra lateral del proyecto o elige Editar en la lista de proyectos (menú ⋯). Cualquier miembro de la organización puede ver Nombre, ID del Proyecto y Descripción.

Solo el Propietario y los Administradores de la organización pueden guardar cambios. Miembros y observadores ven los mismos campos en solo lectura.

El Propietario y los Administradores también pueden subir, cambiar o quitar la imagen del proyecto desde la configuración. La imagen aparece en la barra lateral del proyecto, en la lista de proyectos y en el encabezado de configuración. Miembros y observadores ven la imagen (o las iniciales de respaldo) pero no pueden modificarla. Formatos admitidos: PNG, JPEG o WebP, hasta 5 MB.

El ID del Proyecto es el prefijo en mayúsculas de los IDs visibles de casos y suites (por ejemplo ACME-14). Cambiarlo actualiza esos prefijos al instante y rompe URLs antiguas /projects/<id-anterior> y marcadores—revisa integraciones y enlaces compartidos antes de renombrar.

Archivar y eliminar un proyecto

El encabezado de configuración incluye dos acciones de ciclo de vida de todo el proyecto, visibles solo para propietarios y administradores de la organización:

  • Archive / Unarchive — un alternador reversible. Archivar oculta el proyecto del directorio por defecto (ver filtro Status más arriba) en todos los lugares donde aparece listado, pero no cambia nada más: el proyecto, sus suites, casos, ejecuciones, hitos y defectos siguen siendo totalmente legibles y editables, y cada enlace existente sigue resolviendo. Desarchivar lo devuelve a la vista por defecto. Archivar no libera un asiento de proyecto de tu límite del plan — eliminar sigue siendo la única forma de hacerlo.
  • Delete — permanente e irreversible. Elimina el proyecto y cada suite, caso, ejecución e hito que contiene. Ambas acciones piden confirmación antes de hacer algo; cancelar no genera ninguna solicitud.

Limitación conocida. Eliminar un proyecto no quita su imagen ni los adjuntos de pasos del almacenamiento — solo las filas de la base de datos. Esto no tiene efecto visible hoy y está previsto abordarlo en un cambio futuro.

Control de acceso — Miembros individuales

Abre la pestaña Control de acceso en la configuración del proyecto para administrar la lista de acceso de un proyecto privado. Debajo del alternador de modo y del propietario, aparecen dos pestañas internas solo en modo privado: Grupos (una superficie reservada sin funcionalidad todavía — no existe la entidad de grupo ni el acceso por grupos) y Miembros individuales.

La pestaña Miembros individuales lista a cada miembro que está actualmente en la lista de acceso con su avatar, nombre, correo, rol y cargo. Para agregar a alguien, elige un miembro activo de la organización que aún no esté en la lista y confirma — obtiene acceso de inmediato, sin cambiar el modo del proyecto. Para quitar a alguien, usa la acción Revocar acceso en su fila y confirma en el diálogo que lo nombra.

La acción de revocar solo aparece en una fila con rol Miembro — nunca en una fila de Propietario ni de Administrador, incluso cuando ese administrador tiene un otorgamiento propio (su acceso proviene de su rol de organización de todas formas, así que revocar esa fila en particular no cambiaría nada sobre quién puede abrir el proyecto). Si todas las filas restantes de la lista son de Propietario o Administrador, ninguna fila es accionable — el alternador de modo es la única salida, y eso es intencional: publicar un proyecto es un cambio de modo y debe hacerse como tal, no como efecto secundario de quitar las últimas filas visibles.

Eliminar el último otorgamiento restante en un proyecto privado ahora tiene éxito: la lista de acceso queda vacía y el proyecto permanece privado, alcanzable solo mediante el bypass de propietario/ administrador de la organización hasta que se otorgue acceso de nuevo o se cambie explícitamente el modo a público. Vaciar la lista de acceso nunca es en sí mismo una publicación — solo el alternador de modo anterior publica un proyecto.