Files
admin-edu-space/.agents/skills/moodle-replicator/SKILL.md
T

3.4 KiB

name, description
name description
moodle-replicator Procedimiento y script de automatización para exportar participantes, materias y carreras desde Moodle Producción UniCABA y replicarlos en el Moodle Local (10.0.0.207) con DNI y credenciales mockeadas.

Skill: Replicador de Datos de Moodle Producción a Local

Propósito

Automatizar la extracción de participantes (estudiantes y docentes), asignaturas y carreras desde el campus virtual institucional de UniCABA en producción (https://campus.udelaciudad.edu.ar/) y replicar su estructura y usuarios en el entorno de pruebas local de Moodle (http://10.0.0.207/moodle), permitiendo validar la integración y concurrencia con Admin Edu Space.


1. Mapeo Oficial de Entidades

Entidad Nombre Oficial ID Producción ID Local
Carrera Mi carrera - Lic. en Tecnologías Digitales (CCC) 922 19
Materia 1 ASIG00124 - Sistemas Digitales_2/2026 5311 16
Materia 2 ASIG00126 - Seguridad de la Información_2/2026 5313 17
Materia 3 ASIG00127 - Programación de Vanguardia - E1_2/2026 5314 18

2. Reglas de Negocio y Mocking

  1. Credenciales en Producción:

    • Obtenidas exclusivamente de .credenciales (sección Login Moodle del Campus UniCABA en producción).
    • Flujo de dos pasos: GET /login/index.php para extraer logintoken pre-sesión -> POST de credenciales manteniendo la cookie MoodleSession.
  2. Descarga Directa de Participantes:

    • Invocación al endpoint de exportación /user/action_redir.php con bulkchange.php?operation=download_participants&dataformat=json pasando los checkboxes de usuarios extraídos con perpage=5000.
    • Fusión con los datos de rol extraídos de la tabla HTML para distinguir Profesor Universidad (editingteacher, ID 3) de Estudiante Universidad (student, ID 5).
  3. Generación Determinística de DNI:

    • Para todo participante que no posea DNI explícito: DNI = 90 + ID_Moodle_6_digitos (ej. moodle_id=12740 -> 90012740).
    • Regla de Acceso Local: username = DNI y password = DNI.
    • Si el usuario cuenta con DNI real conocido (ej. Carlos Tello: 34247025), se preserva su DNI real.
  4. Alta y Matriculación en Moodle Local:

    • Consumo de la REST API institucional en http://10.0.0.207/moodle/webservice/rest/server.php.
    • Funciones: core_user_create_users y enrol_manual_enrol_users.

3. Comandos de Ejecución

Modo Simulación (Dry-Run):

.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --dry-run

Exportar y Guardar en Archivo JSON:

.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --export-json participantes_moodle.json --dry-run

Ejecutar Replicación Completa en Moodle Local:

.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py

Replicar Curso Específico:

.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --course 5311

4. Verificación en Moodle Local

Para verificar que los usuarios fueron importados y matriculados correctamente:

plink.exe -ssh -batch -pw "Unicaba2026*" root@10.0.0.207 "mysql -u moodleuser -p'MoodlePass2026!Segura' moodle -e 'SELECT c.fullname, COUNT(ue.id) as matriculados FROM mdl_course c JOIN mdl_enrol e ON e.courseid=c.id JOIN mdl_user_enrolments ue ON ue.enrolid=e.id WHERE c.id IN (16,17,18,19) GROUP BY c.id;'"