feat(moodle): replicador de produccion a local con usuarios, profesores y correos reales v3.5.1

This commit is contained in:
2026-10-16 14:31:23 -03:00
parent 0ca5688b47
commit 0828c93edd
15 changed files with 1029 additions and 245 deletions
+42
View File
@@ -0,0 +1,42 @@
# 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`.
+51
View File
@@ -0,0 +1,51 @@
# 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.
+26
View File
@@ -0,0 +1,26 @@
# Tareas de Implementación: Replicador Moodle Producción -> Local
**Ruta**: `specs/002-moodle-export-sync/tasks.md`
- [x] **T1: Formalización de Especificación SDD**:
- Hecho cuando: Existen `specs/002-moodle-export-sync/spec.md`, `plan.md` y `tasks.md`.
- [x] **T2: Implementación del Script `scripts/moodle_replicator.py`**:
- Hecho cuando:
- Extrae credenciales de `.credenciales`.
- Autentica con Moodle producción con extracción de `logintoken`.
- Descarga participantes vía `action_redir.php` (JSON) y extrae correos electrónicos REALES concurrentemente desde los perfiles.
- Genera DNI determinístico (`90XXXXXX`) para `username` y `password`, preservando el DNI real de Carlos Tello.
- Consume la API REST de `10.0.0.207` para crear/actualizar usuarios y matricularlos por curso.
- [x] **T3: Creación de la Skill de Automatización**:
- Hecho cuando: Existe `.agents/skills/moodle-replicator/SKILL.md` documentando el procedimiento, comandos y parámetros.
- [x] **T4: Ejecución y Replicación en Vivo en Moodle Local (`10.0.0.207`)**:
- Hecho cuando: Se replican los 4 cursos (Carrera 922, 5311, 5313, 5314) y se matriculan los 504 usuarios en local con emails reales.
- [x] **T5: Verificación de Integridad y Acceso Local**:
- Hecho cuando: Se comprueba en base de datos local que los usuarios y enrolments están activos y se valida inicio de sesión local con un alumno generado (`http://10.0.0.207/moodle/my/courses.php`).
- [x] **T6: Documentación, Bump Semántico y Git Push**:
- Hecho cuando: Se actualizan `CHANGELOG.md`, `MEMORY.md`, se incrementa la versión y se realiza `git push origin dev` y `main`.