# Proyectos

> Explora los proyectos de tu organización como lista o como cuadrícula de tarjetas — revisa métricas de salud, filtra por miembro y fija favoritos arriba.

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étrica        | Significado                                                                                                                                                                                                                |
| -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cases**      | Casos de prueba activos (no archivados) del proyecto                                                                                                                                                                       |
| **Runs**       | Todas las ejecuciones de prueba, con un calificador **"\{n\} en curso"** para las que siguen abiertas                                                                                                                      |
| **Defects**    | Defectos 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 |
| **Milestones** | Hitos vigentes (no eliminados) del proyecto                                                                                                                                                                                |

**Runs**, **Defects** y **Milestones** son enlaces: un conteo mayor que cero abre la lista
correspondiente de ese proyecto. **Cases** no lo es —el proyecto ya se abre con un clic en cualquier
otro punto de su fila o tarjeta— y ningún conteo de cero lo es tampoco, porque no hay nada que
abrir. En un [proyecto bloqueado](https://docs.probara.net/es/guides/billing/#qué-es-un-proyecto-bloqueado), seleccionar un
conteo abre los detalles de tu plan en su lugar.

## 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](#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.

## Navegar tablas con el teclado

En las pantallas de lista de Probara que se muestran como tabla — la lista de proyectos en modo **List**, 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**. La descripción admite formato e imágenes, igual que al crear el proyecto.

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. La imagen cuenta para el almacenamiento de tu organización, así que una subida se rechaza cuando la organización se quedó sin almacenamiento.

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.

## Repositorio — revisión de casos de prueba

La pestaña **Repositorio** de la configuración del proyecto activa la **revisión de casos de prueba**
en el proyecto y define cómo funciona: si la revisión es obligatoria, si el autor puede fusionar, las
aprobaciones necesarias, la fusión automática y los revisores predeterminados. La revisión de casos de
prueba está disponible en los planes **Pro** y **Enterprise**. Consulta
[Revisión de casos de prueba](https://docs.probara.net/es/guides/test-case-review/) para cada opción y para enviar casos a
revisión.

La misma pestaña define el **Formato de pasos por defecto**, **Clásico** o **Gherkin**. Un caso nuevo lo toma, salvo que quien lo crea elija otro formato, y cambiarlo deja los casos existentes como están. Consulta [Casos de prueba Gherkin](https://docs.probara.net/es/guides/gherkin-test-cases/).

## 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](#filtrado) 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.

**Almacenamiento.** Eliminar un proyecto también elimina todos sus archivos — imágenes dentro de textos,
archivos subidos a casos de prueba, evidencia de resultados, evidencia de defectos y su imagen — y
libera ese espacio del almacenamiento de tu
organización al instante. Consulta [qué cuenta como almacenamiento](https://docs.probara.net/es/guides/attachments/).

## Control de acceso — Miembros individuales

Abre la pestaña **Control de acceso** en la configuración del proyecto para administrar quién puede abrir
un proyecto. Primero aparece el propietario y luego el alternador **Público** / **Privado**, con una línea
que explica qué significa el modo actual. En modo privado aparecen dos pestañas internas, **Grupos** y
**Miembros individuales**, cada una con su cantidad. Todos los miembros de un grupo de la pestaña
**Grupos** pueden abrir el proyecto.

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. El botón del extremo derecho de la barra de pestañas agrega en la
pestaña que tienes abierta: **Agregar miembro** aquí, **Agregar grupo** en Grupos. 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.
