Skip to main content

​
Administracion

El modulo Admin proporciona endpoints para la gestion de usuarios a nivel de sistema: creacion, roles, operaciones en lote y estadisticas generales. Todos los endpoints requieren rol admin.

​
Roles de usuario

RolDescripcion
adminAcceso completo al sistema
moderatorAcceso intermedio
userAcceso basico

​
Estados de usuario

EstadoDescripcion
activeUsuario activo
inactiveUsuario desactivado

​
API Endpoints

MetodoEndpointDescripcion
POST/admin/usersCrear usuario
GET/admin/usersListar usuarios (paginado)
PATCH/admin/users/:id/roleCambiar rol de usuario
DELETE/admin/users/:idEliminar usuario
POST/admin/users/bulkOperaciones en lote
GET/admin/statsEstadisticas del sistema

​
Crear usuario

{
  "email": "user@vivla.com",
  "firstName": "Nombre",
  "lastName": "Apellido",
  "role": "user",
  "password": "optional-min-8-chars"
}

​
Operaciones en lote

{
  "userIds": ["uuid-1", "uuid-2"],
  "action": "activate"  // "delete" | "activate" | "deactivate"
}

​
Estadisticas

GET /admin/stats devuelve: 
{
  "totalUsers": 150,
  "activeUsers": 142,
  "totalTeams": 8,
  "totalModules": 12,
  "roleDistribution": {
    "admin": 5,
    "moderator": 15,
    "user": 130
  }
}

​
Paginacion

GET /admin/users acepta:
  • page (default: 1)
  • limit (default: 50)
Respuesta con paginacion: 
{
  "users": [...],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150,
    "totalPages": 3
  }
}

​
Estructura de modulo

apps/backend/src/admin/
  admin.module.ts
  admin.controller.ts
  admin.service.ts
  dto/
    create-user.dto.ts
    update-user-role.dto.ts
    bulk-users.dto.ts