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 (competencias, training items, Descripciones de Puesto, Quiz Builder), y dos schedulers automáticos para vencimiento de trainings y de competencias.

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: Catálogo de competencias, Training items, Asignar training, Asignación masiva, Descripciones de Puesto, Quiz Builder y Participantes. 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.

Tab Scheduler Trainings con parámetros de días, toggles de notificación y botón Ejecutar ahora
Tab Scheduler Trainings con parámetros de días, toggles de notificación y botón Ejecutar ahora

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 Descripción de Puesto30 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ído15 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 08:00 UTC (05: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. Competencias

Job dedicado a detectar competencias 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 competencias" como un chip naranja junto a la competencia 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 competencias evaluadas, competencias críticas encontradas, competencias en advertencia, notificaciones creadas y notificaciones actualizadas.

ℹ️

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