Manual de la Academia
El curso de Introducción (induccion_ia) se genera desde el código con la clase manual y el script build-intro-manual.php.
El curso Introducción: Cómo usar la Academia con IA (nombre corto induccion_ia, número de ID APOYO-IA) es el manual de uso de la plataforma. Su contenido vive en el código, en classes/manual.php, y se vuelca al curso en cada despliegue con infrastructure/moodle/build-intro-manual.php (paso crítico de moodle-config.sh).
Editar las páginas del manual desde Moodle no sirve: el siguiente despliegue las vuelve a escribir desde manual.php. Para cambiar el manual se edita el código y se despliega.
Estructura
manual::sections() devuelve las partes (secciones del curso) y sus capítulos (páginas), en orden:
| Clave | Sección | Público | Capítulos |
|---|---|---|---|
academia | Cómo usar la Academia | Todos | 1.1 a 1.6 (ingreso, recuperar contraseña, menú y Área personal, módulos, reglas de los repasos, certificado) |
chat | Chat de IA | Todos | 2.1 a 2.5 (qué es, primer uso y términos, alcance, límite diario e historial, asistente de gestión) |
tthh | Guía para Talento Humano | Grupo manual_th | 3.1 a 3.12 (mapa, crear colaborador, personal y contraseñas, postulantes, pruebas técnicas, equipos, módulos, reglas y calificaciones, reportes y revisión anual, importar personal, clientes) |
admin | Guía para administradores | Grupo manual_admin | 4.1 a 4.5 (alcance del super administrador, perfiles y cohortes, recuperar el acceso de un super administrador, configuración del chat de IA, qué se aplica en cada despliegue) |
Cada capítulo es una página (mod_page) con número de ID manual_<sección>_<capítulo> (constante manual::PREFIX = 'manual_'), completado automático al abrirla y sin evaluaciones. Al final queda la sección "Certificado".
Marcas del contenido
El HTML de cada capítulo admite marcas que manual::render() convierte:
| Marca | Resultado |
|---|---|
[[ruta|Menú → Pantalla|/ruta.php]] | Recuadro "Ruta:" con la ruta y un enlace "Abrir" (el tercer tramo es opcional) |
[[nota|texto]] | Aviso alert alert-info |
{{W}} | Se reemplaza por $CFG->wwwroot |
Públicos de las guías
manual::AUDIENCES define dos grupos del curso:
| Clave | idnumber del grupo | Nombre | Perfiles que lo integran |
|---|---|---|---|
th | manual_th | Guía para Talento Humano | delta_jefaturas, delta_a2_rrhh, delta_socios |
admin | manual_admin | Guía para administradores | Ninguno (solo el super administrador, que ve todo) |
manual::sync_groups() crea los grupos y deja como integrantes exactamente a quienes tienen alguno de esos perfiles en contexto de sistema y están inscritos en el curso. Las secciones de esas guías llevan la restricción "pertenecer al grupo" oculta para los demás; academy::gate_certificate() y academy::apply_course_completion() no exigen esas páginas a quien no es del grupo.
Sincronización: manual::sync()
Idempotente. Si el curso induccion_ia no existe, no hace nada (lo crea create-onboarding-course.php).
Retirar contenido anterior
Borra las páginas antiguas listadas en manual::LEGACY_PAGES. El repaso antiguo (manual::LEGACY_QUIZ) se borra si nadie lo rindió; si tiene intentos, se oculta para conservarlos. Se limpia la restricción del certificado para recalcularla.
Secciones
Crea o reubica una sección por parte (1..N) y aplica la restricción de grupo a las guías; deja la sección del certificado al final con su texto; escribe la introducción en la sección 0.
Páginas
Crea las páginas que faltan, actualiza nombre y contenido de las existentes (subiendo revision), asegura completado al ver y visibilidad, y las ordena al final de su sección. Borra los capítulos manual_* que ya no están en el código.
Certificado y completado
academy::gate_certificate() y academy::apply_course_completion(): el certificado se desbloquea al abrir todas las páginas que corresponden a cada persona.
Matrícula
Agrega a la cohorte "Todo el equipo Deltamontero" (delta_todos) a todo el personal con cohorte de cargo que aún no esté, y sincroniza la matrícula por cohorte del curso.
manual::refresh() solo actualiza el texto de las páginas existentes. Lo llama rules.php al guardar la regla general, para que los capítulos 1.5 y 3.9 muestren los valores nuevos.
gate-certificates.php no revoca los certificados de induccion_ia emitidos con la versión anterior del curso (que tenía un repaso): se conservan.
Guía para Talento Humano en Administración
guide.php (Administración del sitio → Academia → Guía para Talento Humano, capacidad local/deltamodules:managestandard) es una versión resumida, por clics, con enlaces directos a cada pantalla. La versión completa es la sección tthh del manual.
Importador de módulos
Asistente "Crear módulo desde archivo" (import.php), lectores en Python (parse-curriculum.py, parse-document.py), plantilla Excel, bancos de preguntas e IA opcional.
Acceso a módulos
Quién ve cada módulo y por qué, con matrículas nativas de Moodle por cargo, por empresa cliente o individuales, y la tabla de exclusiones.