Módulos y estándar

Un módulo de la Academia es un curso de Moodle dentro de la categoría Academia Deltamontero (o de una subcategoría suya). Cuatro clases se reparten el trabajo:

¿Qué es un módulo de la Academia?Copy Anchor Link

standard::is_academy(int $courseid) decide si un curso sigue el estándar: es true cuando la categoría del curso es la categoría raíz cuyo nombre es academy::CATEGORY ('Academia Deltamontero') o una subcategoría suya (se compara el path de la categoría). El sitio (SITEID) nunca lo es. El resultado se guarda en una caché estática por petición.

Casi todo lo automático (reglas, observadores, avisos de borrador, pantalla corta de nuevo repaso) solo actúa sobre cursos para los que is_academy() devuelve true. El curso de la Prueba Técnica de Selección (seleccion_pruebas_tecnicas, número de ID PTS) y el curso de Introducción se tratan aparte.

Estructura oficial (academy)Copy Anchor Link

academy::create_module(array $def) crea un módulo con exactamente la estructura de los módulos 1 a 12. La usa el asistente "Crear módulo desde archivo" (Importador).

Definición que recibe create_moduleCopy Anchor Link

$def = [
    'n' => 13,                       // número del módulo
    'titulo' => 'Nombre del módulo',
    'catid' => 0,                    // 0 = categoría Academia Deltamontero
    'objetivo' => '...', 'aplicacion' => '...',
    'responsable' => 'Talento Humano',
    'tipo' => 1,                     // 0..4 (ver academy::TIPOS)
    'obligatorios' => [/* cohortid */], 'complementarios' => [], 'editores' => [],
    'repasos' => true, 'candado' => true, 'certificado' => true,
    'rules' => ['attempts' => 3],    // reglas propias del módulo (opcional)
    'qbank' => ['path' => '...', 'name' => '...', 'format' => 'gift'],   // opcional
    'temas' => [
        ['tema' => '...', 'objetivo' => '...', 'codigo' => 'G-3-OP-...', 'url' => 'https://youtu.be/...',
         'texto' => '...', 'preguntas' => [/* formato de builder::add_questions */]],
    ],
];

Las reglas propias (rules) se guardan antes de crear el contenido, para que cada video y repaso nazca con ellas. Devuelve courseid, quizcms (cmids de los repasos creados), contadores (videos, links, pending, questions, readings), bank (resultado del banco de preguntas), cert y criteria.

Otras operaciones de academyCopy Anchor Link

Fábrica de bajo nivel (builder)Copy Anchor Link

Formato de las preguntas que reciben add_questions y academy::create_module:

$qs = [
    ['q' => 'Enunciado', 't' => 'mc', 'opts' => ['A', 'B', 'C'], 'ok' => 1, 'fb' => 'Retroalimentación'],
    ['q' => 'Enunciado', 't' => 'vf', 'ok' => 0],   // vf: ok 0 = Verdadero, 1 = Falso
];

Los videos se crean con type = 'yt', source = 'url', completionpercentage = 0 y extendedcompletion = {"watchtillend":1} (completado nativo del plugin al llegar al final). Los enlaces se abren en una pestaña nueva (display = 3) y se marcan como hechos al abrirlos.

Estándar de la Academia (standard)Copy Anchor Link

standard hace que todos los módulos se comporten igual según sus Reglas. Se aplica:

• en cada despliegue, desde infrastructure/moodle/normalize-academy.php (vía health::repair y standard::sweep_pending);
• al instante, con el observador module_changed sobre course_module_created y course_module_updated;
• cuando Talento Humano cambia una regla (apply_changes).

Videos: apply_video($cm)Copy Anchor Link

• Con la regla video_player = 1, displayoptions queda en {"distractionfreemode":1} y conserva solo usecustomposterimage y posterimagesize (portada propia de los videos alojados en R2). Un displayoptions vacío no se toca.
• Con video_completion = end: extendedcompletion.watchtillend = 1, completionpercentage = 0, completado automático sin completionview. Con view: se quita watchtillend y se marca al abrirlo.

Repasos: apply_quiz($cm, $isnew, $force)Copy Anchor Link

1. Anota el cuestionario en la configuración examsecured (lista JSON de ids) para que configure-exam-security.php no le vuelva a imponer las reglas de examen.
2. Intentos y tiempo: los del cuestionario. Solo si la regla attempts o timelimit está en $force (Talento Humano la acaba de cambiar) se impone el valor de la regla.
3. Nota para aprobar: si el cuestionario no tiene (gradepass <= 0) o si passpercent está en $force, se fija grade * passpercent / 100 en el ítem de calificación y se recalcula el completado de quien ya rindió.
4. Aviso inicial: con exam_notice = 1, se reescribe con los valores reales; un aviso escrito a mano se respeta.
5. Completado: automático por calificación (completiongradeitemnumber = 0), con completionpassgrade = 1 si la regla quiz_completion es pass y hay nota para aprobar.
6. Candado: con quiz_lock = 1, la restricción de acceso exige completar todos los videos interactivos de la misma sección (se agregan los que falten); con 0, se quitan esas condiciones. Solo se toca una restricción raíz con operador &.

Módulo completo: apply_course($courseid, $force)Copy Anchor Link

Aplica apply_video y apply_quiz a cada actividad, luego apply_certificate (solo si cambió cert_enabled o cert_template), academy::gate_certificate y academy::apply_course_completion. Si cambiaron video_completion o quiz_completion, reinicia el estado de completado (reset_all_state) de las actividades afectadas para recalcular el avance de todos con la regla nueva. apply_changes($changes) recorre los módulos devueltos por rules::save() con un límite de tiempo de 600 s.

Al crear o editar una actividad: module_changedCopy Anchor Link

• Video: apply_video.
• Cuestionario: apply_quiz; si se creó desde /course/modedit.php, guarda $SESSION->deltanewquiz para que la siguiente página sea su editor (questions.php); además registra una función de cierre (core_shutdown_manager) que vuelve a aplicar apply_quiz cuando Moodle termina de guardar la nota para aprobar.
• Al crear cualquier actividad o al tocar un certificado: recalcula gate_certificate y apply_course_completion.

Volver a ver el videoCopy Anchor Link

Regla: quien agota sus intentos sin aprobar vuelve a ver el video del tema y recibe intentos nuevos (retakeattempts, 2 por defecto; 0 lo desactiva).

sweep_pending($courseid) marca como pendientes a quienes ya habían agotado sus intentos antes de existir la regla (lo ejecuta normalize-academy.php).

Revisión de módulos (health)Copy Anchor Link

health::check_all() revisa todos los módulos de la Academia (menos PTS) y health::check($courseid) devuelve problemas con nivel error, warn o info, si los arregla el botón Reparar (fix) y un enlace a donde corregirlos (action). Lo usa modcheck.php (Módulos → Revisar los módulos).

La comprobación de YouTube (youtube_status) consulta el servicio oEmbed de YouTube en tandas de 10 con curl_multi, forzando IPv4 y respetando $CFG->proxyhost. Interpreta 200 = reproducible, 401/403 = privado o sin permiso de inserción, 404 = eliminado. Las respuestas se recuerdan 6 horas (health::YT_TTL) en la configuración ytcheck; una consulta sin respuesta no se guarda.

health::repair($courseid) activa el completado si estaba apagado, quita de las restricciones las condiciones sobre actividades inexistentes, aplica standard::apply_course() y recalcula el completado de las vistas completas que quedaron sin "Hecho". Devuelve cuántos avances recalculó. No cambia intentos, tiempo ni nota configurados en cada repaso.