Admin — TMS
ADMIN-TMS-001 · ADMIN-TMS-002 · ADMIN-TMS-003

Admin TMS

El panel Admin TMS tiene 3 pestañas: la configuración completa del módulo (skills, training items, job descriptions, quiz builder), y dos schedulers automáticos para vencimiento de trainings y skills.

Admin exclusivo

Tab Configuración

Muestra el módulo TMS en su vista de configuración completa, con todas las sub-pestañas disponibles para Admin/QA: Skills, Training Items, Asignar, Masiva, Job Descriptions y Quiz Builder. Ver la documentación detallada en Configuración TMS.

Tab Scheduler — Trainings

Configura y opera el job automático que gestiona las fechas de vencimiento de los trainings asignados y genera notificaciones de overdue.

Parámetros configurables

ParámetroDescripciónDefault
Días para asignación de documento nuevo (due_days_new_document)Días desde la efectivización de un documento hasta el vencimiento del training de lectura para usuarios con ese doc en su JD15 días
Días para asignación de revisión (due_days_revision)Días para completar el re-training cuando se efectiviza una nueva revisión de un documento ya leído10 días
Notificar usuario al asignarEnvía notificación in-app al técnico cuando se le asigna un nuevo trainingActivo
Notificar QA al asignarNotifica a QA/Admin de cada nueva asignación generadaDesactivo
Check de overdue habilitadoActiva el job nocturno que detecta trainings vencidos y genera notificacionesActivo
Notificar usuario en overdueEnvía notificación al técnico cuando su training vencióActivo
Notificar QA en overdueEnvía notificación a QA/Admin cuando un training de un técnico vencióActivo

El horario automático del job es 07:00 UTC (04:00 ART) diario. Para forzar la ejecución inmediata sin esperar el cron, hacé clic en el botón > Ejecutar ahora.

El panel muestra la última modificación de la configuración con el email del Admin que la editó y el timestamp en ART.

Guardar y aplicar

Hacé los cambios en los toggles y campos numéricos y hacé clic en Guardar configuración. El sistema llama a PATCH /admin/jobs/tms y actualiza el job. Los cambios tienen efecto en la próxima ejecución del cron.

Tab Scheduler — Venc. Skills

Job dedicado a detectar skills próximas a vencer y generar notificaciones preventivas. Evalúa todas las TechnicianSkill con state certified y expires_at IS NOT NULL.

Bandas de alerta

BandaCondiciónTipo de notificaciónDestinatarios
CríticaVence en ≤ 30 díasNotificación urgenteTécnico + QA/Admin
AdvertenciaVence en 31–60 díasNotificación altaTécnico + QA/Admin

El técnico ve la alerta en su pestaña "Mis Skills" como un chip naranja junto a la skill próxima a vencer. El horario automático es 10:00 UTC (07:00 ART) diario.

El job usa upsert por entidad para las notificaciones — no genera spam si ya envió la notificación del mismo vencimiento. Solo crea una nueva notificación si el estado cambió.

Ejecutar manualmente

El botón > Ejecutar ahora fuerza el job inmediatamente. El resultado muestra las métricas de la ejecución: total de skills evaluadas, skills críticas encontradas, skills en advertencia, notificaciones creadas y notificaciones actualizadas.

ℹ️

La ejecución manual es de solo lectura respecto a datos de skill — solo crea/actualiza notificaciones, no modifica los estados de las skills ni los trainings.