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

3.8 KiB

Especificación de Requisitos: Exportación y Replicación Moodle Producción a Local

Ruta: specs/002-moodle-export-sync/spec.md
Versión: 1.0.0
Estado: Aprobado
Fecha: 16-Octubre-2026


1. Propósito y Contexto

Desarrollar un componente de automatización y skill para exportar la estructura académica (facultad, carrera, materias) y los participantes reales (docentes y estudiantes) desde el Moodle de Producción de UniCABA (https://campus.udelaciudad.edu.ar/) y replicarlos fielmente en la instancia de Moodle Local de pruebas (http://10.0.0.207/moodle), habilitando el testing integral de la integración con Admin Edu Space.


2. Requisitos Funcionales en Sintaxis EARS

RF1 (Ubicuo - Autenticación y Sesión de Producción)

El sistema deberá autenticarse de forma automatizada en https://campus.udelaciudad.edu.ar/login/index.php obteniendo dinámicamente el logintoken pre-sesión y reutilizando la cookie autenticada para todas las peticiones posteriores.

RF2 (Evento - Descarga Directa y Scraping Híbrido)

Al solicitar la extracción de participantes de un curso o carrera, el sistema deberá obtener el listado completo mediante la invocación directa al endpoint nativo de exportación de Moodle (action_redir.php con bulkchange.php?operation=download_participants&dataformat=json) combinado con el scraping de la vista de participantes (user/index.php?id=XXXX&perpage=5000) para capturar nombres, apellidos, roles (profesor vs estudiante), enlaces de perfil y correos institucionales.

RF3 (Estado - Mocking de DNI y Credenciales Locales)

Mientras se procesan registros de participantes que no dispongan de número de documento explícito, el sistema deberá generar un DNI ficticio determinístico de 8 dígitos (prefijo 90 + id numérico a 6 dígitos: 90XXXXXX), asignando dicho DNI idénticamente como username y como password para la cuenta en el Moodle local.

RF4 (Opcional - Preservación de Credenciales Reales Conocidas)

Si el usuario corresponde a un registro con DNI real previamente conocido (ej. Carlos Tello: 34247025), el sistema deberá preservar su documento original tanto en username como en los atributos de cuenta local.

RF5 (Ubicuo - Alta Automatizada en Moodle Local)

El sistema deberá consultar e insertar los usuarios procesados en Moodle Local (10.0.0.207) utilizando el endpoint REST oficial core_user_create_users, evitando duplicaciones y asegurando que las cuentas queden activas con contraseña operativa.

RF6 (Ubicuo - Matriculación en Cursos Locales por Rol)

El sistema deberá matricular a los usuarios en sus respectivos cursos locales mediante enrol_manual_enrol_users, asignando el rol student (id 5) a los estudiantes y editingteacher (id 3) a los profesores.


3. Alcance de Cursos e Identificadores (Mapeo Producción -> Local)

Entidad Nombre en Producción ID Prod ID Local
Facultad Escuela de Tecnología e Industrias Digitales 187 Cat 1
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

4. Perímetro Cerrado y Fuera de Alcance Estricto

  • NO modificar datos ni alterar configuraciones en el Moodle de Producción (operación de extracción estrictamente de solo lectura).
  • NO descargar tareas, foros, entregas de estudiantes ni calificaciones de producción (únicamente estructura de participantes y cursos para pruebas de concurrencia y asignación áulica).
  • NO exponer credenciales productivas en commits ni reportes.