Importador de módulos

El asistente Nuevo módulo (import.php, también "Crear módulo desde archivo" en Administración del sitio → Cursos) crea un módulo con la estructura oficial de la Academia a partir de un archivo, de un documento libre o desde cero. El módulo siempre queda como borrador (oculto) hasta publicarlo.

Pasos del asistenteCopy Anchor Link

En modo "en blanco" el módulo, al crearse, se abre directamente en modo de edición (editmode.php). Un borrador solo se puede eliminar si no es un módulo del manual (access::is_manual) ni PTS ni APOYO-IA, y con moodle/course:delete.

Modos de entradaCopy Anchor Link

Salida común de los lectoresCopy Anchor Link

Los dos scripts de Python imprimen una línea JSON por la salida estándar (el PHP toma la última línea JSON válida). importer::sanitize_modules() normaliza el resultado:

{"ok": true, "source": "archivo.xlsx", "modules": [
  {"n": 13, "raw_title": "MÓDULO 13: ...", "titulo": "...",
   "temas": [{"n": 1, "codigo": "G-3-OP-...", "tema": "...", "objetivo": "...",
              "url": "https://youtu.be/...", "texto": "", "preguntas": []}]}
]}

En caso de error: {"ok": false, "error": "..."}. Si python3 no está disponible, el asistente lo informa ("Python 3 no está disponible en el servidor"). Las dependencias pypdf, python-docx y openpyxl se instalan en el Dockerfile.

importer::clean_title() quita el prefijo "Módulo N:" y pasa a mayúscula inicial los títulos que vienen completos en MAYÚSCULAS.

Plantilla ExcelCopy Anchor Link

template.php (capacidad moodle/course:create) descarga Plantilla modulo Academia Deltamontero.xlsx, generada por local_deltamodules\template::spreadsheet() con PhpSpreadsheet:

Las cabeceras son las que reconoce parse-curriculum.py; si se cambian, hay que cambiar ambos.

Bancos de preguntasCopy Anchor Link

importer acepta preguntas en varios formatos y las convierte a lo que entiende el importador nativo de Moodle:

Formato reconocido por parse_free():

Tema 2                         (o "13.2 Nombre del tema": las preguntas siguientes van a ese tema)
1. ¿Pregunta?                  (numerada o no; puede seguir en varias líneas)
a) opción                      (A. / a- / a) ; mayúscula o minúscula)
*b) opción correcta            (o "(correcta)" / "✓" al final de la opción)
Respuesta: b                   (o "ANSWER: B"; "Respuesta: Falso" = verdadero/falso)

importer::docx_lines() lee el Word directamente del ZIP y reconstruye las letras y números de las listas automáticas de Word (que no vienen en el texto). Una sublista numerada bajo una pregunta se interpreta como opciones.

importer::qbank_preview() lee el archivo sin guardar nada y cuenta preguntas por tipo y por categoría. importer::match_topic($categoria, $temas) asigna cada categoría a un tema por su número (13.2 …, 2. …, Tema 2) o por su nombre (con o sin "Repaso:"). Las preguntas que no corresponden a un tema quedan en el banco del módulo, en la categoría "Módulo N. Título".

IA opcional (ai_author)Copy Anchor Link

En modo documento, si se marcó "Asistente de IA", el paso ai llama a ai_author::enrich_topic() tema por tema (los temas con al menos 200 caracteres de texto, ai_author::MIN_TEXT):

• Usa la instancia de local_ai_manager del chat (conector chatgpt con endpoint de Groq, o la instancia llamada "Chat IA - Academia Deltamontero") y el modelo openai/gpt-oss-20b (ai_author::MODEL), temperatura 0.2 y respuesta en formato JSON.
• Envía hasta 6.000 caracteres del tema y pide un objetivo breve y 3 preguntas de opción múltiple (4 opciones, una correcta) sacadas solo del texto.
• Si recibe un error 429 espera lo que indica el proveedor (máximo 20 s) y reintenta una vez.
• Valida la respuesta (validate): descarta preguntas incompletas, con opciones repetidas o con menos de 3 o más de 5 opciones. Solo completa el objetivo si el tema no tenía y las preguntas si el tema no traía.
• Si la IA falla en un tema, ese tema queda como estaba y el módulo se crea igual.

Otros caminos para crear módulosCopy Anchor Link