Skip to content

Ciclo de vida de la propiedad de una empresa ​

Esta página documenta qué pasa exactamente cuando alguien se registra, quién queda como dueño de qué empresa, la diferencia entre la "empresa por defecto" y una empresa creada por su propio owner, y quién puede borrar una empresa. Es lógica de negocio que hoy solo vive repartida en UsersService, CompaniesService y CompanyEntity — esta página la centraliza.

→ Para cómo se aísla cada empresa como tenant (JWT, X-Company-Id, assertOwnership()), ver Multi-tenancy. Para quién puede asignar qué rol, ver Roles y permisos.

CompanyEntity.ownerId — qué es y qué no es ​

Cada empresa tiene un campo ownerId (columna owner_id, select: false — nunca se devuelve en las respuestas HTTP de /companies, igual que UserEntity.password):

  • Se rellena con el userId del usuario que creó la empresa (POST /companies o el registro con companyName, ver abajo). Puede ser null (empresas creadas sin un usuario asociado, p. ej. el script de seed o datos de sistema).
  • No es lo mismo que ser OWNER en la tabla user_companies. ownerId es un puntero fijo a quien creó la fila companies; el rol owner en user_companies es una membresía que se puede añadir o quitar (ver Roles y permisos). En la práctica ambos coinciden al crear la empresa — el creador se guarda como ownerId y se le da de alta como miembro con rol owner en la misma operación — pero solo ownerId sobrevive si esa membresía se elimina después.
  • Hoy ownerId solo se usa para una cosa: GET /companies acota el listado a "las empresas que posee" cuando quien pregunta es un OWNER (ver Empresas → Listar, ver y actualizar). No se usa para autorización — el borrado y la edición de una empresa comprueban membresía (assertOwnership()) y rol (@Roles(...)), no ownerId.

Registro → owner: las dos rutas de POST /users ​

POST /users es pública (paso de registro) y siempre devuelve un access_token. El campo opcional companyName decide cuál de las dos rutas se ejecuta — ver UsersService.create() / UsersService.createWithOwnCompany():

Sin companyNameCon companyName
EmpresaSe une a la empresa por defecto, si existeCrea una empresa nueva
Rol asignadomemberowner
¿Atómico?Usuario y membresía en pasos separadosUsuario + empresa + membresía en una sola transacción (DataSource.transaction)
ownerId de la empresaNo aplica (empresa preexistente)El userId del usuario recién creado
JWT devueltocompanyId/role de la empresa por defecto (o sin empresa, si no hay ninguna marcada como por defecto)companyId/role: owner de la empresa recién creada

Ninguna de las dos rutas depende de si el sistema está en modo multi_company — un usuario recién creado nunca tiene membresías previas, así que la restricción de "un usuario ya pertenece a una empresa" (ver Multi-tenancy → Modo empresa única) nunca se dispara en el registro en sí.

→ Ver Usuarios → Registro como owner de una empresa nueva para el contrato completo del endpoint (payload, respuesta, generación del slug).

Empresa por defecto vs. empresa creada por su owner ​

Estos son dos conceptos distintos y no automáticos entre sí:

Empresa por defecto (CompanyEntity.isDefault) ​

  • Es un flag booleano (is_default), false por defecto en toda empresa nueva — incluida la que crea el script de seed (src/database/seed.ts). Ninguna ruta del código pone isDefault en true automáticamente. Marcar una empresa como "la empresa por defecto" es una decisión manual de operación (PATCH /companies/:id { "isDefault": true }, o directamente en base de datos).
  • Efecto: cuando un usuario se registra sin companyName (UsersService.assignDefaultCompanyIfNeeded()), el sistema busca la empresa con isDefault = true y isActive = true (CompanyRepository.findDefault()) y lo une a ella como member. Si el usuario ya tiene alguna membresía (poco común en un registro nuevo, pero cubierto por el mismo método) o si no existe ninguna empresa marcada como isDefault, no pasa nada — el método retorna sin error y el usuario queda registrado sin ninguna empresa.

Sin empresa por defecto configurada, el registro simple deja al usuario "huérfano"

Si nadie marcó ninguna empresa como isDefault = true, un POST /users sin companyName crea la cuenta pero no la vincula a ninguna empresa. El usuario podrá iniciar sesión pero no verá datos de ninguna empresa hasta que alguien lo añada manualmente (POST /companies/:id/users) o acepte una invitación. Esto es intencional (no hay una empresa "genérica" implícita) pero es fácil de confundir con un bug en un entorno recién desplegado sin seed de datos.

Empresa creada por su propio owner (companyName en el registro, u OWNER/ADMIN vía POST /companies) ​

  • Nace sin isDefault (queda en false) — es una empresa normal, no candidata a recibir automáticamente a otros usuarios que se registren sin companyName.
  • Su creador queda registrado en CompanyEntity.ownerId y como miembro owner — ver la sección anterior.
  • Un OWNER puede acabar siendo dueño de varias empresas de este tipo (crear una segunda empresa con POST /companies mientras ya pertenece a otra requiere multi_company = true, ver Multi-tenancy). GET /companies para un OWNER devuelve todas las que posee, no solo la seleccionada como tenant actual — ver Empresas → Listar, ver y actualizar.

En resumen: "por defecto" es sobre cómo entran los nuevos usuarios sin companyName; "creada por su owner" es sobre quién queda registrado como dueño de una empresa nueva. Una misma empresa podría, en teoría, ser ambas cosas a la vez (alguien marca como isDefault una empresa que un owner creó para sí mismo), pero no hay ninguna relación automática entre los dos conceptos.

Quién puede borrar una empresa ​

DELETE /companies/:id

Reglas, de CompaniesController (@Roles(CompanyRole.OWNER)) + CompaniesService.remove() (assertOwnership()):

  1. Solo el rol owner puede borrar — ni admin ni ningún otro rol, aunque admin sí puede crear y editar empresas (PATCH). No existe una jerarquía de "admin puede borrar si no hay owner" ni similar: el guard de ruta exige owner literalmente.
  2. El caller debe tener una membresía UserCompany activa en la empresa que intenta borrar. La selección de empresa (JWT o X-Company-Id) no concede acceso por sí sola; se aplica el rol actual de esa membresía. Un owner de la empresa A no puede borrar la empresa B aunque ambas tengan el mismo rol asignado.
  3. El rol Super Admin de plataforma no omite la membresía ni el ownership. Un Super Admin puede borrar una empresa solo si también tiene allí una membresía activa con el rol OWNER; su permiso global se reserva para operaciones y catálogos explícitamente de plataforma.
  4. El borrado es un DELETE real de la fila companies (TypeORM .remove()), no un soft-delete (isActive = false es un campo distinto, gestionado por PATCH). Las membresías (user_companies) asociadas se eliminan en cascada a nivel de base de datos (onDelete: 'CASCADE' en UserCompanyEntity).
  5. Borrar una empresa no transfiere ni reasigna su ownerId a nadie — simplemente deja de existir, junto con sus membresías. No hay ningún flujo de "transferir propiedad" antes o durante el borrado.

No existe ningún mecanismo para impedir que la última empresa de un owner sea borrada, ni para impedir que se borre la empresa marcada como isDefault — si eso ocurre, el próximo registro sin companyName simplemente no encontrará ninguna empresa por defecto (ver arriba) hasta que se marque otra.

Contexto activo y última empresa usada ​

La empresa activa de una sesión y la última empresa usada por una persona son conceptos distintos. Un Super Admin puede seleccionar una empresa para las peticiones del SDK mediante X-Company-Id solo si tiene allí una membresía UserCompany activa; se aplican los roles/grants de esa membresía. La selección temporal no crea una membresía ni cambia users.last_used_company_id.

Para un usuario humano, auth.selectCompany() actualiza users.last_used_company_id mediante PUT /users/me/last-used-company y solicita un refresh forzado para recibir un JWT cuyo companyId y rol correspondan a la nueva membresía. El PUT sigue requiriendo pertenencia; el refresh vuelve a resolver el contexto desde el backend. Si una renovación falla, el SDK solo afirma que revirtió el cambio cuando obtiene confirmación de que restauró la preferencia anterior. Como la API no ofrece una operación para guardar null, una preferencia previa nula no puede restaurarse; el SDK cierra la sesión con company_switch_partial_reauthenticate y requiere login.

Referencias cruzadas ​

  • Roles y permisos — jerarquía de quién puede asignar qué rol a quién.
  • Multi-tenancy — aislamiento de datos por empresa, modo empresa única vs. multi-empresa.
  • Usuarios — contrato completo de POST /users y el flag isSuperAdmin.
  • Empresas — contrato completo de POST/PATCH/DELETE /companies y gestión de miembros.