diff --git a/.agents/skills/moodle-replicator/SKILL.md b/.agents/skills/moodle-replicator/SKILL.md new file mode 100644 index 0000000..158b60b --- /dev/null +++ b/.agents/skills/moodle-replicator/SKILL.md @@ -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;'" +``` diff --git a/.gitignore b/.gitignore index 869c7e4..7a9ae7c 100644 --- a/.gitignore +++ b/.gitignore @@ -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 \ No newline at end of file +# 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 \ No newline at end of file diff --git a/CHANGELOG.md b/CHANGELOG.md index 0362778..f428bd2 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -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):** diff --git a/MEMORY.md b/MEMORY.md index e273d62..cd47ea0 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -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. \ No newline at end of file +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. \ No newline at end of file diff --git a/README.md b/README.md index 529cc93..9e0c071 100644 --- a/README.md +++ b/README.md @@ -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`) diff --git a/ROADMAP.md b/ROADMAP.md index 2cad560..ffc12c5 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -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` diff --git a/backend/app/__init__.py b/backend/app/__init__.py index 5bd52ad..d604f1d 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -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() diff --git a/backend/app/routes/api/openapi.py b/backend/app/routes/api/openapi.py index 650389b..7765ecb 100644 --- a/backend/app/routes/api/openapi.py +++ b/backend/app/routes/api/openapi.py @@ -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": [ { diff --git a/backend/setup.py b/backend/setup.py index 41c0684..563ce03 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -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", diff --git a/frontend/package.json b/frontend/package.json index 70770f7..7465786 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.5.0", + "version": "3.5.1", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/src/app.js b/frontend/src/app.js index 6783392..20a16c1 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -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); diff --git a/scripts/moodle_replicator.py b/scripts/moodle_replicator.py new file mode 100644 index 0000000..7e9c406 --- /dev/null +++ b/scripts/moodle_replicator.py @@ -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']+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