Files

52 lines
3.8 KiB
Markdown

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