Un tenant es un entorno aislado en el que viven tus datos. Cada instancia que creas — cada cliente, factura, ticket, o lo que tus modelos describan — pertenece a exactamente un tenant. Los tenants te dan mundos separados: datos de producción, una copia para pruebas, un cajón de sastre personal, un espacio dedicado para un cliente — cada uno independiente.

Por qué existen los tenants

La parte de metadatos de Yellow (schemas, modelos, propiedades) está pensada para ser compartida y reutilizada. La parte de datos, en cambio, debe mantenerse separada. Los tenants son la frontera:

  • Aislamiento — las instancias de un tenant son invisibles desde otro. Dos tenants pueden tener el mismo schema con filas completamente distintas.
  • Entornos — mantén un tenant de "producción" junto a uno de "staging" o "desarrollo" que reproduce la estructura pero contiene datos desechables.
  • Espacios por cliente — para productos que sirven a múltiples clientes, cada cliente puede tener su propio tenant bajo la misma organización.
  • Borrador personal — cada usuario puede tener su tenant privado para experimentar.

Propiedad

Cada tenant es propiedad de un usuario o de una organización:

  • Tenant de usuario — creado desde el menú de usuario → Nuevo Tenant. Solo ese usuario puede acceder. Útil para proyectos personales, experimentos o aprendizaje.
  • Tenant de organización — creado desde la página Tenants de la organización. Cualquier miembro propietario de la organización puede gestionarlo, y los miembros de la organización pueden acceder a través de sus roles.

El tipo de propiedad se decide al crearlo y no cambia. Puedes tener muchos de cada tipo a la vez.

Qué contiene un tenant

Dentro de un tenant encontrarás:

  • Instancias — las filas de datos reales para todos los modelos definidos por los schemas.
  • Ficheros adjuntos a instancias — contratos, exportaciones, imágenes, cualquier cosa que subas junto a una fila.
  • Configuración dentro del tenant — marcadores, widgets del dashboard, actividad reciente y otras preferencias de usuario se guardan por tenant, de modo que cada entorno mantiene su propio contexto.

Los schemas y modelos en sí no se guardan dentro del tenant — viven un nivel por encima y pueden reutilizarse entre tenants. Por eso puedes promover un schema de un entorno de pruebas a producción: la estructura viaja con el schema, solo los datos quedan ligados al tenant.

Cambiar de tenant

Cuando inicias sesión, Yellow te ofrece los tenants a los que tienes acceso. El que tienes activo en ese momento se muestra:

  • En el título de la ventana en escritorio (por ejemplo, Yellow · Acme Producción).
  • En el menú de usuario, donde puedes elegir Cambiar a este tenant para saltar a otro.
  • Como tu tenant por defecto en la configuración de usuario — el que Yellow abrirá automáticamente la próxima vez.

Cambiar de tenant es una reautenticación: tu token de sesión se vincula al nuevo tenant y todas las llamadas gRPC posteriores solo devuelven datos de ese tenant.

Recursos entre tenants

Algunas cosas cruzan deliberadamente la frontera de los tenants. Están controladas por administradores y se gestionan con capabilities específicas:

  • Ficheros entre tenants — ficheros a nivel de sistema (por ejemplo, los artículos de ayuda que estás leyendo ahora mismo) compartidos por todos los tenants.
  • Asistentes de sincronización de schemas y tenants — operaciones disponibles desde la pantalla de la organización que copian schemas, o datos de instancias con una fecha límite opcional, de un tenant origen a un tenant destino. Son útiles para promover cambios de un entorno de staging a producción.

Sin estas operaciones explícitas, el muro entre tenants es completo.

Gestión de tenants

Desde la pantalla organización → Tenants puedes:

  • Crear un nuevo tenant bajo la organización.
  • Renombrar un tenant haciendo clic en su nombre.
  • Borrar un tenant (borrado lógico; se requiere confirmación).
  • Sincronizar schemas o datos hacia otro tenant.

Para los tenants de usuario, las mismas opciones están en el menú de usuario.

Relacionados

  • Schemas — la unidad estructural que se reutiliza entre tenants.
  • Instancias — los datos reales dentro de un tenant.