Saltar a contenido

Organizaciones

Descripción

Las organizaciones representan empresas o entidades que contratan, prueban o utilizan el software E-Training. Cada organización agrupa usuarios, roles y un contacto principal. Un usuario pertenece a una única organización. Ver 07-usuarios.md.

Tipos de organización

Tipo Descripción
COMMON Organización estándar. Mismas capacidades que SUPER_ADMIN pero solo gestiona su propia organización.
SUPER_ADMIN Super administradora. Puede administrar otras organizaciones (crear/actualizar usuarios, cambiar propiedades, etc.) además de gestionar la suya propia.

Reglas:

  • Toda organización nueva se crea como COMMON.
  • Solo una organización SUPER_ADMIN puede convertir a otra organización en SUPER_ADMIN.
  • Una organización COMMON no puede cambiar su propio tipo.

⚠️ Estado de implementación: el cambio de tipo de organización (COMMON↔SUPER_ADMIN) no está implementado. La actualización de organización sólo permite modificar el nombre y el estado activo. Pendiente de resolución.

Slug (identificador fiscal)

El slug es el identificador único de la organización y actúa como número fiscal o identificador que representa a la empresa fiscalmente.

Reglas:

  • Obligatorio y único en el sistema.
  • Debe aceptar formatos válidos según el país:
  • Argentina: CUIT
  • Brasil: CNPJ
  • Chile: RUT
  • EEUU: EIN
  • Uruguay: RUT

⚠️ Estado de implementación: la validación fiscal del slug por país (CUIT/CNPJ/RUT/EIN) no está implementada. Hoy sólo se valida un formato genérico: minúsculas alfanuméricas separadas por guiones. Pendiente de resolución.

Contacto principal

Cada organización tiene un contacto principal, normalmente la persona que crea la organización.

Reglas:

  • Una organización no puede existir sin contacto principal.
  • El contacto principal debe ser un usuario perteneciente a esa misma organización.
  • Una organización SUPER_ADMIN puede cambiar el contacto principal por otro usuario de esa misma organización.

⚠️ Estado de implementación: el concepto de contacto principal no existe en el modelo de organización. No hay campo ni gestión de contacto principal. Pendiente de resolución.

Usuarios y roles

  • Las organizaciones poseen usuarios. Ver 07-usuarios.md.
  • Las organizaciones poseen roles por organización. Ver 03-roles.md y 02-permisos.md.
  • Al crearse, la organización dispone siempre de un rol administrador con todos los permisos disponibles (excepto ORGANIZATION, que solo aplica a organizaciones SUPER_ADMIN); este rol no puede eliminarse.
  • La organización debe tener como mínimo un usuario.

Invitaciones

Las organizaciones pueden invitar usuarios a unirse. Ver 09-invitaciones.md.

Estado (activo/inactivo)

Las organizaciones tienen un estado que indica si están activas o inactivas.

Reglas:

  • Por defecto, las organizaciones se crean activas.
  • Solo una organización SUPER_ADMIN puede cambiar el estado de otra organización (por ejemplo, desactivarla).
  • Una organización COMMON no puede cambiar su propio estado ni el de otras organizaciones.

Condiciones de negocio (resumen)

  • Un usuario pertenece a una única organización.
  • Los roles son por organización.
  • Una organización sin contacto principal no es válida.
  • El slug es único y debe cumplir formatos fiscales admitidos (CUIT, CNPJ, RUT, EIN).
  • Solo organizaciones SUPER_ADMIN pueden administrar otras organizaciones o cambiar tipos/estados.