Files

43 lines
2.0 KiB
Markdown

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