Administración de la plataforma — Usuarios¶
Disponible solo para: Platform Admin
Los Platform Admins pueden ver y administrar usuarios en todos los inquilinos desde una interfaz global única. Esto es distinto de la gestión de usuarios a nivel inquilino, responsabilidad del Owner de cada empresa para sus propios usuarios.
API de usuarios del inquilino¶
La gestión de usuarios está acotada a un inquilino específico — los Platform Admins acceden a usuarios especificando primero el inquilino:
| Method | Endpoint | Description |
|---|---|---|
GET |
/platform/tenants/{id}/users/ |
Listar usuarios de un inquilino (paginado, 25/100) |
GET |
/platform/tenants/{id}/users/{user_id}/ |
Detalle de usuario |
PATCH |
/platform/tenants/{id}/users/{user_id}/ |
Actualizar role y/o status |
DELETE |
/platform/tenants/{id}/users/{user_id}/ |
Eliminar usuario de forma lógica |
Parámetros de consulta admitidos para el listado:
?search=— filtra por correo, nombre o apellido (sin distinguir mayúsculas)?page=/?page_size=— paginación (predeterminado 25, máximo 100)
Esta vista es para supervisión operativa y soporte. La gestión cotidiana de usuarios (invitaciones, incorporación) la maneja el Owner del inquilino dentro de su inquilino.
Gestión de roles¶
Los Platform Admins pueden cambiar el rol de un usuario desde la vista global:
- Abra el registro del usuario.
- Seleccione el nuevo rol en el menú desplegable.
- Guarde el cambio.
Los cambios de rol aplican en la siguiente solicitud a la API (el JWT se vuelve a validar). El cambio queda en el ActivityLog bajo role_change.
Cambiar el rol de un usuario puede reducir su acceso de inmediato. Por ejemplo, bajar un Owner a Project Manager elimina la capacidad de aprobar Bids y administrar usuarios. Confirme la intención antes de guardar.
Inicio de eliminación lógica¶
Solo Platform Admin puede iniciar eliminación lógica en un registro de usuario.
Los Owners de inquilino pueden desactivar usuarios (impedir inicio de sesión), pero no pueden eliminar de forma lógica el registro de usuario. Solo Platform Admin puede hacerlo.
Cuando un usuario se elimina de forma lógica:
- El registro recibe marca
deleted_at. - El registro ya no aparece en ninguna interfaz ni respuesta de API del inquilino.
- La cuenta Auth0 del usuario se bloquea.
- Todos los registros históricos (entradas del ActivityLog, asignaciones, actualizaciones firmadas) se conservan — siguen referenciando el ID del usuario en la base de datos.
- La acción queda en el ActivityLog bajo
admin_action.
Eliminar un usuario de forma lógica no es reversible por la interfaz. La recuperación requiere intervención directa en base de datos por un Platform Admin.
Diferencia respecto a la gestión de usuarios del inquilino¶
| Capacidad | Owner de inquilino | Platform Admin |
|---|---|---|
| Invitar nuevos usuarios | Sí (solo su inquilino) | No — los Owners manejan invitaciones |
| Desactivar usuarios | Sí (solo su inquilino) | Sí (cualquier inquilino) |
| Cambiar roles | Sí (solo su inquilino) | Sí (cualquier inquilino) |
| Eliminar registros de usuario de forma lógica | No | Sí (cualquier inquilino) |
| Ver usuarios en todos los inquilinos | No | Sí |
| Acceder a datos de usuarios de otros inquilinos | No — nunca | Sí (solo soporte/supervisión) |
Los Platform Admins no deben realizar tareas rutinarias de usuarios en nombre de inquilinos. Si un Owner necesita ayuda, guíelo en el proceso en lugar de actuar directamente en su inquilino.