Programacion y Reportes

¿Para qué sirve?

• Distribuir órdenes entre técnicos según capacidad y ubicación.
• Respetar ventanas de mantenimiento de producción.
• Minimizar desplazamientos entre plantas o zonas.

¿Cómo funciona?

El scheduler resuelve un problema de asignación considerando skill del técnico, ubicación del activo, ventanas autorizadas y SLAs pendientes. El supervisor puede forzar manualmente.

Reportes programados

Puedes configurar reportes automáticos que se generan y entregan periodicamente con información de tus planes de mantenimiento.

Crear un reporte programado

1. Ve a Mantenimiento > Reportes Programados.
2. Haz clic en Nuevo Reporte.
3. Configura los parametros:

Frecuencias disponibles

Presets de branding

Los reportes programados pueden usar un preset de branding guardado para mantener una identidad visual consistente:

Para vincular un branding a un reporte programado, usa el campo branding_id:

{
  "name": "Reporte Semanal de Mantenimiento",
  "frequency": "weekly",
  "format": "pdf",
  "branding_id": "branding_abc123",
  "day_of_week": 0,
  "hour": 8
}

Integración con Cloud Scheduler

Los reportes programados se ejecutan a traves de un endpoint interno invocado por Google Cloud Scheduler:

POST /internal/run-scheduled-reports

Flujo de ejecución

1. Cloud Scheduler invoca el endpoint a intervalos regulares.
2. El sistema revisa todos los reportes habilitados de todos los tenants.
3. Para cada reporte, verifica si es el momento de ejecutarlo segun su frecuencia y hora configurada.
4. Genera el reporte en el formato especificado (PDF o Excel).
5. Entrega el reporte al canal configurado (email o WhatsApp).
6. Actualiza last_run_at y calcula next_run_at.

Seguridad del endpoint

El endpoint interno esta protegido por:

• HMAC Secret — El header X-Scheduler-Secret debe coincidir con el secreto configurado.
• Sin JWT — No requiere autenticación de usuario, solo el secreto del scheduler.

Pausar y reanudar planes

Puedes pausar temporalmente un plan de mantenimiento sin eliminarlo. La pausa deshabilita la ejecución automatica y registra la acción en el trail de auditoria.

Pausar un plan

1. Selecciona el plan desde Mantenimiento > Planes.
2. Haz clic en Pausar.
3. Opcionalmente, ingresa un motivo (max 500 caracteres).

Al pausar un plan:

Reanudar un plan

1. Selecciona el plan pausado.
2. Haz clic en Reanudar.

Al reanudar un plan:

Trail de auditoria

Todas las acciones de pausa y reanudacion quedan registradas en el trail de auditoria inmutable:

{
  "action": "pause",
  "resource_type": "maintenance_plan",
  "resource_id": "plan_abc123",
  "actor": "user_xyz",
  "actor_type": "user",
  "details": { "reason": "Equipo en reparacion mayor" },
  "timestamp": "2026-03-25T10:30:00Z"
}

Esto permite rastrear quien pauso o reanudo un plan, cuando y por que.

Proteccion de idempotencia

El sistema incluye multiples mecanismos para garantizar que los planes no se ejecuten de forma duplicada:

Ejecución manual de reportes

Ademas de la ejecución automatica, puedes generar cualquier reporte programado inmediatamente:

1. Ve a Mantenimiento > Reportes Programados.
2. Selecciona el reporte.
3. Haz clic en Ejecutar Ahora.

La ejecución manual actualiza last_run_at pero no modifica next_run_at. El reporte se entrega inmediatamente al canal configurado.

Beneficios clave

• Asignación optimizada por skill y ubicación.
• Respeta ventanas de producción automáticamente.
• Minimiza desplazamientos — menos tiempo muerto.
• Forzado manual para casos excepcionales.
• Visibilidad previa del plan de la semana.