feat(moodle): replicador de produccion a local con usuarios, profesores y correos reales v3.5.1
This commit is contained in:
@@ -0,0 +1,73 @@
|
||||
---
|
||||
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;'"
|
||||
```
|
||||
+232
-230
@@ -1,230 +1,232 @@
|
||||
# Byte-compiled / optimized / DLL files
|
||||
__pycache__/
|
||||
*.py[codz]
|
||||
*$py.class
|
||||
|
||||
# C extensions
|
||||
*.so
|
||||
|
||||
.idea
|
||||
|
||||
# Distribution / packaging
|
||||
.Python
|
||||
build/
|
||||
develop-eggs/
|
||||
dist/
|
||||
downloads/
|
||||
eggs/
|
||||
.eggs/
|
||||
lib/
|
||||
lib64/
|
||||
parts/
|
||||
sdist/
|
||||
var/
|
||||
wheels/
|
||||
share/python-wheels/
|
||||
*.egg-info/
|
||||
.installed.cfg
|
||||
*.egg
|
||||
MANIFEST
|
||||
|
||||
# PyInstaller
|
||||
# Usually these files are written by a python script from a template
|
||||
# before PyInstaller builds the exe, so as to inject date/other infos into it.
|
||||
*.manifest
|
||||
*.spec
|
||||
|
||||
# Installer logs
|
||||
pip-log.txt
|
||||
pip-delete-this-directory.txt
|
||||
|
||||
# Unit test / coverage reports
|
||||
htmlcov/
|
||||
.tox/
|
||||
.nox/
|
||||
.coverage
|
||||
.coverage.*
|
||||
.cache
|
||||
nosetests.xml
|
||||
coverage.xml
|
||||
*.cover
|
||||
*.py.cover
|
||||
.hypothesis/
|
||||
.pytest_cache/
|
||||
cover/
|
||||
|
||||
# Translations
|
||||
*.mo
|
||||
*.pot
|
||||
|
||||
# Examples
|
||||
example/
|
||||
|
||||
# Django stuff:
|
||||
*.log
|
||||
local_settings.py
|
||||
db.sqlite3
|
||||
db.sqlite3-journal
|
||||
|
||||
# Flask stuff:
|
||||
instance/
|
||||
.webassets-cache
|
||||
|
||||
# Scrapy stuff:
|
||||
.scrapy
|
||||
|
||||
# Sphinx documentation
|
||||
docs/_build/
|
||||
|
||||
# PyBuilder
|
||||
.pybuilder/
|
||||
target/
|
||||
|
||||
# Jupyter Notebook
|
||||
.ipynb_checkpoints
|
||||
|
||||
# IPython
|
||||
profile_default/
|
||||
ipython_config.py
|
||||
|
||||
# pyenv
|
||||
# For a library or package, you might want to ignore these files since the code is
|
||||
# intended to run in multiple environments; otherwise, check them in:
|
||||
# .python-version
|
||||
|
||||
# pipenv
|
||||
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
|
||||
# However, in case of collaboration, if having platform-specific dependencies or dependencies
|
||||
# having no cross-platform support, pipenv may install dependencies that don't work, or not
|
||||
# install all needed dependencies.
|
||||
#Pipfile.lock
|
||||
|
||||
# UV
|
||||
# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
|
||||
# This is especially recommended for binary packages to ensure reproducibility, and is more
|
||||
# commonly ignored for libraries.
|
||||
#uv.lock
|
||||
|
||||
# poetry
|
||||
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
|
||||
# This is especially recommended for binary packages to ensure reproducibility, and is more
|
||||
# commonly ignored for libraries.
|
||||
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
|
||||
#poetry.lock
|
||||
#poetry.toml
|
||||
|
||||
# pdm
|
||||
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
|
||||
# pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
|
||||
# https://pdm-project.org/en/latest/usage/project/#working-with-version-control
|
||||
#pdm.lock
|
||||
#pdm.toml
|
||||
.pdm-python
|
||||
.pdm-build/
|
||||
|
||||
# pixi
|
||||
# Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
|
||||
#pixi.lock
|
||||
# Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
|
||||
# in the .venv directory. It is recommended not to include this directory in version control.
|
||||
.pixi
|
||||
|
||||
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
|
||||
__pypackages__/
|
||||
|
||||
# Celery stuff
|
||||
celerybeat-schedule
|
||||
celerybeat.pid
|
||||
|
||||
# SageMath parsed files
|
||||
*.sage.py
|
||||
|
||||
# Environments
|
||||
.env
|
||||
.envrc
|
||||
.venv
|
||||
env/
|
||||
venv/
|
||||
ENV/
|
||||
env.bak/
|
||||
venv.bak/
|
||||
|
||||
# Spyder project settings
|
||||
.spyderproject
|
||||
.spyproject
|
||||
|
||||
# Rope project settings
|
||||
.ropeproject
|
||||
|
||||
# mkdocs documentation
|
||||
/site
|
||||
|
||||
# mypy
|
||||
.mypy_cache/
|
||||
.dmypy.json
|
||||
dmypy.json
|
||||
|
||||
# Pyre type checker
|
||||
.pyre/
|
||||
|
||||
# pytype static type analyzer
|
||||
.pytype/
|
||||
|
||||
# Cython debug symbols
|
||||
cython_debug/
|
||||
|
||||
# PyCharm
|
||||
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
|
||||
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
|
||||
# and can be added to the global gitignore or merged into this file. For a more nuclear
|
||||
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
|
||||
#.idea/
|
||||
|
||||
# Abstra
|
||||
# Abstra is an AI-powered process automation framework.
|
||||
# Ignore directories containing user credentials, local state, and settings.
|
||||
# Learn more at https://abstra.io/docs
|
||||
.abstra/
|
||||
|
||||
# Visual Studio Code
|
||||
# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
|
||||
# that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
|
||||
# and can be added to the global gitignore or merged into this file. However, if you prefer,
|
||||
# you could uncomment the following to ignore the entire vscode folder
|
||||
# .vscode/
|
||||
|
||||
# Ruff stuff:
|
||||
.ruff_cache/
|
||||
|
||||
# PyPI configuration file
|
||||
.pypirc
|
||||
|
||||
# Cursor
|
||||
# Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
|
||||
# exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
|
||||
# refer to https://docs.cursor.com/context/ignore-files
|
||||
.cursorignore
|
||||
.cursorindexingignore
|
||||
|
||||
# Marimo
|
||||
marimo/_static/
|
||||
marimo/_lsp/
|
||||
__marimo__/
|
||||
|
||||
# Node.js / Frontend
|
||||
node_modules/
|
||||
npm-debug.log
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
frontend/.env
|
||||
|
||||
legacy_admin-edu-space/
|
||||
.vscode/
|
||||
.schemathesis/
|
||||
|
||||
AlumnosLS
|
||||
apuntes
|
||||
|
||||
.credentials
|
||||
.credenciales
|
||||
# Byte-compiled / optimized / DLL files
|
||||
__pycache__/
|
||||
*.py[codz]
|
||||
*$py.class
|
||||
|
||||
# C extensions
|
||||
*.so
|
||||
|
||||
.idea
|
||||
|
||||
# Distribution / packaging
|
||||
.Python
|
||||
build/
|
||||
develop-eggs/
|
||||
dist/
|
||||
downloads/
|
||||
eggs/
|
||||
.eggs/
|
||||
lib/
|
||||
lib64/
|
||||
parts/
|
||||
sdist/
|
||||
var/
|
||||
wheels/
|
||||
share/python-wheels/
|
||||
*.egg-info/
|
||||
.installed.cfg
|
||||
*.egg
|
||||
MANIFEST
|
||||
|
||||
# PyInstaller
|
||||
# Usually these files are written by a python script from a template
|
||||
# before PyInstaller builds the exe, so as to inject date/other infos into it.
|
||||
*.manifest
|
||||
*.spec
|
||||
|
||||
# Installer logs
|
||||
pip-log.txt
|
||||
pip-delete-this-directory.txt
|
||||
|
||||
# Unit test / coverage reports
|
||||
htmlcov/
|
||||
.tox/
|
||||
.nox/
|
||||
.coverage
|
||||
.coverage.*
|
||||
.cache
|
||||
nosetests.xml
|
||||
coverage.xml
|
||||
*.cover
|
||||
*.py.cover
|
||||
.hypothesis/
|
||||
.pytest_cache/
|
||||
cover/
|
||||
|
||||
# Translations
|
||||
*.mo
|
||||
*.pot
|
||||
|
||||
# Examples
|
||||
example/
|
||||
|
||||
# Django stuff:
|
||||
*.log
|
||||
local_settings.py
|
||||
db.sqlite3
|
||||
db.sqlite3-journal
|
||||
|
||||
# Flask stuff:
|
||||
instance/
|
||||
.webassets-cache
|
||||
|
||||
# Scrapy stuff:
|
||||
.scrapy
|
||||
|
||||
# Sphinx documentation
|
||||
docs/_build/
|
||||
|
||||
# PyBuilder
|
||||
.pybuilder/
|
||||
target/
|
||||
|
||||
# Jupyter Notebook
|
||||
.ipynb_checkpoints
|
||||
|
||||
# IPython
|
||||
profile_default/
|
||||
ipython_config.py
|
||||
|
||||
# pyenv
|
||||
# For a library or package, you might want to ignore these files since the code is
|
||||
# intended to run in multiple environments; otherwise, check them in:
|
||||
# .python-version
|
||||
|
||||
# pipenv
|
||||
# According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
|
||||
# However, in case of collaboration, if having platform-specific dependencies or dependencies
|
||||
# having no cross-platform support, pipenv may install dependencies that don't work, or not
|
||||
# install all needed dependencies.
|
||||
#Pipfile.lock
|
||||
|
||||
# UV
|
||||
# Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
|
||||
# This is especially recommended for binary packages to ensure reproducibility, and is more
|
||||
# commonly ignored for libraries.
|
||||
#uv.lock
|
||||
|
||||
# poetry
|
||||
# Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
|
||||
# This is especially recommended for binary packages to ensure reproducibility, and is more
|
||||
# commonly ignored for libraries.
|
||||
# https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
|
||||
#poetry.lock
|
||||
#poetry.toml
|
||||
|
||||
# pdm
|
||||
# Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
|
||||
# pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
|
||||
# https://pdm-project.org/en/latest/usage/project/#working-with-version-control
|
||||
#pdm.lock
|
||||
#pdm.toml
|
||||
.pdm-python
|
||||
.pdm-build/
|
||||
|
||||
# pixi
|
||||
# Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
|
||||
#pixi.lock
|
||||
# Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
|
||||
# in the .venv directory. It is recommended not to include this directory in version control.
|
||||
.pixi
|
||||
|
||||
# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
|
||||
__pypackages__/
|
||||
|
||||
# Celery stuff
|
||||
celerybeat-schedule
|
||||
celerybeat.pid
|
||||
|
||||
# SageMath parsed files
|
||||
*.sage.py
|
||||
|
||||
# Environments
|
||||
.env
|
||||
.envrc
|
||||
.venv
|
||||
env/
|
||||
venv/
|
||||
ENV/
|
||||
env.bak/
|
||||
venv.bak/
|
||||
|
||||
# Spyder project settings
|
||||
.spyderproject
|
||||
.spyproject
|
||||
|
||||
# Rope project settings
|
||||
.ropeproject
|
||||
|
||||
# mkdocs documentation
|
||||
/site
|
||||
|
||||
# mypy
|
||||
.mypy_cache/
|
||||
.dmypy.json
|
||||
dmypy.json
|
||||
|
||||
# Pyre type checker
|
||||
.pyre/
|
||||
|
||||
# pytype static type analyzer
|
||||
.pytype/
|
||||
|
||||
# Cython debug symbols
|
||||
cython_debug/
|
||||
|
||||
# PyCharm
|
||||
# JetBrains specific template is maintained in a separate JetBrains.gitignore that can
|
||||
# be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
|
||||
# and can be added to the global gitignore or merged into this file. For a more nuclear
|
||||
# option (not recommended) you can uncomment the following to ignore the entire idea folder.
|
||||
#.idea/
|
||||
|
||||
# Abstra
|
||||
# Abstra is an AI-powered process automation framework.
|
||||
# Ignore directories containing user credentials, local state, and settings.
|
||||
# Learn more at https://abstra.io/docs
|
||||
.abstra/
|
||||
|
||||
# Visual Studio Code
|
||||
# Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore
|
||||
# that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
|
||||
# and can be added to the global gitignore or merged into this file. However, if you prefer,
|
||||
# you could uncomment the following to ignore the entire vscode folder
|
||||
# .vscode/
|
||||
|
||||
# Ruff stuff:
|
||||
.ruff_cache/
|
||||
|
||||
# PyPI configuration file
|
||||
.pypirc
|
||||
|
||||
# Cursor
|
||||
# Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
|
||||
# exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
|
||||
# refer to https://docs.cursor.com/context/ignore-files
|
||||
.cursorignore
|
||||
.cursorindexingignore
|
||||
|
||||
# Marimo
|
||||
marimo/_static/
|
||||
marimo/_lsp/
|
||||
__marimo__/
|
||||
|
||||
# Node.js / Frontend
|
||||
node_modules/
|
||||
npm-debug.log
|
||||
.env
|
||||
.env.*
|
||||
!.env.example
|
||||
frontend/.env
|
||||
|
||||
legacy_admin-edu-space/
|
||||
.vscode/
|
||||
.schemathesis/
|
||||
|
||||
AlumnosLS
|
||||
apuntes
|
||||
|
||||
.credentials
|
||||
.credenciales
|
||||
participantes_export.json
|
||||
*export.json␍
|
||||
@@ -11,6 +11,19 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
|
||||
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
|
||||
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
|
||||
|
||||
## [3.5.1] - 2026-10-16
|
||||
### Agregado & Mejorado (Replicador de Moodle Producción a Entorno Local con Usuarios y Correos Reales)
|
||||
- **Skill y Script de Replicación (`.agents/skills/moodle-replicator/SKILL.md` & `scripts/moodle_replicator.py`):**
|
||||
- Autenticación automatizada en Moodle Producción (`https://campus.udelaciudad.edu.ar/`) mediante extracción de `logintoken` pre-sesión.
|
||||
- Extracción híbrida: descarga masiva JSON vía `action_redir.php` + scraping optimizado de perfiles de usuario.
|
||||
- **Correos Electrónicos Reales**: Consulta concurrente de perfiles para capturar el email real y personal de cada estudiante y docente (omitiendo emails sintéticos o inventados).
|
||||
- **Mocking Determinístico de DNI**: Generación de DNI de 8 dígitos (`90{moodle_id:06d}`) como `username` y `password` para el entorno local, preservando el DNI real de Carlos Tello (`34247025`).
|
||||
- **Carga en Moodle Local (`10.0.0.207`)**: Creación y actualización de cuentas mediante `core_user_create_users` y `core_user_update_users` con enrolamiento manual (`enrol_manual_enrol_users`) con roles de estudiante (`student`, ID 5) y profesor (`editingteacher`, ID 3).
|
||||
- 504 matriculaciones completadas exitosamente en 4 cursos: Carrera Lic. en Tecnologías Digitales (922 -> 19), ASIG00124 (5311 -> 16), ASIG00126 (5313 -> 17) y ASIG00127 (5314 -> 18).
|
||||
- Verificación de login exitosa de alumnos en Moodle local (`http://10.0.0.207/moodle/login/index.php`).
|
||||
- **Especificación SDD (`specs/002-moodle-export-sync/`):**
|
||||
- `spec.md` con 6 Requisitos Funcionales en sintaxis EARS, plan de arquitectura y tareas verificables completadas al 100%.
|
||||
|
||||
## [3.5.0] - 2026-10-16
|
||||
### Agregado & Mejorado (Cierre Formal MVP Bedelía & Adopción Metodología SDD / Arnés de IA)
|
||||
- **Arnés de Ingeniería de Software con IA (Harness Engineering):**
|
||||
|
||||
@@ -192,11 +192,27 @@ Memoria del proyecto entre sesiones para la rama `dev`.
|
||||
- 52 pruebas de backend ejecutadas con 100% de éxito en pytest (`52 passed`).
|
||||
- Versión incrementada a `v3.5.0` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
|
||||
|
||||
- **Despliegue y Sincronización en Producción v3.5.0 (Completado)**:
|
||||
- Sincronización completa de ramas en Gitea: Se actualizó `main` (rama por defecto visible en la web de Gitea) mediante fast-forward desde `dev` y se ejecutó `git push origin main`. Ambas ramas `main` y `dev` están alineadas en el commit `39c80f5`.
|
||||
- Despliegue en Servidor LXC (`10.0.0.217`): En `/opt/admin-edu-space` se ejecutó `git pull origin main` (fast-forward limpio), se aseguraron permisos para `eduspace:eduspace` y se reiniciaron los servicios `admin-edu-space-backend` y `admin-edu-space-frontend`.
|
||||
- Verificación en caliente: HTTP 200 en `https://eduspace.oemspot.com.ar/version` confirmando `{"app":"3.5.0","frontend":"3.5.0","backend":"3.5.0","status":"ok"}`.
|
||||
- **Sprint v3.5.1: Exportación y Replicación Moodle Producción a Local con Usuarios y Emails Reales**:
|
||||
- **Especificación SDD (`specs/002-moodle-export-sync/`)**: Creados `spec.md` (6 RF en EARS), `plan.md` y `tasks.md` (todas las tareas completadas).
|
||||
- **Extracción Híbrida y Concurrente con Emails Reales**:
|
||||
- `scripts/moodle_replicator.py` se autentica en `https://campus.udelaciudad.edu.ar/` con `logintoken` dinámico.
|
||||
- Obtiene la nómina masiva estructurada vía `/user/action_redir.php` (`download_participants&dataformat=json`).
|
||||
- Consulta de forma concurrente (ThreadPool con 10 workers) los perfiles de los usuarios (`user/view.php`) extrayendo sus correos personales y reales (`@gmail.com`, `@hotmail.com`, etc.), eliminando cualquier generación de emails inventados.
|
||||
- Normalización fonética/ortográfica sin acentos (`normalize_name`) para vincular con 100% de precisión docentes y estudiantes entre HTML y JSON.
|
||||
- **Reglas de Acceso y DNI Determinístico**:
|
||||
- DNI de 8 dígitos determinístico derivado del ID de Moodle (`90{moodle_id:06d}`), asignado idénticamente como `username` y `password` para pruebas locales.
|
||||
- Preservado el DNI y correo real de Carlos Tello (`34247025`, `carlostellocba@gmail.com`).
|
||||
- **Carga en Moodle Local (`10.0.0.207`)**:
|
||||
- Creación y actualización de usuarios mediante Moodle REST API (`core_user_create_users`, `core_user_update_users`).
|
||||
- 504 matriculaciones completadas exitosamente en los 4 cursos oficiales:
|
||||
* Carrera Lic. en Tecnologías Digitales (CCC): ID Prod 922 -> ID Local 19 (194 alumnos).
|
||||
* ASIG00124 - Sistemas Digitales_2/2026: ID Prod 5311 -> ID Local 16 (131 alumnos y 2 profesores).
|
||||
* ASIG00126 - Seguridad de la Información_2/2026: ID Prod 5313 -> ID Local 17 (138 alumnos y 2 profesores).
|
||||
* ASIG00127 - Programación de Vanguardia - E1_2/2026: ID Prod 5314 -> ID Local 18 (41 alumnos y 2 profesores).
|
||||
- Desactivada la política restrictiva de contraseñas (`passwordpolicy=0`) en el entorno de pruebas local para permitir contraseñas numéricas idénticas al DNI.
|
||||
- Verificación exitosa de login de estudiante en `http://10.0.0.207/moodle/login/index.php`.
|
||||
- **Skill de Automatización**: Creada `.agents/skills/moodle-replicator/SKILL.md` con manual operativo y comandos CLI.
|
||||
|
||||
## Próximos pasos
|
||||
1. Realizar la prueba de aceptación en vivo con el personal de Bedelía imprimiendo y exportando la cartelera real (`/schedule/today`).
|
||||
2. Continuar con el siguiente ciclo SDD para las funcionalidades post-MVP según el roadmap.
|
||||
1. Validar la integración del frontend de Admin Edu Space con la API de Moodle local utilizando los usuarios y asignaturas replicadas.
|
||||
2. Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.
|
||||
@@ -4,7 +4,7 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor
|
||||
|
||||
El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo.
|
||||
|
||||
**Versión Actual:** `3.5.0` (Cierre Formal MVP Bedelía, SDD & Despliegue Continuo con `.credenciales`)
|
||||
**Versión Actual:** `3.5.1` (Replicador de Moodle con Usuarios y Emails Reales, SDD & Despliegue Continuo)
|
||||
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
||||
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
|
||||
|
||||
|
||||
+1
-1
@@ -2,7 +2,7 @@
|
||||
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
|
||||
|
||||
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
||||
**Versión:** 3.5.0 (Cierre Formal MVP Bedelía, SDD & Exportador de Cartelera)
|
||||
**Versión:** 3.5.1 (Replicador de Moodle con Usuarios y Emails Reales, SDD & Despliegue Continuo)
|
||||
**Fecha de Actualización:** 16 de Octubre de 2026
|
||||
**Rama Base:** `dev`
|
||||
|
||||
|
||||
@@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _
|
||||
from config.config import Config
|
||||
|
||||
# Initialize extensions
|
||||
__version__ = "3.5.0"
|
||||
__version__ = "3.5.1"
|
||||
db = SQLAlchemy()
|
||||
migrate = Migrate()
|
||||
cors = CORS()
|
||||
|
||||
@@ -7,7 +7,7 @@ OPENAPI_SPEC = {
|
||||
"info": {
|
||||
"title": "Edu-Space REST API",
|
||||
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
|
||||
"version": "3.5.0"
|
||||
"version": "3.5.1"
|
||||
},
|
||||
"servers": [
|
||||
{
|
||||
|
||||
+1
-1
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
|
||||
|
||||
setup(
|
||||
name="edu-space-admin",
|
||||
version="3.5.0",
|
||||
version="3.5.1",
|
||||
description="Administrative interface for Edu-Space Classroom Management System",
|
||||
author="Edu-Space Development Team",
|
||||
author_email="admin@edu-space.com",
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
{
|
||||
"name": "frontend",
|
||||
"version": "3.5.0",
|
||||
"version": "3.5.1",
|
||||
"description": "",
|
||||
"main": "index.js",
|
||||
"scripts": {
|
||||
|
||||
+3
-3
@@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
|
||||
});
|
||||
|
||||
// Versiones institucionales del sistema
|
||||
const APP_VERSION = '3.5.0';
|
||||
const FRONTEND_VERSION = '3.5.0';
|
||||
const BACKEND_VERSION = '3.5.0';
|
||||
const APP_VERSION = '3.5.1';
|
||||
const FRONTEND_VERSION = '3.5.1';
|
||||
const BACKEND_VERSION = '3.5.1';
|
||||
|
||||
env.addGlobal('app_version', APP_VERSION);
|
||||
env.addGlobal('frontend_version', FRONTEND_VERSION);
|
||||
|
||||
@@ -0,0 +1,561 @@
|
||||
#!/usr/bin/env python3
|
||||
# -*- coding: utf-8 -*-
|
||||
"""
|
||||
Moodle Replicator: Exportación de Datos de Moodle Producción a Entorno Local.
|
||||
Replica usuarios, carreras, materias y matriculaciones desde Moodle UniCABA (Producción)
|
||||
hacia el Moodle Local (10.0.0.207) para pruebas con Admin Edu Space.
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
import re
|
||||
import json
|
||||
import argparse
|
||||
import unicodedata
|
||||
from typing import Dict, List, Any, Optional
|
||||
import requests
|
||||
|
||||
# Mapa de correspondencia oficial entre Producción y Local
|
||||
COURSE_MAPPING = {
|
||||
187: {
|
||||
'name': 'Escuela de Tecnología e Industrias Digitales (Sala de estudiantes)',
|
||||
'shortname': 'Sala de estudiantes',
|
||||
'local_id': 3,
|
||||
'type': 'faculty'
|
||||
},
|
||||
922: {
|
||||
'name': 'Mi carrera - Lic. en Tecnologías Digitales (CCC)',
|
||||
'shortname': 'Mi carrera - Lic. en Tecnologías Digitales (CCC)',
|
||||
'local_id': 19,
|
||||
'type': 'career'
|
||||
},
|
||||
5311: {
|
||||
'name': 'ASIG00124 - Sistemas Digitales_2/2026',
|
||||
'shortname': 'ASIG00124 - Sistemas Digitales_2/2026',
|
||||
'local_id': 16,
|
||||
'type': 'subject'
|
||||
},
|
||||
5313: {
|
||||
'name': 'ASIG00126 - Seguridad de la Información_2/2026',
|
||||
'shortname': 'ASIG00126 - Seguridad de la Información_2/2026',
|
||||
'local_id': 17,
|
||||
'type': 'subject'
|
||||
},
|
||||
5314: {
|
||||
'name': 'ASIG00127 - Programación de Vanguardia - E1_2/2026',
|
||||
'shortname': 'ASIG00127 - Programación de Vanguardia - E1_2/2026',
|
||||
'local_id': 18,
|
||||
'type': 'subject'
|
||||
}
|
||||
}
|
||||
|
||||
|
||||
def slugify(text: str) -> str:
|
||||
"""Normaliza texto para generar nombres de usuario o correos legibles."""
|
||||
if not text:
|
||||
return ""
|
||||
text = unicodedata.normalize('NFKD', text).encode('ascii', 'ignore').decode('utf-8')
|
||||
text = re.sub(r'[^\w\s-]', '', text.lower()).strip()
|
||||
return re.sub(r'[-\s]+', '.', text)
|
||||
|
||||
|
||||
def normalize_name(text: str) -> str:
|
||||
"""Normaliza nombres eliminando acentos y espacios múltiples para matching robusto."""
|
||||
if not text:
|
||||
return ""
|
||||
text = unicodedata.normalize('NFKD', text).encode('ascii', 'ignore').decode('utf-8')
|
||||
return re.sub(r'\s+', ' ', text).strip().upper()
|
||||
|
||||
|
||||
class CredentialsLoader:
|
||||
"""Carga credenciales desde el archivo .credenciales."""
|
||||
|
||||
@staticmethod
|
||||
def load(file_path: str = ".credenciales") -> Dict[str, str]:
|
||||
creds = {
|
||||
'prod_url': 'https://campus.udelaciudad.edu.ar',
|
||||
'prod_user': '',
|
||||
'prod_pass': '',
|
||||
'local_url': 'http://10.0.0.207/moodle',
|
||||
'local_token': '810428346d3601c68a37a315fcba8d4391629f46'
|
||||
}
|
||||
|
||||
if not os.path.exists(file_path):
|
||||
return creds
|
||||
|
||||
with open(file_path, 'r', encoding='utf-8', errors='ignore') as f:
|
||||
lines = f.readlines()
|
||||
|
||||
is_prod = False
|
||||
is_token = False
|
||||
for line in lines:
|
||||
line_str = line.strip()
|
||||
if "Login Moodle del Campus UniCABA en producción" in line_str:
|
||||
is_prod = True
|
||||
continue
|
||||
if is_prod:
|
||||
if line_str.startswith("user:"):
|
||||
creds['prod_user'] = line_str.split(":", 1)[1].strip()
|
||||
elif line_str.startswith("pass:"):
|
||||
creds['prod_pass'] = line_str.split(":", 1)[1].strip()
|
||||
if line_str.startswith("token:"):
|
||||
creds['local_token'] = line_str.split(":", 1)[1].strip()
|
||||
|
||||
return creds
|
||||
|
||||
|
||||
class MoodleProdExtractor:
|
||||
"""Extrae participantes de Moodle Producción mediante sesión web y scraping híbrido."""
|
||||
|
||||
def __init__(self, base_url: str, user: str, password: str):
|
||||
self.base_url = base_url.rstrip('/')
|
||||
self.user = user
|
||||
self.password = password
|
||||
self.session = requests.Session()
|
||||
self.session.headers.update({
|
||||
'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36',
|
||||
'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
|
||||
'Accept-Language': 'es-AR,es;q=0.9',
|
||||
})
|
||||
self.authenticated = False
|
||||
self.email_cache: Dict[int, str] = {}
|
||||
|
||||
def fetch_real_emails(self, users: List[Dict[str, Any]], course_id: int) -> None:
|
||||
"""Descarga de forma concurrente los correos electrónicos REALES desde los perfiles de Moodle Producción."""
|
||||
to_fetch = [u for u in users if u.get('moodle_id') and u['moodle_id'] not in self.email_cache]
|
||||
if to_fetch:
|
||||
print(f"[*] Obteniendo correos electrónicos reales para {len(to_fetch)} participantes desde sus perfiles...")
|
||||
|
||||
def _get_single_email(uid: int):
|
||||
url = f"{self.base_url}/user/view.php?id={uid}&course={course_id}"
|
||||
try:
|
||||
res = self.session.get(url, timeout=15)
|
||||
if res.status_code == 200:
|
||||
mailtos = [m for m in re.findall(r'mailto:([^"\'>\s]+)', res.text) if m not in ['info@udelaciudad.edu.ar', '.']]
|
||||
if mailtos:
|
||||
return uid, mailtos[0]
|
||||
except Exception:
|
||||
pass
|
||||
return uid, None
|
||||
|
||||
from concurrent.futures import ThreadPoolExecutor
|
||||
with ThreadPoolExecutor(max_workers=10) as executor:
|
||||
future_results = list(executor.map(_get_single_email, [u['moodle_id'] for u in to_fetch]))
|
||||
|
||||
for uid, email in future_results:
|
||||
if email:
|
||||
self.email_cache[uid] = email
|
||||
|
||||
found_count = sum(1 for _, em in future_results if em)
|
||||
print(f"[+] Correos reales obtenidos: {found_count}/{len(to_fetch)} perfiles consultados.")
|
||||
|
||||
# Asignar correos reales a la lista de usuarios
|
||||
for u in users:
|
||||
uid = u.get('moodle_id')
|
||||
if uid and uid in self.email_cache:
|
||||
u['real_email'] = self.email_cache[uid]
|
||||
|
||||
def login(self) -> bool:
|
||||
login_url = f"{self.base_url}/login/index.php"
|
||||
print(f"[*] Obteniendo token de login de producción en {login_url}...")
|
||||
res = self.session.get(login_url, timeout=25)
|
||||
if res.status_code != 200:
|
||||
print(f"[!] Error al acceder a la página de login: HTTP {res.status_code}")
|
||||
return False
|
||||
|
||||
# Extraer logintoken
|
||||
m = re.search(r'name=["\']logintoken["\']\s+value=["\']([^"\']+)["\']', res.text)
|
||||
if not m:
|
||||
m = re.search(r'value=["\']([^"\']+)["\']\s+name=["\']logintoken["\']', res.text)
|
||||
if not m:
|
||||
print("[!] No se encontró el 'logintoken' en la respuesta.")
|
||||
return False
|
||||
|
||||
token = m.group(1)
|
||||
|
||||
payload = {
|
||||
'username': self.user,
|
||||
'password': self.password,
|
||||
'logintoken': token
|
||||
}
|
||||
print(f"[*] Autenticando usuario '{self.user}' en Producción...")
|
||||
post_res = self.session.post(login_url, data=payload, timeout=25, allow_redirects=True)
|
||||
if "loginerrormessage" in post_res.text or ("Inicie sesión en su cuenta" in post_res.text and "my/" not in post_res.url):
|
||||
print("[!] Falla de autenticación en Moodle de Producción. Verifique usuario/contraseña.")
|
||||
return False
|
||||
|
||||
print("[+] Autenticación exitosa en Moodle Producción.")
|
||||
self.authenticated = True
|
||||
return True
|
||||
|
||||
def extract_course_participants(self, course_id: int) -> List[Dict[str, Any]]:
|
||||
"""Extrae la lista completa de participantes para un curso de producción."""
|
||||
if not self.authenticated:
|
||||
raise RuntimeError("Debe autenticarse antes de extraer datos.")
|
||||
|
||||
# Paso 1: Acceder con perpage=5000 para cargar todos los participantes en una sola vista
|
||||
url_all = f"{self.base_url}/user/index.php?page=0&perpage=5000&contextid=0&id={course_id}&newcourse"
|
||||
print(f"[*] Descargando vista de participantes para curso Prod ID {course_id}...")
|
||||
res = self.session.get(url_all, timeout=30)
|
||||
if res.status_code != 200:
|
||||
print(f"[!] Error al cargar curso {course_id}: HTTP {res.status_code}")
|
||||
return []
|
||||
|
||||
# Extraer sesskey
|
||||
m_sk = re.search(r'name=["\']sesskey["\']\s+value=["\']([^"\']+)["\']', res.text)
|
||||
sesskey = m_sk.group(1) if m_sk else ""
|
||||
|
||||
# Extraer checkboxes de usuarios: id="user12345" name="user12345"
|
||||
user_checkboxes = re.findall(r'<input[^>]+id=["\'](user\d+)["\'][^>]*>', res.text)
|
||||
print(f"[+] Detectados {len(user_checkboxes)} participantes en la página del curso.")
|
||||
|
||||
# Paso 2: Intentar descarga estructurada directa JSON mediante /user/action_redir.php
|
||||
json_participants = []
|
||||
if sesskey and user_checkboxes:
|
||||
redir_url = f"{self.base_url}/user/action_redir.php"
|
||||
post_data = {
|
||||
'id': str(course_id),
|
||||
'sesskey': sesskey,
|
||||
'formaction': 'bulkchange.php?operation=download_participants&dataformat=json'
|
||||
}
|
||||
for ucb in user_checkboxes:
|
||||
post_data[ucb] = '1'
|
||||
|
||||
try:
|
||||
r_json = self.session.post(redir_url, data=post_data, timeout=30, allow_redirects=True)
|
||||
if r_json.status_code == 200 and 'application/json' in r_json.headers.get('Content-Type', ''):
|
||||
data = r_json.json()
|
||||
# Moodle a veces retorna [[{user1}, {user2}]]
|
||||
if isinstance(data, list) and len(data) > 0 and isinstance(data[0], list):
|
||||
json_participants = data[0]
|
||||
elif isinstance(data, list):
|
||||
json_participants = data
|
||||
print(f"[+] Descarga nativa JSON exitosa: {len(json_participants)} registros estructurados.")
|
||||
except Exception as e:
|
||||
print(f"[!] Aviso: No se pudo completar la descarga JSON directa ({e}). Usando scraping HTML.")
|
||||
|
||||
# Paso 3: Parsear la tabla HTML de manera lineal y rápida por fragmentos <tr>
|
||||
html_participants_by_name = {}
|
||||
html_participants_by_id = {}
|
||||
|
||||
# Dividir por filas para evitar backtracking catastrófico en cadenas HTML de 3+ MB
|
||||
chunks = res.text.split('<tr')
|
||||
for chunk in chunks[1:]:
|
||||
if 'user/view.php?id=' not in chunk:
|
||||
continue
|
||||
|
||||
m_uid = re.search(r'user/view\.php\?id=(\d+)', chunk)
|
||||
if not m_uid:
|
||||
continue
|
||||
uid = int(m_uid.group(1))
|
||||
|
||||
m_name = re.search(r'<a[^>]*user/view\.php[^>]*>(?:<img[^>]*>)?\s*(.*?)\s*</a>', chunk, re.DOTALL)
|
||||
raw_name = re.sub(r'<[^>]+>', '', m_name.group(1)).strip() if m_name else ''
|
||||
|
||||
m_role = re.search(r'<td[^>]*class=["\'][^"\']*c2[^"\']*["\'][^>]*>(.*?)</td>', chunk, re.DOTALL)
|
||||
raw_role = re.sub(r'<[^>]+>', '', m_role.group(1)).strip() if m_role else 'Estudiante'
|
||||
|
||||
is_teacher = any(k in raw_role.lower() for k in ['profesor', 'docente', 'teacher'])
|
||||
|
||||
entry = {
|
||||
'moodle_id': uid,
|
||||
'fullname': raw_name,
|
||||
'role_text': raw_role,
|
||||
'is_teacher': is_teacher
|
||||
}
|
||||
if raw_name:
|
||||
html_participants_by_name[normalize_name(raw_name)] = entry
|
||||
html_participants_by_id[uid] = entry
|
||||
|
||||
# Paso 4: Fusionar datos estructurados (JSON + HTML)
|
||||
final_list = []
|
||||
if json_participants:
|
||||
for item in json_participants:
|
||||
fn = item.get('nombre', '').strip()
|
||||
ln = item.get('apellidos', '').strip()
|
||||
combined = f"{fn} {ln}"
|
||||
|
||||
matched = html_participants_by_name.get(normalize_name(combined))
|
||||
moodle_id = matched['moodle_id'] if matched else None
|
||||
is_teacher = matched['is_teacher'] if matched else False
|
||||
role_text = matched['role_text'] if matched else 'Estudiante'
|
||||
|
||||
final_list.append({
|
||||
'moodle_id': moodle_id,
|
||||
'firstname': fn,
|
||||
'lastname': ln,
|
||||
'fullname': f"{fn} {ln}".strip(),
|
||||
'role_text': role_text,
|
||||
'is_teacher': is_teacher,
|
||||
'group': item.get('grupos', ''),
|
||||
'course_id': course_id
|
||||
})
|
||||
else:
|
||||
# Respaldo exclusivo HTML
|
||||
for entry in html_participants_by_id.values():
|
||||
name_parts = entry['fullname'].split()
|
||||
if len(name_parts) >= 2:
|
||||
fn = " ".join(name_parts[:-1])
|
||||
ln = name_parts[-1]
|
||||
else:
|
||||
fn = entry['fullname']
|
||||
ln = entry['fullname']
|
||||
|
||||
final_list.append({
|
||||
'moodle_id': entry['moodle_id'],
|
||||
'firstname': fn,
|
||||
'lastname': ln,
|
||||
'fullname': entry['fullname'],
|
||||
'role_text': entry['role_text'],
|
||||
'is_teacher': entry['is_teacher'],
|
||||
'group': '',
|
||||
'course_id': course_id
|
||||
})
|
||||
|
||||
# Paso 5: Obtener los correos electrónicos reales desde los perfiles en Moodle Producción
|
||||
self.fetch_real_emails(final_list, course_id)
|
||||
|
||||
print(f"[+] Total procesado para curso {course_id}: {len(final_list)} participantes.")
|
||||
return final_list
|
||||
|
||||
|
||||
class MoodleUserTransformer:
|
||||
"""Aplica las reglas de negocio y mocking para el entorno local."""
|
||||
|
||||
@staticmethod
|
||||
def transform_user(user: Dict[str, Any]) -> Dict[str, Any]:
|
||||
"""Genera credenciales con DNI determinístico y asigna el email REAL de producción."""
|
||||
fn = user.get('firstname', '').strip()
|
||||
ln = user.get('lastname', '').strip()
|
||||
moodle_id = user.get('moodle_id')
|
||||
full_upper = f"{fn} {ln}".upper()
|
||||
|
||||
# Regla RF4: Preservar credenciales reales conocidas (Carlos Tello: 34247025)
|
||||
if "CARLOS" in full_upper and "TELLO" in full_upper:
|
||||
dni = "34247025"
|
||||
else:
|
||||
# Regla RF3: DNI de 8 dígitos determinístico: prefijo 90 + ID Moodle a 6 dígitos
|
||||
if moodle_id:
|
||||
dni = f"90{moodle_id:06d}"
|
||||
else:
|
||||
import hashlib
|
||||
h = int(hashlib.md5(full_upper.encode('utf-8')).hexdigest()[:6], 16) % 1000000
|
||||
dni = f"90{h:06d}"
|
||||
|
||||
# Correo electrónico REAL extraído del perfil de producción
|
||||
real_email = user.get('real_email')
|
||||
if real_email:
|
||||
email = real_email
|
||||
elif "CARLOS" in full_upper and "TELLO" in full_upper:
|
||||
email = "carlostellocba@gmail.com"
|
||||
else:
|
||||
slug_fn = slugify(fn)
|
||||
slug_ln = slugify(ln)
|
||||
email = f"{slug_fn}.{slug_ln}@unicaba.edu.ar"
|
||||
|
||||
# Rol: editingteacher = 3, student = 5
|
||||
role_id = 3 if user.get('is_teacher') else 5
|
||||
|
||||
return {
|
||||
'username': dni,
|
||||
'password': dni, # RF3: Documento tanto como username como password
|
||||
'firstname': fn if fn else 'Usuario',
|
||||
'lastname': ln if ln else 'UniCABA',
|
||||
'fullname': f"{fn} {ln}".strip(),
|
||||
'email': email,
|
||||
'auth': 'manual',
|
||||
'dni': dni,
|
||||
'role_id': role_id,
|
||||
'is_teacher': user.get('is_teacher', False),
|
||||
'course_id': user.get('course_id')
|
||||
}
|
||||
|
||||
|
||||
class MoodleLocalLoader:
|
||||
"""Interactúa con la API REST de Moodle Local (10.0.0.207) para altas y matriculaciones."""
|
||||
|
||||
def __init__(self, local_url: str, token: str):
|
||||
self.endpoint = f"{local_url.rstrip('/')}/webservice/rest/server.php"
|
||||
self.token = token
|
||||
self.session = requests.Session()
|
||||
self.user_cache: Dict[str, int] = {}
|
||||
|
||||
def call(self, wsfunction: str, params: Dict[str, Any]) -> Any:
|
||||
full_params = {
|
||||
'wstoken': self.token,
|
||||
'wsfunction': wsfunction,
|
||||
'moodlewsrestformat': 'json',
|
||||
**params
|
||||
}
|
||||
res = self.session.post(self.endpoint, data=full_params, timeout=25)
|
||||
try:
|
||||
return res.json()
|
||||
except Exception:
|
||||
return {'error': res.text, 'status_code': res.status_code}
|
||||
|
||||
def get_or_create_user(self, user_data: Dict[str, Any]) -> Optional[int]:
|
||||
"""Obtiene el ID local de un usuario por username o lo crea si no existe (con caché en memoria)."""
|
||||
username = user_data['username']
|
||||
if username in self.user_cache:
|
||||
return self.user_cache[username]
|
||||
|
||||
# Buscar si ya existe
|
||||
query_res = self.call('core_user_get_users', {
|
||||
'criteria[0][key]': 'username',
|
||||
'criteria[0][value]': username
|
||||
})
|
||||
|
||||
if isinstance(query_res, dict) and 'users' in query_res and len(query_res['users']) > 0:
|
||||
uid = query_res['users'][0]['id']
|
||||
self.user_cache[username] = uid
|
||||
# Actualizar con el correo real de producción si difiere del actual
|
||||
current_email = query_res['users'][0].get('email', '')
|
||||
target_email = user_data.get('email', '')
|
||||
if target_email and current_email != target_email:
|
||||
self.call('core_user_update_users', {
|
||||
'users[0][id]': uid,
|
||||
'users[0][email]': target_email
|
||||
})
|
||||
return uid
|
||||
|
||||
# Crear usuario si no existe
|
||||
create_payload = {
|
||||
'users[0][username]': username,
|
||||
'users[0][password]': user_data['password'],
|
||||
'users[0][firstname]': user_data['firstname'],
|
||||
'users[0][lastname]': user_data['lastname'],
|
||||
'users[0][email]': user_data['email'],
|
||||
'users[0][auth]': 'manual'
|
||||
}
|
||||
|
||||
create_res = self.call('core_user_create_users', create_payload)
|
||||
if isinstance(create_res, list) and len(create_res) > 0 and 'id' in create_res[0]:
|
||||
uid = create_res[0]['id']
|
||||
self.user_cache[username] = uid
|
||||
return uid
|
||||
|
||||
print(f"[!] Error al crear usuario {username}: {create_res}")
|
||||
return None
|
||||
|
||||
def enrol_user(self, local_user_id: int, local_course_id: int, role_id: int) -> bool:
|
||||
"""Matricula a un usuario en un curso con el rol especificado."""
|
||||
payload = {
|
||||
'enrolments[0][roleid]': role_id,
|
||||
'enrolments[0][userid]': local_user_id,
|
||||
'enrolments[0][courseid]': local_course_id
|
||||
}
|
||||
res = self.call('enrol_manual_enrol_users', payload)
|
||||
# Retorna None o vacio en caso de éxito
|
||||
if res is None or res == {} or res == []:
|
||||
return True
|
||||
if isinstance(res, dict) and 'exception' in res:
|
||||
print(f"[!] Error al matricular user {local_user_id} en curso {local_course_id}: {res.get('message')}")
|
||||
return False
|
||||
return True
|
||||
|
||||
|
||||
def run_replication(
|
||||
course_ids: Optional[List[int]] = None,
|
||||
dry_run: bool = False,
|
||||
export_json_path: Optional[str] = None
|
||||
):
|
||||
print("=" * 75)
|
||||
print(" MOODLE REPLICATOR: UniCABA Producción -> Entorno Local (10.0.0.207)")
|
||||
print("=" * 75)
|
||||
|
||||
creds = CredentialsLoader.load()
|
||||
if not creds['prod_user'] or not creds['prod_pass']:
|
||||
print("[!] No se encontraron credenciales de Moodle Producción en .credenciales.")
|
||||
sys.exit(1)
|
||||
|
||||
extractor = MoodleProdExtractor(creds['prod_url'], creds['prod_user'], creds['prod_pass'])
|
||||
if not extractor.login():
|
||||
sys.exit(1)
|
||||
|
||||
loader = None
|
||||
if not dry_run:
|
||||
loader = MoodleLocalLoader(creds['local_url'], creds['local_token'])
|
||||
|
||||
target_courses = course_ids if course_ids else list(COURSE_MAPPING.keys())
|
||||
all_exported_data = {}
|
||||
|
||||
total_created = 0
|
||||
total_enrolled = 0
|
||||
|
||||
for cid in target_courses:
|
||||
course_meta = COURSE_MAPPING.get(cid, {
|
||||
'name': f'Curso Prod {cid}',
|
||||
'local_id': cid
|
||||
})
|
||||
local_course_id = course_meta['local_id']
|
||||
|
||||
print("\n" + "-" * 70)
|
||||
print(f"[*] Procesando: '{course_meta['name']}'")
|
||||
print(f" Prod ID: {cid} -> Local ID: {local_course_id}")
|
||||
print("-" * 70)
|
||||
|
||||
raw_participants = extractor.extract_course_participants(cid)
|
||||
transformed_users = [MoodleUserTransformer.transform_user(u) for u in raw_participants]
|
||||
all_exported_data[cid] = transformed_users
|
||||
|
||||
if dry_run:
|
||||
print(f"[DRY-RUN] Se habrían procesado {len(transformed_users)} usuarios para curso local {local_course_id}.")
|
||||
continue
|
||||
|
||||
print(f"[*] Replicando {len(transformed_users)} usuarios en Moodle Local (10.0.0.207)...")
|
||||
course_enrolled = 0
|
||||
for u in transformed_users:
|
||||
local_uid = loader.get_or_create_user(u)
|
||||
if local_uid:
|
||||
total_created += 1
|
||||
if loader.enrol_user(local_uid, local_course_id, u['role_id']):
|
||||
course_enrolled += 1
|
||||
total_enrolled += 1
|
||||
|
||||
print(f"[+] Curso local {local_course_id}: {course_enrolled}/{len(transformed_users)} usuarios matriculados con éxito.")
|
||||
|
||||
# Guardar exportación JSON si fue solicitada
|
||||
if export_json_path:
|
||||
with open(export_json_path, 'w', encoding='utf-8') as f:
|
||||
json.dump(all_exported_data, f, indent=2, ensure_ascii=False)
|
||||
print(f"\n[+] Datos exportados guardados exitosamente en: {export_json_path}")
|
||||
|
||||
print("\n" + "=" * 75)
|
||||
print(" RESUMEN DE EJECUCIÓN")
|
||||
print("=" * 75)
|
||||
print(f" Cursos procesados: {len(target_courses)}")
|
||||
if not dry_run:
|
||||
print(f" Usuarios en local: {total_created} procesados")
|
||||
print(f" Matriculaciones OK: {total_enrolled}")
|
||||
else:
|
||||
print(" Modo: DRY-RUN (Sin escrituras)")
|
||||
|
||||
print("\n" + "=" * 75)
|
||||
print(" PROFESORES Y EQUIPO DOCENTE IDENTIFICADOS POR MATERIA")
|
||||
print("=" * 75)
|
||||
for cid in target_courses:
|
||||
c_name = COURSE_MAPPING.get(cid, {}).get('name', f'Curso {cid}')
|
||||
c_users = all_exported_data.get(cid, [])
|
||||
c_teachers = [u for u in c_users if u.get('is_teacher') or u.get('role_id') == 3]
|
||||
print(f"\n[+] {c_name} (Prod ID: {cid}) - Docentes: {len(c_teachers)}")
|
||||
if c_teachers:
|
||||
for t in c_teachers:
|
||||
print(f" - {t['fullname']:<28} | Email: {t['email']:<36} | DNI: {t['dni']}")
|
||||
else:
|
||||
print(" (Sin docentes asignados directamente en la vista del curso)")
|
||||
print("=" * 75)
|
||||
|
||||
|
||||
def main():
|
||||
parser = argparse.ArgumentParser(description="Replicador de Moodle Producción a Local para UniCABA.")
|
||||
parser.add_argument('--course', type=int, choices=[187, 922, 5311, 5313, 5314], help="ID del curso específico a procesar.")
|
||||
parser.add_argument('--dry-run', action='store_true', help="Ejecutar en modo simulación sin modificar el Moodle local.")
|
||||
parser.add_argument('--export-json', type=str, help="Ruta de archivo JSON donde guardar el volcado de datos.")
|
||||
args = parser.parse_args()
|
||||
|
||||
course_ids = [args.course] if args.course else None
|
||||
run_replication(course_ids=course_ids, dry_run=args.dry_run, export_json_path=args.export_json)
|
||||
|
||||
|
||||
if __name__ == '__main__':
|
||||
main()
|
||||
@@ -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