feat(moodle): replicador de produccion a local con usuarios, profesores y correos reales v3.5.1
This commit is contained in:
@@ -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`.
|
||||
@@ -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.
|
||||
@@ -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`.
|
||||
|
||||
Reference in New Issue
Block a user