43 lines
2.0 KiB
Markdown
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`.
|