Files
admin-edu-space/.agents/skills/moodle-replicator/SKILL.md
T

74 lines
3.4 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
| Entidad | Nombre Oficial | ID Producción | ID Local |
| :--- | :--- | :--- | :--- |
| **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` |
---
## 2. Reglas de Negocio y Mocking
1. **Credenciales en Producción**:
- 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;'"
```