# Adjuntos (Workspace)

> Monitorea el uso de almacenamiento y gestiona archivos de todas las superficies de adjuntos desde Workspace.

**Adjuntos** en la barra lateral de Workspace abre `/workspace/attachments`. Cualquier miembro
autenticado de la organización activa puede ver la sección; solo los **propietarios** y
**administradores** pueden seleccionar archivos y usar la eliminación masiva.

## Medidor de almacenamiento

En la parte superior de la sección, una tarjeta muestra cuánto almacenamiento ha usado tu
organización frente a su cuota: el total usado (por ejemplo `500 MB`), la cuota (`de 1 GiB usados`
en el plan Free, el predeterminado para las organizaciones creadas después del lanzamiento del
plan — las organizaciones creadas antes conservan su límite heredado de 5 GiB) y el porcentaje
usado con una barra de progreso delgada. Los tres valores vienen del servidor: el medidor nunca
estima el almacenamiento en el navegador. Si tu organización tiene un límite de almacenamiento
personalizado, el medidor muestra ese valor en lugar del predeterminado del plan.

El medidor siempre refleja el uso actual de la organización, así que eliminar archivos (ver
**Eliminación masiva** más abajo) actualiza el total usado y el porcentaje en cuanto la eliminación
se completa.

## Qué cuenta como almacenamiento

El almacenamiento mide los **archivos** que guarda tu organización, nada más.

**Cuenta:**

- Imágenes dentro de textos: descripciones, pasos, comentarios y otros campos de texto enriquecido,
  cada una listada como **Imagen de contenido**
- Archivos subidos a la sección [Adjuntos](https://docs.probara.net/es/guides/test-repository/#adjuntos-del-caso) de un caso de prueba
- Adjuntos de resultados
- Evidencia de defectos
- Imágenes de proyecto

**No cuenta:**

- Texto y registros: los proyectos, suites, casos, pasos, comentarios, ejecuciones y defectos en sí
- Las fotos de perfil de los usuarios
- Los archivos subidos para una importación

Los registros como los proyectos se limitan con los conteos propios de tu plan — ver
[Facturación](https://docs.probara.net/es/guides/billing/) —, no con el almacenamiento.

**Al llegar al límite.** Cualquier subida que haría que tu organización supere su cuota se rechaza
con un mensaje que indica que tu organización se quedó sin almacenamiento, y no se guarda ninguno
de sus archivos. Guardar un paso, un comentario, un paso de ejecución o una imagen de proyecto se
rechaza por completo y todo queda exactamente como estaba; en un resultado de prueba
solo se rechazan sus adjuntos — el resultado que registraste se conserva. Lo que escribiste sigue en
el formulario, así que puedes reintentar después de liberar espacio. Los guardados que no añaden
archivos siempre se aceptan, incluso si ya superaste la cuota; también los que quitan más archivos
de los que añaden, salvo cuando los archivos que quitan siguen en el almacenamiento porque una
versión anterior de su caso aún los muestra (ver **Imágenes que solo muestran versiones anteriores**
más abajo).

**Liberar espacio.** El espacio vuelve en cuanto los archivos desaparecen:

- Elimina archivos aquí con la **Eliminación masiva** (propietarios y administradores).
- Quita una imagen de su texto, cuando ninguna versión anterior de su caso la siga mostrando.
- Elimina un archivo de la sección **Adjuntos** de un caso de prueba.
- Elimina de forma permanente un caso de prueba, una ejecución o un defecto.
- Quita la imagen de un proyecto, o elimina un proyecto — lo que elimina todos sus archivos.

Una imagen que quitas de su texto sigue en el almacenamiento mientras una versión anterior de su caso
la siga mostrando, así que la imagen se sigue viendo al abrir o restaurar esa versión. Ese espacio
vuelve cuando la retención del historial de tu plan elimina la última versión que la muestra, o
cuando eliminas de forma permanente el caso de prueba o su proyecto.

## El listado unificado

Debajo del medidor, una única tabla muestra archivos de **todas** las superficies de adjuntos:
evidencia de resultados de prueba, evidencia de defectos, archivos subidos a casos de prueba e
imágenes dentro de textos (listadas como **Imagen de contenido**),
incluidas las que solo muestran versiones anteriores de un caso (ver abajo). Las fotos de perfil no
están incluidas: esta tabla es solo para evidencia y archivos subidos. Las imágenes de proyecto
tampoco se listan, aunque el medidor las cuenta; cámbialas o quítalas desde la configuración del
proyecto.

El listado muestra únicamente los archivos de los proyectos a los que tienes acceso: un proyecto
privado al que no tienes acceso nunca aporta filas aquí. Los **propietarios**, los
**administradores** y las solicitudes autenticadas con un **token de API** ven todos los archivos
de la organización, proyectos privados incluidos; esa vista sin filtrar es una excepción deliberada,
no un descuido. El medidor de almacenamiento de arriba, en cambio, siempre refleja el uso total de
la organización sin importar tu propio acceso a los proyectos: el medidor y el listado pueden
diferir por diseño.

Los archivos que están dentro de un proyecto **bloqueado** no aparecen en este listado, y tampoco
se cuentan en su total. Un proyecto queda bloqueado cuando tu organización tiene
más proyectos de los que permite tu plan; consulta [Facturación](https://docs.probara.net/es/guides/billing/). El medidor
de almacenamiento de arriba sigue contando esos archivos, porque los sigues almacenando: el medidor
y el listado difieren aquí por diseño, igual que ya lo hacen con los proyectos privados a los que no
tienes acceso. Ampliar el número de proyectos que permite tu plan devuelve esos archivos al
listado, y eliminar el proyecto bloqueado también los elimina junto con él.

Cada fila muestra:

| Columna | Significado                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| ------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Archivo | Un icono del tipo de archivo, el nombre del archivo enlazado al archivo almacenado y, debajo, quién lo subió (para un [token de aplicación](https://docs.probara.net/es/guides/integrations/junit-xml/), el logotipo y el nombre de la aplicación junto al nombre del token). Una imagen dentro de un texto no tiene nombre de archivo, así que se llama **Imagen de contenido**; cuando un caso de prueba la contiene, la línea de abajo muestra ese caso como enlace, en lugar de quien la subió. Un archivo subido a un caso de prueba conserva su nombre, y la línea de abajo muestra su caso de la misma forma. Los archivos subidos antes de que existiera esta funcionalidad no tienen ese dato, así que esa línea no aparece. |
| Tipo    | El tipo MIME del archivo (por ejemplo `image/png`, `application/pdf`)                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Tamaño  | Tamaño de archivo en formato legible                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Subido  | La fecha de subida y, debajo, cuánto tiempo hace. Pasa el cursor sobre la fecha para ver la hora exacta.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |

### Imágenes que solo muestran versiones anteriores

Una imagen que quitaste de un texto sigue contando en el almacenamiento mientras una versión anterior
de su caso la muestre. El listado la muestra una sola vez, la muestren cuantas versiones la muestren.
No tiene enlace al caso, porque el caso ya no la contiene, y su fecha es la de cuando se guardó.

No puedes eliminarla desde aquí: la eliminación masiva no la toca. Su espacio vuelve cuando la
retención del historial de tu plan elimina la última versión que la muestra, o cuando eliminas de
forma permanente su caso de prueba o su proyecto.

### Búsqueda, orden y paginación

Usa el campo de búsqueda para filtrar por nombre de archivo o tipo MIME; por ejemplo, escribir
`png` acota el listado a nombres o imágenes coincidentes. La búsqueda se ejecuta en el servidor y
actualiza la URL, así que un enlace de búsqueda puede compartirse o guardarse.

Haz clic en el encabezado Archivo, Tipo, Tamaño o Subido para ordenar todo el listado por esa
columna (Archivo ordena por nombre), y vuelve a hacer clic para invertir el orden; la flecha del
encabezado indica el orden vigente. Tanto el orden como la búsqueda se aplican a la vez sobre todas
las superficies de adjuntos, no por separado. Usa el control de paginación al final de la tabla para
moverte entre páginas o cambiar cuántas filas se muestran por página.

## Seleccionar archivos y eliminación masiva

Si eres **propietario** o **administrador**, cada fila de archivo tiene una casilla, y el encabezado
de la tabla tiene una casilla para seleccionar todas las filas de la página actual. Una imagen dentro
de un texto no tiene casilla: quítala de su texto. Seleccionar algunas filas de la página, pero no
todas, muestra la casilla del encabezado en un estado parcialmente marcado; seleccionar todas las
filas de la página la marca por completo.

En cuanto seleccionas un archivo, aparece una barra en la parte inferior de la pantalla con la
cantidad de archivos seleccionados y la acción **Eliminar**. Al hacer clic en **Eliminar** se abre
un diálogo de confirmación; ningún archivo se elimina hasta que confirmes. La **×** de la barra
limpia la selección.

Un archivo que está dentro de un proyecto bloqueado tampoco puede eliminarse desde aquí: se omite,
se informa como bloqueado y se queda donde está, mientras que el resto de la selección se elimina
con normalidad. La única forma de quitar esos archivos es reabrir el proyecto ampliando el número
de proyectos que permite tu plan, o eliminar el proyecto bloqueado.

Una imagen dentro de un texto se elimina quitándola de su texto, no desde esta lista. Su espacio
vuelve cuando ninguna versión anterior de su caso la sigue mostrando.

**Eliminar es permanente.** No hay papelera ni forma de deshacer la acción. Si un archivo eliminado
estaba incrustado en otra parte del producto (por ejemplo dentro de un comentario), esa referencia
no se reescribe: sigue mostrando el mismo estado de archivo roto o no disponible que la aplicación
ya usa para cualquier archivo faltante.

Después de confirmar, los archivos seleccionados desaparecen de la tabla, tu selección se limpia y
el medidor de almacenamiento se actualiza para reflejar el espacio liberado.

En una pantalla angosta (ancho de teléfono) el listado se reorganiza como una lista de tarjetas: cada
archivo se presenta como su propia tarjeta, mostrando el mismo tipo, tamaño y momento de subida, con
la misma casilla de selección (para propietarios y administradores) siempre visible en el borde
inicial — nunca revelada solo al pasar el cursor, salvo en una imagen dentro de un texto, que no
tiene casilla. Al seleccionar una tarjeta aparece la misma barra con la acción **Eliminar**. Desde el
ancho de tablet en adelante, la lista es la tabla descrita arriba.

## Quién puede hacer qué

| Rol           | Ve el medidor y el listado | Selecciona archivos y elimina en lote |
| ------------- | -------------------------- | ------------------------------------- |
| Propietario   | Sí                         | Sí                                    |
| Administrador | Sí                         | Sí                                    |
| Miembro       | Sí                         | No                                    |
| Lector        | Sí                         | No                                    |

Los miembros y lectores ven el medidor de almacenamiento y el listado completo, pero no ven
casillas ni la acción **Eliminar**: la eliminación masiva está restringida a
propietarios y administradores, y el servidor rechaza cualquier solicitud de eliminación masiva de
otro rol aunque se intente directamente.
