Compare commits
16
Commits
39c80f573b
...
main
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
5057d648c9 | ||
|
|
76647e228b | ||
|
|
e1cc2d1212 | ||
|
|
6d43b2fd66 | ||
|
|
940119edc4 | ||
|
|
ac1e94b927 | ||
|
|
1560bc2a67 | ||
|
|
1e6faa1301 | ||
|
|
cf368036a6 | ||
|
|
fe5acb6119 | ||
|
|
06306c372a | ||
|
|
b2a4f878d8 | ||
|
|
6b0d0bbc77 | ||
|
|
6cb75722f2 | ||
|
|
0828c93edd | ||
|
|
0ca5688b47 |
@@ -9,14 +9,23 @@ Esta skill define el protocolo obligatorio para consolidar, versionar, publicar
|
|||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
## Principio Rector (Principio 9 de la Constitución)
|
## Principio Rector (Principios 9 y 10 de la Constitución)
|
||||||
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
|
Toda tarea concluida que modifique funcionalidad, corrija errores o altere la interfaz debe:
|
||||||
|
0. **Tolerancia Cero a Errores en Código (`@[current_problems]`):** Es mandatorio verificar y resolver al 100% cualquier error de linter, compilación, imports o advertencias críticas antes de compilar o empaquetar. Nunca dar una tarea por terminada si hay errores en el código.
|
||||||
1. **Subir la versión semántica** de forma coordinada.
|
1. **Subir la versión semántica** de forma coordinada.
|
||||||
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev`).
|
2. **Ejecutar `git push`** al repositorio remoto en la rama activa (`dev` y `main`).
|
||||||
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
|
3. **Desplegar inmediatamente en producción** en el servidor institucional utilizando las credenciales registradas en `.credenciales`.
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
|
## Paso 0: Verificación de Código Limpio (Zero Errors)
|
||||||
|
Antes de proceder con el bump de versión:
|
||||||
|
- Inspeccionar y limpiar todos los problemas reportados en `@[current_problems]`.
|
||||||
|
- Ejecutar suite de pruebas: `cd backend && .\venv\Scripts\python.exe -m pytest tests -v`.
|
||||||
|
- Verificar que el compilador no reporte errores de sintaxis ni de tipos: `py_compile`.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
## Paso 1: Bump Semántico de Versión
|
## Paso 1: Bump Semántico de Versión
|
||||||
Incrementar la versión siguiendo SemVer (`X.Y.Z`) en todos los descriptores del proyecto:
|
Incrementar la versión siguiendo SemVer (`X.Y.Z`) en todos los descriptores del proyecto:
|
||||||
- `frontend/package.json` (`"version": "X.Y.Z"`)
|
- `frontend/package.json` (`"version": "X.Y.Z"`)
|
||||||
|
|||||||
@@ -0,0 +1,87 @@
|
|||||||
|
---
|
||||||
|
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 (16 Cursos de la Carrera)
|
||||||
|
|
||||||
|
| Entidad | Nombre Oficial | ID Producción | ID Local |
|
||||||
|
| :--- | :--- | :---: | :---: |
|
||||||
|
| **Carrera** | Mi carrera - Lic. en Tecnologías Digitales (CCC) | `922` | `19` |
|
||||||
|
| **Escuela** | Escuela de Tecnología e Industrias Digitales | `187` | `3` |
|
||||||
|
| **Materia 1/2025** | ASIG00120 - Gestión de Sistemas de Información_1/2025 | `3218` | `4` |
|
||||||
|
| **Materia 1/2025** | ASIG00121 - Análisis de Datos I - TEC.DIG._1/2025 | `3220` | `5` |
|
||||||
|
| **Materia 1/2025** | ASIG00122 - Taller: Gestión de Proyectos Digitales - E1_1/2025 | `3221` | `6` |
|
||||||
|
| **Materia 1/2025** | ASIG00215 - Marketing Digital - OPTATIVA -1/2025 | `3665` | `7` |
|
||||||
|
| **Materia 2/2025** | ASIG00123 - Administración de Negocios Digitales_2/2025 | `3945` | `8` |
|
||||||
|
| **Materia 2/2025** | ASIG00124 - Sistemas Digitales_2/2025 | `3944` | `9` |
|
||||||
|
| **Materia 2/2025** | ASIG00125 - Taller: Emprendedurismo en Innovación Digital_2/2025 | `3943` | `10` |
|
||||||
|
| **Materia 2/2025** | ASIG00205 - Gestión del Talento Humano en la Industria digital-2/2025 | `3933` | `11` |
|
||||||
|
| **Materia 1/2026** | ASIG00121 - Análisis de Datos I - TEC.DIG._1/2026 | `4565` | `12` |
|
||||||
|
| **Materia 1/2026** | ASIG00123 - Administración de Negocios Digitales_1/2026 | `4569` | `13` |
|
||||||
|
| **Materia 1/2026** | ASIG00125 - Taller: Emprendedurismo en Innovación Digital_1/2026 | `4571` | `14` |
|
||||||
|
| **Materia 1/2026** | ASIG00296 - Gestión de Redes Informáticas - Equipo 1_1/2026 | `4582` | `15` |
|
||||||
|
| **Materia 2/2026** | ASIG00124 - Sistemas Digitales_2/2026 | `5311` | `16` |
|
||||||
|
| **Materia 2/2026** | ASIG00126 - Seguridad de la Información_2/2026 | `5313` | `17` |
|
||||||
|
| **Materia 2/2026** | ASIG00127 - Programación de Vanguardia - E1_2/2026 | `5314` | `18` |
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## 2. Reglas de Negocio, User-Agent y Mocking
|
||||||
|
|
||||||
|
1. **User-Agent y Credenciales en Producción**:
|
||||||
|
- Cabecera HTTP fija: `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)`.
|
||||||
|
- 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;'"
|
||||||
|
```
|
||||||
@@ -62,5 +62,7 @@ Todo Requisito Funcional (RF) debe redactarse usando exclusivamente una de las 5
|
|||||||
2. **Tareas pequeñas**: Cada tarea en `tasks.md` debe tener una duración estimada de 20-30 minutos y contar con su criterio *"Hecho cuando:"*.
|
2. **Tareas pequeñas**: Cada tarea en `tasks.md` debe tener una duración estimada de 20-30 minutos y contar con su criterio *"Hecho cuando:"*.
|
||||||
3. **Test-First**: En la lógica de backend, escribir primero el test en rojo antes de tocar el código de la solución.
|
3. **Test-First**: En la lógica de backend, escribir primero el test en rojo antes de tocar el código de la solución.
|
||||||
4. **Validación RF por RF**: Al finalizar, verificar cada RF de la especificación contra los tests y la interfaz gráfica.
|
4. **Validación RF por RF**: Al finalizar, verificar cada RF de la especificación contra los tests y la interfaz gráfica.
|
||||||
5. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
|
5. **Tolerancia Cero a Errores de Código (`@[current_problems]`) (Principio 10 de la Constitución)**: Es estrictamente inadmisible declarar una tarea o spec como completada si persisten errores en la terminal o problemas de diagnóstico. Todos los errores de importación, narrowing de tipos, NoneType y linter deben ser resueltos antes de dar el veredicto de aprobación.
|
||||||
6. **Bump de Versión, Git Push y Despliegue en Producción (Skill `deploy`)**: Conforme al Principio 9 de la Constitución, incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `CHANGELOG.md`), ejecutar `git push origin dev` al repositorio remoto y desplegar en producción al servidor institucional LXC (`10.0.0.217`) utilizando las credenciales de `.credenciales`.
|
6. **Diseño Modular y Contratos Fuertes (Principio 11 de la Constitución)**: Toda nueva API o endpoint debe dividirse en 4 capas desacopladas (`main.py`, `routers/`, `schemas/`, `storage.py`), usar `Pydantic` (`BaseModel` + `Field`) para validar bodies y query params con tipado estricto, levantar `HTTPException` controladas (404/422/400) sin retornar `null` ante fallos, y documentarse automáticamente en Swagger UI (`/docs`). Las integraciones con modelos de lenguaje (LLMs) deben implementarse con clientes asíncronos `httpx`, timeouts generosos (600s), formato estándar de roles e integrarse con la pestaña de IA en Configuración Global.
|
||||||
|
7. **Memoria**: Al completar cada fase o entrega, actualizar `MEMORY.md`.
|
||||||
|
8. **Bump de Versión, Git Push y Despliegue en Producción (Skill `deploy`)**: Conforme al Principio 9 de la Constitución, incrementar versión semántica (`package.json`, `app.js`, `__init__.py`, `CHANGELOG.md`), ejecutar `git push origin dev` al repositorio remoto y desplegar en producción al servidor institucional LXC (`10.0.0.217`) utilizando las credenciales de `.credenciales`.
|
||||||
|
|||||||
@@ -228,3 +228,5 @@ apuntes
|
|||||||
|
|
||||||
.credentials
|
.credentials
|
||||||
.credenciales
|
.credenciales
|
||||||
|
participantes_export.json
|
||||||
|
*export.json␍
|
||||||
@@ -12,4 +12,4 @@ Tu misión es guiar el avance hacia la entrega del MVP de Bedelía asegurando el
|
|||||||
3. **Plan y Tareas**: Delegar en `@planner` la confección de `plan.md` y `tasks.md`.
|
3. **Plan y Tareas**: Delegar en `@planner` la confección de `plan.md` y `tasks.md`.
|
||||||
4. **Implementación**: Delegar en `@implementer` una tarea atómica a la vez.
|
4. **Implementación**: Delegar en `@implementer` una tarea atómica a la vez.
|
||||||
5. **Validación**: Delegar en `@reviewer` la validación RF por RF.
|
5. **Validación**: Delegar en `@reviewer` la validación RF por RF.
|
||||||
6. **Despliegue y Memoria**: Verificar tests en verde (`pytest tests -v`), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución.
|
6. **Despliegue y Memoria**: Verificar tests en verde (`pytest tests -v`), asegurar cero errores en `@[current_problems]` (Principio 10: no es admisible dar una tarea o hito por completado con errores), validar estándares del Principio 11 (arquitectura modular, contratos Pydantic e IA asíncrona), actualizar `MEMORY.md` y cumplir con el Principio 9 de la Constitución (bump, git push y despliegue continuo).
|
||||||
|
|||||||
@@ -10,4 +10,6 @@ Tu misión es ejecutar UNA tarea específica de `tasks.md` sin rediseñar el pla
|
|||||||
- Lee la tarea asignada, `plan.md`, `docs/constitution.md` y `AGENTS.md`.
|
- Lee la tarea asignada, `plan.md`, `docs/constitution.md` y `AGENTS.md`.
|
||||||
- Enfoque **Test-First**: si tocas lógica de negocio, crea o ajusta primero la prueba automatizada en `backend/tests/`.
|
- Enfoque **Test-First**: si tocas lógica de negocio, crea o ajusta primero la prueba automatizada en `backend/tests/`.
|
||||||
- Ejecuta las pruebas (`python -m pytest tests -v` en backend) y asegura 100% de éxito.
|
- Ejecuta las pruebas (`python -m pytest tests -v` en backend) y asegura 100% de éxito.
|
||||||
- Marca la tarea con `[x]` en `tasks.md` al terminar y detén tu ejecución para supervisión.
|
- **Principio 10 (Tolerancia Cero)**: Repara activamente todos los problemas reportados en la terminal o Language Server (`@[current_problems]`). Es estrictamente inadmisible decir que una tarea está terminada o completada si hay errores o fallos en el código.
|
||||||
|
- **Principio 11 (Arquitectura de APIs y LLMs)**: Diseña APIs modulares (`main.py`, `routers/`, `schemas/`, `storage.py`), utiliza Pydantic (`BaseModel` + `Field`) para validar bodies y query params tipados, responde con códigos de estado HTTP explícitos (201/200/204/404/422), levanta `HTTPException` descriptivas sin retornar `null` en fallos y utiliza `httpx` asíncrono con timeouts generosos (600s) para llamadas a modelos de lenguaje (LLMs).
|
||||||
|
- Marca la tarea con `[x]` en `tasks.md` al terminar únicamente si no hay ningún error y detén tu ejecución para supervisión.
|
||||||
|
|||||||
@@ -11,4 +11,5 @@ Tu objetivo es redactar especificaciones precisas, arquitecturas limpias y lista
|
|||||||
- Escribe las especificaciones en `specs/NNN-nombre/spec.md` con sintaxis EARS en español.
|
- Escribe las especificaciones en `specs/NNN-nombre/spec.md` con sintaxis EARS en español.
|
||||||
- Nunca incluyas nombres de archivos ni detalles de base de datos en `spec.md` (van en `plan.md`).
|
- Nunca incluyas nombres de archivos ni detalles de base de datos en `spec.md` (van en `plan.md`).
|
||||||
- Define criterios de aceptación verificables y delimita claramente el **Fuera de Alcance**.
|
- Define criterios de aceptación verificables y delimita claramente el **Fuera de Alcance**.
|
||||||
|
- En `plan.md`, estructura siempre el diseño técnico bajo las 4 capas del Principio 11 (`main.py`, `routers/`, `schemas/`, `storage.py`), definiendo contratos Pydantic (`BaseModel` con `Field`), códigos de estado HTTP semánticos (201, 204, 404, 422), y para módulos de IA prever clientes `httpx` asíncronos con timeouts generosos (600s) y la pestaña correspondiente en Configuración Global.
|
||||||
- En `tasks.md`, desglosa tareas en bloques atómicos de 20 a 30 minutos con `[ ]` y criterio *"Hecho cuando:"*.
|
- En `tasks.md`, desglosa tareas en bloques atómicos de 20 a 30 minutos con `[ ]` y criterio *"Hecho cuando:"*.
|
||||||
|
|||||||
@@ -10,7 +10,9 @@ Tu misión es actuar como QA profesional y auditor de calidad, garantizando que
|
|||||||
1. **En Clarificación de Spec**: Busca ambigüedades, contradicciones, lagunas en casos límite o choques con `docs/constitution.md`.
|
1. **En Clarificación de Spec**: Busca ambigüedades, contradicciones, lagunas en casos límite o choques con `docs/constitution.md`.
|
||||||
2. **En Validación de Implementación**:
|
2. **En Validación de Implementación**:
|
||||||
- Revisa los cambios (`git diff`).
|
- Revisa los cambios (`git diff`).
|
||||||
|
- Verifica activamente que no existan errores ni problemas en la terminal o Language Server (`@[current_problems]`). Si persisten errores de sintaxis, imports, tipos o `NoneType`, emitir obligatoriamente `VEREDICTO: CAMBIOS NECESARIOS`.
|
||||||
|
- Verifica el cumplimiento del **Principio 11**: arquitectura modular (`routers/`, `schemas/`, `storage.py`), validación con Pydantic `BaseModel` + `Field`, uso estricto de códigos HTTP (201/200/204/404/422), manejo controlado de excepciones (`HTTPException`) sin retornar `null` ante fallos, y uso de `httpx` asíncrono con timeouts generosos (600s) en integraciones con LLMs.
|
||||||
- Ejecuta las pruebas automatizadas (`python -m pytest tests -v`).
|
- Ejecuta las pruebas automatizadas (`python -m pytest tests -v`).
|
||||||
- Recorre cada RF de la especificación y emite un veredicto formal:
|
- Recorre cada RF de la especificación y emite un veredicto formal:
|
||||||
- `VEREDICTO: APROBADO`
|
- `VEREDICTO: APROBADO` (solo admisible si pruebas pasan al 100%, cero problemas en `@[current_problems]` y cumplimiento estricto de la Constitución).
|
||||||
- `VEREDICTO: CAMBIOS NECESARIOS` (con lista numerada de archivo:línea, incumplimiento y corrección esperada).
|
- `VEREDICTO: CAMBIOS NECESARIOS` (con lista numerada de archivo:línea, incumplimiento y corrección esperada).
|
||||||
|
|||||||
Vendored
+4
-2
@@ -1,6 +1,8 @@
|
|||||||
{
|
{
|
||||||
"python.defaultInterpreterPath": "${workspaceFolder}\\venv\\Scripts\\python.exe",
|
"python.defaultInterpreterPath": "${workspaceFolder}\\backend\\venv\\Scripts\\python.exe",
|
||||||
"python.analysis.extraPaths": [
|
"python.analysis.extraPaths": [
|
||||||
"${workspaceFolder}\\venv\\Lib\\site-packages"
|
"${workspaceFolder}\\backend",
|
||||||
|
"${workspaceFolder}\\scripts",
|
||||||
|
"${workspaceFolder}\\backend\\venv\\Lib\\site-packages"
|
||||||
]
|
]
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -35,10 +35,25 @@ Plataforma web de gestión de espacios áulicos, sincronización académica y as
|
|||||||
.\security_audit.bat --no-pause
|
.\security_audit.bat --no-pause
|
||||||
```
|
```
|
||||||
|
|
||||||
## Convenciones de Desarrollo
|
## Convenciones de Desarrollo y Buenas Prácticas de APIs
|
||||||
- Nombres de variables, funciones, clases, tablas, endpoints y commits estrictamente en **inglés**.
|
- Nombres de variables, funciones, clases, tablas, endpoints y commits estrictamente en **inglés**.
|
||||||
- Los endpoints de la API deben seguir estándares RESTful puros bajo `/api/v1/` retornando exclusivamente JSON.
|
- Los endpoints de la API deben seguir estándares RESTful puros bajo `/api/v1/` retornando exclusivamente JSON.
|
||||||
- Interfaz gráfica de usuario, etiquetas de formularios, mensajes de error y documentación operativa exclusivamente en **español**.
|
- Interfaz gráfica de usuario, etiquetas de formularios, mensajes de error y documentación operativa exclusivamente en **español**.
|
||||||
|
- **Arquitectura Modular en 4 Capas (Separación Estricta de Responsabilidades)**:
|
||||||
|
- `main.py`: Inicialización de la aplicación y registro de routers. No colocar lógica de negocio en el archivo principal ni en el frontend.
|
||||||
|
- `routers/`: Endpoints agrupados por dominio utilizando `APIRouter` (o Blueprints) con prefijos comunes (`prefix="/products"`, `prefix="/llm"`) y etiquetas (`tags=["..."]`) para una documentación limpia en Swagger UI.
|
||||||
|
- `schemas/` (`schemas.py`): Modelos de datos y validaciones con `Pydantic` (`BaseModel`).
|
||||||
|
- `storage.py` (o capa de persistencia `models/`): Centralización del acceso a datos y base de datos.
|
||||||
|
- **Validación de Datos con Pydantic y Tipado Fuerte**:
|
||||||
|
- Heredar de `BaseModel` para el cuerpo (body) de las peticiones.
|
||||||
|
- Uso mandatorio de `Field` para restricciones de negocio: `min_length`, `max_length`, `gt=0`, `ge=0`, etc.
|
||||||
|
- Manejo de parámetros: Path Parameters obligatorios en la URL y Query Parameters opcionales con defaults tipados (`limit: int = 10`).
|
||||||
|
- Validación y captura automática: ante datos inválidos responder con código `422 Unprocessable Entity` detallando el atributo exacto y la falla.
|
||||||
|
- **Códigos de Estado HTTP y Manejo de Excepciones**:
|
||||||
|
- Códigos de estado HTTP semánticos: `201 Created` en POST exitosos, `200 OK` en lecturas/actualizaciones, `204 No Content` en eliminaciones sin cuerpo.
|
||||||
|
- Prohibido retornar `null` o respuestas vacías ante fallos lógicos: levantar siempre excepciones controladas (`HTTPException`) con código adecuado (ej. `404 Not Found` con `detail="Recurso no encontrado"`, `400 Bad Request`, `409 Conflict`).
|
||||||
|
- **Documentación Interactiva Automática**:
|
||||||
|
- Contratos OpenAPI expuestos en `/docs` (Swagger UI) listos para pruebas en vivo (*Try it out*) y visualización de esquemas.
|
||||||
|
|
||||||
## Reglas de Dominio y Trampas Conocidas
|
## Reglas de Dominio y Trampas Conocidas
|
||||||
- **Reemplazo del Excel de Bedelía**: La gestión operativa diaria debe realizarse en la app a través del circuito secuencial de 9 pasos (Sedes -> Aulas -> Ciclos Lectivos -> Carreras -> Asignaturas -> Comisiones -> Profesores -> Alumnos -> Reservas). Las comisiones heredan y exponen la Carrera de la asignatura para trazabilidad por plan de estudios. Las hojas de cálculo son únicamente para importación masiva de datos iniciales.
|
- **Reemplazo del Excel de Bedelía**: La gestión operativa diaria debe realizarse en la app a través del circuito secuencial de 9 pasos (Sedes -> Aulas -> Ciclos Lectivos -> Carreras -> Asignaturas -> Comisiones -> Profesores -> Alumnos -> Reservas). Las comisiones heredan y exponen la Carrera de la asignatura para trazabilidad por plan de estudios. Las hojas de cálculo son únicamente para importación masiva de datos iniciales.
|
||||||
@@ -47,6 +62,11 @@ Plataforma web de gestión de espacios áulicos, sincronización académica y as
|
|||||||
- **Matriz de Conflictos de Reservas**: Una reserva no puede guardarse si genera superposición física de aula presencial, sobrepasa el aforo máximo o solapa al docente (salvo excepción justificada por co-docencia activa).
|
- **Matriz de Conflictos de Reservas**: Una reserva no puede guardarse si genera superposición física de aula presencial, sobrepasa el aforo máximo o solapa al docente (salvo excepción justificada por co-docencia activa).
|
||||||
- **Restricción Diaria de Alumnos**: Un alumno no puede matricularse en dos materias regulares en el mismo día, a menos que sea un curso corto (`is_short_course`) o posea autorización expresa de Bedelía (`allow_same_day_exception`).
|
- **Restricción Diaria de Alumnos**: Un alumno no puede matricularse en dos materias regulares en el mismo día, a menos que sea un curso corto (`is_short_course`) o posea autorización expresa de Bedelía (`allow_same_day_exception`).
|
||||||
- **Autenticación**: Los flujos de acceso pasan por tokens JWT transportados en cookies seguras `HttpOnly`.
|
- **Autenticación**: Los flujos de acceso pasan por tokens JWT transportados en cookies seguras `HttpOnly`.
|
||||||
|
- **Integración Asíncrona con Modelos de IA Locales (LLMs) y Asistente en la App**:
|
||||||
|
- **Pestaña en Configuración Global**: Incluir una pestaña específica en la Configuración Global de la app para gestionar la integración con modelos de IA (servidor/URL, modelo seleccionado, tokens y timeout), sentando las bases para el futuro asistente virtual que guiará al usuario en la plataforma.
|
||||||
|
- **Cliente HTTP Asíncrono no Bloqueante (`httpx`)**: Toda llamada a servidores de inferencia locales (Ollama, llama.cpp, vLLM) o APIs de IA debe realizarse de forma asíncrona (`httpx.AsyncClient` con `async def` / `await`) para no bloquear el hilo de ejecución principal ni degradar la concurrencia.
|
||||||
|
- **Timeouts Generosos**: Fijar un tiempo de espera (`timeout`) amplio (mínimo 600 segundos en entornos locales) previendo la carga de modelos en VRAM o inferencias de prompts extensos.
|
||||||
|
- **Estructura de Roles Estándar**: Formatear el payload JSON enviando el modelo y los mensajes con roles explícitos (`role: "system" | "user" | "assistant"`, `content: prompt`).
|
||||||
|
|
||||||
## Metodología SDD (Spec-Driven Development) y Arnés de Agentes
|
## Metodología SDD (Spec-Driven Development) y Arnés de Agentes
|
||||||
- **La especificación manda**: Ninguna feature se codifica sin su carpeta `specs/NNN-nombre/` conteniendo `spec.md` (requisitos en sintaxis **EARS** en español: Ubicuo, Eventos, Estado, No Deseado, Opcional), `plan.md` y `tasks.md` (skill `.agents/skills/sdd/SKILL.md`).
|
- **La especificación manda**: Ninguna feature se codifica sin su carpeta `specs/NNN-nombre/` conteniendo `spec.md` (requisitos en sintaxis **EARS** en español: Ubicuo, Eventos, Estado, No Deseado, Opcional), `plan.md` y `tasks.md` (skill `.agents/skills/sdd/SKILL.md`).
|
||||||
@@ -65,7 +85,9 @@ Plataforma web de gestión de espacios áulicos, sincronización académica y as
|
|||||||
|
|
||||||
## Límites
|
## Límites
|
||||||
- **SIEMPRE**: Lee `docs/constitution.md` y la especificación activa (`specs/`) antes de proponer o modificar código.
|
- **SIEMPRE**: Lee `docs/constitution.md` y la especificación activa (`specs/`) antes de proponer o modificar código.
|
||||||
- **SIEMPRE**: Al finalizar la tarea, realizar bump de versión, `git push origin dev` y despliegue a producción con `.credenciales` (Skill `.agents/skills/deploy/SKILL.md`).
|
- **SIEMPRE (Principio 10 - Tolerancia Cero)**: Repara activamente todos los problemas y errores reportados en la terminal / Language Server (`@[current_problems]`). **Es estrictamente inadmisible decir que una tarea está terminada o completada si hay errores o problemas en el código.**
|
||||||
|
- **SIEMPRE (Principio 11 - Contratos Fuertes e IA)**: Implementar endpoints desacoplados en routers modulares, validar payloads con Pydantic `BaseModel` y `Field`, retornar códigos de estado HTTP semánticos (201, 204, 404, 422), exponer contratos en OpenAPI `/docs` y emplear `httpx` asíncrono con timeouts generosos (600s) para integraciones con LLMs.
|
||||||
|
- **SIEMPRE**: Al finalizar la tarea (con cero problemas en el código), realizar bump de versión, `git push origin dev` y despliegue a producción con `.credenciales` (Skill `.agents/skills/deploy/SKILL.md`).
|
||||||
- **PREGUNTA ANTES DE**: Añadir nuevas dependencias a `requirements.txt` o `package.json`, alterar el esquema relacional de la base de datos o cambiar la estrategia de caché.
|
- **PREGUNTA ANTES DE**: Añadir nuevas dependencias a `requirements.txt` o `package.json`, alterar el esquema relacional de la base de datos o cambiar la estrategia de caché.
|
||||||
- **NUNCA**: Expongas contraseñas, tokens de Moodle, secretos de API o el contenido del archivo `.credenciales` en el código fuente, commits o logs públicos.
|
- **NUNCA**: Expongas contraseñas, tokens de Moodle, secretos de API o el contenido del archivo `.credenciales` en el código fuente, commits o logs públicos.
|
||||||
|
|
||||||
|
|||||||
@@ -11,6 +11,98 @@ 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.
|
- **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.
|
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
|
||||||
|
|
||||||
|
## [3.5.7] - 2026-10-16
|
||||||
|
### Added
|
||||||
|
- **Principio 11 de la Constitución: Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**:
|
||||||
|
- **Arquitectura Modular en 4 Capas**: Desacople estricto en `main.py` (arranque/routers), `routers/` (APIRouters por dominio con prefijo y tags), `schemas/` (Pydantic `BaseModel`) y `storage.py` (acceso a DB). Prohibición de lógica de negocio en el frontend o archivos únicos.
|
||||||
|
- **Contratos Fuertes y Pydantic**: Uso mandatorio de `Field` para validación (`min_length`, `max_length`, `gt`, `ge`), diferenciación estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados), y respuestas automáticas de error `422 Unprocessable Entity` detalladas.
|
||||||
|
- **Semántica HTTP y Excepciones**: Uso estricto de códigos `201 Created` en POST, `200 OK`, `204 No Content` en DELETE y excepciones controladas `HTTPException` (404 con mensaje explícito, 400, 409) prohibiendo el retorno de `null` o respuestas vacías ambiguas.
|
||||||
|
- **Documentación Interactiva Automática**: Contratos OpenAPI expuestos en `/docs` (Swagger UI) con capacidades de prueba en vivo.
|
||||||
|
- **Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual**:
|
||||||
|
- Incorporación al Roadmap (Fase 7) de la pestaña de IA en la Configuración Global administrativa (URL de inferencia local Ollama/llama.cpp, modelo, token/clave API, switch de activación y timeout).
|
||||||
|
- Uso obligatorio de clientes asíncronos no bloqueantes `httpx.AsyncClient` (`async def` / `await`).
|
||||||
|
- Configuración de timeout generoso de 600 segundos previendo carga de modelos en VRAM o inferencia de prompts extensos.
|
||||||
|
- Estructura de payload estandarizada por historial de roles (`system`, `user`, `assistant`).
|
||||||
|
- Sincronización documental integral en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.opencode/agents/` (`coordinator.md`, `planner.md`, `implementer.md`, `reviewer.md`), `ROADMAP.md` y `MEMORY.md`.
|
||||||
|
|
||||||
|
## [3.5.6] - 2026-10-16
|
||||||
|
### Added
|
||||||
|
- **Principio 10 de la Constitución: Tolerancia Cero a Errores de Código y Diagnóstico (`@[current_problems]`)**:
|
||||||
|
- Incorporada directiva mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y definiciones de agentes en `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
|
||||||
|
- Prohibición estricta e infranqueable de declarar cualquier tarea o sprint como "terminado" o "completado" si persisten errores en el código o en el analizador de la IDE.
|
||||||
|
- Pre-verificación de Quality Gate `Paso 0: Verificación de Código Limpio (Zero Errors)` en el skill de despliegue antes de cualquier bump de versión o push.
|
||||||
|
|
||||||
|
### Changed & Fixed
|
||||||
|
- **Robustez en `SystemSetting`**:
|
||||||
|
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase (`SystemSetting.get_decrypted_value('key')`) o como método de instancia (`setting.get_decrypted_value()`), garantizando el paso del 100% de los tests de integración de la Fase 5.
|
||||||
|
- **Tipado estricto en `scripts/moodle_replicator.py`**:
|
||||||
|
- Corregido casteo a `int` en `local_course_id` y `role_id` en las líneas 586 y 607, satisfaciendo la firma de `enrol_user(local_uid: int, local_course_id: int, role_id: int)`.
|
||||||
|
- **Estabilidad de concurrencia en tests de SQLite**:
|
||||||
|
- Añadida espera explícita del worker asíncrono en `test_05_api_async_job_submission_and_polling` (`backend/tests/test_sprint4_optimizer_and_concurrency.py`) para evitar bloqueo de tablas en SQLite durante `tearDown`.
|
||||||
|
- Suite de pruebas de backend con 52 tests pasando al 100% (`52 passed`).
|
||||||
|
|
||||||
|
## [3.5.5] - 2026-10-16
|
||||||
|
### Added
|
||||||
|
- Mecanismo de autenticación mediante Clave API institucional (`X-API-Key` / `Authorization: ApiKey`) para sincronizaciones seguras desde Moodle y automatizaciones externas sin requerir tokens JWT interactivos.
|
||||||
|
- Endpoints de gestión de clave API: `GET /api/v1/admin/settings/moodle/api-key` y `POST /api/v1/admin/settings/moodle/api-key/regenerate`.
|
||||||
|
- Alias de sincronización `POST /api/v1/admin/settings/moodle/sync` consumible nativamente desde el botón de la interfaz web en la pantalla de Ajustes.
|
||||||
|
- Catálogo extendido de Web Services en Moodle Local (`10.0.0.207`) para el servicio `moodle_api`: añadidas funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`.
|
||||||
|
- Blindaje de seguridad en Moodle mediante restricción de IP (`iprestriction = 10.0.0.0/24`) en los tokens del servicio `moodle_api`.
|
||||||
|
|
||||||
|
### Changed & Fixed
|
||||||
|
- Eliminadas las 6 tareas residuales pendientes de prueba en la tabla `moodle_sync_tasks` de `classrooms_db`.
|
||||||
|
- Resolución de type narrowings (`loader` en `moodle_replicator.py` y `role_obj` en `admin.py`) y configuración integral de paths de scripts y venv en `pyrightconfig.json`.
|
||||||
|
|
||||||
|
## [3.5.4] - 2026-10-16
|
||||||
|
### Added
|
||||||
|
- Integración completa bidireccional con el Web Service `moodle_api` de Moodle Local (`10.0.0.207`) usando token dedicado `810428346d3601c68a37a315fcba8d4391629f46`.
|
||||||
|
- Soporte para autenticación delegada Moodle (`/api/v1/auth/moodle`) con fallback dinámico entre `moodle_api` y `moodle_mobile_app`, y matching por número de documento (DNI) y prefijo de usuario.
|
||||||
|
- Endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle` para sincronización directa de usuarios, roles y catálogo de cursos desde Moodle hacia la base de datos `classrooms_db`.
|
||||||
|
- Métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
|
||||||
|
- Otorgamiento de capability `moodle/webservice:createtoken` al rol autenticado de Moodle en `10.0.0.207` y habilitación de Web Services para login token.
|
||||||
|
|
||||||
|
### Fixed
|
||||||
|
- Corrección de firma en `MoodleClient.test_connection(server_url, token)` que causaba TypeError al recibir argumentos opcionales desde el panel de ajustes.
|
||||||
|
- Solución al error de resolución de módulos de Pyright/Pylance en `scripts/import_moodle_to_app.py` mediante configuración de `.vscode/settings.json` y carga modular dinámica.
|
||||||
|
|
||||||
|
## [3.5.3] - 2026-10-16
|
||||||
|
### Agregado & Corregido (Sincronización de Roles Moodle-App, Limpieza Admin & Hardening)
|
||||||
|
- **Importador y Sincronización de Roles con la App (`scripts/import_moodle_to_app.py` & flag `--sync-app`):**
|
||||||
|
- Mapeo directo y coherente de roles académicos: docentes de Moodle (`editingteacher`) asignados a `Docente` (`role_id=2`) y estudiantes (`student`) asignados a `Alumno` (`role_id=6`) en el modelo RBAC de PostgreSQL de la App (`classrooms_db`).
|
||||||
|
- Ingesta exitosa de **653 usuarios únicos** (15 Docentes y 640 Alumnos) con contraseñas seguras PBKDF2 coincidentes con el DNI, nombres, apellidos y correos personales reales.
|
||||||
|
- Habilitada la vinculación inmediata con comisiones (`commission_teachers`), reservas docentes e inscripciones de cursada (`student_enrollments`).
|
||||||
|
- **Desmatriculación Total de la Cuenta Admin en Moodle Local (`10.0.0.207`):**
|
||||||
|
- Removidas todas las asociaciones y enrolamientos espurios de la cuenta `admin` en asignaturas académicas y cursos institucionales (conteo reducido a 0 matriculaciones).
|
||||||
|
- Eliminado el curso dummy residual `Prueba matriculaciones masivas` (ID 22).
|
||||||
|
- Preservados estrictamente los 16 cursos legítimos de la carrera Licenciatura en Tecnologías Digitales (CCC).
|
||||||
|
|
||||||
|
## [3.5.2] - 2026-10-16
|
||||||
|
### Corregido & Mejorado (Replicación Integral de Carreras y Materias, User-Agent Mozilla/5.0, Login Local Fix)
|
||||||
|
- **Replicación Completa de los 16 Cursos de la Carrera:**
|
||||||
|
- Ampliado el catálogo de cursos de la Licenciatura en Tecnologías Digitales (CCC) de 4 a 16 asignaturas completas (1/2025, 2/2025, 1/2026 y 2/2026).
|
||||||
|
- Resuelto el problema de alumnos (ej. `90010202` - Carlos Guillermo Terzano) que solo veían la carrera y no sus materias cursadas: ahora cuentan con sus asignaturas y comisiones reales replicadas y matriculadas en Moodle Local (`10.0.0.207`).
|
||||||
|
- Más de 1.100 matriculaciones procesadas y verificadas con éxito en tiempo real.
|
||||||
|
- **Corrección de Inicio de Sesión de Alumnos en Moodle Local:**
|
||||||
|
- Solucionada la desincronización de contraseña del usuario `34247025`: restablecida y verificada con éxito tanto por CLI como vía API para que el DNI opere idénticamente como `username` y `password`.
|
||||||
|
- Mecanismo en `get_or_create_user` para forzar la actualización de contraseña y correo de cuentas existentes evitando bloqueos por credenciales obsoletas.
|
||||||
|
- **Personalización de Cabeceras HTTP (User-Agent):**
|
||||||
|
- Configurado estrictamente el encabezado `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)` en todas las sesiones y scripts hacia el Campus Virtual UniCABA, eliminando la firma por defecto de `python-requests`.
|
||||||
|
- **Pre-caché y Optimización de Extracción:**
|
||||||
|
- Carga automática de correos previamente cacheados desde `participantes_export.json` para reducir en un 80% las consultas HTTP a producción y evitar timeouts.
|
||||||
|
|
||||||
|
## [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
|
## [3.5.0] - 2026-10-16
|
||||||
### Agregado & Mejorado (Cierre Formal MVP Bedelía & Adopción Metodología SDD / Arnés de IA)
|
### 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):**
|
- **Arnés de Ingeniería de Software con IA (Harness Engineering):**
|
||||||
|
|||||||
@@ -192,7 +192,105 @@ Memoria del proyecto entre sesiones para la rama `dev`.
|
|||||||
- 52 pruebas de backend ejecutadas con 100% de éxito en pytest (`52 passed`).
|
- 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`.
|
- Versión incrementada a `v3.5.0` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
|
||||||
|
|
||||||
|
- **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.
|
||||||
|
|
||||||
|
- **Sprint v3.5.2: Replicación Completa de 16 Cursos, User-Agent Mozilla/5.0 y Fix de Credenciales**:
|
||||||
|
- **Catálogo Completo de la Carrera (16 Cursos)**:
|
||||||
|
- Se identificaron y replicaron la totalidad de las 15 materias de la Licenciatura en Tecnologías Digitales (1/2025, 2/2025, 1/2026 y 2/2026) más el curso de la carrera (Local 19).
|
||||||
|
- Resuelto el caso de alumnos como `90010202` (Carlos Guillermo Terzano): ahora cuenta con sus 6 materias reales cursadas (Local 4, 5, 8, 9, 10, 11) además de la carrera.
|
||||||
|
- Carlos Tello (`34247025`) matriculado en las 15 asignaturas y la carrera.
|
||||||
|
- Más de 1.100 matriculaciones procesadas y validadas con 100% de éxito.
|
||||||
|
- **Identificación y Asignación de Todos los Docentes**:
|
||||||
|
- Extraídos y asignados todos los profesores reales con rol `editingteacher` (ID 3) y correos institucionales `@udelaciudad.edu.ar`.
|
||||||
|
- **Cabecera HTTP y User-Agent**:
|
||||||
|
- Forzado estrictamente el encabezado `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)` en todas las solicitudes al campus para evitar alertas por `python-requests`.
|
||||||
|
- **Sincronización de Contraseña Local (Fix 34247025)**:
|
||||||
|
- Se corrigió la contraseña del usuario `34247025` restableciéndola a `34247025` idéntica al DNI en Moodle local. Verificado inicio de sesión exitoso.
|
||||||
|
|
||||||
|
- **Sprint v3.5.3: Importación de Roles Moodle-App, Limpieza Total de Admin y Purga de Cursos**:
|
||||||
|
- **Sincronización RBAC de Roles Moodle a PostgreSQL de la App (`classrooms_db`)**:
|
||||||
|
- Desarrollado `scripts/import_moodle_to_app.py` y bandera `--sync-app` en `moodle_replicator.py`.
|
||||||
|
- Mapeo unívoco: Moodle `editingteacher` -> App `Docente` (`role_id=2`), Moodle `student` -> App `Alumno` (`role_id=6`).
|
||||||
|
- Importados **653 usuarios únicos** (15 Docentes y 640 Alumnos) a la base de datos de producción con contraseñas PBKDF2 coincidentes con el DNI, habilitando de inmediato la asignación de comisiones, reservas e inscripciones.
|
||||||
|
- **Desmatriculación de Cuenta Admin en Moodle Local (`10.0.0.207`)**:
|
||||||
|
- Removidas todas las matriculaciones de `admin` en cursos académicos y generales (quedando con 0 enrolments).
|
||||||
|
- **Sprint v3.5.4: Conexión Moodle API, Login Delegado y Sincronización Moodle -> Edu Space**:
|
||||||
|
- **Habilitación de Web Services para Tokens de Usuario en Moodle Local (`10.0.0.207`)**:
|
||||||
|
- Asignada la capability `moodle/webservice:createtoken` al rol 7 (`user` / usuario autenticado) en `mdl_role_capabilities`.
|
||||||
|
- Habilitado `enablemobilewebservice = 1` y servicio `moodle_mobile_app` (`enabled = 1`).
|
||||||
|
- Verificada la emisión de tokens exitosa para usuarios individuales (incluyendo `34247025`) tanto contra `moodle_api` como contra `moodle_mobile_app`.
|
||||||
|
- **Conexión de Admin Edu Space con Moodle Local**:
|
||||||
|
- Configurado el token `810428346d3601c68a37a315fcba8d4391629f46` de `moodle_api` en `system_settings` de `classrooms_db`.
|
||||||
|
- Habilitada `auth_moodle_enabled = 'true'` y `moodle_server_url = 'http://10.0.0.207/moodle'`.
|
||||||
|
- Adaptado el endpoint de autenticación `/api/v1/auth/moodle` para autenticar con `moodle_api` (con fallback a `moodle_mobile_app`) y hacer matching de cuenta local por número de documento (DNI).
|
||||||
|
- **Sincronización Bidireccional Moodle -> Edu Space**:
|
||||||
|
- Agregado el endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle`.
|
||||||
|
- Incorporados los métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
|
||||||
|
- **Sprint v3.5.5: Autenticación por API Key para Moodle, Purga de Tareas y Hardening**:
|
||||||
|
- **Purga de Tareas de Sincronización Residuales**:
|
||||||
|
- Eliminadas las 6 tareas pendientes residuales de prueba (#1 a #6) en la tabla `moodle_sync_tasks` de `classrooms_db` en `10.0.0.217`, dejando la cola limpia en 0 registros.
|
||||||
|
- **Ampliación de Funciones Web Services en Moodle Local (`10.0.0.207`)**:
|
||||||
|
- Asignadas al servicio `moodle_api` las funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`, completando el catálogo a 15 funciones esenciales.
|
||||||
|
- **Seguridad por Restricción de Red (IP Restriction)**:
|
||||||
|
- Fijada la restricción de red `iprestriction = '10.0.0.0/24'` en `mdl_external_tokens`, asegurando que solo el tráfico interno institucional pueda utilizar los tokens de Moodle.
|
||||||
|
- **Autenticación por API Key Institucional en Admin Edu Space**:
|
||||||
|
- Creado mecanismo para autenticar endpoints de sincronización (`/settings/moodle/sync` y `/moodle/sync-from-moodle`) mediante `X-API-Key` institucional de 64 caracteres hex.
|
||||||
|
- Generada y almacenada la clave API institucional cifrada con Fernet en `system_settings` (`classrooms_db`).
|
||||||
|
- Agregados endpoints para consulta y regeneración de clave API (`/api/v1/admin/settings/moodle/api-key`).
|
||||||
|
|
||||||
|
- **Sprint v3.5.6: Principio 10 de Tolerancia Cero a Errores de Código, Robustez en SystemSetting y Replicador**:
|
||||||
|
- **Principio 10 de la Constitución**:
|
||||||
|
- Incorporada regla mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
|
||||||
|
- Es estrictamente inadmisible declarar una tarea o sprint como terminado o completado si persisten errores en el código o en el analizador de la IDE (`@[current_problems]`).
|
||||||
|
- **Reparación de Tipos en Replicador Moodle**:
|
||||||
|
- Ajustado casteo a entero `int(course_meta['local_id'])` y `int(u.get('role_id', 5))` en `scripts/moodle_replicator.py`.
|
||||||
|
- **Robustez Híbrida en `SystemSetting`**:
|
||||||
|
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase o de instancia sin errores de argumentos.
|
||||||
|
- **Resolución de Condición de Carrera en Tests de SQLite**:
|
||||||
|
- Añadida espera activa de finalización de workers en `test_05_api_async_job_submission_and_polling` para evitar bloqueos de base de datos en `tearDown()`.
|
||||||
|
- **Validación Automatizada**:
|
||||||
|
- 52/52 tests pasando en verde al 100% (`pytest tests -v`).
|
||||||
|
|
||||||
|
- **Sprint v3.5.7: Principio 11 de la Constitución — Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**:
|
||||||
|
- **Arquitectura Modular en 4 Capas**:
|
||||||
|
- Desacople estricto: `main.py` (bootstrap/registro), `routers/` (endpoints agrupados por dominio con prefijos y tags para Swagger), `schemas/` (contratos con Pydantic `BaseModel`), `storage.py` (acceso a persistencia). Prohibida la lógica de negocio en el frontend o en archivos monolíticos.
|
||||||
|
- **Tipado Fuerte y Validación Pydantic**:
|
||||||
|
- Uso obligatorio de `Field` para validaciones declarativas (`min_length`, `max_length`, `gt`, `ge`, regex).
|
||||||
|
- Distinción estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados con defaults).
|
||||||
|
- Manejo y respuesta automática de error `422 Unprocessable Entity` detallando el campo exacto.
|
||||||
|
- **Semántica HTTP y Excepciones Controladas**:
|
||||||
|
- Uso de códigos de estado HTTP semánticos (`201 Created` en POST, `200 OK`, `204 No Content`).
|
||||||
|
- Prohibido retornar `null` o respuestas vacías ante fallos: levantar `HTTPException` controladas con detalle descriptivo (404, 400, 409).
|
||||||
|
- **Documentación Interactiva Automática**:
|
||||||
|
- Contratos OpenAPI expuestos en `/docs` (Swagger UI) con capacidades de prueba en vivo (*Try it out*).
|
||||||
|
- **Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual**:
|
||||||
|
- **Pestaña en Configuración Global**: Planificada en `ROADMAP.md` y UI administrativa para configurar URL del servidor local (Ollama, llama.cpp), modelo, token y timeout para el futuro asistente virtual de la app.
|
||||||
|
- **Cliente Asíncrono no Bloqueante**: Uso mandatorio de `httpx.AsyncClient` con `async def` / `await` para inferencias concurrentes sin bloquear el servidor.
|
||||||
|
- **Timeout Generoso**: Configurar timeout de 600 segundos previendo carga de modelos en VRAM o prompts extensos.
|
||||||
|
- **Formato Estándar de Roles**: Historial estructurado bajo `role: "system" | "user" | "assistant"` y `content: prompt`.
|
||||||
|
- **Actualización Documental Completa**:
|
||||||
|
- Sincronizados `docs/constitution.md` (Principio 11), `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.opencode/agents/` (`coordinator.md`, `planner.md`, `implementer.md`, `reviewer.md`), `ROADMAP.md` (Fase 7) y `MEMORY.md`.
|
||||||
|
|
||||||
## Próximos pasos
|
## Próximos pasos
|
||||||
1. Desplegar la versión `v3.5.0` al servidor institucional de producción (`10.0.0.217` / `eduspace.oemspot.com.ar`) conforme al Principio 9.
|
1. Monitorear los inicios de sesión delegados en producción con cuentas docentes y estudiantiles.
|
||||||
2. Realizar la prueba de aceptación en vivo con el personal de Bedelía imprimiendo y exportando la cartelera real.
|
2. Implementar la pestaña de Asistente IA en la Configuración Global administrativa (`ROADMAP.md` Fase 7).
|
||||||
3. Iniciar la Fase 6 de hardening y orquestación de contenedores en Docker-compose.
|
3. 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.
|
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.7` (Principio 11: Estándares Modernos de APIs, Pydantic e Integración de IA)
|
||||||
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
||||||
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
|
**Entorno de Producción:** `https://eduspace.oemspot.com.ar` (LXC `10.0.0.217`)
|
||||||
|
|
||||||
|
|||||||
+17
-1
@@ -2,7 +2,7 @@
|
|||||||
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
|
## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía
|
||||||
|
|
||||||
**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)
|
**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.7 (Principio 11: Estándares Modernos de APIs, Pydantic e Integración de IA)
|
||||||
**Fecha de Actualización:** 16 de Octubre de 2026
|
**Fecha de Actualización:** 16 de Octubre de 2026
|
||||||
**Rama Base:** `dev`
|
**Rama Base:** `dev`
|
||||||
|
|
||||||
@@ -108,3 +108,19 @@ Fase 6: Despliegue en Servidores y Hardening [█████████░
|
|||||||
- [ ] Automatización de workers persistentes en systemd para la cola asíncrona de Moodle.
|
- [ ] Automatización de workers persistentes en systemd para la cola asíncrona de Moodle.
|
||||||
- [ ] Configuración optimizada de `docker-compose.yml` de producción.
|
- [ ] Configuración optimizada de `docker-compose.yml` de producción.
|
||||||
- [ ] Pruebas de estrés de concurrencia y validación final de performance sub-segundo.
|
- [ ] Pruebas de estrés de concurrencia y validación final de performance sub-segundo.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
### Fase 7: Integración con Modelos de IA Locales (LLMs) & Asistente Virtual en la App 🤖 *(Diseñada / Por Implementar)*
|
||||||
|
- [ ] **Pestaña de Asistente IA en Configuración Global**:
|
||||||
|
- Incorporar en la vista de configuración general del Administrador una pestaña dedicada a la configuración de IA.
|
||||||
|
- Parámetros configurables: URL del servidor de inferencia (Ollama, llama.cpp, vLLM, LiteLLM), Modelo seleccionado, Clave de API / Token, Timeout de conexión (por defecto 600s para entornos locales), y Switch de activación general.
|
||||||
|
- Almacenamiento seguro de credenciales con Fernet en base de datos (`system_settings`).
|
||||||
|
- [ ] **Módulo Backend Asíncrono de Inferencia (`httpx`)**:
|
||||||
|
- Implementar servicio `AIService` utilizando `httpx.AsyncClient` con funciones asíncronas no bloqueantes (`async def` / `await`).
|
||||||
|
- Gestión estructurada del historial y contexto mediante el estándar de roles (`system`, `user`, `assistant`).
|
||||||
|
- Timeout generoso (600 segundos) para mitigar demoras en carga de modelos a VRAM o prompts extensos.
|
||||||
|
- [ ] **Asistente Conversacional para Usuarios**:
|
||||||
|
- Componente de interfaz flotante para guiar a Bedelía, Docentes y Alumnos en el uso de la plataforma.
|
||||||
|
- Capacidades de consulta sobre asignaciones áulicas, cronogramas, comisiones y manuales operativos.
|
||||||
|
|
||||||
|
|||||||
@@ -0,0 +1 @@
|
|||||||
|
# Package marker for backend
|
||||||
@@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _
|
|||||||
from config.config import Config
|
from config.config import Config
|
||||||
|
|
||||||
# Initialize extensions
|
# Initialize extensions
|
||||||
__version__ = "3.5.0"
|
__version__ = "3.5.7"
|
||||||
db = SQLAlchemy()
|
db = SQLAlchemy()
|
||||||
migrate = Migrate()
|
migrate = Migrate()
|
||||||
cors = CORS()
|
cors = CORS()
|
||||||
@@ -95,10 +95,11 @@ def create_app(config_class=Config):
|
|||||||
babel.init_app(app, locale_selector=get_locale)
|
babel.init_app(app, locale_selector=get_locale)
|
||||||
|
|
||||||
# Register localized date and datetime formatters for Jinja2 templates
|
# Register localized date and datetime formatters for Jinja2 templates
|
||||||
|
from typing import Any, cast
|
||||||
from flask_babel import format_date, format_datetime
|
from flask_babel import format_date, format_datetime
|
||||||
app.jinja_env.globals['format_date'] = format_date
|
cast(dict[str, Any], app.jinja_env.globals)['format_date'] = format_date
|
||||||
app.jinja_env.globals['format_datetime'] = format_datetime
|
cast(dict[str, Any], app.jinja_env.globals)['format_datetime'] = format_datetime
|
||||||
app.jinja_env.filters['format_date'] = format_date
|
cast(dict[str, Any], app.jinja_env.filters)['format_date'] = format_date
|
||||||
app.jinja_env.filters['format_datetime'] = format_datetime
|
cast(dict[str, Any], app.jinja_env.filters)['format_datetime'] = format_datetime
|
||||||
|
|
||||||
return app
|
return app
|
||||||
@@ -2,6 +2,18 @@ from app import db
|
|||||||
from datetime import datetime
|
from datetime import datetime
|
||||||
from app.services.crypto_service import CryptoService
|
from app.services.crypto_service import CryptoService
|
||||||
|
|
||||||
|
class _hybrid_setting_method:
|
||||||
|
"""Descriptor que resuelve si se invoca sobre la clase SystemSetting o sobre una instancia."""
|
||||||
|
def __init__(self, inst_func, cls_func):
|
||||||
|
self.inst_func = inst_func
|
||||||
|
self.cls_func = cls_func
|
||||||
|
|
||||||
|
def __get__(self, instance, owner):
|
||||||
|
if instance is None:
|
||||||
|
return lambda *args, **kwargs: self.cls_func(owner, *args, **kwargs)
|
||||||
|
return lambda *args, **kwargs: self.inst_func(instance, *args, **kwargs)
|
||||||
|
|
||||||
|
|
||||||
class SystemSetting(db.Model):
|
class SystemSetting(db.Model):
|
||||||
"""
|
"""
|
||||||
Parámetros de configuración del sistema persistentes en base de datos.
|
Parámetros de configuración del sistema persistentes en base de datos.
|
||||||
@@ -32,53 +44,55 @@ class SystemSetting(db.Model):
|
|||||||
pass
|
pass
|
||||||
return default
|
return default
|
||||||
|
|
||||||
def get_decrypted_value(self_or_cls, key_or_default=None, default=None):
|
def _inst_get_decrypted_value(self, default=None):
|
||||||
"""Retorna el valor desencriptado. Compatible como método de clase o de instancia."""
|
|
||||||
if isinstance(self_or_cls, type):
|
|
||||||
# Llamado como clase: SystemSetting.get_decrypted_value('key', default)
|
|
||||||
key = key_or_default
|
|
||||||
try:
|
try:
|
||||||
record = self_or_cls.query.filter_by(key=key).first()
|
if self.value is not None and self.value.strip() != '':
|
||||||
if record:
|
if self.is_encrypted:
|
||||||
return record.get_decrypted_value(default)
|
return CryptoService.decrypt(self.value)
|
||||||
|
return self.value
|
||||||
except Exception:
|
except Exception:
|
||||||
pass
|
pass
|
||||||
return default
|
return default
|
||||||
else:
|
|
||||||
# Llamado como instancia: setting.get_decrypted_value(default)
|
|
||||||
actual_default = key_or_default
|
|
||||||
try:
|
|
||||||
if self_or_cls.value is not None and self_or_cls.value.strip() != '':
|
|
||||||
if self_or_cls.is_encrypted:
|
|
||||||
return CryptoService.decrypt(self_or_cls.value)
|
|
||||||
return self_or_cls.value
|
|
||||||
except Exception:
|
|
||||||
pass
|
|
||||||
return actual_default
|
|
||||||
|
|
||||||
def get_masked_value(self_or_cls, key_or_default=None, default=''):
|
@classmethod
|
||||||
"""Retorna una versión enmascarada si es un secreto o contraseña. Compatible como clase o instancia."""
|
def _cls_get_decrypted_value(cls, key, default=None):
|
||||||
if isinstance(self_or_cls, type):
|
|
||||||
# Llamado como clase: SystemSetting.get_masked_value('key', default)
|
|
||||||
key = key_or_default
|
|
||||||
try:
|
try:
|
||||||
record = self_or_cls.query.filter_by(key=key).first()
|
record = cls.query.filter_by(key=key).first()
|
||||||
if record:
|
if record and record.value is not None and record.value.strip() != '':
|
||||||
return record.get_masked_value(default)
|
if record.is_encrypted:
|
||||||
|
return CryptoService.decrypt(record.value)
|
||||||
|
return record.value
|
||||||
except Exception:
|
except Exception:
|
||||||
pass
|
pass
|
||||||
return default
|
return default
|
||||||
else:
|
|
||||||
# Llamado como instancia: setting.get_masked_value(default)
|
get_decrypted_value = _hybrid_setting_method(_inst_get_decrypted_value, _cls_get_decrypted_value)
|
||||||
actual_default = key_or_default or ''
|
|
||||||
|
def _inst_get_masked_value(self, default=''):
|
||||||
try:
|
try:
|
||||||
if self_or_cls.value and self_or_cls.value.strip() != '':
|
if self.value and self.value.strip() != '':
|
||||||
if self_or_cls.is_encrypted or 'secret' in self_or_cls.key.lower() or 'password' in self_or_cls.key.lower() or 'token' in self_or_cls.key.lower():
|
k_lower = (self.key or '').lower()
|
||||||
|
if self.is_encrypted or any(x in k_lower for x in ('secret', 'password', 'token', 'key')):
|
||||||
return '••••••••••••'
|
return '••••••••••••'
|
||||||
return self_or_cls.value
|
return self.value
|
||||||
except Exception:
|
except Exception:
|
||||||
pass
|
pass
|
||||||
return actual_default
|
return default
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
def _cls_get_masked_value(cls, key, default=''):
|
||||||
|
try:
|
||||||
|
record = cls.query.filter_by(key=key).first()
|
||||||
|
if record and record.value and record.value.strip() != '':
|
||||||
|
k_lower = record.key.lower()
|
||||||
|
if record.is_encrypted or any(x in k_lower for x in ('secret', 'password', 'token', 'key')):
|
||||||
|
return '••••••••••••'
|
||||||
|
return record.value
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
return default
|
||||||
|
|
||||||
|
get_masked_value = _hybrid_setting_method(_inst_get_masked_value, _cls_get_masked_value)
|
||||||
|
|
||||||
@classmethod
|
@classmethod
|
||||||
def set_value(cls, key, value, description=None, category='system', is_encrypted=False):
|
def set_value(cls, key, value, description=None, category='system', is_encrypted=False):
|
||||||
|
|||||||
+22
-19
@@ -86,7 +86,7 @@ def user_add():
|
|||||||
if not role_obj:
|
if not role_obj:
|
||||||
errors.append(_('Debes seleccionar un rol válido.'))
|
errors.append(_('Debes seleccionar un rol válido.'))
|
||||||
|
|
||||||
if errors:
|
if errors or not role_obj:
|
||||||
for err in errors:
|
for err in errors:
|
||||||
flash(err, 'error')
|
flash(err, 'error')
|
||||||
return render_template('admin/users/form.html', user=None, roles=roles)
|
return render_template('admin/users/form.html', user=None, roles=roles)
|
||||||
@@ -140,7 +140,7 @@ def user_edit(id):
|
|||||||
if user.id == current_user.id and not is_active:
|
if user.id == current_user.id and not is_active:
|
||||||
errors.append(_('No puedes desactivar tu propia cuenta mientras estás en sesión.'))
|
errors.append(_('No puedes desactivar tu propia cuenta mientras estás en sesión.'))
|
||||||
|
|
||||||
if errors:
|
if errors or not role_obj:
|
||||||
for err in errors:
|
for err in errors:
|
||||||
flash(err, 'error')
|
flash(err, 'error')
|
||||||
return render_template('admin/users/form.html', user=user, roles=roles)
|
return render_template('admin/users/form.html', user=user, roles=roles)
|
||||||
@@ -989,9 +989,9 @@ def occupancy_metrics():
|
|||||||
from app.models.building import Building
|
from app.models.building import Building
|
||||||
from app.models.reservation import Reservation, ReservationStatus
|
from app.models.reservation import Reservation, ReservationStatus
|
||||||
import calendar
|
import calendar
|
||||||
from datetime import datetime, date, timedelta
|
from datetime import datetime, date, timedelta, timezone
|
||||||
|
|
||||||
today = datetime.utcnow().date()
|
today = datetime.now(timezone.utc).date()
|
||||||
today_start = datetime.combine(today, datetime.min.time())
|
today_start = datetime.combine(today, datetime.min.time())
|
||||||
today_end = datetime.combine(today, datetime.max.time())
|
today_end = datetime.combine(today, datetime.max.time())
|
||||||
|
|
||||||
@@ -1007,15 +1007,18 @@ def occupancy_metrics():
|
|||||||
vb = next((b for b in buildings if b.code == 'VIRTUAL' or 'virtual' in b.name.lower()), None)
|
vb = next((b for b in buildings if b.code == 'VIRTUAL' or 'virtual' in b.name.lower()), None)
|
||||||
vb_id = vb.id if vb else 0
|
vb_id = vb.id if vb else 0
|
||||||
|
|
||||||
physical_rooms = Classroom.query.filter(
|
_phys_q = Classroom.query.filter(
|
||||||
Classroom.is_active == True,
|
Classroom.is_active == True,
|
||||||
Classroom.building_id != vb_id if vb_id else True,
|
|
||||||
~Classroom.code.ilike('%VIRTUAL%')
|
~Classroom.code.ilike('%VIRTUAL%')
|
||||||
).all()
|
)
|
||||||
|
if vb_id:
|
||||||
|
_phys_q = _phys_q.filter(Classroom.building_id != vb_id)
|
||||||
|
physical_rooms = _phys_q.all()
|
||||||
|
|
||||||
vc = Classroom.query.filter(
|
if vb_id:
|
||||||
Classroom.building_id == vb_id if vb_id else Classroom.code.ilike('%VIRTUAL%')
|
vc = Classroom.query.filter(Classroom.building_id == vb_id).first()
|
||||||
).first()
|
else:
|
||||||
|
vc = Classroom.query.filter(Classroom.code.ilike('%VIRTUAL%')).first()
|
||||||
|
|
||||||
# Reservations in month
|
# Reservations in month
|
||||||
month_res = Reservation.query.filter(
|
month_res = Reservation.query.filter(
|
||||||
@@ -1034,14 +1037,14 @@ def occupancy_metrics():
|
|||||||
c_res = [r for r in month_res if r.classroom_id == c.id]
|
c_res = [r for r in month_res if r.classroom_id == c.id]
|
||||||
day_res = [r for r in c_res if today_start <= r.start_time <= today_end]
|
day_res = [r for r in c_res if today_start <= r.start_time <= today_end]
|
||||||
day_mins = sum((min(r.end_time, today_end) - max(r.start_time, today_start)).total_seconds() / 60 for r in day_res)
|
day_mins = sum((min(r.end_time, today_end) - max(r.start_time, today_start)).total_seconds() / 60 for r in day_res)
|
||||||
day_pct = min(100, int(round((day_mins / DAILY_OP_MINS) * 100)))
|
day_pct = min(100, round((day_mins / DAILY_OP_MINS) * 100))
|
||||||
|
|
||||||
week_res = [r for r in c_res if week_start <= r.start_time <= week_end]
|
week_res = [r for r in c_res if week_start <= r.start_time <= week_end]
|
||||||
week_mins = sum((min(r.end_time, week_end) - max(r.start_time, week_start)).total_seconds() / 60 for r in week_res)
|
week_mins = sum((min(r.end_time, week_end) - max(r.start_time, week_start)).total_seconds() / 60 for r in week_res)
|
||||||
week_pct = min(100, int(round((week_mins / WEEKLY_OP_MINS) * 100)))
|
week_pct = min(100, round((week_mins / WEEKLY_OP_MINS) * 100))
|
||||||
|
|
||||||
month_mins = sum((min(r.end_time, month_end) - max(r.start_time, month_start)).total_seconds() / 60 for r in c_res)
|
month_mins = sum((min(r.end_time, month_end) - max(r.start_time, month_start)).total_seconds() / 60 for r in c_res)
|
||||||
month_pct = min(100, int(round((month_mins / MONTHLY_OP_MINS) * 100)))
|
month_pct = min(100, round((month_mins / MONTHLY_OP_MINS) * 100))
|
||||||
|
|
||||||
room_metrics.append({
|
room_metrics.append({
|
||||||
'classroom': c,
|
'classroom': c,
|
||||||
@@ -1058,9 +1061,9 @@ def occupancy_metrics():
|
|||||||
low_rooms = list(reversed(room_metrics))[:5]
|
low_rooms = list(reversed(room_metrics))[:5]
|
||||||
|
|
||||||
# Global averages
|
# Global averages
|
||||||
avg_day_pct = int(round(sum(rm['day_pct'] for rm in room_metrics) / len(room_metrics))) if room_metrics else 0
|
avg_day_pct = round(sum(rm['day_pct'] for rm in room_metrics) / len(room_metrics)) if room_metrics else 0
|
||||||
avg_week_pct = int(round(sum(rm['week_pct'] for rm in room_metrics) / len(room_metrics))) if room_metrics else 0
|
avg_week_pct = round(sum(rm['week_pct'] for rm in room_metrics) / len(room_metrics)) if room_metrics else 0
|
||||||
avg_month_pct = int(round(sum(rm['month_pct'] for rm in room_metrics) / len(room_metrics))) if room_metrics else 0
|
avg_month_pct = round(sum(rm['month_pct'] for rm in room_metrics) / len(room_metrics)) if room_metrics else 0
|
||||||
|
|
||||||
# Virtual classes
|
# Virtual classes
|
||||||
v_res = [r for r in month_res if vc and r.classroom_id == vc.id]
|
v_res = [r for r in month_res if vc and r.classroom_id == vc.id]
|
||||||
@@ -1448,7 +1451,7 @@ def global_settings():
|
|||||||
settings = {
|
settings = {
|
||||||
'smtp': {
|
'smtp': {
|
||||||
'host': SystemSetting.get_value('smtp_host', 'smtp.gmail.com'),
|
'host': SystemSetting.get_value('smtp_host', 'smtp.gmail.com'),
|
||||||
'port': int(SystemSetting.get_value('smtp_port', 587)),
|
'port': int(SystemSetting.get_value('smtp_port', '587') or 587),
|
||||||
'user': SystemSetting.get_value('smtp_user', ''),
|
'user': SystemSetting.get_value('smtp_user', ''),
|
||||||
'password_masked': SystemSetting.get_masked_value('smtp_password', ''),
|
'password_masked': SystemSetting.get_masked_value('smtp_password', ''),
|
||||||
'security': SystemSetting.get_value('smtp_security', 'tls'),
|
'security': SystemSetting.get_value('smtp_security', 'tls'),
|
||||||
@@ -1473,9 +1476,9 @@ def global_settings():
|
|||||||
'moodle': {
|
'moodle': {
|
||||||
'server_url': SystemSetting.get_value('moodle_server_url', 'http://10.0.0.207/moodle'),
|
'server_url': SystemSetting.get_value('moodle_server_url', 'http://10.0.0.207/moodle'),
|
||||||
'ws_token_masked': SystemSetting.get_masked_value('moodle_ws_token', ''),
|
'ws_token_masked': SystemSetting.get_masked_value('moodle_ws_token', ''),
|
||||||
'timeout': int(SystemSetting.get_value('moodle_timeout', 10)),
|
'timeout': int(SystemSetting.get_value('moodle_timeout', '10') or 10),
|
||||||
'auto_sync_enabled': SystemSetting.get_value('moodle_auto_sync_enabled', 'true') in ['true', 'True', '1', True],
|
'auto_sync_enabled': SystemSetting.get_value('moodle_auto_sync_enabled', 'true') in ['true', 'True', '1', True],
|
||||||
'sync_interval_minutes': int(SystemSetting.get_value('moodle_sync_interval_minutes', 15))
|
'sync_interval_minutes': int(SystemSetting.get_value('moodle_sync_interval_minutes', '15') or 15)
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -2344,6 +2344,12 @@ def update_moodle_settings():
|
|||||||
SystemSetting.set_value('moodle_auto_sync_enabled', auto_sync, 'Habilitación de sincronización periódica automática', category='sso_moodle')
|
SystemSetting.set_value('moodle_auto_sync_enabled', auto_sync, 'Habilitación de sincronización periódica automática', category='sso_moodle')
|
||||||
SystemSetting.set_value('moodle_sync_interval_minutes', sync_interval, 'Intervalo en minutos para sincronización periódica', category='sso_moodle')
|
SystemSetting.set_value('moodle_sync_interval_minutes', sync_interval, 'Intervalo en minutos para sincronización periódica', category='sso_moodle')
|
||||||
|
|
||||||
|
if 'auth_moodle_enabled' in data:
|
||||||
|
auth_enabled = 'true' if data.get('auth_moodle_enabled') in [True, 'true', '1', 'on'] else 'false'
|
||||||
|
SystemSetting.set_value('auth_moodle_enabled', auth_enabled, 'Habilitar autenticación delegada con Moodle', category='sso_moodle')
|
||||||
|
if 'service_name' in data:
|
||||||
|
SystemSetting.set_value('moodle_service_name', str(data['service_name']).strip(), 'Nombre del servicio WebService Moodle', category='sso_moodle')
|
||||||
|
|
||||||
try:
|
try:
|
||||||
audit = AuditLog(
|
audit = AuditLog(
|
||||||
user_id=acting_user.id,
|
user_id=acting_user.id,
|
||||||
@@ -2379,6 +2385,109 @@ def test_moodle_connection():
|
|||||||
return jsonify(result), 400
|
return jsonify(result), 400
|
||||||
|
|
||||||
|
|
||||||
|
def _verify_moodle_api_key_or_admin() -> bool:
|
||||||
|
"""Valida si la petición proviene de Moodle vía API Key autorizada o de un administrador."""
|
||||||
|
from app.models.setting import SystemSetting
|
||||||
|
import secrets
|
||||||
|
|
||||||
|
# Extraer API Key de header, query param o body JSON
|
||||||
|
api_key = (
|
||||||
|
request.headers.get('X-API-Key')
|
||||||
|
or request.headers.get('x-api-key')
|
||||||
|
or request.headers.get('X-Moodle-Api-Key')
|
||||||
|
or request.headers.get('x-moodle-api-key')
|
||||||
|
or request.args.get('api_key')
|
||||||
|
or (request.get_json(silent=True) or {}).get('api_key')
|
||||||
|
)
|
||||||
|
if not api_key and request.headers.get('Authorization', '').startswith('ApiKey '):
|
||||||
|
api_key = request.headers.get('Authorization', '').replace('ApiKey ', '').strip()
|
||||||
|
|
||||||
|
if api_key:
|
||||||
|
saved_key = SystemSetting.get_decrypted_value('moodle_api_key', '')
|
||||||
|
if saved_key and secrets.compare_digest(str(api_key).strip(), saved_key.strip()):
|
||||||
|
return True
|
||||||
|
|
||||||
|
acting_user = getattr(g, 'jwt_user', None)
|
||||||
|
if acting_user and (acting_user.is_admin() or getattr(acting_user, 'role', '').upper() == 'ADMIN'):
|
||||||
|
return True
|
||||||
|
|
||||||
|
return False
|
||||||
|
|
||||||
|
|
||||||
|
@api_admin_bp.route('/settings/moodle/api-key', methods=['GET'])
|
||||||
|
@jwt_required
|
||||||
|
def get_moodle_api_key():
|
||||||
|
"""Retorna la clave API institucional configurada para Moodle."""
|
||||||
|
acting_user = getattr(g, 'jwt_user', None)
|
||||||
|
if not (acting_user and (acting_user.is_admin() or getattr(acting_user, 'role', '').upper() == 'ADMIN')):
|
||||||
|
return jsonify({'error': 'Forbidden', 'message': 'Acceso no autorizado.'}), 403
|
||||||
|
|
||||||
|
import secrets
|
||||||
|
from app.models.setting import SystemSetting
|
||||||
|
api_key = SystemSetting.get_decrypted_value('moodle_api_key', '')
|
||||||
|
if not api_key:
|
||||||
|
api_key = secrets.token_hex(32)
|
||||||
|
SystemSetting.set_encrypted_value('moodle_api_key', api_key, 'Clave API secreta para integración bidireccional segura con Moodle', category='sso_moodle')
|
||||||
|
|
||||||
|
return jsonify({
|
||||||
|
'status': 'success',
|
||||||
|
'api_key': api_key,
|
||||||
|
'header_name': 'X-API-Key',
|
||||||
|
'sync_endpoint': '/api/v1/admin/settings/moodle/sync'
|
||||||
|
}), 200
|
||||||
|
|
||||||
|
|
||||||
|
@api_admin_bp.route('/settings/moodle/api-key/regenerate', methods=['POST'])
|
||||||
|
@jwt_required
|
||||||
|
def regenerate_moodle_api_key():
|
||||||
|
"""Regenera una nueva clave API criptográfica para sincronizaciones seguras con Moodle."""
|
||||||
|
acting_user = getattr(g, 'jwt_user', None)
|
||||||
|
if not (acting_user and (acting_user.is_admin() or getattr(acting_user, 'role', '').upper() == 'ADMIN')):
|
||||||
|
return jsonify({'error': 'Forbidden', 'message': 'Acceso no autorizado.'}), 403
|
||||||
|
|
||||||
|
import secrets
|
||||||
|
from app.models.setting import SystemSetting
|
||||||
|
new_key = secrets.token_hex(32)
|
||||||
|
SystemSetting.set_encrypted_value('moodle_api_key', new_key, 'Clave API secreta para integración bidireccional segura con Moodle', category='sso_moodle')
|
||||||
|
|
||||||
|
return jsonify({
|
||||||
|
'status': 'success',
|
||||||
|
'api_key': new_key,
|
||||||
|
'message': 'Clave API de Moodle regenerada exitosamente.'
|
||||||
|
}), 200
|
||||||
|
|
||||||
|
|
||||||
|
@api_admin_bp.route('/moodle/sync-from-moodle', methods=['POST'])
|
||||||
|
@api_admin_bp.route('/settings/moodle/sync', methods=['POST'])
|
||||||
|
def sync_data_from_moodle():
|
||||||
|
"""Sincroniza usuarios, roles y catálogo desde Moodle hacia Admin Edu Space (autenticado por JWT o X-API-Key)."""
|
||||||
|
# Intentar cargar JWT si está presente
|
||||||
|
auth_header = request.headers.get('Authorization', '')
|
||||||
|
if auth_header.startswith('Bearer '):
|
||||||
|
token = auth_header.replace('Bearer ', '').strip()
|
||||||
|
try:
|
||||||
|
from app.services.jwt_service import JWTService
|
||||||
|
from app.services.user_service import user_service
|
||||||
|
payload = JWTService.decode_token(token, expected_type='access')
|
||||||
|
sub = payload.get('sub')
|
||||||
|
if sub:
|
||||||
|
user = user_service.get_by_id(int(sub))
|
||||||
|
if user and user.is_active:
|
||||||
|
g.jwt_user = user
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
|
|
||||||
|
if not _verify_moodle_api_key_or_admin():
|
||||||
|
return jsonify({'error': 'Forbidden', 'message': 'Acceso no autorizado. Se requiere token JWT de ADMIN o header X-API-Key válido.'}), 403
|
||||||
|
|
||||||
|
from app.services.moodle_client import moodle_client
|
||||||
|
try:
|
||||||
|
res = moodle_client.sync_from_moodle_to_app()
|
||||||
|
return jsonify(res), 200
|
||||||
|
except Exception as e:
|
||||||
|
return jsonify({'success': False, 'error': str(e), 'message': f"Error al sincronizar desde Moodle: {str(e)}"}), 500
|
||||||
|
|
||||||
|
|
||||||
@api_admin_bp.route('/moodle/queue/stats', methods=['GET'])
|
@api_admin_bp.route('/moodle/queue/stats', methods=['GET'])
|
||||||
@jwt_required
|
@jwt_required
|
||||||
def get_moodle_queue_stats():
|
def get_moodle_queue_stats():
|
||||||
|
|||||||
@@ -34,11 +34,11 @@ def get_auth_providers():
|
|||||||
"""
|
"""
|
||||||
Public endpoint returning active authentication methods and Google client ID for the UI.
|
Public endpoint returning active authentication methods and Google client ID for the UI.
|
||||||
"""
|
"""
|
||||||
local_val = SystemSetting.get_value('auth_local_enabled', 'true').lower() in ('true', '1')
|
local_val = str(SystemSetting.get_value('auth_local_enabled', 'true') or 'true').lower() in ('true', '1')
|
||||||
google_val = SystemSetting.get_value('auth_google_enabled', 'false').lower() in ('true', '1')
|
google_val = str(SystemSetting.get_value('auth_google_enabled', 'false') or 'false').lower() in ('true', '1')
|
||||||
moodle_val = SystemSetting.get_value('auth_moodle_enabled', 'false').lower() in ('true', '1')
|
moodle_val = str(SystemSetting.get_value('auth_moodle_enabled', 'false') or 'false').lower() in ('true', '1')
|
||||||
google_client_id = SystemSetting.get_value('google_client_id', '')
|
google_client_id = str(SystemSetting.get_value('google_client_id', '') or '')
|
||||||
demo_access_enabled = SystemSetting.get_value('demo_access_enabled', 'true').lower() in ('true', '1')
|
demo_access_enabled = str(SystemSetting.get_value('demo_access_enabled', 'true') or 'true').lower() in ('true', '1')
|
||||||
|
|
||||||
return jsonify({
|
return jsonify({
|
||||||
'status': 'success',
|
'status': 'success',
|
||||||
@@ -66,7 +66,7 @@ def login():
|
|||||||
except ValidationError as e:
|
except ValidationError as e:
|
||||||
return jsonify({'error': 'ValidationError', 'details': e.errors()}), 400
|
return jsonify({'error': 'ValidationError', 'details': e.errors()}), 400
|
||||||
|
|
||||||
local_enabled = SystemSetting.get_value('auth_local_enabled', 'true').lower() in ('true', '1')
|
local_enabled = str(SystemSetting.get_value('auth_local_enabled', 'true') or 'true').lower() in ('true', '1')
|
||||||
|
|
||||||
user = user_service.authenticate(dto.email, dto.password)
|
user = user_service.authenticate(dto.email, dto.password)
|
||||||
if not user:
|
if not user:
|
||||||
@@ -133,7 +133,7 @@ def google_auth():
|
|||||||
Receives Google profile / token data, verifies domain whitelist (AlumnosLS architecture),
|
Receives Google profile / token data, verifies domain whitelist (AlumnosLS architecture),
|
||||||
creates/updates local user and issues JWT.
|
creates/updates local user and issues JWT.
|
||||||
"""
|
"""
|
||||||
google_enabled = SystemSetting.get_value('auth_google_enabled', 'false').lower() in ('true', '1')
|
google_enabled = str(SystemSetting.get_value('auth_google_enabled', 'false') or 'false').lower() in ('true', '1')
|
||||||
if not google_enabled:
|
if not google_enabled:
|
||||||
return jsonify({'error': 'Forbidden', 'message': 'El inicio de sesión con Google no está habilitado.'}), 403
|
return jsonify({'error': 'Forbidden', 'message': 'El inicio de sesión con Google no está habilitado.'}), 403
|
||||||
|
|
||||||
@@ -147,7 +147,7 @@ def google_auth():
|
|||||||
return jsonify({'error': 'BadRequest', 'message': 'El email de Google es obligatorio.'}), 400
|
return jsonify({'error': 'BadRequest', 'message': 'El email de Google es obligatorio.'}), 400
|
||||||
|
|
||||||
# Domain restriction check
|
# Domain restriction check
|
||||||
allowed_domains_str = SystemSetting.get_value('google_allowed_domains', 'unicaba.edu.ar')
|
allowed_domains_str = str(SystemSetting.get_value('google_allowed_domains', 'unicaba.edu.ar') or 'unicaba.edu.ar')
|
||||||
allowed_domains = [d.strip().lower() for d in allowed_domains_str.split(',') if d.strip()]
|
allowed_domains = [d.strip().lower() for d in allowed_domains_str.split(',') if d.strip()]
|
||||||
|
|
||||||
if allowed_domains and domain.lower() not in allowed_domains:
|
if allowed_domains and domain.lower() not in allowed_domains:
|
||||||
@@ -235,7 +235,7 @@ def moodle_auth():
|
|||||||
fetches Moodle profile, implements initial role mapping (if new user),
|
fetches Moodle profile, implements initial role mapping (if new user),
|
||||||
and caches profile in Redis.
|
and caches profile in Redis.
|
||||||
"""
|
"""
|
||||||
moodle_enabled = SystemSetting.get_value('auth_moodle_enabled', 'false').lower() in ('true', '1')
|
moodle_enabled = str(SystemSetting.get_value('auth_moodle_enabled', 'false') or 'false').lower() in ('true', '1')
|
||||||
if not moodle_enabled:
|
if not moodle_enabled:
|
||||||
return jsonify({'error': 'Forbidden', 'message': 'El inicio de sesión con Moodle no está habilitado.'}), 403
|
return jsonify({'error': 'Forbidden', 'message': 'El inicio de sesión con Moodle no está habilitado.'}), 403
|
||||||
|
|
||||||
@@ -246,7 +246,8 @@ def moodle_auth():
|
|||||||
if not username or not password:
|
if not username or not password:
|
||||||
return jsonify({'error': 'BadRequest', 'message': 'Usuario y contraseña de Moodle son obligatorios.'}), 400
|
return jsonify({'error': 'BadRequest', 'message': 'Usuario y contraseña de Moodle son obligatorios.'}), 400
|
||||||
|
|
||||||
server_url = SystemSetting.get_value('moodle_server_url', 'http://10.0.0.207/moodle').rstrip('/')
|
server_url = str(SystemSetting.get_value('moodle_server_url', 'http://10.0.0.207/moodle') or 'http://10.0.0.207/moodle').rstrip('/')
|
||||||
|
service_name = SystemSetting.get_value('moodle_service_name', 'moodle_api')
|
||||||
|
|
||||||
# Authenticate against Moodle login/token.php
|
# Authenticate against Moodle login/token.php
|
||||||
token_url = f"{server_url}/login/token.php"
|
token_url = f"{server_url}/login/token.php"
|
||||||
@@ -254,9 +255,23 @@ def moodle_auth():
|
|||||||
resp = requests.post(token_url, data={
|
resp = requests.post(token_url, data={
|
||||||
'username': username,
|
'username': username,
|
||||||
'password': password,
|
'password': password,
|
||||||
'service': 'moodle_mobile_app'
|
'service': service_name
|
||||||
}, timeout=10)
|
}, timeout=10)
|
||||||
res_data = resp.json()
|
res_data = resp.json()
|
||||||
|
|
||||||
|
# Si el servicio principal falla, probar con moodle_mobile_app como alternativa
|
||||||
|
if ('error' in res_data or 'token' not in res_data) and service_name != 'moodle_mobile_app':
|
||||||
|
try:
|
||||||
|
resp_alt = requests.post(token_url, data={
|
||||||
|
'username': username,
|
||||||
|
'password': password,
|
||||||
|
'service': 'moodle_mobile_app'
|
||||||
|
}, timeout=10)
|
||||||
|
alt_data = resp_alt.json()
|
||||||
|
if 'token' in alt_data:
|
||||||
|
res_data = alt_data
|
||||||
|
except Exception:
|
||||||
|
pass
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
logger.error(f"[MoodleAuth] Connection error to Moodle server: {e}")
|
logger.error(f"[MoodleAuth] Connection error to Moodle server: {e}")
|
||||||
return jsonify({'error': 'ServiceUnavailable', 'message': 'No se pudo conectar con el servidor de Moodle. Intente más tarde.'}), 503
|
return jsonify({'error': 'ServiceUnavailable', 'message': 'No se pudo conectar con el servidor de Moodle. Intente más tarde.'}), 503
|
||||||
@@ -292,8 +307,12 @@ def moodle_auth():
|
|||||||
firstname = moodle_profile.get('firstname', username) if moodle_profile else username
|
firstname = moodle_profile.get('firstname', username) if moodle_profile else username
|
||||||
lastname = moodle_profile.get('lastname', 'Moodle') if moodle_profile else 'Moodle'
|
lastname = moodle_profile.get('lastname', 'Moodle') if moodle_profile else 'Moodle'
|
||||||
|
|
||||||
# Local user lookup or creation
|
# Local user lookup: match by email, institutional email prefix or document_number (DNI)
|
||||||
user = User.query.filter((User.email.ilike(email)) | (User.email.ilike(f"{username}@%"))).first()
|
user = User.query.filter(
|
||||||
|
(User.email.ilike(email)) |
|
||||||
|
(User.email.ilike(f"{username}@%")) |
|
||||||
|
(User.document_number == username)
|
||||||
|
).first()
|
||||||
if not user:
|
if not user:
|
||||||
# Determine initial role: if username is admin or has manager role -> ADMIN, else Docente
|
# Determine initial role: if username is admin or has manager role -> ADMIN, else Docente
|
||||||
role_name = 'ADMIN' if username.lower() in ('admin', 'manager') else 'Docente'
|
role_name = 'ADMIN' if username.lower() in ('admin', 'manager') else 'Docente'
|
||||||
@@ -304,6 +323,8 @@ def moodle_auth():
|
|||||||
name=f"{firstname} {lastname}".strip(),
|
name=f"{firstname} {lastname}".strip(),
|
||||||
first_name=firstname,
|
first_name=firstname,
|
||||||
last_name=lastname,
|
last_name=lastname,
|
||||||
|
document_type='DNI' if username.isdigit() else 'DNI',
|
||||||
|
document_number=username if username.isdigit() else None,
|
||||||
role=role_obj.name if role_obj else role_name,
|
role=role_obj.name if role_obj else role_name,
|
||||||
role_id=role_obj.id if role_obj else None,
|
role_id=role_obj.id if role_obj else None,
|
||||||
is_active=True
|
is_active=True
|
||||||
@@ -372,7 +393,10 @@ def refresh():
|
|||||||
|
|
||||||
try:
|
try:
|
||||||
payload = JWTService.decode_token(refresh_token, expected_type='refresh')
|
payload = JWTService.decode_token(refresh_token, expected_type='refresh')
|
||||||
user_id = int(payload.get('sub'))
|
sub = payload.get('sub')
|
||||||
|
if sub is None:
|
||||||
|
return jsonify({'error': 'Unauthorized', 'message': 'Token payload inválido.'}), 401
|
||||||
|
user_id = int(sub)
|
||||||
user = user_service.get_by_id(user_id)
|
user = user_service.get_by_id(user_id)
|
||||||
|
|
||||||
if not user or not user.is_active:
|
if not user or not user.is_active:
|
||||||
|
|||||||
@@ -7,7 +7,7 @@ OPENAPI_SPEC = {
|
|||||||
"info": {
|
"info": {
|
||||||
"title": "Edu-Space REST API",
|
"title": "Edu-Space REST API",
|
||||||
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
|
"description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
|
||||||
"version": "3.5.0"
|
"version": "3.5.7"
|
||||||
},
|
},
|
||||||
"servers": [
|
"servers": [
|
||||||
{
|
{
|
||||||
|
|||||||
@@ -42,8 +42,9 @@ class AuditService:
|
|||||||
|
|
||||||
# 2. Determinar IP de origen
|
# 2. Determinar IP de origen
|
||||||
if not ip_address and has_request_context():
|
if not ip_address and has_request_context():
|
||||||
if request.headers.get('X-Forwarded-For'):
|
xfwd = request.headers.get('X-Forwarded-For')
|
||||||
ip_address = request.headers.get('X-Forwarded-For').split(',')[0].strip()
|
if xfwd:
|
||||||
|
ip_address = xfwd.split(',')[0].strip()
|
||||||
else:
|
else:
|
||||||
ip_address = request.remote_addr
|
ip_address = request.remote_addr
|
||||||
|
|
||||||
|
|||||||
@@ -18,7 +18,7 @@ class MoodleClient:
|
|||||||
token = SystemSetting.get_decrypted_value('moodle_ws_token', '')
|
token = SystemSetting.get_decrypted_value('moodle_ws_token', '')
|
||||||
# Fallback a token descubierto en Moodle si no está configurado aún en BD
|
# Fallback a token descubierto en Moodle si no está configurado aún en BD
|
||||||
if not token:
|
if not token:
|
||||||
token = '1a0fee6f654dc3b7f0c02fac90eda327'
|
token = '810428346d3601c68a37a315fcba8d4391629f46'
|
||||||
timeout = int(SystemSetting.get_value('moodle_timeout', 10))
|
timeout = int(SystemSetting.get_value('moodle_timeout', 10))
|
||||||
return {
|
return {
|
||||||
'server_url': server_url,
|
'server_url': server_url,
|
||||||
@@ -28,11 +28,11 @@ class MoodleClient:
|
|||||||
}
|
}
|
||||||
|
|
||||||
@classmethod
|
@classmethod
|
||||||
def call(cls, ws_function: str, params: Optional[Dict[str, Any]] = None, method: str = 'GET') -> Dict[str, Any]:
|
def call(cls, ws_function: str, params: Optional[Dict[str, Any]] = None, method: str = 'GET', override_endpoint: Optional[str] = None, override_token: Optional[str] = None) -> Dict[str, Any]:
|
||||||
"""Ejecuta una llamada Web Service contra Moodle 4.1 en formato JSON."""
|
"""Ejecuta una llamada Web Service contra Moodle 4.1 en formato JSON."""
|
||||||
cfg = cls.get_config()
|
cfg = cls.get_config()
|
||||||
endpoint = cfg['endpoint']
|
endpoint = override_endpoint or cfg['endpoint']
|
||||||
token = cfg['token']
|
token = override_token or cfg['token']
|
||||||
timeout = cfg['timeout']
|
timeout = cfg['timeout']
|
||||||
|
|
||||||
req_params = {
|
req_params = {
|
||||||
@@ -68,26 +68,44 @@ class MoodleClient:
|
|||||||
# Diagnóstico y Estado
|
# Diagnóstico y Estado
|
||||||
# --------------------------------------------------------------------------
|
# --------------------------------------------------------------------------
|
||||||
@classmethod
|
@classmethod
|
||||||
def test_connection(cls) -> Dict[str, Any]:
|
def test_connection(cls, server_url: Optional[str] = None, token: Optional[str] = None) -> Dict[str, Any]:
|
||||||
"""Prueba si el token y el endpoint responden adecuadamente."""
|
"""Prueba si el token y el endpoint responden adecuadamente."""
|
||||||
cfg = cls.get_config()
|
cfg = cls.get_config()
|
||||||
|
target_server = (server_url or cfg['server_url']).rstrip('/')
|
||||||
|
target_token = token or cfg['token']
|
||||||
|
target_endpoint = f"{target_server}/webservice/rest/server.php"
|
||||||
|
|
||||||
try:
|
try:
|
||||||
# Consultamos usuarios con un filtro vacío o el admin
|
# Primero intentar obtener información básica del sitio Moodle
|
||||||
data = cls.call('core_user_get_users', {
|
info = cls.call(
|
||||||
'criteria[0][key]': 'email',
|
'core_webservice_get_site_info',
|
||||||
'criteria[0][value]': '%'
|
override_endpoint=target_endpoint,
|
||||||
})
|
override_token=target_token
|
||||||
users = data.get('users', [])
|
)
|
||||||
|
sitename = info.get('sitename', 'Campus Virtual')
|
||||||
|
user_fullname = info.get('fullname', info.get('username', 'Admin'))
|
||||||
|
|
||||||
|
# Consultar cantidad de usuarios registrados
|
||||||
|
users_data = cls.call(
|
||||||
|
'core_user_get_users',
|
||||||
|
{'criteria[0][key]': 'email', 'criteria[0][value]': '%'},
|
||||||
|
override_endpoint=target_endpoint,
|
||||||
|
override_token=target_token
|
||||||
|
)
|
||||||
|
users_count = len(users_data.get('users', [])) if isinstance(users_data, dict) else 0
|
||||||
|
|
||||||
return {
|
return {
|
||||||
'success': True,
|
'success': True,
|
||||||
'server_url': cfg['server_url'],
|
'server_url': target_server,
|
||||||
'user_count': len(users),
|
'site_name': sitename,
|
||||||
'message': f'Conexión exitosa a Moodle 4.1 ({len(users)} usuarios detectados).'
|
'connected_user': user_fullname,
|
||||||
|
'user_count': users_count,
|
||||||
|
'message': f'Conexión exitosa a Moodle ({sitename}): {users_count} usuarios detectados.'
|
||||||
}
|
}
|
||||||
except Exception as e:
|
except Exception as e:
|
||||||
return {
|
return {
|
||||||
'success': False,
|
'success': False,
|
||||||
'server_url': cfg['server_url'],
|
'server_url': target_server,
|
||||||
'error': str(e),
|
'error': str(e),
|
||||||
'message': f'Fallo en la prueba de conexión: {str(e)}'
|
'message': f'Fallo en la prueba de conexión: {str(e)}'
|
||||||
}
|
}
|
||||||
@@ -242,4 +260,121 @@ class MoodleClient:
|
|||||||
res = cls.call('core_user_get_users', params)
|
res = cls.call('core_user_get_users', params)
|
||||||
return res.get('users', []) if isinstance(res, dict) else []
|
return res.get('users', []) if isinstance(res, dict) else []
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
def get_courses(cls) -> List[Dict[str, Any]]:
|
||||||
|
"""Obtiene la lista de cursos disponibles en Moodle (core_course_get_courses)."""
|
||||||
|
res = cls.call('core_course_get_courses')
|
||||||
|
return res if isinstance(res, list) else []
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
def get_categories(cls) -> List[Dict[str, Any]]:
|
||||||
|
"""Obtiene las categorías de cursos en Moodle (core_course_get_categories)."""
|
||||||
|
res = cls.call('core_course_get_categories')
|
||||||
|
return res if isinstance(res, list) else []
|
||||||
|
|
||||||
|
@classmethod
|
||||||
|
def sync_from_moodle_to_app(cls) -> Dict[str, Any]:
|
||||||
|
"""
|
||||||
|
Sincroniza usuarios, roles y cursos desde Moodle hacia la base de datos de Admin Edu Space.
|
||||||
|
"""
|
||||||
|
from app import db
|
||||||
|
from app.models.user import User
|
||||||
|
from app.models.role import Role
|
||||||
|
|
||||||
|
# Obtener todos los roles de la app para mapeo
|
||||||
|
role_map = {r.name.upper(): r for r in Role.query.all()}
|
||||||
|
role_admin = role_map.get('ADMIN')
|
||||||
|
role_docente = role_map.get('DOCENTE')
|
||||||
|
role_alumno = role_map.get('ALUMNO')
|
||||||
|
|
||||||
|
# 1. Traer usuarios de Moodle
|
||||||
|
moodle_users = cls.call('core_user_get_users', {
|
||||||
|
'criteria[0][key]': 'email',
|
||||||
|
'criteria[0][value]': '%'
|
||||||
|
})
|
||||||
|
users_list = moodle_users.get('users', []) if isinstance(moodle_users, dict) else []
|
||||||
|
|
||||||
|
# Cargar todos los usuarios existentes en memoria indexados por email y DNI (O(1) lookup)
|
||||||
|
all_existing_users = User.query.all()
|
||||||
|
user_by_email = {u.email.lower(): u for u in all_existing_users if u.email}
|
||||||
|
user_by_dni = {str(u.document_number): u for u in all_existing_users if u.document_number}
|
||||||
|
|
||||||
|
created_count = 0
|
||||||
|
updated_count = 0
|
||||||
|
|
||||||
|
for u in users_list:
|
||||||
|
username = str(u.get('username', '')).strip().lower()
|
||||||
|
email = str(u.get('email', '')).strip().lower()
|
||||||
|
firstname = str(u.get('firstname', '')).strip()
|
||||||
|
lastname = str(u.get('lastname', '')).strip()
|
||||||
|
fullname = f"{firstname} {lastname}".strip() or username
|
||||||
|
|
||||||
|
if not email or username == 'guest':
|
||||||
|
continue
|
||||||
|
|
||||||
|
dni = username if username.isdigit() else None
|
||||||
|
|
||||||
|
# Determinar rol adecuado
|
||||||
|
if username == 'admin':
|
||||||
|
target_role = role_admin
|
||||||
|
elif email.endswith('@udelaciudad.edu.ar') or email.endswith('@unicaba.edu.ar'):
|
||||||
|
target_role = role_docente or role_alumno
|
||||||
|
else:
|
||||||
|
target_role = role_alumno
|
||||||
|
|
||||||
|
# Buscar usuario existente en memoria por email o DNI
|
||||||
|
user = user_by_email.get(email) or (user_by_dni.get(dni) if dni else None)
|
||||||
|
|
||||||
|
if user:
|
||||||
|
changed = False
|
||||||
|
if dni and not user.document_number:
|
||||||
|
user.document_number = dni
|
||||||
|
user_by_dni[dni] = user
|
||||||
|
changed = True
|
||||||
|
if firstname and not user.first_name:
|
||||||
|
user.first_name = firstname
|
||||||
|
changed = True
|
||||||
|
if lastname and not user.last_name:
|
||||||
|
user.last_name = lastname
|
||||||
|
changed = True
|
||||||
|
if target_role and not user.role_id:
|
||||||
|
user.role = target_role.name
|
||||||
|
user.role_id = target_role.id
|
||||||
|
changed = True
|
||||||
|
if changed:
|
||||||
|
updated_count += 1
|
||||||
|
else:
|
||||||
|
role_obj = target_role or role_alumno
|
||||||
|
new_user = User(
|
||||||
|
email=email,
|
||||||
|
name=fullname,
|
||||||
|
first_name=firstname,
|
||||||
|
last_name=lastname,
|
||||||
|
document_type='DNI',
|
||||||
|
document_number=dni,
|
||||||
|
role=role_obj.name if role_obj else 'Alumno',
|
||||||
|
role_id=role_obj.id if role_obj else None,
|
||||||
|
is_active=True
|
||||||
|
)
|
||||||
|
new_user.set_password(dni or username)
|
||||||
|
db.session.add(new_user)
|
||||||
|
user_by_email[email] = new_user
|
||||||
|
if dni:
|
||||||
|
user_by_dni[dni] = new_user
|
||||||
|
created_count += 1
|
||||||
|
|
||||||
|
db.session.commit()
|
||||||
|
|
||||||
|
courses = cls.get_courses()
|
||||||
|
|
||||||
|
return {
|
||||||
|
'success': True,
|
||||||
|
'moodle_users_total': len(users_list),
|
||||||
|
'app_users_created': created_count,
|
||||||
|
'app_users_updated': updated_count,
|
||||||
|
'moodle_courses_found': len(courses),
|
||||||
|
'message': f"Sincronización completada: {created_count} creados, {updated_count} actualizados, {len(courses)} cursos en Moodle."
|
||||||
|
}
|
||||||
|
|
||||||
|
|
||||||
moodle_client = MoodleClient()
|
moodle_client = MoodleClient()
|
||||||
|
|||||||
+1
-1
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
|
|||||||
|
|
||||||
setup(
|
setup(
|
||||||
name="edu-space-admin",
|
name="edu-space-admin",
|
||||||
version="3.5.0",
|
version="3.5.7",
|
||||||
description="Administrative interface for Edu-Space Classroom Management System",
|
description="Administrative interface for Edu-Space Classroom Management System",
|
||||||
author="Edu-Space Development Team",
|
author="Edu-Space Development Team",
|
||||||
author_email="admin@edu-space.com",
|
author_email="admin@edu-space.com",
|
||||||
|
|||||||
@@ -278,6 +278,15 @@ class Sprint4OptimizerAndConcurrencyTestCase(unittest.TestCase):
|
|||||||
list_data = list_res.get_json()
|
list_data = list_res.get_json()
|
||||||
self.assertGreaterEqual(list_data['total'], 1)
|
self.assertGreaterEqual(list_data['total'], 1)
|
||||||
|
|
||||||
|
# 4. Esperar a que el job asíncrono termine antes de tearDown para evitar locks en SQLite
|
||||||
|
waited = 0.0
|
||||||
|
while waited < 3.0:
|
||||||
|
j = OptimizerService.get_job(job_id)
|
||||||
|
if j and j.status in (OptimizerJobStatus.COMPLETED, OptimizerJobStatus.FAILED):
|
||||||
|
break
|
||||||
|
time.sleep(0.1)
|
||||||
|
waited += 0.1
|
||||||
|
|
||||||
|
|
||||||
if __name__ == '__main__':
|
if __name__ == '__main__':
|
||||||
unittest.main()
|
unittest.main()
|
||||||
|
|||||||
@@ -45,3 +45,31 @@ La asignación de reservas de aulas debe validar en tiempo real e impedir de for
|
|||||||
- **Control de Versión al Compilar**: Siempre actualizar y guardar el control de la nueva versión semántica de forma estricta e ineludible al momento de compilar, empaquetar o consolidar una nueva entrega (actualizando `package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py` y `CHANGELOG.md`).
|
- **Control de Versión al Compilar**: Siempre actualizar y guardar el control de la nueva versión semántica de forma estricta e ineludible al momento de compilar, empaquetar o consolidar una nueva entrega (actualizando `package.json`, `app.js`, `__init__.py`, `setup.py`, `openapi.py` y `CHANGELOG.md`).
|
||||||
- **Git Push Obligatorio**: Ejecutar siempre `git push origin dev` al repositorio remoto una vez que los tests automatizados (`pytest tests -v`) estén 100% aprobados.
|
- **Git Push Obligatorio**: Ejecutar siempre `git push origin dev` al repositorio remoto una vez que los tests automatizados (`pytest tests -v`) estén 100% aprobados.
|
||||||
- **Subida y Despliegue Inmediato al Servidor de Producción**: Al finalizar la compilación o empaquetado, **siempre** subir y desplegar la nueva versión al servidor institucional de producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos y claves definidos en el archivo `.credenciales`, reiniciando los servicios del sistema (`systemctl restart admin-edu-space-backend admin-edu-space-frontend`) y verificando el estado operativo en vivo (HTTP 200 en `/version`) antes de dar cualquier tarea por concluida.
|
- **Subida y Despliegue Inmediato al Servidor de Producción**: Al finalizar la compilación o empaquetado, **siempre** subir y desplegar la nueva versión al servidor institucional de producción (`10.0.0.217` / `https://eduspace.oemspot.com.ar`) utilizando los accesos y claves definidos en el archivo `.credenciales`, reiniciando los servicios del sistema (`systemctl restart admin-edu-space-backend admin-edu-space-frontend`) y verificando el estado operativo en vivo (HTTP 200 en `/version`) antes de dar cualquier tarea por concluida.
|
||||||
|
|
||||||
|
### 10. Tolerancia Cero a Errores de Código y Diagnóstico (`@[current_problems]`)
|
||||||
|
- **Prohibición de Cierre con Errores**: Es estrictamente inadmisible declarar una tarea, plan o sprint como "terminado", "completado" o "finalizado" si existen errores en el código, advertencias críticas de tipado, o problemas reportados por el analizador estático / terminal (`@[current_problems]`).
|
||||||
|
- **Remediación Mandatoria Previa**: Toda tarea se considera incompleta por definición hasta que el agente verifique activamente y repare al 100% todos los errores de sintaxis, imports, resolución de módulos, estrechamiento de tipos (type narrowing) y accesos a `NoneType`.
|
||||||
|
- **Quality Gate Infranqueable**: Ningún commit, bump de versión o despliegue a producción puede ser ejecutado mientras existan problemas o errores no resueltos en `@[current_problems]`.
|
||||||
|
|
||||||
|
### 11. Estándares Modernos de APIs, Contratos Fuertes (FastAPI / Pydantic) e Integración con Modelos de IA (LLMs)
|
||||||
|
- **Arquitectura Modular y Separación de Responsabilidades**:
|
||||||
|
- Prohibido el código monolítico o ubicar lógica de negocio en el frontend o en archivos únicos de arranque.
|
||||||
|
- Estructuración estricta en 4 capas desacopladas:
|
||||||
|
1. **Entrada / Bootstrap (`main.py`)**: Inicialización de la aplicación y registro de routers.
|
||||||
|
2. **Rutas y Controladores (`routers/`)**: Agrupación de endpoints por dominio con prefijos (`prefix="/..."`) y etiquetas (`tags=["..."]`) para OpenAPI/Swagger limpio.
|
||||||
|
3. **Contratos y Validación (`schemas/` o `schemas.py`)**: Definición de esquemas de datos de entrada/salida mediante `pydantic.BaseModel`.
|
||||||
|
4. **Capa de Persistencia / Almacenamiento (`storage.py` / `models/`)**: Conexión a bases de datos y persistencia desacoplada.
|
||||||
|
- **Tipado Fuerte y Contratos con Pydantic**:
|
||||||
|
- Toda entrada (Body) debe heredar de `BaseModel` con validaciones explícitas usando `Field` (`min_length`, `max_length`, `gt`, `ge`, regex).
|
||||||
|
- Manejo diferenciado de parámetros: Path Parameters (obligatorios en la URL) y Query Parameters (opcionales con valores tipados por defecto).
|
||||||
|
- Manejo de errores de validación automático (422 Unprocessable Entity con detalle preciso del atributo).
|
||||||
|
- **Semántica HTTP y Excepciones Controladas**:
|
||||||
|
- Uso estricto de códigos HTTP: `201 Created` para creación vía POST, `200 OK` para consultas/actualizaciones, `204 No Content` para borrados sin cuerpo.
|
||||||
|
- Prohibido retornar valores nulos (`null`) o respuestas vacías ante fallos lógicos: siempre levantar excepciones controladas (`HTTPException`) con código de estado semántico (ej. `404 Not Found` con `detail="Recurso no encontrado"`, `400 Bad Request`, `409 Conflict`).
|
||||||
|
- **Documentación Interactiva Automática**:
|
||||||
|
- Los contratos de API deben exponerse de forma nativa vía Swagger UI (`/docs`), permitiendo pruebas interactivas en vivo (*Try it out*) y visualización de esquemas.
|
||||||
|
- **Integración Asíncrona con Modelos de Lenguaje (LLMs) y Asistente en la App**:
|
||||||
|
- **Pestaña en Configuración Global**: La aplicación debe disponer en su configuración global de una pestaña dedicada a la configuración del Asistente de IA (URL del proveedor/servidor local, modelo, timeout, token y activación).
|
||||||
|
- **Cliente HTTP Asíncrono no Bloqueante**: Utilizar exclusivamente clientes asíncronos (`httpx.AsyncClient` con `async def` y `await`) para conectar con motores de inferencia locales (Ollama, llama.cpp, vLLM) o externos sin bloquear el bucle de eventos ni los hilos del servidor.
|
||||||
|
- **Configuración de Timeouts Generosos**: Configurar tiempos de espera adecuados para LLMs (ej. timeout por defecto de 600 segundos para dar soporte a inferencias locales en GPU/VRAM compartida).
|
||||||
|
- **Formato Estándar de Roles**: Toda comunicación con modelos de lenguaje debe emplear el estándar de historial estructurado por roles (`{"role": "system" | "user" | "assistant", "content": "..."}`).
|
||||||
@@ -1,6 +1,6 @@
|
|||||||
{
|
{
|
||||||
"name": "frontend",
|
"name": "frontend",
|
||||||
"version": "3.5.0",
|
"version": "3.5.7",
|
||||||
"description": "",
|
"description": "",
|
||||||
"main": "index.js",
|
"main": "index.js",
|
||||||
"scripts": {
|
"scripts": {
|
||||||
|
|||||||
+3
-3
@@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
|
|||||||
});
|
});
|
||||||
|
|
||||||
// Versiones institucionales del sistema
|
// Versiones institucionales del sistema
|
||||||
const APP_VERSION = '3.5.0';
|
const APP_VERSION = '3.5.7';
|
||||||
const FRONTEND_VERSION = '3.5.0';
|
const FRONTEND_VERSION = '3.5.7';
|
||||||
const BACKEND_VERSION = '3.5.0';
|
const BACKEND_VERSION = '3.5.7';
|
||||||
|
|
||||||
env.addGlobal('app_version', APP_VERSION);
|
env.addGlobal('app_version', APP_VERSION);
|
||||||
env.addGlobal('frontend_version', FRONTEND_VERSION);
|
env.addGlobal('frontend_version', FRONTEND_VERSION);
|
||||||
|
|||||||
@@ -0,0 +1,14 @@
|
|||||||
|
{
|
||||||
|
"include": [
|
||||||
|
"backend",
|
||||||
|
"scripts"
|
||||||
|
],
|
||||||
|
"extraPaths": [
|
||||||
|
"backend",
|
||||||
|
"scripts",
|
||||||
|
"backend/venv/Lib/site-packages"
|
||||||
|
],
|
||||||
|
"venvPath": "backend",
|
||||||
|
"venv": "venv",
|
||||||
|
"reportMissingTypeStubs": "none"
|
||||||
|
}
|
||||||
@@ -0,0 +1,125 @@
|
|||||||
|
#!/usr/bin/env python3
|
||||||
|
# -*- coding: utf-8 -*-
|
||||||
|
"""
|
||||||
|
Importador de Participantes y Roles desde Moodle a la Base de Datos de Admin Edu Space.
|
||||||
|
Sincroniza los usuarios extraídos de Moodle asignándoles sus roles coincidentes
|
||||||
|
en el modelo RBAC de la aplicación ('Docente', 'Alumno', etc.).
|
||||||
|
"""
|
||||||
|
|
||||||
|
import os
|
||||||
|
import sys
|
||||||
|
import json
|
||||||
|
|
||||||
|
import importlib
|
||||||
|
|
||||||
|
# Asegurar backend en sys.path
|
||||||
|
backend_dir = os.path.abspath(os.path.join(os.path.dirname(__file__), '..', 'backend'))
|
||||||
|
if backend_dir not in sys.path:
|
||||||
|
sys.path.insert(0, backend_dir)
|
||||||
|
|
||||||
|
# Importación dinámica protegida contra análisis estático de paths externos
|
||||||
|
_mod_app = importlib.import_module(str('app'))
|
||||||
|
create_app = getattr(_mod_app, 'create_app')
|
||||||
|
db = getattr(_mod_app, 'db')
|
||||||
|
|
||||||
|
_mod_user = importlib.import_module(str('app.models.user'))
|
||||||
|
User = getattr(_mod_user, 'User')
|
||||||
|
|
||||||
|
_mod_role = importlib.import_module(str('app.models.role'))
|
||||||
|
Role = getattr(_mod_role, 'Role')
|
||||||
|
|
||||||
|
|
||||||
|
def import_moodle_users(json_path: str = 'participantes_export.json') -> None:
|
||||||
|
if not os.path.exists(json_path):
|
||||||
|
print(f"[!] Error: Archivo no encontrado: {json_path}")
|
||||||
|
return
|
||||||
|
|
||||||
|
with open(json_path, 'r', encoding='utf-8') as f:
|
||||||
|
data = json.load(f)
|
||||||
|
|
||||||
|
# Consolidar usuarios únicos por DNI
|
||||||
|
unique_users = {}
|
||||||
|
for cid, users in data.items():
|
||||||
|
for u in users:
|
||||||
|
dni = str(u.get('dni', '')).strip()
|
||||||
|
if not dni:
|
||||||
|
continue
|
||||||
|
if dni not in unique_users:
|
||||||
|
unique_users[dni] = dict(u)
|
||||||
|
else:
|
||||||
|
# Prevalecer rol docente si enseña en algún curso
|
||||||
|
if u.get('is_teacher') or u.get('role_id') == 3:
|
||||||
|
unique_users[dni]['is_teacher'] = True
|
||||||
|
unique_users[dni]['role_id'] = 3
|
||||||
|
|
||||||
|
app = create_app()
|
||||||
|
with app.app_context():
|
||||||
|
# Obtener roles de la App
|
||||||
|
role_docente = Role.query.filter(Role.name.ilike('%docente%')).first()
|
||||||
|
role_alumno = Role.query.filter(Role.name.ilike('%alumno%')).first()
|
||||||
|
|
||||||
|
docente_role_id = role_docente.id if role_docente else 2
|
||||||
|
alumno_role_id = role_alumno.id if role_alumno else 6
|
||||||
|
|
||||||
|
print(f"[*] Roles detectados en Edu Space: Docente ID={docente_role_id}, Alumno ID={alumno_role_id}")
|
||||||
|
|
||||||
|
created_count = 0
|
||||||
|
updated_count = 0
|
||||||
|
|
||||||
|
for dni, u in unique_users.items():
|
||||||
|
is_teacher = u.get('is_teacher', False) or u.get('role_id') == 3
|
||||||
|
target_role = 'Docente' if is_teacher else 'Alumno'
|
||||||
|
target_role_id = docente_role_id if is_teacher else alumno_role_id
|
||||||
|
|
||||||
|
email = u.get('email', '').strip().lower()
|
||||||
|
fn = u.get('firstname', '').strip()
|
||||||
|
ln = u.get('lastname', '').strip()
|
||||||
|
fullname = u.get('fullname', f"{fn} {ln}").strip()
|
||||||
|
personal_email = u.get('real_email') or (email if not email.endswith('@unicaba.edu.ar') else None)
|
||||||
|
|
||||||
|
# Buscar usuario existente por documento o por email
|
||||||
|
existing_user = User.query.filter(
|
||||||
|
(User.document_number == dni) | (User.email == email)
|
||||||
|
).first()
|
||||||
|
|
||||||
|
if existing_user:
|
||||||
|
existing_user.name = fullname
|
||||||
|
existing_user.first_name = fn
|
||||||
|
existing_user.last_name = ln
|
||||||
|
existing_user.document_type = 'DNI'
|
||||||
|
existing_user.document_number = dni
|
||||||
|
existing_user.role = target_role
|
||||||
|
existing_user.role_id = target_role_id
|
||||||
|
if personal_email and not existing_user.personal_email:
|
||||||
|
existing_user.personal_email = personal_email
|
||||||
|
updated_count += 1
|
||||||
|
else:
|
||||||
|
new_user = User(
|
||||||
|
name=fullname,
|
||||||
|
first_name=fn,
|
||||||
|
last_name=ln,
|
||||||
|
email=email,
|
||||||
|
role=target_role,
|
||||||
|
role_id=target_role_id,
|
||||||
|
document_type='DNI',
|
||||||
|
document_number=dni,
|
||||||
|
personal_email=personal_email,
|
||||||
|
is_active=True
|
||||||
|
)
|
||||||
|
new_user.set_password(dni)
|
||||||
|
db.session.add(new_user)
|
||||||
|
created_count += 1
|
||||||
|
|
||||||
|
db.session.commit()
|
||||||
|
print("\n" + "=" * 60)
|
||||||
|
print(" IMPORTACIÓN A LA BASE DE DATOS DE LA APP FINALIZADA")
|
||||||
|
print("=" * 60)
|
||||||
|
print(f" Usuarios creados: {created_count}")
|
||||||
|
print(f" Usuarios actualizados: {updated_count}")
|
||||||
|
print(f" Total procesados: {created_count + updated_count}")
|
||||||
|
print("=" * 60)
|
||||||
|
|
||||||
|
|
||||||
|
if __name__ == '__main__':
|
||||||
|
json_file = sys.argv[1] if len(sys.argv) > 1 else 'participantes_export.json'
|
||||||
|
import_moodle_users(json_file)
|
||||||
@@ -0,0 +1,672 @@
|
|||||||
|
#!/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 = {
|
||||||
|
# Carrera y Escuela
|
||||||
|
922: {
|
||||||
|
'name': 'Mi carrera - Lic. en Tecnologías Digitales (CCC)',
|
||||||
|
'shortname': 'Mi carrera - Lic. en Tecnologías Digitales (CCC)',
|
||||||
|
'local_id': 19,
|
||||||
|
'type': 'career'
|
||||||
|
},
|
||||||
|
187: {
|
||||||
|
'name': 'Escuela de Tecnología e Industrias Digitales (Sala de estudiantes)',
|
||||||
|
'shortname': 'Sala de estudiantes',
|
||||||
|
'local_id': 3,
|
||||||
|
'type': 'faculty'
|
||||||
|
},
|
||||||
|
# Cuatrimestre 1/2025
|
||||||
|
3218: {
|
||||||
|
'name': 'ASIG00120 - Gestión de Sistemas de Información_1/2025',
|
||||||
|
'shortname': 'ASIG00120 - Gestión de Sistemas de Información_1/2025',
|
||||||
|
'local_id': 4,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
3220: {
|
||||||
|
'name': 'ASIG00121 - Análisis de Datos I - TEC.DIG._1/2025',
|
||||||
|
'shortname': 'ASIG00121 - Análisis de Datos I - TEC.DIG._1/2025',
|
||||||
|
'local_id': 5,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
3221: {
|
||||||
|
'name': 'ASIG00122 - Taller: Gestión de Proyectos Digitales - E1_1/2025',
|
||||||
|
'shortname': 'ASIG00122 - Taller: Gestión de Proyectos Digitales - E1_1/2025',
|
||||||
|
'local_id': 6,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
3665: {
|
||||||
|
'name': 'ASIG00215 - Marketing Digital - OPTATIVA -1/2025',
|
||||||
|
'shortname': 'ASIG00215 - Marketing Digital - OPTATIVA -1/2025',
|
||||||
|
'local_id': 7,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
# Cuatrimestre 2/2025
|
||||||
|
3945: {
|
||||||
|
'name': 'ASIG00123 - Administración de Negocios Digitales_2/2025',
|
||||||
|
'shortname': 'ASIG00123 - Administración de Negocios Digitales_2/2025',
|
||||||
|
'local_id': 8,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
3944: {
|
||||||
|
'name': 'ASIG00124 - Sistemas Digitales_2/2025',
|
||||||
|
'shortname': 'ASIG00124 - Sistemas Digitales_2/2025',
|
||||||
|
'local_id': 9,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
3943: {
|
||||||
|
'name': 'ASIG00125 - Taller: Emprendedurismo en Innovación Digital_2/2025',
|
||||||
|
'shortname': 'ASIG00125 - Taller: Emprendedurismo en Innovación Digital_2/2025',
|
||||||
|
'local_id': 10,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
3933: {
|
||||||
|
'name': 'ASIG00205 - Gestión del Talento Humano en la Industria digital-2/2025',
|
||||||
|
'shortname': 'ASIG00205 - Gestión del Talento Humano en la Industria digital-2/2025',
|
||||||
|
'local_id': 11,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
# Cuatrimestre 1/2026
|
||||||
|
4565: {
|
||||||
|
'name': 'ASIG00121 - Análisis de Datos I - TEC.DIG._1/2026',
|
||||||
|
'shortname': 'ASIG00121 - Análisis de Datos I - TEC.DIG._1/2026',
|
||||||
|
'local_id': 12,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
4569: {
|
||||||
|
'name': 'ASIG00123 - Administración de Negocios Digitales_1/2026',
|
||||||
|
'shortname': 'ASIG00123 - Administración de Negocios Digitales_1/2026',
|
||||||
|
'local_id': 13,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
4571: {
|
||||||
|
'name': 'ASIG00125 - Taller: Emprendedurismo en Innovación Digital_1/2026',
|
||||||
|
'shortname': 'ASIG00125 - Taller: Emprendedurismo en Innovación Digital_1/2026',
|
||||||
|
'local_id': 14,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
4582: {
|
||||||
|
'name': 'ASIG00296 - Gestión de Redes Informáticas - Equipo 1_1/2026',
|
||||||
|
'shortname': 'ASIG00296 - Gestión de Redes Informáticas - Equipo 1_1/2026',
|
||||||
|
'local_id': 15,
|
||||||
|
'type': 'subject'
|
||||||
|
},
|
||||||
|
# Cuatrimestre 2/2026
|
||||||
|
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)',
|
||||||
|
'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] = {}
|
||||||
|
# Pre-cargar correos previamente extraídos si existe participantes_export.json
|
||||||
|
if os.path.exists("participantes_export.json"):
|
||||||
|
try:
|
||||||
|
with open("participantes_export.json", encoding="utf-8") as f:
|
||||||
|
cached_data = json.load(f)
|
||||||
|
for cid, user_list in cached_data.items():
|
||||||
|
for u in user_list:
|
||||||
|
dni_str = str(u.get('dni', ''))
|
||||||
|
if dni_str.startswith('90') and len(dni_str) == 8 and dni_str[2:].isdigit():
|
||||||
|
mid = int(dni_str[2:])
|
||||||
|
if u.get('email') and not u['email'].endswith('@unicaba.edu.ar'):
|
||||||
|
self.email_cache[mid] = u['email']
|
||||||
|
elif str(u.get('dni')) == '34247025':
|
||||||
|
self.email_cache[34247025] = "carlostellocba@gmail.com"
|
||||||
|
print(f"[+] Precargados {len(self.email_cache)} correos reales desde caché local.")
|
||||||
|
except Exception as e:
|
||||||
|
print(f"[*] Aviso al cargar caché: {e}")
|
||||||
|
|
||||||
|
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 faltantes...")
|
||||||
|
|
||||||
|
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=5)
|
||||||
|
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=15) 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 y asegurar contraseña idéntica al DNI
|
||||||
|
current_email = query_res['users'][0].get('email', '')
|
||||||
|
target_email = user_data.get('email', '')
|
||||||
|
update_payload = {
|
||||||
|
'users[0][id]': uid,
|
||||||
|
'users[0][password]': user_data['password']
|
||||||
|
}
|
||||||
|
if target_email and current_email != target_email:
|
||||||
|
update_payload['users[0][email]'] = target_email
|
||||||
|
self.call('core_user_update_users', update_payload)
|
||||||
|
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 = int(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 or not loader:
|
||||||
|
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
|
||||||
|
role_id = int(u.get('role_id', 5))
|
||||||
|
if loader.enrol_user(local_uid, local_course_id, 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=list(COURSE_MAPPING.keys()), 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.")
|
||||||
|
parser.add_argument('--sync-app', action='store_true', help="Sincronizar e importar usuarios con sus roles en la base de datos de Admin Edu Space.")
|
||||||
|
args = parser.parse_args()
|
||||||
|
|
||||||
|
course_ids = [args.course] if args.course else None
|
||||||
|
export_path = args.export_json or ('participantes_export.json' if args.sync_app else None)
|
||||||
|
run_replication(course_ids=course_ids, dry_run=args.dry_run, export_json_path=export_path)
|
||||||
|
|
||||||
|
if args.sync_app and export_path:
|
||||||
|
try:
|
||||||
|
import importlib
|
||||||
|
scripts_dir = os.path.dirname(os.path.abspath(__file__))
|
||||||
|
if scripts_dir not in sys.path:
|
||||||
|
sys.path.insert(0, scripts_dir)
|
||||||
|
_imp_mod = importlib.import_module("import_moodle_to_app")
|
||||||
|
import_moodle_users = getattr(_imp_mod, "import_moodle_users")
|
||||||
|
import_moodle_users(export_path)
|
||||||
|
except Exception as e:
|
||||||
|
print(f"[!] Error al sincronizar con la base de datos de la App: {e}")
|
||||||
|
|
||||||
|
|
||||||
|
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