Academia Deltamontero · Documentación
Desarrollolocal_deltamodules

Revisión anual

Registro histórico de la revisión anual obligatoria de los módulos (review.php, tabla local_deltamodules_review) y el aviso mensual review_reminder.

El manual de la Academia exige que todos los módulos se revisen formalmente al menos una vez por año y que ninguno pase más de doce meses sin constancia de revisión. La plataforma lo implementa con una página, una tabla con el historial, campos personalizados del curso y una tarea mensual.

Qué cursos se revisan

academy::review_courses(): cursos con número de ID M seguido de dos o más dígitos (M01…M12 y los creados después, M13…) y la Prueba Técnica de Selección (PTS), ordenados por número y con PTS al final.

Página review.php

Administración del sitio → Informes → Revisión anual de módulos (página externa local_deltamodules_review), capacidad local/deltamodules:managereview.

Muestra el estado de cada curso y permite registrar una revisión (action=form, luego action=save con sesskey). Al guardar:

  • exige marcar todos los criterios mínimos del manual (11 criterios fijos en la página, como vigencia del contenido, cambios normativos, tributarios o laborales, procedimientos, sistema, funcionalidades, servicios, procesos de clientes, evaluaciones, perfiles y nuevos contenidos);
  • el resultado es uno de tres: sin cambios, requiere actualización, actualizado;
  • inserta una fila en local_deltamodules_review (fecha, responsable, resultado, cambios requeridos, criterios evaluados, fecha de actualización, próxima revisión, quién registró). Las revisiones no se pisan: el historial queda en la tabla;
  • la próxima revisión, si no se indica, es la fecha de revisión + 12 meses;
  • actualiza los campos personalizados del curso con la última revisión: ultima_revision, responsable_revision, resultado_revision, cambios_requeridos, fecha_actualizacion, proxima_revision.

Los campos personalizados los crean configure-module-metadata.php y align-academy-to-manual.php. Al crear un módulo con el asistente, academy::create_module() fija ultima_revision (hoy), proxima_revision (+12 meses) y responsable_revision; en "Revisar y publicar" se cambian con academy::update_review().

Aviso mensual: review_reminder

DatoValor
Claselocal_deltamodules\task\review_reminder
ProgramaciónDía 1 de cada mes a las 08:00
Proveedor de mensajesreviewreminder (db/messages.php): campana activada por defecto; correo permitido
DestinatariosUsuarios activos con el rol delta_jefaturas en contexto de sistema

Para cada curso de review_courses() calcula la última revisión (MAX(reviewdate)) y la próxima (MAX(nextdate)) de la tabla y lista los módulos sin revisión, vencidos (pasada la próxima fecha o más de 12 meses desde la última) y por vencer (menos de 60 días). Si no hay ninguno, no envía nada. El mensaje enlaza a review.php.

Como el correo de las notificaciones de Moodle está desactivado (configure-mail.php), en la práctica este aviso llega solo a la campana. create-annual-review-event.php (que no se ejecuta en cada arranque) crea además eventos en el calendario del sitio para los próximos 3 años.

En esta página