Qué es Weblabor Teams

Qué agregan los equipos a Weblabor Base, qué cambian y dónde está documentado el resto.

Weblabor Teams es Weblabor Base con el equipo en el centro de tu producto: varias personas comparten una cuenta, un plan y una factura, y el equipo decide quién entra. Lee esto primero para saber qué agregan los equipos, qué cambian y qué guía cubre cada parte.

De dónde parte

Todo lo que trae Weblabor Base está aquí, sin cambios: cuentas e inicio de sesión, el área de cuenta, el panel de administración, roles y permisos, planes y complementos, notificaciones, notificaciones del navegador y el sitio instalable, dos idiomas, zonas horarias, detección del país, el sitio público y este centro de ayuda. Nada de eso se explica otra vez aquí: la base tiene su propio sitio en base.wbor.dev, y su centro de ayuda en base.wbor.dev/help cubre la parte compartida.

Qué agregan los equipos

Equipos. Cada equipo tiene un nombre, una descripción, un logo, campos extra propios y un propietario. Una persona crea tantos equipos como quiera y pertenece a tantos como la agreguen, salvo que tu producto apague el selector de equipos: entonces cada persona entra directo a un solo equipo. Ve Equipos y el selector de equipos.
Un espacio de trabajo por equipo. Después de iniciar sesión la persona vuelve al equipo en el que trabajó por última vez, o elige uno la primera vez, y cada pantalla del equipo funciona dentro de él: su dashboard, su configuración, sus miembros, sus roles, su plan. Cambiar de equipo cambia todo eso.
Miembros e invitaciones. A alguien se le agrega por correo, teléfono o nombre de usuario. Una cuenta que ya existe entra de inmediato; una nueva recibe una invitación para registrarse, o se le crea la cuenta al momento, según cómo funcione tu producto. Ve Miembros e invitaciones.
Roles por equipo. Cada equipo tiene sus propios roles: un rol de propietario que puede hacer todo, y un rol inicial para los miembros nuevos. El equipo escribe más roles desde su propia pantalla. Ve Roles y permisos del equipo.
Cobros por equipo. El plan, los complementos, la tarjeta, las facturas y los límites de uso son del equipo. Ve Planes y cobros del equipo.
Archivos y espacio por equipo. Una biblioteca de archivos compartida en la que trabaja el equipo, y una cuota de espacio que se define en el plan del equipo y que se puede vender en tamaños más grandes. El logo del equipo también vive ahí. Ve Archivos y espacio del equipo.
Los datos de un equipo, movidos entre entornos. Desde su configuración un equipo empaca todo lo que tiene en un archivo y lo carga en un equipo en otro lugar, archivos incluidos. Ve Mueve los datos de un equipo entre entornos.
Soporte desde el equipo. Cuando los tickets de soporte están encendidos, Tickets vive en el menú del equipo, cada ticket pertenece al equipo en el que la persona está trabajando y su plazo de respuesta sigue el plan de ese equipo; cuando el chat en vivo está encendido, Chat está a su lado y si puedes chatear también depende del plan de ese equipo. Ve Pedir soporte desde un equipo.
Equipos en el panel de administración. Dos pantallas, equipos y membresías, con los cobros de cada equipo. Ve Equipos en el panel de administración.

Qué cambia respecto a Weblabor Base

Algunas cosas significan algo distinto una vez que existe el equipo. Tenlas en cuenta al leer una guía de la base.

En Weblabor Base	En Weblabor Teams
Después de iniciar sesión la persona llega a su propio dashboard.	Después de iniciar sesión la persona llega al dashboard del equipo en el que trabajó por última vez, o elige un equipo la primera vez.
Los roles son los mismos para todo el producto.	El panel de administración conserva sus roles, y cada equipo escribe roles propios.
La suscripción es de la persona, y se administra desde su cuenta.	La suscripción es del equipo, y se administra desde las pantallas de planes, complementos, facturación y métodos de pago del equipo.
Las categorías las comparten todos.	Una categoría puede pertenecer a un equipo: dentro de un equipo sólo se ofrecen las categorías de ese equipo, y fuera de cualquier equipo sólo las que no pertenecen a ninguno.
La biblioteca de archivos y la cuota de espacio son de la persona.	Son de la persona y del equipo: cada persona conserva una biblioteca personal, y cada equipo tiene una compartida, cada una con su propia cuota.
Un registro nuevo crea una cuenta.	Un registro nuevo además entra a cada equipo que invitó a ese correo.

El área de cuenta, el perfil, las sesiones, las notificaciones y el idioma siguen siendo personales: acompañan a la persona a cada equipo.

Para qué sirve

Un producto que se vende a empresas, agencias, clínicas, escuelas, estudios: cualquier caso donde varias personas comparten una cuenta y una factura, y una de ellas decide quién entra. Un producto donde la misma persona trabaja para más de un cliente. Un producto cuyo panel de administración necesita ver a cada cliente y lo que paga.

Para qué no está hecho

Un producto con una cuenta por persona y nada compartido, donde la base sola es el camino más corto. Un producto donde cada cliente necesita su propia base de datos: los equipos separan a los clientes dentro de una sola base de datos compartida.

A dónde seguir

Equipos y el selector de equipos para lo que la persona ve primero.
Miembros e invitaciones para traer gente.
Roles y permisos del equipo para decidir qué puede hacer cada quien.

Para desarrolladores

Clonas el kit, construyes encima y le mezclas la base mientras el proyecto viva. Las carpetas propias de la base se quedan en el repositorio, docs/weblabor-base/ y resources/views/landing/weblabor-base/, intactas y sin usarse. Todo lo de equipos vive en docs/weblabor-teams/ y resources/views/landing/weblabor-teams/, así que una mezcla desde la base nunca choca con ello.
Los equipos son el modelo Team. Todo bajo /team corre dentro del equipo seleccionado. /app es el área personal: manda directo a /team a una persona con equipo actual, y /app?redirect=false muestra la lista de equipos (el botón Cambiar de equipo de la barra lateral del equipo, que se muestra mientras app.enable_multi_teams está encendido).
Las cuentas nuevas se invitan o se crean al momento según una clave de configuración; ve Miembros e invitaciones.
Los roles del equipo corren sobre el modo de equipos de Spatie Permission, con un rol de propietario que tiene todos los permisos del equipo. Hay dos guards de permisos: web para el panel de administración y el selector, team para todo lo que está dentro de un equipo; la misma clase de política elige el correcto.
Los cobros por equipo llegan con el adaptador de packages/billing-team. Las pantallas de cobro del equipo son /team/plans, /team/add-ons, /team/billing y /team/payment-methods, donde la base usa /account/plans.
La biblioteca personal es /app/media y la del equipo /team/media.
Mover los datos de un equipo empaca un zip. Lo que viaja se lee de las relaciones que declara tu propio modelo Team, así que las tablas que agregues viajan sin tocar el exportador.
Los equipos aíslan por una columna team_id y un contexto de permisos, no por conexión.
Antes de escribir código: Pon a andar el proyecto en el sitio de la base, que aplica tal cual; Configura los equipos para las claves que agregan los equipos; y El contexto del equipo y Construye un CRUD con alcance de equipo antes de escribir tu primera pantalla dentro de un equipo.