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
userIddel usuario que creó la empresa (POST /companieso el registro concompanyName, ver abajo). Puede sernull(empresas creadas sin un usuario asociado, p. ej. el script de seed o datos de sistema). - No es lo mismo que ser
OWNERen la tablauser_companies.ownerIdes un puntero fijo a quien creó la filacompanies; el rolownerenuser_companieses 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 comoownerIdy se le da de alta como miembro con rolowneren la misma operación — pero soloownerIdsobrevive si esa membresía se elimina después. - Hoy
ownerIdsolo se usa para una cosa:GET /companiesacota el listado a "las empresas que posee" cuando quien pregunta es unOWNER(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(...)), noownerId.
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 companyName | Con companyName | |
|---|---|---|
| Empresa | Se une a la empresa por defecto, si existe | Crea una empresa nueva |
| Rol asignado | member | owner |
| ¿Atómico? | Usuario y membresía en pasos separados | Usuario + empresa + membresía en una sola transacción (DataSource.transaction) |
ownerId de la empresa | No aplica (empresa preexistente) | El userId del usuario recién creado |
| JWT devuelto | companyId/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),falsepor defecto en toda empresa nueva — incluida la que crea el script de seed (src/database/seed.ts). Ninguna ruta del código poneisDefaultentrueautomá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 conisDefault = trueyisActive = true(CompanyRepository.findDefault()) y lo une a ella comomember. 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 comoisDefault, 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 enfalse) — es una empresa normal, no candidata a recibir automáticamente a otros usuarios que se registren sincompanyName. - Su creador queda registrado en
CompanyEntity.ownerIdy como miembroowner— ver la sección anterior. - Un
OWNERpuede acabar siendo dueño de varias empresas de este tipo (crear una segunda empresa conPOST /companiesmientras ya pertenece a otra requieremulti_company = true, ver Multi-tenancy).GET /companiespara unOWNERdevuelve 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/:idReglas, de CompaniesController (@Roles(CompanyRole.OWNER)) + CompaniesService.remove() (assertOwnership()):
- Solo el rol
ownerpuede borrar — niadminni ningún otro rol, aunqueadminsí 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 exigeownerliteralmente. - El caller debe tener una membresía
UserCompanyactiva en la empresa que intenta borrar. La selección de empresa (JWT oX-Company-Id) no concede acceso por sí sola; se aplica el rol actual de esa membresía. Unownerde la empresa A no puede borrar la empresa B aunque ambas tengan el mismo rol asignado. - 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.
- El borrado es un
DELETEreal de la filacompanies(TypeORM .remove()), no un soft-delete (isActive = falsees un campo distinto, gestionado porPATCH). Las membresías (user_companies) asociadas se eliminan en cascada a nivel de base de datos (onDelete: 'CASCADE'enUserCompanyEntity). - Borrar una empresa no transfiere ni reasigna su
ownerIda 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 /usersy el flagisSuperAdmin. - Empresas — contrato completo de
POST/PATCH/DELETE /companiesy gestión de miembros.