88 lines
4.8 KiB
Markdown
88 lines
4.8 KiB
Markdown
---
|
|
name: moodle-replicator
|
|
description: Procedimiento y script de automatización para exportar participantes, materias y carreras desde Moodle Producción UniCABA y replicarlos en el Moodle Local (10.0.0.207) con DNI y credenciales mockeadas.
|
|
---
|
|
|
|
# Skill: Replicador de Datos de Moodle Producción a Local
|
|
|
|
## Propósito
|
|
Automatizar la extracción de participantes (estudiantes y docentes), asignaturas y carreras desde el campus virtual institucional de UniCABA en producción (`https://campus.udelaciudad.edu.ar/`) y replicar su estructura y usuarios en el entorno de pruebas local de Moodle (`http://10.0.0.207/moodle`), permitiendo validar la integración y concurrencia con **Admin Edu Space**.
|
|
|
|
---
|
|
|
|
## 1. Mapeo Oficial de Entidades (16 Cursos de la Carrera)
|
|
|
|
| Entidad | Nombre Oficial | ID Producción | ID Local |
|
|
| :--- | :--- | :---: | :---: |
|
|
| **Carrera** | Mi carrera - Lic. en Tecnologías Digitales (CCC) | `922` | `19` |
|
|
| **Escuela** | Escuela de Tecnología e Industrias Digitales | `187` | `3` |
|
|
| **Materia 1/2025** | ASIG00120 - Gestión de Sistemas de Información_1/2025 | `3218` | `4` |
|
|
| **Materia 1/2025** | ASIG00121 - Análisis de Datos I - TEC.DIG._1/2025 | `3220` | `5` |
|
|
| **Materia 1/2025** | ASIG00122 - Taller: Gestión de Proyectos Digitales - E1_1/2025 | `3221` | `6` |
|
|
| **Materia 1/2025** | ASIG00215 - Marketing Digital - OPTATIVA -1/2025 | `3665` | `7` |
|
|
| **Materia 2/2025** | ASIG00123 - Administración de Negocios Digitales_2/2025 | `3945` | `8` |
|
|
| **Materia 2/2025** | ASIG00124 - Sistemas Digitales_2/2025 | `3944` | `9` |
|
|
| **Materia 2/2025** | ASIG00125 - Taller: Emprendedurismo en Innovación Digital_2/2025 | `3943` | `10` |
|
|
| **Materia 2/2025** | ASIG00205 - Gestión del Talento Humano en la Industria digital-2/2025 | `3933` | `11` |
|
|
| **Materia 1/2026** | ASIG00121 - Análisis de Datos I - TEC.DIG._1/2026 | `4565` | `12` |
|
|
| **Materia 1/2026** | ASIG00123 - Administración de Negocios Digitales_1/2026 | `4569` | `13` |
|
|
| **Materia 1/2026** | ASIG00125 - Taller: Emprendedurismo en Innovación Digital_1/2026 | `4571` | `14` |
|
|
| **Materia 1/2026** | ASIG00296 - Gestión de Redes Informáticas - Equipo 1_1/2026 | `4582` | `15` |
|
|
| **Materia 2/2026** | ASIG00124 - Sistemas Digitales_2/2026 | `5311` | `16` |
|
|
| **Materia 2/2026** | ASIG00126 - Seguridad de la Información_2/2026 | `5313` | `17` |
|
|
| **Materia 2/2026** | ASIG00127 - Programación de Vanguardia - E1_2/2026 | `5314` | `18` |
|
|
|
|
---
|
|
|
|
## 2. Reglas de Negocio, User-Agent y Mocking
|
|
|
|
1. **User-Agent y Credenciales en Producción**:
|
|
- Cabecera HTTP fija: `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)`.
|
|
- Obtenidas exclusivamente de `.credenciales` (sección `Login Moodle del Campus UniCABA en producción`).
|
|
- Flujo de dos pasos: `GET /login/index.php` para extraer `logintoken` pre-sesión -> `POST` de credenciales manteniendo la cookie `MoodleSession`.
|
|
|
|
2. **Descarga Directa de Participantes**:
|
|
- Invocación al endpoint de exportación `/user/action_redir.php` con `bulkchange.php?operation=download_participants&dataformat=json` pasando los checkboxes de usuarios extraídos con `perpage=5000`.
|
|
- Fusión con los datos de rol extraídos de la tabla HTML para distinguir `Profesor Universidad` (`editingteacher`, ID 3) de `Estudiante Universidad` (`student`, ID 5).
|
|
|
|
3. **Generación Determinística de DNI**:
|
|
- Para todo participante que no posea DNI explícito: `DNI = 90 + ID_Moodle_6_digitos` (ej. `moodle_id=12740` -> `90012740`).
|
|
- **Regla de Acceso Local**: `username = DNI` y `password = DNI`.
|
|
- Si el usuario cuenta con DNI real conocido (ej. Carlos Tello: `34247025`), se preserva su DNI real.
|
|
|
|
4. **Alta y Matriculación en Moodle Local**:
|
|
- Consumo de la REST API institucional en `http://10.0.0.207/moodle/webservice/rest/server.php`.
|
|
- Funciones: `core_user_create_users` y `enrol_manual_enrol_users`.
|
|
|
|
---
|
|
|
|
## 3. Comandos de Ejecución
|
|
|
|
### Modo Simulación (Dry-Run):
|
|
```powershell
|
|
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --dry-run
|
|
```
|
|
|
|
### Exportar y Guardar en Archivo JSON:
|
|
```powershell
|
|
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --export-json participantes_moodle.json --dry-run
|
|
```
|
|
|
|
### Ejecutar Replicación Completa en Moodle Local:
|
|
```powershell
|
|
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py
|
|
```
|
|
|
|
### Replicar Curso Específico:
|
|
```powershell
|
|
.\backend\venv\Scripts\python.exe scripts/moodle_replicator.py --course 5311
|
|
```
|
|
|
|
---
|
|
|
|
## 4. Verificación en Moodle Local
|
|
Para verificar que los usuarios fueron importados y matriculados correctamente:
|
|
```powershell
|
|
plink.exe -ssh -batch -pw "Unicaba2026*" root@10.0.0.207 "mysql -u moodleuser -p'MoodlePass2026!Segura' moodle -e 'SELECT c.fullname, COUNT(ue.id) as matriculados FROM mdl_course c JOIN mdl_enrol e ON e.courseid=c.id JOIN mdl_user_enrolments ue ON ue.enrolid=e.id WHERE c.id IN (16,17,18,19) GROUP BY c.id;'"
|
|
```
|