Qué es Weblabor Teams

Qué agrega la capa de equipos a Weblabor Base, qué cambia y dónde está documentado el resto.

Weblabor Teams es Weblabor Base con el equipo como la unidad de tu producto. Lo clonas, construyes encima y le mezclas la base mientras el proyecto viva. Lee esto primero para saber qué agrega la capa de equipos, qué cambia en la base y qué guía cubre cada parte.

Sobre qué está construido

Todo lo que trae Weblabor Base está en este kit, sin cambios: cuentas e inicio de sesión, el área de cuenta, el panel de administración, roles y permisos, planes y complementos en Stripe, notificaciones, web push y la PWA, dos idiomas, zonas horarias, detección de país, el sitio público y este centro de ayuda. Nada de eso se documenta otra vez aquí. La base tiene su propio sitio en base.wbor.dev, y su centro de ayuda en base.wbor.dev/help es donde instalas, configuras, despliegas y extiendes la parte compartida.

Las carpetas propias de la base se quedan en el repositorio, docs/weblabor-base/ y resources/views/landing/weblabor-base/, intactas y sin uso. 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.

Qué agrega la capa de equipos

Equipos. Un modelo Team con nombre, descripción, logo, campos extra tuyos y un propietario. Una persona crea tantos equipos como quiera y pertenece a tantos como la agreguen. Ve Equipos y el selector de equipos.
Un espacio de trabajo por equipo. Después de iniciar sesión la persona elige un equipo y cada pantalla bajo /team corre dentro de él: su tablero, su configuración, sus miembros, sus roles, su plan. Cambiar de equipo cambia todo eso.
Miembros e invitaciones. Alguien se agrega por correo, teléfono o nombre de usuario. Una cuenta existente entra de inmediato; una nueva recibe una invitación para registrarse, o su cuenta se crea al momento, según una clave de configuración. Ve Miembros e invitaciones.
Roles por equipo. Cada equipo tiene sus propios roles sobre el modo de equipos de Spatie Permission, un rol de propietario con todos los permisos del equipo y un rol predeterminado 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 pertenecen al equipo, a través de un adaptador de cobros que viene en el kit como packages/billing-team. Ve Planes y cobros del equipo.
Archivos y almacenamiento por equipo. Una sola biblioteca de archivos compartida en la que trabaja el equipo, y una cuota de espacio que defines en el plan del equipo y de la que puedes vender más. El logo del equipo también vive ahí. Ve Archivos y espacio del equipo.
Los datos de un equipo, movidos entre ambientes. Desde su configuración un equipo empaca todo lo que le pertenece en un zip y lo carga en un equipo de otro entorno, con archivos incluidos. Lo que viaja se lee de las relaciones que declara tu propio modelo Team, así que las tablas que agregues vienen junto sin tocar el exportador. Ve Mueve los datos de un equipo entre entornos.
Equipos en el panel de administración. Dos recursos, equipos y membresías, con el panel de cobros de cada equipo. Ve Equipos en el panel de administración.

Qué cambia en la base

La base se mezcla, no se reescribe, pero algunas cosas significan algo distinto una vez que existe el equipo. Tenlas en mente cuando leas una guía de la base.

En Weblabor Base	En Weblabor Teams
Después de iniciar sesión la persona llega a su propio tablero.	Después de iniciar sesión la persona llega a `/app`, el selector de equipos, y después al tablero del equipo en `/team`.
Un solo guard de permisos, `web`.	Dos: `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 roles son globales.	Roles globales para el panel de administración, más roles acotados a cada equipo.
La suscripción pertenece al usuario y se administra desde `/account/plans`.	La suscripción pertenece al equipo y se administra desde `/team/plans`, `/team/add-ons`, `/team/billing` y `/team/payment-methods`.
Las categorías son globales.	Las categorías pertenecen al equipo que las creó.
La biblioteca de archivos y la cuota de espacio pertenecen a la persona.	Pertenecen a la persona y al equipo: `/app/media` es la personal, `/team/media` es la compartida del equipo, cada una con su propia cuota.
Un registro nuevo crea una cuenta.	Un registro nuevo también entra a cada equipo que invitó a ese correo.

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

Para qué sirve el kit

Un producto que se vende a empresas, agencias, clínicas, escuelas, estudios: cualquier cosa 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 que necesita el panel de administración de la base para ver a cada cliente y lo que cada uno paga.

Para qué no

Un producto con una cuenta por persona y nada compartido, donde la base sola es el camino más corto. Un producto donde el tenant necesita su propia base de datos: Weblabor Teams aísla por una columna team_id y un contexto de permisos, no por conexión.

A dónde ir después

Ponlo a correr en el sitio de la base, que aplica tal cual. Después Configura los equipos para las claves que agrega la capa de equipos.
Equipos y el selector de equipos para lo que la persona ve primero.
El contexto del equipo y Construye un CRUD acotado al equipo antes de escribir tu primera pantalla dentro de un equipo.