Programar un Reporte Semanal

En este tutorial dejás programado un reporte de mantenimiento que se genera y entrega todos los lunes sin intervención humana.

Antes de empezar

Necesitás:

• Una cuenta de email verificada (o un número WhatsApp conectado).
• Un branding guardado (opcional pero recomendado) — ver Brandings.
• Lista de destinatarios (emails o teléfonos).
• ~15 minutos.

Paso 1 — Preparar el branding

Si aún no lo hiciste:

1. Administración → Marcas y Logos → Nueva.
2. Subir logo, definir colores del header, texto del footer.
3. Marcarlo como default del tenant.
4. Guardar.

Si ya tenés un default, saltar al Paso 2.

Paso 2 — Crear el reporte programado

1. Datos → Reportes Programados → Nuevo.
2. Nombre: "Mantenimiento semanal — Planta Norte".
3. Frecuencia: weekly.
4. Hora: 7 (UTC). Para Argentina/Mexico ajustar según huso horario — 7 UTC = 4am CDMX / 4am CABA (horario estándar).
5. Día: Lunes (day_of_week=0).
6. Canal: email.
7. Cuenta de email: seleccionar la cuenta verificada.
8. Destinatarios: gerencia@tu-empresa.com, mantenimiento@tu-empresa.com.
9. Branding: seleccionar el branding del Paso 1 (o dejar vacío si ya marcaste uno como default).

Paso 3 — Definir la estructura del reporte

Usar el editor de bloques. Estructura sugerida:

1. Bloque clave-valor
   - Planta: Norte
   - Período: última semana
   - Responsable: Coordinador de mantenimiento

2. Encabezado: "Tareas Completadas Esta Semana"

3. Tabla (fuente: colección `tasks`, filtro: última semana, status=completed)
   - Columnas: task_code, título, activo, técnico, duración

4. Encabezado: "Alarmas Críticas"

5. Tabla (fuente: _alerts, filtro: última semana, severity=critical)
   - Columnas: asset_id, first_seen_at, count, status

6. Encabezado: "KPIs del Período"

7. Clave-valor: disponibilidad, MTTR, MTBF, tareas completadas

Paso 4 — Probar la ejecución

Antes de activar, verificar que todo funcione:

1. En el detalle del reporte programado, clic en Ejecutar ahora.
2. Abrir el email que llega a los destinatarios de prueba.
3. Revisar:
   • El branding aplica correcto (logo, colores).
   • Las tablas tienen datos.
   • El título y la fecha son coherentes.

Si algo sale mal, editar la estructura y volver a ejecutar.

Paso 5 — Activar

1. Toggle Habilitado en on.
2. Guardar.

El próximo lunes a las 7am UTC el sistema genera el PDF y lo envía a los destinatarios automáticamente.

Paso 6 — Verificar el historial

Una semana después:

1. Datos → Reportes Programados → abrir el reporte.
2. Pestaña Ejecuciones.
3. Ver:
   • La ejecución del lunes pasado con status ok.
   • El signed_url del PDF entregado (click para re-descargar).
   • Los destinatarios efectivos.

Tips

• Si el reporte llega con tablas vacías, revisar los filtros de la colección — el rango "última semana" puede quedar mal si el sistema no tiene timezone configurado.
• Para cambiar branding o destinatarios: editar el reporte programado. La próxima ejecución aplica los cambios automáticamente.
• Para pausar sin borrar: toggle Habilitado en off. Volverlo a activar reanuda el calendario.

Ver data/scheduled-reports para parámetros completos y casos avanzados.