Buscar en la documentación

Acciones de sistema

Reiniciar workers, reiniciar el tiempo real y limpiar la caché de datos desde la app, con permiso, código, límite de frecuencia y registro, sin acceso a Docker.

Módulo system1 min de lecturaVer en GitHub

Desde el panel de salud, el Super admin (system.actions.execute) puede ejecutar acciones dentro del alcance de la propia app. Ninguna toca Docker ni el servidor: usan las señales de Laravel y Docker vuelve a levantar lo que se cierra.

AcciónQué hace de verdad
Reiniciar workersqueue:restart: cada worker termina el job en curso y se cierra; Docker lo levanta de nuevo con el código actual
Reiniciar tiempo realEscribe la clave laravel:reverb:restart, la misma de artisan reverb:restart: Reverb la revisa cada pocos segundos y se cierra
Limpiar caché de datosSube la generación de la caché del dashboard. Los bloqueos, límites y sesiones no se tocan

Las mismas protecciones aplican al modo mantenimiento y a los jobs fallidos.

Diagrama4 carriles · 9 pasos · 3 salidas de error
SíNoSíNoSíNoPulsa la acción enla tarjeta1Pide su código comoconfirmación2Envía POST/system/actions/{acción}3¿Menos de 5acciones en elminuto?4Responde 429¿Tienesystem.actions.execute?5Responde 403¿Códigoválido?6Responde 422 o423Deja la señal osube la generación7Lo registra enadmin_actions8Ve el aviso y elpanel actualizado9
Los números coinciden con el paso a paso. En pantallas pequeñas el diagrama se desliza de lado.

Paso a paso

  1. Super adminPulsa la acción en la tarjeta
  2. NavegadorPide su código como confirmación

    El diálogo del código explica qué va a pasar; escribirlo es la confirmación.

  3. NavegadorEnvía POST /system/actions/{acción}
  4. API¿Menos de 5 acciones en el minuto?

    Límite system-actions: 5 por minuto por persona.

  5. API¿Tiene system.actions.execute?

    El permiso va primero, para que quien no lo tiene no gaste intentos de código.

  6. API¿Código válido?

    Sin repetición; cinco incorrectos en un minuto bloquean la reautenticación (423).

  7. RedisDeja la señal o sube la generación
  8. APILo registra en admin_actions

    system_workers_restarted, system_realtime_restarted o system_cache_cleared. Aparece en la auditoría de administración.

  9. Super adminVe el aviso y el panel actualizado

Qué ve la persona en cada error

CódigoHTTPCuándoMensaje en pantalla
TOO_MANY_REQUESTS429Más de 5 acciones en un minutoHiciste demasiados intentos seguidos. Espera {wait} y vuelve a intentarlo.
MFA_CODE_INVALID422El código no es correctoEl código no es correcto. Escribe el que muestra ahora tu aplicación de autenticación.
REAUTHENTICATION_LOCKED423Cinco códigos incorrectos en un minutoEscribiste varios códigos incorrectos seguidos. Espera {wait} y vuelve a intentarlo.
FORBIDDEN_ACTION403Sin system.actions.executeNo tienes permiso para hacer esta acción. Si crees que deberías tenerlo, habla con un administrador.

Dónde está en el código