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 = ` -
Reservations Assigned
+Reservas Asignadas
Fitness Score
+Puntaje de Aptitud (Fitness)
Total Requests
+Total de Solicitudes
| Code | -Name | -Students | +Código | +Asignatura | +Estudiantes |
|---|
| # | -Purpose | -Classroom | -Start Time | -End Time | -Attendees | +Propósito | +Aula Asignada | +Inicio | +Fin | +Asistentes |
|---|