Files
admin-edu-space/specs/002-moodle-export-sync/plan.md
T

2.0 KiB

Plan de Implementación: Replicador Moodle Producción -> Local

Ruta: specs/002-moodle-export-sync/plan.md
Referencia: specs/002-moodle-export-sync/spec.md


1. Arquitectura de Componentes

+------------------------------------+
|        Moodle Producción           |
| (https://campus.udelaciudad.edu.ar)|
+------------------------------------+
                  |
        [1] Sesión & Auth (logintoken)
        [2] action_redir.php (download_participants JSON)
        [3] HTML Scraping (roles, perfiles, emails)
                  v
+------------------------------------+
|    scripts/moodle_replicator.py    |
| - MoodleProdExtractor              |
| - MoodleUserTransformer (Mock DNI) |
| - MoodleLocalLoader (REST API)     |
+------------------------------------+
                  |
        [4] core_user_create_users (REST API)
        [5] enrol_manual_enrol_users (REST API)
                  v
+------------------------------------+
|          Moodle Local              |
|       (http://10.0.0.207)          |
+------------------------------------+

2. Decisiones Técnicas

  1. Librería de Transporte: Se utiliza requests.Session de Python con pooling de conexiones y cabeceras de emulación de navegador (User-Agent, Accept).
  2. Descarga Directa de Participantes: Se explota el mecanismo nativo de Moodle (/user/action_redir.php) con operation=download_participants&dataformat=json, obteniendo de forma limpia y tipada nombre, apellidos y grupos.
  3. Mapeo de Roles: Se discrimina Profesor / Docente (roleid = 3, editingteacher) vs Estudiante / Alumno (roleid = 5, student).
  4. Mocking de DNI Determinístico: Para registros sin DNI, se calcula dni = f"90{int(moodle_user_id):06d}", y se establece username = dni y password = dni.
  5. Carga en Lote: Invocación al endpoint REST webservice/rest/server.php de Moodle local con el token institucional 810428346d3601c68a37a315fcba8d4391629f46.