# 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.