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.