Archivos y espacio del equipo

Weblabor Base le da a cada cuenta una biblioteca de archivos y una cuota de espacio. Weblabor Teams le da esas dos cosas al equipo: una sola carpeta compartida en la que trabaja cada miembro, y una cuota que defines en el plan del equipo y de la que puedes vender más. Esta guía cubre ambas pantallas, el permiso que las abre y qué cambió con el logo del equipo.

Las dos pantallas

Ambas aparecen en el menú lateral del equipo bajo Administración. Abrir cualquiera de las dos requiere una sola cosa: permiso para administrar los archivos del equipo — manage media en el guard team.

• Quien lo tiene ve Media y Espacio en el menú y abre las dos, con los planes encendidos o apagados, y sin importar el plan, el saldo o los permisos de planes del equipo.
• Quien no lo tiene no ve las entradas, y abrir su URL se rechaza.
• El rol de propietario del equipo lo tiene desde el principio, como cualquier otro permiso del equipo; dáselo a otro rol desde /team/roles. Ve Roles y permisos del equipo.

Una sola carpeta compartida

Un equipo tiene un solo árbol de carpetas, y todos los que pueden abrirlo ven lo mismo. No hay carpetas por miembro ni un área privada: un archivo que sube un miembro es un archivo que cualquier otro miembro con el permiso puede renombrar, mover o eliminar. Ese es justamente el punto: los archivos son del equipo, no de quien los haya subido.

Si tu producto necesita archivos que pertenezcan a una sola persona, ya existen: la biblioteca personal en /app/media no cambió y acompaña a la persona a cada equipo.

Definir la cuota

La cuota es el medidor disk_space que siembra la base. Su número se lee en la unidad que tu proyecto declara para el espacio en disco —megabytes o gigabytes, gigabytes si no declaraste otra, con $diskSpaceUnit en App\Classes\PlanLimits— y los equipos usan esa misma unidad: no hay una aparte para equipos.

1. Abre el plan del equipo en el panel de administración y agrega disk_space bajo Límites, con el espacio que incluye el plan, en esa unidad.
2. Nada más. Las pantallas del equipo lo leen de inmediato, igual que la tarjeta de uso del tablero del equipo.

Para vender más espacio, crea un complemento con Vendido por escalones encendido y una fila de límite disk_space, y pon la cantidad, en la misma unidad, en la columna Unidades de cada variación de precio. Comprarlo sube la cuota del equipo de inmediato; cancelarlo la baja. El recorrido completo es Vender complementos en el sitio de la base.

Con los planes apagados, o en un plan que no declara disk_space, no se resuelve ninguna cuota y no se bloquea nada. Un equipo sin plan activo es lo contrario: su cuota es cero, así que se rechaza toda subida —la pantalla Media, los cargadores y el logo del equipo por igual— y su pantalla Espacio muestra lo que ocupan sus archivos con "No incluido en tu plan" debajo. Ve Planes y cobros del equipo.

Qué pasa al llegar a la cuota

Una subida se rechaza en cuanto el equipo está en su cuota, y también un archivo que lo dejaría por encima de ella: a la persona se le dice por qué en vez de mostrarle un aviso de éxito. El único lugar donde un archivo todavía puede cruzar la cuota desde abajo es la subida propia de la pantalla Media cuando los archivos no van directo a S3; ahí, igual que en una cuenta personal, la siguiente subida se rechaza en cuanto el equipo está en su cuota. Todo lo demás sigue funcionando: renombrar, mover y eliminar archivos y crear carpetas nunca se bloquean, porque son el camino de regreso.

Nunca se elimina nada automáticamente. Un equipo que queda por encima de su cuota —por cancelar un complemento o por pasarse a un plan más chico— conserva sus archivos y simplemente no puede agregar más hasta que libere espacio o compre más.

La pantalla de espacio muestra lo que usa el equipo contra lo que le da su plan, cada cifra en su propio tamaño —"500 MB de 2 GB"—, avisa desde el 80% y dice con claridad cuándo el equipo se quedó sin espacio. La tarjeta de espacio en disco de la pantalla de complementos del equipo dice lo mismo al llegar al límite, y nombra las dos salidas: liberar algo, o comprar más capacidad. Los archivos se liberan desde /team/media.

Qué no muestra la pantalla de espacio

Muestra el total y la cuota, y nada más.

• Sin desglose por área. La pantalla de espacio personal lista cuánto ocupa cada parte del producto. Ese conteo está construido por persona y no existe un equivalente por equipo; la pantalla del equipo responde la pregunta que hace la cuota —qué tan llena está— en vez de adivinar la parte que a cada equipo le toca de cada tabla.
• Sin botón de limpiar historial. La pantalla personal lo ofrece porque una persona acumula un historial de accesos y actividad que es suyo y puede borrar. La bitácora de actividad de un equipo es un rastro de auditoría de lo que hicieron sus miembros, no un registro del que el equipo sea dueño y pueda tirar, así que ese botón no tendría qué limpiar.

El logo es un archivo de la biblioteca

El logo se define en /team/settings, con el mismo cargador de archivos que el resto del producto usa para las imágenes: suelta un archivo encima o haz clic para elegir uno, y te muestra el logo que el equipo está usando. Los mismos formatos de siempre, el mismo límite de 5 MB. No hay botón de guardar: cada cambio se aplica en cuanto lo haces y se confirma una sola vez.

• Reemplázalo subiendo otro. El que tenía se elimina, no se conserva.
• Usa una imagen que ya está en la biblioteca escribiendo su ID en Agregar ID de archivo directamente.... Solo se aceptan imágenes de la biblioteca del propio equipo, y el logo anterior se queda en la biblioteca. Escribir un ID requiere el permiso manage media; sin él, igual puedes subir un logo nuevo.
• Quitar de este registro le quita el logo al equipo pero conserva el archivo en la biblioteca, que sigue contando contra la cuota.
• Eliminar de la biblioteca multimedia borra el archivo de verdad, y el espacio que ocupaba vuelve al equipo.
• Después de cualquiera de los dos últimos, el equipo muestra otra vez el avatar generado a partir de su nombre, igual que un equipo que nunca tuvo logo.
• Está en el nivel superior de /team/media y cuenta contra la cuota del equipo, como cualquier otro archivo. Un logo que dejaría al equipo por encima de su cuota se rechaza.

Los logos guardados antes de que existiera la biblioteca se movieron a ella, así que un equipo que tenía uno puede ver crecer su uso sin que nadie haya subido nada: un logo ocupa espacio, así que cuenta. No se perdió nada: los archivos se copiaron, no se movieron. Un equipo cuyo archivo de logo ya no estaba en el disco muestra el avatar generado, y puede subir uno nuevo cuando quiera.

Si un logo que sigue en el disco no se pudo mover, las migraciones se detienen en vez de terminar, nombran los equipos a los que pertenece y conservan la columna del logo anterior para que nada se pierda. Vuelve a correr las migraciones para reintentar; la columna se elimina una vez que se movieron todos esos logos.

Los equipos que ya existían

Cada equipo tiene su carpeta desde que se crea. A los equipos que ya existían se les dio la suya, y a su rol de propietario se le dio manage media, al correr las migraciones que vinieron con esto: no hay nada que hacer a mano.

Dónde quedan los archivos

Quedan en el disco de medios bajo teams/{team_id}/, junto a las carpetas users/{user_id}/ de las bibliotecas personales. Cuál es ese disco, y cómo apuntarlo a S3 o dejarlo local, es Archivos, imágenes y almacenamiento en el sitio de la base.