diff --git a/CHANGELOG.md b/CHANGELOG.md index 41706ef..3be818e 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -11,6 +11,18 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1 - **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1. - **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción. +## [3.4.5] - 2026-10-08 +### Corregido & Mejorado (Optimizador de Aulas por Inteligencia Artificial - IA) +- **Corrección de Permisos RBAC para Bedelía y Operadores en el Optimizador Genético:** + - Resolución del bloqueo que devolvía `403 Forbidden` a usuarios con rol `Bedelia`, `Docente` o Administradores con roles formateados en minúsculas en los endpoints `/api/genetic/commissions`, `/api/genetic/algorithm-status`, `/api/genetic/preview-optimization`, `/api/genetic/optimize` y `/api/genetic/apply-optimization`. + - Creación del helper de verificación de permisos `check_optimizer_permission(user, requires_write)` en `backend/app/routes/genetic_algorithm.py` admitiendo a Administradores, Bedelía, Docentes y permisos RBAC personalizados. +- **Enriquecimiento del Listado de Comisiones para Asignación Áulica:** + - `GET /api/genetic/commissions` ahora expone `subject_name`, `subject_code`, `career_name`, `schedule` y `shift` para cada comisión activa. +- **Rediseño e Internacionalización de la Interfaz del Optimizador:** + - `frontend/views/genetic_optimizer.html`: Interfaz traducida integralmente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas interactivas de comisiones con badges de código, asignatura, carrera, turno, horario y aforo, buscador en vivo multi-criterio y manejo de errores visible. + - `frontend/public/js/genetic-algorithm.js`: Traducción de alertas, modales y tablas de resultados ("Resultados de la Optimización", "Previsualización", confirmación de aplicación directa a Bedelía). + - Protección de la ruta web `/genetic_optimizer` con `requireAuth` e inyección de datos de sesión en `frontend/src/app.js`. + ## [3.4.4] - 2026-10-07 ### Añadido & Mejorado (Dashboard Operativo de Bedelía y Admin) - **Filtro Temporal "Mañana" en Switchers de Período y Cartelera:** diff --git a/MEMORY.md b/MEMORY.md index b1e74e2..42e65d7 100644 --- a/MEMORY.md +++ b/MEMORY.md @@ -132,6 +132,22 @@ Memoria del proyecto entre sesiones para la rama `dev`. - Versión incrementada a `v3.4.4` en Frontend y Backend. - Despliegue al servidor institucional `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificación en caliente. +- **Sprint Optimizador de Aulas IA: Corrección de Permisos y Carga de Comisiones (v3.4.5)**: + - **Problema Reportado**: AI Room Reservation Optimizer no mostraba comisiones y los indicadores de Available Classrooms, Active Commissions y Existing Reservations quedaban en `--`. + - **Causa Raíz Identificada**: + - En `backend/app/routes/genetic_algorithm.py` las rutas `@genetic_bp.route('/commissions')`, `/algorithm-status`, `/preview-optimization`, `/optimize` y `/apply-optimization` exigían de forma estricta `g.jwt_user.role in ['ADMIN', 'teacher']` o `g.jwt_user.role in ['ADMIN']`. + - Al ingresar como Bedelía (`role == 'Bedelia'`), Docentes o Administradores con rol en minúsculas, el backend devolvía `403 Forbidden`, bloqueando la llamada AJAX y dejando la interfaz vacía con `--`. + - En el Frontend BFF, la ruta `/genetic_optimizer` no requería `requireAuth` ni pasaba datos de sesión de usuario a la plantilla. + - **Solución Implementada**: + - Creación del helper `check_optimizer_permission(user, requires_write)` en `backend/app/routes/genetic_algorithm.py` habilitando acceso a `admin`, `administrador`, `bedelia`, `docente`/`teacher` y permisos RBAC en 'optimizer'. + - `GET /api/genetic/commissions` ahora enriquece los objetos con `subject_name`, `subject_code`, `career_name`, `schedule` y `shift`. + - `frontend/views/genetic_optimizer.html`: Traducido íntegramente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas de comisiones con badges, buscador en vivo multi-criterio y manejo de errores visual. + - `frontend/public/js/genetic-algorithm.js`: Traducción de alertas, modales y tablas de resultados. + - `frontend/src/app.js`: Protección con `requireAuth` e inyección de sesión a la vista. + - **Bump Semántico y Despliegue Obligatorio (Principio 9)**: + - Versión incrementada a `v3.4.5` en Frontend y Backend. + - Despliegue inmediato al servidor institucional `10.0.0.217` y verificación en caliente HTTP 200. + ## Próximos pasos 1. Continuar con los objetivos de la Fase 6 del Roadmap institucional (Docker-compose productivo, Nginx con SSL y automatización de workers continuos Moodle). 2. Monitoreo continuo de la experiencia de usuario en Bedelía, Cartelera del Día y Sincronización Académica. \ No newline at end of file diff --git a/ROADMAP.md b/ROADMAP.md index 769fb22..2864886 100644 --- a/ROADMAP.md +++ b/ROADMAP.md @@ -2,8 +2,8 @@ ## Gestión de Espacios Áulicos, Asignación de Comisiones y Operatoria de Bedelía **Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA) -**Versión:** 3.4.4 (Dashboard Bedelía: Filtro Temporal "Mañana" en Switchers y Cartelera Operativa) -**Fecha de Actualización:** 07 de Octubre de 2026 +**Versión:** 3.4.5 (Optimizador de Aulas IA: Corrección de Permisos Bedelía, Carga de Comisiones e Interfaz en Español) +**Fecha de Actualización:** 08 de Octubre de 2026 **Rama Base:** `dev` --- diff --git a/backend/app/__init__.py b/backend/app/__init__.py index e7b784c..763534d 100644 --- a/backend/app/__init__.py +++ b/backend/app/__init__.py @@ -6,7 +6,7 @@ from flask_babel import Babel, gettext as _ from config.config import Config # Initialize extensions -__version__ = "3.4.4" +__version__ = "3.4.5" db = SQLAlchemy() migrate = Migrate() cors = CORS() diff --git a/backend/app/routes/api/openapi.py b/backend/app/routes/api/openapi.py index 7880a55..b640375 100644 --- a/backend/app/routes/api/openapi.py +++ b/backend/app/routes/api/openapi.py @@ -7,7 +7,7 @@ OPENAPI_SPEC = { "info": { "title": "Edu-Space REST API", "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.", - "version": "3.4.4" + "version": "3.4.5" }, "servers": [ { diff --git a/backend/app/routes/genetic_algorithm.py b/backend/app/routes/genetic_algorithm.py index d3abe74..0fddb9b 100644 --- a/backend/app/routes/genetic_algorithm.py +++ b/backend/app/routes/genetic_algorithm.py @@ -8,6 +8,33 @@ from app.utils.jwt_decorators import jwt_required genetic_bp = Blueprint('genetic_algorithm', __name__, url_prefix='/api/genetic') +def check_optimizer_permission(user, requires_write=False): + """ + Verifica si el usuario tiene permiso para consultar o ejecutar el optimizador de reservas. + Permitido para Administradores, Bedelía, Docentes o usuarios con permisos RBAC en 'optimizer'. + """ + if not user: + return False + + # 1. Administrador (método o rol) + if hasattr(user, 'is_admin') and user.is_admin(): + return True + + role = (getattr(user, 'role', '') or '').strip().lower() + if role in ['admin', 'administrador', 'bedelia']: + return True + if role in ['docente', 'teacher']: + return True + + # 2. RBAC granular + if hasattr(user, 'has_permission'): + if requires_write: + return user.has_permission('optimizer', 'read_write') + return user.has_permission('optimizer', 'read') or user.has_permission('optimizer', 'read_write') + + return False + + @genetic_bp.route('/optimize', methods=['POST']) @jwt_required def optimize_reservations(): @@ -39,8 +66,8 @@ def optimize_reservations(): except ValueError: return jsonify({'error': 'Invalid end_date format. Use ISO format.'}), 400 - # Check if user has permission (admin, teacher or RBAC optimizer write) - if not (g.jwt_user.is_admin() or g.jwt_user.has_permission('optimizer', 'read_write') or g.jwt_user.role in ['ADMIN', 'teacher']): + # Check if user has permission (admin, bedelia, teacher or RBAC optimizer write) + if not check_optimizer_permission(g.jwt_user, requires_write=True): return jsonify({'error': 'Insufficient permissions to optimize reservations'}), 403 # Initialize optimizer and run optimization @@ -84,7 +111,7 @@ def apply_optimization(): return jsonify({'error': 'reservations must be a list'}), 400 # Check if user has permission - if not (g.jwt_user.is_admin() or g.jwt_user.has_permission('optimizer', 'read_write') or g.jwt_user.role in ['ADMIN', 'teacher']): + if not check_optimizer_permission(g.jwt_user, requires_write=True): return jsonify({'error': 'Insufficient permissions to apply reservations'}), 403 # Initialize optimizer and apply reservations @@ -124,7 +151,7 @@ def preview_optimization(): return jsonify({'error': 'commission_ids must be a non-empty list'}), 400 # Check if user has permission - if g.jwt_user.role not in ['ADMIN', 'teacher']: + if not check_optimizer_permission(g.jwt_user, requires_write=False): return jsonify({'error': 'Insufficient permissions to preview optimization'}), 403 # Initialize optimizer and run optimization @@ -171,7 +198,7 @@ def get_commissions(): """Get available commissions for optimization""" try: # Check if user has permission - if g.jwt_user.role not in ['ADMIN', 'teacher']: + if not check_optimizer_permission(g.jwt_user, requires_write=False): return jsonify({'error': 'Insufficient permissions'}), 403 from app.models.subject import Commission, Subject @@ -183,6 +210,8 @@ def get_commissions(): for commission in commissions: commission_dict = commission.to_dict() commission_dict['get_full_code'] = commission.get_full_code() + commission_dict['subject_name'] = commission.subject.name if commission.subject else 'Sin Asignatura' + commission_dict['subject_code'] = commission.subject.code if commission.subject else '' commissions_data.append(commission_dict) return jsonify({ @@ -201,7 +230,7 @@ def get_algorithm_status(): """Get genetic algorithm configuration status""" try: # Check if user has permission - if g.jwt_user.role not in ['ADMIN']: + if not check_optimizer_permission(g.jwt_user, requires_write=False): return jsonify({'error': 'Insufficient permissions'}), 403 # Get system status @@ -249,7 +278,7 @@ genetic_web_bp = Blueprint('genetic_algorithm_web', __name__) @jwt_required def genetic_optimizer(): """Render the genetic algorithm optimizer interface""" - if not (g.jwt_user.has_permission('optimizer', 'read') or (g.jwt_user.role and g.jwt_user.role.upper() == 'ADMIN')): + if not check_optimizer_permission(g.jwt_user, requires_write=False): return render_template('auth/403.html'), 403 return render_template('genetic_optimizer.html') \ No newline at end of file diff --git a/backend/setup.py b/backend/setup.py index a31be7c..82ee8b1 100644 --- a/backend/setup.py +++ b/backend/setup.py @@ -2,7 +2,7 @@ from setuptools import setup, find_packages setup( name="edu-space-admin", - version="3.4.4", + version="3.4.5", description="Administrative interface for Edu-Space Classroom Management System", author="Edu-Space Development Team", author_email="admin@edu-space.com", diff --git a/frontend/package.json b/frontend/package.json index 8d6570c..fc8f5fa 100644 --- a/frontend/package.json +++ b/frontend/package.json @@ -1,6 +1,6 @@ { "name": "frontend", - "version": "3.4.4", + "version": "3.4.5", "description": "", "main": "index.js", "scripts": { diff --git a/frontend/public/js/genetic-algorithm.js b/frontend/public/js/genetic-algorithm.js index 0311059..0303f49 100644 --- a/frontend/public/js/genetic-algorithm.js +++ b/frontend/public/js/genetic-algorithm.js @@ -143,7 +143,7 @@ class GeneticAlgorithmManager { const commissionIds = this.getSelectedCommissionIds(); if (commissionIds.length === 0) { - this.showAlert('Please select at least one commission to optimize.', 'warning'); + this.showAlert('Por favor seleccione al menos una comisión para optimizar.', 'warning'); return; } @@ -153,12 +153,12 @@ class GeneticAlgorithmManager { if (result.success) { this.displayOptimizationResults(result.data); - this.showAlert('Optimization completed successfully!', 'success'); + this.showAlert('¡Optimización de reservas completada con éxito!', 'success'); } else { - this.showAlert('Optimization failed: ' + (result.error || 'Unknown error'), 'danger'); + this.showAlert('Fallo en la optimización: ' + (result.error || 'Error desconocido'), 'danger'); } } catch (error) { - this.showAlert('Error during optimization: ' + error.message, 'danger'); + this.showAlert('Error durante la optimización: ' + error.message, 'danger'); } finally { this.showLoading(false); } @@ -169,7 +169,7 @@ class GeneticAlgorithmManager { const commissionIds = this.getSelectedCommissionIds(); if (commissionIds.length === 0) { - this.showAlert('Please select at least one commission to preview.', 'warning'); + this.showAlert('Por favor seleccione al menos una comisión para previsualizar.', 'warning'); return; } @@ -179,12 +179,12 @@ class GeneticAlgorithmManager { if (result.success) { this.displayPreviewResults(result.data); - this.showAlert('Preview generated successfully!', 'success'); + this.showAlert('¡Previsualización generada con éxito!', 'success'); } else { - this.showAlert('Preview failed: ' + (result.error || 'Unknown error'), 'danger'); + this.showAlert('Fallo en la previsualización: ' + (result.error || 'Error desconocido'), 'danger'); } } catch (error) { - this.showAlert('Error during preview: ' + error.message, 'danger'); + this.showAlert('Error durante la previsualización: ' + error.message, 'danger'); } finally { this.showLoading(false); } @@ -195,11 +195,11 @@ class GeneticAlgorithmManager { const pendingReservations = this.getPendingReservations(); if (!pendingReservations || pendingReservations.length === 0) { - this.showAlert('No pending reservations to apply.', 'warning'); + this.showAlert('No hay reservas optimizadas pendientes de aplicar.', 'warning'); return; } - if (!confirm('Are you sure you want to apply these reservations? This will create actual reservation records.')) { + if (!confirm('¿Está seguro de que desea aplicar estas asignaciones optimizadas? Se crearán las reservas definitivas en el sistema.')) { return; } @@ -208,15 +208,15 @@ class GeneticAlgorithmManager { const result = await this.applyOptimization(pendingReservations); if (result.success) { - this.showAlert(`Successfully applied ${result.data.applied_count} reservations!`, 'success'); + this.showAlert(`¡Se aplicaron con éxito ${result.data.applied_count} reservas en Bedelía!`, 'success'); this.clearPendingReservations(); - // Redirect to reservations page - window.location.href = '/schedule'; + // Redirigir al listado de reservas + window.location.href = '/schedule/list_reservations'; } else { - this.showAlert('Failed to apply reservations: ' + (result.error || 'Unknown error'), 'danger'); + this.showAlert('Fallo al aplicar reservas: ' + (result.error || 'Error desconocido'), 'danger'); } } catch (error) { - this.showAlert('Error applying reservations: ' + error.message, 'danger'); + this.showAlert('Error al aplicar reservas: ' + error.message, 'danger'); } finally { this.showLoading(false); } @@ -252,47 +252,53 @@ class GeneticAlgorithmManager { const scorePercentage = (data.fitness_score * 100).toFixed(1); resultsContainer.innerHTML = ` -
-
-
Optimization Results
+
+
+
Resultados de la Optimización
-
-
+
+
-
-

${data.assigned_reservations}

-

Reservations Assigned

+
+

${data.assigned_reservations}

+

Reservas Asignadas

-
-

${scorePercentage}%

-

Fitness Score

+
+

${scorePercentage}%

+

Puntaje de Aptitud (Fitness)

-
-

${data.total_requests}

-

Total Requests

+
+

${data.total_requests}

+

Total de Solicitudes

${data.conflicts.length > 0 ? ` -
- Warning: ${data.conflicts.length} potential conflicts detected. +
+ +
Atención: Se detectaron ${data.conflicts.length} conflictos potenciales no resueltos.
- ` : ''} + ` : ` +
+ +
Excelente: ¡0 conflictos detectados! Todas las asignaciones cumplen aforo y disponibilidad.
+
+ `} -
- - -
@@ -306,30 +312,30 @@ class GeneticAlgorithmManager { const commissionsHtml = data.commission_details.map(commission => ` - ${commission.code} + ${commission.code} ${commission.name} - ${commission.current_students}/${commission.max_students} + ${commission.current_students || 0}/${commission.max_students} `).join(''); const optimization = data.optimization_result; previewContainer.innerHTML = ` -
-
-
Optimization Preview
+
+
+
Previsualización de la Optimización
-
-
-
-
Commissions to Optimize
-
- - +
+
+
+
Comisiones a Optimizar
+
+
+ - - - + + + @@ -338,20 +344,20 @@ class GeneticAlgorithmManager {
CodeNameStudentsCódigoAsignaturaEstudiantes
-
-
Expected Results
-
    -
  • - Reservations Created: - ${optimization.assigned_reservations} +
    +
    Resultados Estimados
    +
      +
    • + Reservas Creadas: + ${optimization.assigned_reservations}
    • -
    • - Fitness Score: - ${(optimization.fitness_score * 100).toFixed(1)}% +
    • + Puntaje de Aptitud: + ${(optimization.fitness_score * 100).toFixed(1)}%
    • -
    • - Conflicts: - +
    • + Conflictos: + ${optimization.conflicts.length}
    • @@ -361,10 +367,10 @@ class GeneticAlgorithmManager {
      -
    @@ -375,7 +381,7 @@ class GeneticAlgorithmManager { viewReservationDetails() { const reservations = this.getPendingReservations(); if (!reservations || reservations.length === 0) { - this.showAlert('No reservation details available.', 'info'); + this.showAlert('No hay detalles de reserva disponibles.', 'info'); return; } @@ -383,11 +389,11 @@ class GeneticAlgorithmManager { const detailsHtml = reservations.map((res, index) => ` ${index + 1} - ${res.purpose} - Classroom ${res.classroom_id} - ${new Date(res.start_time).toLocaleString()} - ${new Date(res.end_time).toLocaleString()} - ${res.expected_attendees} + ${res.purpose || 'Cursada Académica'} + Aula ID ${res.classroom_id} + ${new Date(res.start_time).toLocaleString('es-AR')} + ${new Date(res.end_time).toLocaleString('es-AR')} + ${res.expected_attendees || 0} `).join(''); @@ -395,15 +401,15 @@ class GeneticAlgorithmManager { if (modal) { modal.querySelector('.modal-body').innerHTML = `
    - - +
    + - - - - - + + + + + diff --git a/frontend/src/app.js b/frontend/src/app.js index 22878ff..5e2f1bc 100644 --- a/frontend/src/app.js +++ b/frontend/src/app.js @@ -85,9 +85,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), { }); // Versiones institucionales del sistema -const APP_VERSION = '3.4.4'; -const FRONTEND_VERSION = '3.4.4'; -const BACKEND_VERSION = '3.4.4'; +const APP_VERSION = '3.4.5'; +const FRONTEND_VERSION = '3.4.5'; +const BACKEND_VERSION = '3.4.5'; env.addGlobal('app_version', APP_VERSION); env.addGlobal('frontend_version', FRONTEND_VERSION); @@ -352,16 +352,22 @@ app.get(['/main/dashboard', '/main'], (req, res) => { res.redirect('/dashboard' + query); }); +const { requireAuth } = require('./middlewares/authMiddleware'); + // Módulo Predictivo y Optimizador -app.get('/predictive', (req, res) => { +app.get('/predictive', requireAuth, (req, res) => { res.render('predictive/index', { - title: 'Dashboard Predictivo - Edu-Space Admin' + title: 'Dashboard Predictivo - Edu-Space Admin', + user: req.user, + user_role: (req.user?.role || 'admin').toLowerCase() }); }); -app.get(['/genetic_optimizer', '/genetic_algorithm_web/genetic_optimizer'], (req, res) => { +app.get(['/genetic_optimizer', '/genetic_algorithm_web/genetic_optimizer'], requireAuth, (req, res) => { res.render('genetic_optimizer', { - title: 'Optimizador de Aulas (IA) - Edu-Space Admin' + title: 'Optimizador de Aulas (IA) - Edu-Space Admin', + user: req.user, + user_role: (req.user?.role || 'admin').toLowerCase() }); }); diff --git a/frontend/views/genetic_optimizer.html b/frontend/views/genetic_optimizer.html index 878ef1f..67f703b 100644 --- a/frontend/views/genetic_optimizer.html +++ b/frontend/views/genetic_optimizer.html @@ -1,6 +1,6 @@ {% extends "base.html" %} -{% block title %}AI Room Reservation Optimizer - Edu-Space Admin{% endblock %} +{% block title %}Optimizador de Aulas (IA) - Edu-Space Admin{% endblock %} {% block extra_css %} @@ -56,21 +57,21 @@ {% block content %}
    - +
    -
    -
    - +
    +
    +

    - AI Room Reservation Optimizer + Optimizador Inteligente de Asignación de Aulas (IA)

    - Use genetic algorithms to automatically optimize room assignments based on capacity, availability, and student enrollment. + Utiliza algoritmos genéticos evolutivos para optimizar la asignación física de espacios áulicos según aforo, turnos y disponibilidad horaria de UniCABA.

    @@ -81,126 +82,140 @@
    - +
    +
    -
    -
    - - Algorithm Status -
    -
    -
    -
    - System Status -
    - Available Classrooms - -- -
    -
    - Active Commissions - -- -
    -
    - Existing Reservations - -- -
    +
    +
    + + Estado del Algoritmo +
    - -
    - Algorithm Configuration -
    - Population Size - 50 +
    +
    + Métricas del Sistema +
    + Aulas Disponibles + -- +
    +
    + Comisiones Activas + -- +
    +
    + Reservas Confirmadas + -- +
    -
    - Generations - 100 -
    -
    - Mutation Rate - 10% + +
    + Parámetros Evolutivos +
    + Tamaño de Población + 50 individuos +
    +
    + Generaciones + 100 iteraciones +
    +
    + Tasa de Mutación + 10% +
    + +
    - -
    -
    - -
    -
    -
    - - Optimization Controls -
    -
    -
    -
    -
    -
    - - -
    -
    -
    -
    - - -
    -
    + +
    +
    +
    + + Controles de Optimización +
    - -
    - - - - +
    +
    +
    +
    + + +
    +
    +
    +
    + + +
    +
    +
    + +
    + + + + +
    -
    - +
    -
    -
    - - Select Commissions to Optimize -
    +
    +
    +
    + + Seleccionar Comisiones a Optimizar +
    + Cargando comisiones de cursada... +
    -
    -
    - + + +
    +
    + + +
    +
    + +
    +
    +
    - Loading commissions... + Cargando comisiones activas...
    @@ -208,9 +223,7 @@
    - - - +
    @@ -223,29 +236,25 @@
    -
    -

    Running genetic algorithm optimization...

    - This may take a few moments +
    +

    Ejecutando algoritmo genético de optimización...

    + Calculando función de aptitud y evaluando combinaciones áulicas sin colisiones...
    #PurposeClassroomStart TimeEnd TimeAttendeesPropósitoAula AsignadaInicioFinAsistentes