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.

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. Bajo el modelo de acceso por exclusión actual, cada miembro de tu organización tiene acceso a cada proyecto, por lo que la pila de equipo de cada proyecto muestra toda la organización activa. Este es el comportamiento honesto actual, no un error. Cuando los controles de acceso por proyecto comiencen a revocar miembros de proyectos específicos, cada pila se reducirá automáticamente a los miembros de ese proyecto, sin cambios adicionales.

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. Como cada miembro de la organización tiene actualmente acceso a cada proyecto (ver la nota anterior), el filtro de miembro todavía no reduce la lista. Está conectado a la misma fuente de acceso que la pila de equipo, por lo que empezará a excluir proyectos automáticamente en cuanto existan revocaciones de acceso por proyecto.

  • 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).

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 o un filtro de miembro no coincide 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 y la selección de miembro. 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.