Skip to main content

Organizaciones

Las organizaciones definen el alcance principal de trabajo en Pehuen. Cada sesión opera sobre una organización activa y, a partir de esa selección, el sistema determina qué datos, roles y módulos tenantizados podés usar.

Qué cambió en este flujo

  • La gestión de organizaciones ahora tiene una pantalla propia fuera del prefijo /admin.
  • Los usuarios Super Admin pueden crear organizaciones y administrar sus miembros desde una vista dedicada.
  • La selección de organización activa se resuelve desde el selector del encabezado y se aplica sin botón de confirmación adicional.
  • Al cambiar de organización, Pehuen intenta mantenerte en una ubicación equivalente cuando eso es seguro; si no, te lleva al inicio de la organización elegida.

Alcance y permisos

  • Solo los usuarios Super Admin pueden abrir el listado global de organizaciones, crear nuevas y administrar memberships.
  • Los usuarios regulares solo pueden trabajar dentro de las organizaciones que ya tengan asignadas.
  • Los roles regulares se aplican por organización. Una misma persona puede tener permisos distintos según la organización activa.

Flujo de uso

1. Entrar al sistema

  • Si tenés una sola organización asignada, queda activa automáticamente al iniciar sesión.
  • Si tenés varias, primero elegís con cuál trabajar.
  • Si no tenés ninguna, la sesión se crea igual pero no podés entrar a módulos operativos hasta recibir una asignación.

2. Cambiar la organización activa

  • Usá el selector Organización activa del encabezado.
  • El cambio se confirma al seleccionar una opción; no hay botón extra.
  • Si estabas en una pantalla tenantizada con formato /organizations/:organization_id/..., el sistema intenta abrir la misma sección en la nueva organización cuando la URL es compatible.
  • Si estabas en una pantalla general o la ruta no se puede reutilizar de forma segura, Pehuen redirige a una ubicación válida para la organización seleccionada.

3. Crear una organización

Ruta: Organizaciones > Nueva organización.

  • Campo obligatorio: Nombre.
  • El nombre debe ser único dentro de toda la plataforma.
  • Al guardar, la organización queda creada y el usuario que la creó se asigna automáticamente como miembro.
  • Después del alta, Pehuen abre la pantalla de detalle y gestión de miembros de esa organización.

Gestión de miembros

Ver una organización

Desde Organizaciones podés revisar:

  • nombre de cada organización,
  • cantidad de miembros asignados,
  • acceso al detalle con el botón Ver.

Agregar usuarios a una organización

Dentro del detalle de la organización:

  • el campo Agregar usuario busca por nombre o email en toda la plataforma,
  • solo aparecen usuarios que todavía no pertenezcan a esa organización,
  • al confirmar, el sistema muestra el mensaje Usuario agregado exitosamente,
  • además se genera una notificación para la persona incorporada.

Buscar miembros ya asignados

  • El listado del detalle permite filtrar por nombre o email.
  • Si no hay coincidencias, se informa que no hay miembros que coincidan con la búsqueda.
  • Cada fila incluye el acceso Gestionar, que abre la pantalla del usuario para administrar sus organizaciones asignadas.

Quitar organizaciones a un usuario

La baja de memberships se gestiona desde la vista de organizaciones del usuario, no desde el listado principal de la organización.

Restricciones importantes:

  • no se puede quitar la única organización que conserva un usuario,
  • no se puede quitar la organización que está activa en la sesión actual,
  • al remover una organización, también se limpian los roles no globales de esa organización y la sesión deja de tenerla como activa,
  • además se genera una notificación para la persona afectada.

Impacto sobre el resto del sistema

  • Los módulos operativos usan la organización activa como scope de datos.
  • Cambiar de organización cambia también los usuarios visibles, los roles efectivos y el resto de los registros tenantizados.
  • Los usuarios Super Admin pueden cambiar a organizaciones aunque no tengan un membership explícito cargado.