feat: implement Bedelía dashboard panels and Phase 1 Automated Security Audit

- Nuevo modelo StudentEnrollment (tabla student_enrollments)
  con inscripcion unica por alumno/comision, estado y notas

- Migracion automatica en init_db.py (CREATE TABLE IF NOT EXISTS)

- Rutas /admin/commissions/ para Bedelia y Admin:
  listado con filtros, detalle, asignar docente,
  inscribir/dar de baja alumnos, cambiar estado

- Blueprint my_subjects_bp en /mis-materias:
  Docente ve solo sus comisiones asignadas
  Alumno ve solo sus inscripciones activas
  Admin/Bedelia ven todo

- Templates: admin/commissions/list.html, detail.html
            my_subjects/list.html, detail.html

- Navbar actualizado por rol:
  Docente y Alumno: 'Mis Materias'
  Bedelia y Admin: 'Gestion de Comisiones'

.gitea/workflows/security-audit.yaml

@@ -0,0 +1,73 @@
+name: Edu-Space Automated Security Audit (Gitea Local)
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  security-scan:
+    # Usamos la etiqueta estándar para contenedores Ubuntu en Gitea Runner
+    runs-on: ubuntu-latest 
+    
+    steps:
+    # 1. Clonar el código del repositorio local
+    - name: Checkout Code
+      uses: actions/checkout@v4
+
+    # 2. Preparar el entorno de paquetes del sistema (Linux)
+    - name: Install System Dependencies (Python & Node.js)
+      run: |
+        apt-get update && apt-get install -y python3 python3-pip python3-venv nodejs npm curl
+        python3 -m pip install --upgrade pip
+
+    # 3. Instalar librerías de Python y herramientas de seguridad
+    - name: Install Python Dependencies & Security Tools
+      run: |
+        pip3 install -r backend/requirements.txt
+        pip3 install -r backend/requirements-dev.txt
+
+    # 4. Instalar librerías de Node.js (Express BFF)
+    - name: Install Node.js Dependencies
+      run: |
+        cd frontend
+        npm ci
+
+    # --- EJECUCIÓN DE CONTROLES (SAST & SCA) ---
+    
+    - name: [1/5] Python SAST (Bandit)
+      run: bandit -r ./backend/app -ll -ii
+
+    - name: [2/5] Python SCA (Pip-Audit)
+      run: pip-audit -s osv --progress-spinner off -r backend/requirements.txt
+
+    - name: [3/5] Node.js SAST (Njsscan)
+      run: njsscan ./frontend/src
+
+    - name: [4/5] Node.js SCA (Npm Audit)
+      run: |
+        cd frontend
+        npm audit --audit-level=high
+
+    # --- CONTROL DINÁMICO DAST (Schemathesis) ---
+    
+    - name: [5/5] Start Flask App & Run DAST (Schemathesis)
+      env:
+        PYTHONUTF8: 1
+        FLASK_APP: backend/app # Ajustar a la ruta de inicio de tu Flask si varía
+      run: |
+        # Levantar Flask en segundo plano dentro del contenedor local
+        # Usamos 'python3 -m flask run' para asegurar el bindeo local
+        cd backend
+        python3 -m flask run --host=127.0.0.1 --port=5000 &
+        
+        # Esperar 5 segundos a que la API responda
+        echo "Esperando a que el backend de Flask inicie en el entorno local..."
+        sleep 5
+        
+        # Verificar con un curl rápido si el JSON de OpenAPI está disponible
+        curl -s http://127.0.0.1:5000/api/v1/openapi.json > /dev/null
+        
+        # Ejecutar Schemathesis contra la instancia local efímera
+        schemathesis run http://127.0.0.1:5000/api/v1/openapi.json --checks not_a_server_error --max-examples=10

.gitignore

@@ -210,3 +210,15 @@ cython_debug/
 marimo/_static/
 marimo/_lsp/
 __marimo__/
+
+# Node.js / Frontend
+node_modules/
+npm-debug.log
+.env
+.env.*
+!.env.example
+frontend/.env
+
+legacy_admin-edu-space/
+.vscode/
+.schemathesis/

CHANGELOG.md

@@ -0,0 +1,188 @@
+# Changelog Oficial — Admin Edu-Space (UniCABA)
+
+Todas las modificaciones notables a este proyecto serán documentadas en este archivo.
+El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1.1.0/) y este proyecto se adhiere a [Semantic Versioning](https://semver.org/lang/es/).
+
+---
+
+## [Unreleased]
+### Planificado (Fase 3 del Roadmap MVP)
+- **Calendario de Evaluación por Comisión:** Programación de parciales, recuperatorios, entregas de trabajos prácticos y exámenes finales con cuenta regresiva.
+- **Libro de Calificaciones (*Gradebook*):** Matriz de carga rápida de notas para docentes, consulta pedagógica individual para alumnos y cierre de actas para Bedelía.
+- **Grilla Semanal Drag & Drop (Fase 4):** Asignación visual interactiva para la oficina de Bedelía.
+
+---
+
+## [2.6.0] - 2026-09-19
+### Añadido
+- **Fase 2 del Roadmap MVP — Co-docencia, Matriz de Conflictos y Regla Diaria:**
+  - **Estadio 2.1 — Modelo y Gestión Integral de Co-docencia:**
+    - Modelo relacional `CommissionTeacher` (`commission_teachers`) con roles de cátedra (`Titular`, `Adjunto`, `JTP`, `Ayudante`) y flags de docente principal.
+    - Endpoints REST de cátedra: `POST /api/v1/commissions/<id>/teachers` y `DELETE /api/v1/commissions/<id>/teachers/<user_id>` con control de duplicados y asignación dinámica.
+    - Integración visual en el detalle de la comisión (`/admin/commission_detail`) con tarjeta interactiva para vincular/desvincular integrantes del equipo docente y badges de rol en la grilla general (`/admin/commissions_list`).
+  - **Estadio 2.2 — Matriz de Conflictos y Validación Integral:**
+    - **Conflicto Físico Estricto:** Bloqueo estricto de superposición horaria en la misma aula física (`ReservationRepository.find_overlapping` & `check_physical_conflicts`).
+    - **Conflicto Docente Inteligente:** Detección de doble reserva simultánea para un mismo profesor (`ReservationRepository.find_teacher_conflicts` & `check_teacher_conflicts`).
+    - **Excepción Justificada por Co-docencia:** Si un docente asignado presenta solapamiento pero la comisión cuenta con co-docentes registrados en `CommissionTeacher`, el motor de conflictos autoriza la reserva validando la cobertura del equipo de cátedra.
+    - **Conflicto de Aforo:** Bloqueo estricto cuando la cantidad de asistentes esperados (`expected_attendees`) excede la capacidad física declarada del aula (`classroom.capacity`).
+    - Endpoint unificado `POST /api/v1/reservations/check-conflicts` para pre-validación asíncrona de conflictos físicos, docentes y de capacidad antes del guardado.
+  - **Estadio 2.3 — Regla de Restricción Diaria del Alumno y Motor de Excepciones:**
+    - Servicio académico `EnrollmentService` (`backend/app/services/enrollment_service.py`) para control de cupos, inscripciones activas y análisis de días de cursada.
+    - **Regla Diaria:** Un alumno no puede matricularse en dos materias regulares programadas para el mismo día de la semana.
+    - **Excepción Automática por Curso Corto:** Indicador `is_short_course` en modelo `Subject`; si una de las asignaturas es un taller, seminario o curso corto, el sistema autoriza automáticamente la cursada simultánea en el mismo día.
+    - **Excepción Expresa de Bedelía:** Parámetros `allow_same_day_exception` y `exception_reason` en el modelo `StudentEnrollment`, permitiendo a Bedelía inscribir alumnos con justificación administrativa expresa (cambio de plan, equivalencias, etc.).
+    - Endpoints de gestión de matrículas por comisión: `GET /api/v1/commissions/<id>/enrollments`, `POST /api/v1/commissions/<id>/enrollments`, `DELETE /api/v1/commissions/<id>/enrollments/<student_id>` y `PUT /api/v1/commissions/<id>/enrollments/<student_id>`.
+    - Adaptación completa de UI en `/admin/commission_detail` con selector de estudiantes, toggle interactivo de excepción de Bedelía, campo de motivo justificado, y tabla de estudiantes matriculados con badges de excepción.
+  - **Suite de Pruebas Unitarias e Integrales de Reglas de Negocio:**
+    - Archivo `backend/tests/test_phase2_rules.py` con 6 tests completos verificando: bloqueo físico, conflicto de aforo, detección docente con bypass de co-docencia, restricción diaria de cursada, excepción por curso corto y excepción por autorización manual de Bedelía. 100% de tests aprobados.
+  - **Mejoras UI/UX en Dashboard de Bedelía:**
+    - Paneles interactivos para visualizar **Comisiones Sin Reserva de Aula** y **Aulas Disponibles** con soporte de filtrado temporal (Semana/Mes) directamente consumiendo estadísticas en tiempo real del motor backend.
+  - **Fase 1: Auditoría y Seguridad Automatizada:**
+    - **Control de Entorno Dev:** Aislamiento de herramientas de seguridad en `requirements-dev.txt`.
+    - **Automatización Local e Integración Continua:** Correcciones de evaluación en `security_audit.bat` para Windows y actualización de `.gitea/workflows/security-audit.yaml` para asegurar la correcta ejecución del stack de auditoría (Bandit, pip-audit, njsscan y Schemathesis).
+## [2.5.0] - 2026-09-19
+### Añadido
+- **Auditoría y Seguridad Automatizada Completa (Python & Node.js):**
+  - **Python SAST (`bandit`):** Escaneo estático del backend Flask de más de 8.400 líneas. Corrección de vulnerabilidad B310 en `sheets_importer.py` mediante validación estricta de esquema HTTP/HTTPS para prevenir ataques de tipo SSRF. Resultado: 0 fallos detectados.
+  - **Python SCA (`pip-audit`):** Análisis de dependencias con base OSV; detección de 24 CVEs históricas en paquetes desactualizados y actualización completa a versiones seguras (`Flask>=3.1.3`, `Werkzeug>=3.1.8`, `requests>=2.34.2`, `bleach>=6.4.0`, `python-dotenv>=1.2.3`). Resultado: 0 CVEs activas.
+  - **Python DAST / Fuzzing (`schemathesis`):** Especificación OpenAPI 3.0.3 en `backend/app/routes/api/openapi.py` (`/api/v1/openapi.json`). Ejecución de 114 casos de prueba dinámicos con mutación de datos. Detección y corrección de caída 500 por payload de tipo JSON inválido en `/auth/login`. Resultado: 114/114 pruebas aprobadas con 0 errores de servidor.
+  - **Node.js SAST (`njsscan`):** Análisis de patrones de código inseguro en el BFF Express (`frontend/src`). Resultado: 0 hallazgos.
+  - **Node.js SCA (`npm audit`):** Auditoría continua de paquetes npm con 0 vulnerabilidades reportadas.
+  - **Blindaje Activo (`helmet` & `express-rate-limit`):** Incorporación de cabeceras HTTP defensivas (`HSTS`, `nosniff`, `SAMEORIGIN`, `X-Permitted-Cross-Domain-Policies`) y limitadores de tasa ante fuerza bruta en `/auth/login` (30 req / 15 min) y `/api` (180 req / min).
+  - **Script Unificado de Auditoría (`security_audit.bat`):** Ejecutable centralizado para correr los 5 controles en un solo comando.
+  - **Documento Formal de Seguridad (`SECURITY_AUDIT_REPORT.md`):** Reporte ejecutivo de auditoría y controles continuos.
+
+---
+
+## [2.4.0] - 2026-09-19
+### Añadido
+- **Perfil Extendido de Usuarios y Tipificaciones de Documentos Oficiales (Argentina y Extranjeros):**
+  - Incorporación en el modelo `User` de los campos: `first_name` (Nombre), `last_name` (Apellido), `email` (Email Institucional de acceso), `personal_email` (Email Personal/Particular de contacto), `phone` (Teléfono con código de área), `address` (Domicilio/Dirección), `document_type` (Tipo de documento) y `document_number` (Número de documento validado).
+  - Catálogo formal de reglas de negocio en `backend/app/constants/document_types.py` con tipificaciones oficiales de Argentina y extranjeros (DNI, CUIL, Pasaporte Argentino, Pasaporte Extranjero, DNI Extranjero, Cédula de Identidad PFA, Cédula Mercosur, Libreta Cívica y Libreta de Enrolamiento).
+  - Validaciones de formato, expresiones regulares, y verificación de unicidad de documento por tipo en endpoints `POST /api/v1/users` y `PUT /api/v1/users/<id>`.
+  - Búsqueda dinámica en `/admin/users_list` habilitada para filtrar por número de documento o email personal/institucional además de nombre.
+  - Rediseño del formulario `/admin/users/form` estructurado en secciones: Identidad y Documentación, Contacto y Domicilio (con Teléfono, Email Personal y Dirección), y Cuenta y Rol Institucional (con Email Institucional y Clave), permitiendo al Administrador General gestionar la totalidad de los datos.
+  - Script de migración SQLite `backend/migrate_user_profile_fields.py` para agregar las columnas e inicializar nombres desglosados de los usuarios existentes.
+- **Co-Docencia y Cátedras Múltiples en Comisiones:**
+  - Creación del modelo relacional `CommissionTeacher` (`commission_teachers`) para asociar múltiples docentes a una misma comisión con roles académicos diferenciados (`Titular`, `Adjunto`, `JTP`, `Ayudante`).
+  - Nuevos endpoints en la API REST: `POST /api/v1/commissions/<id>/teachers` y `DELETE /api/v1/commissions/<id>/teachers/<user_id>`, junto con la serialización completa de cátedras en `GET /api/v1/commissions`.
+  - Nueva tarjeta interactiva *"Equipo Docente / Cátedra"* en el detalle de la comisión (`/admin/commission_detail?id=...`) permitiendo agregar y desvincular docentes con sus respectivos roles.
+  - Actualización de la grilla de comisiones (`/admin/commissions_list`) para exhibir a todos los profesores asignados con badges distintivos de rol.
+- **Eliminación y Gestión Segura de Asignaturas:**
+  - Incorporación de botón y modal interactivo de confirmación de eliminación de asignaturas en `/admin/subjects_list`.
+  - Implementación de regla de negocio de integridad académica: eliminación física si la materia no tiene comisiones asociadas, o desactivación automática si posee historial o cursadas vinculadas.
+
+### Corregido
+- **Bug Visual en Modificación de Asignaturas (`/admin/subjects_list`):**
+  - Solucionado el problema de modales recortados o cubiertos por el fondo oscuro (`modal-backdrop`), originado por la presencia de 206 modales inline dentro de celdas `<td>` en una tabla con `overflow` (`.table-responsive`). Se refactorizó hacia un único modal global `#modalEditSubject` instanciado fuera de la tabla e inicializado dinámicamente con JavaScript.
+### Añadido
+- **Monitoreo y Percentiles de Asignación de Aulas Físicas (Admin & Bedelía):**
+  - Panel analítico *"Estado y Percentiles de Asignación de Aulas Físicas"* incorporado en los dashboards de Administrador (`/dashboard?role=admin`) y Bedelía (`/dashboard?role=bedelia`).
+  - Cálculo dinámico en tiempo real de **Aulas Asignadas** en número y percentil (**26 aulas · 96.3%**) con enlace directo a cursadas activas.
+  - Cálculo dinámico en tiempo real de **Aulas Sin Asignar / Libres** en número y percentil (**1 aula · 3.7%**) con enlace directo al formulario de asignación de espacios.
+  - Barras de progreso visuales con desglose dual: **Planificación Cuatrimestral** (96.3% asignado vs 3.7% disponible) y **Ocupación Operativa del Día** (aulas con clases hoy vs aulas libres).
+  - Exposición de métricas de asignación y percentiles en el endpoint de la API REST `GET /api/v1/dashboard/stats`.
+- **Módulo de Cursadas Asignadas y Métricas Reales en Catálogo Presencial (`/classrooms/list_classrooms?view_mode=physical`):**
+  - Incorporación de la sección *"Cursadas Asignadas"* dentro de cada tarjeta de aula física y columna en vista de tabla, detallando asignaturas, comisiones y turnos.
+  - Métricas de ocupación física real por período (Día, Semana, Mes) con porcentajes calculados dinámicamente (6%, 11%, 17%, 22% según la carga horaria del aula).
+  - Botones de acción directa con ID dinámico: **Ficha** (`/classrooms/view_classroom?id=...`), **Horarios en Calendario** (`/schedule/calendar_view?classroom_id=...`) y **Editar**.
+  - Conexión de la tabla *"Próximas Clases y Reservas"* en la ficha individual del aula (`/classrooms/view_classroom`) con las reservas reales del cuatrimestre y enlaces a cada reserva (`/schedule/view_reservation?id=...`).
+
+### Modificado
+- **Dashboard Docente (`/dashboard?role=docente`):**
+  - Eliminado el botón flotante *"Reservar Aula / Solicitar espacio para clase"* (`/schedule/add_reservation`) a petición de los requerimientos funcionales del cuerpo docente.
+  - Reorganizada la grilla superior a 3 columnas simétricas (`col-md-4`) para las tarjetas de *Mis Clases Hoy*, *Mis Reservas Activas* y *Aulas Virtuales*.
+
+### Corregido
+- **Fallo Crítico de Renderizado en Nunjucks (`memberLookup` con `.items`):**
+  - Solucionada la incompatibilidad de `nunjucks/src/jinja-compat` que interceptaba la propiedad `.items` convirtiendo `classrooms.items` en una función interna en lugar de un array, lo que impedía dibujar las tarjetas de aulas presenciales en `frontend/views/classrooms/list.html`.
+  - Implementado interceptor en `memberLookup` en `frontend/src/app.js` para preservar arrays intactos.
+- **Clasificación Errónea de Reservas Físicas como Virtuales (`is_virtual`):**
+  - Corregida la propiedad `@property is_virtual` en `Reservation` (`backend/app/models/reservation.py`) para garantizar que si una reserva tiene aula física asignada (`self.classroom and not self.classroom.is_virtual`), siempre sea clasificada como presencial (`is_virtual = False`), evitando falsos positivos cuando la comisión posee un enlace virtual predeterminado.
+- **Excepción de SQLAlchemy en Estadísticas de Dashboard:**
+  - Corregido el error de ejecución generado al invocar `.ilike()` sobre la propiedad Python `@property Classroom.room_number` en `backend/app/routes/api/dashboard.py`, migrando la clasificación de aulas presenciales y virtuales a una evaluación robusta en memoria Python (`Classroom.code` y `Classroom.building`).
+
+---
+
+## [2.2.0] - 2026-09-19
+### Añadido
+- **Herramienta de Purga y Reinicio de Datos Académicos (`reset_academic_data`):**
+  - Script CLI `backend/scripts/reset_academic_data.py` con argumentos de limpieza granular (`--all`, `--reservations`, `--classrooms`, `--careers`, `--yes`).
+  - Endpoint de API `POST /api/v1/admin/reset-academic-data` protegido por JWT (rol `admin`) con registro en `AuditLog`.
+  - Panel interactivo "Zona de Reinicio y Purga Académica" en `/admin/google_sheets_import` con checkboxes independientes para reservas, aulas, comisiones, asignaturas y carreras.
+  - Modal modal de confirmación con advertencias de seguridad para prevenir purgas accidentales.
+  - Preservación íntegra de usuarios del sistema, credenciales de acceso, roles RBAC y registros de auditoría.
+- **Configuración Global Dinámica de Google Sheets:**
+  - Nuevo modelo `SystemSetting` (`backend/app/models/setting.py`) para almacenamiento persistente clave-valor en base de datos.
+  - Endpoints `GET /api/v1/admin/sheets-config` y `POST /api/v1/admin/sheets-config`.
+  - Normalizador de enlaces en `GoogleSheetsImporter` compatible con URLs compartidas de edición (`/spreadsheets/d/.../edit`) o enlaces publicados (`/pub?output=csv`).
+  - Interfaz web con formulario de edición de URL, botón de guardado en caliente, restauración a URL oficial predeterminada y acceso directo a Google Docs.
+- **Visualización de Asignaturas Reales:**
+  - Tabla de asignaturas recientemente sincronizadas conectada a la base de datos real en lugar de datos de muestra (*mock*).
+
+### Corregido
+- **Fallo por Timeout en Google Sheets Academic Sync:**
+  - Solucionado el corte prematuro de conexión en el BFF (`frontend/src/services/apiClient.js`), aumentando el timeout base a 25s y el timeout específico de sincronización a 90s (anteriormente limitado a 5s en operaciones que toman ~6.7s).
+  - Eliminado el enmascaramiento silencioso de errores en el BFF, permitiendo reportar fallos reales o éxitos detallados (+carreras, +aulas, +materias, +comisiones, +reservas).
+
+---
+
+## [2.1.0] - 2026-09-19
+### Añadido
+- **Ficha Detallada de Reserva (`schedule.view_reservation`):**
+  - Implementación en BFF Node.js de la ruta `/schedule/view_reservation` (soportando parámetros `:id`, `?id=` o selección automática del primer registro).
+  - Vistas y controladores para modificar reservas con selectores en cascada (`/schedule/edit_reservation`).
+  - Endpoints de acción rápida en backend y BFF: `POST /schedule/confirm_reservation` y `POST /schedule/cancel_reservation`.
+  - Actualización de enlaces en `today.html`, `list.html`, `dashboard.html` y `view.html` para navegar directamente con el identificador de la reserva (`?id=...`).
+- **Creación y Asociación de Comisiones a Asignaturas (`admin/commissions_list`):**
+  - Botón destacado `+ Nueva Comisión` en el encabezado y en el estado vacío de la tabla.
+  - Modal interactivo `#modalAddCommission` con selección obligatoria y clara de la **Asignatura / Materia Asociada** (`<select name="subject_id" required>`), mostrando código oficial, nombre y carrera.
+  - Campos completos de cursada: cuatrimestre (1C/2C/Anual), año lectivo, turno, docente a cargo, cupo máximo y días/horarios.
+  - Generación y configuración automática de enlace a Google Meet institucional cuando no se ingresa un enlace personalizado.
+  - Alerta de confirmación visual (`?created=1`) al registrar y vincular una comisión exitosamente.
+  - Tabla de comisiones actualizada con visualización explícita del código de materia, nombre y badge de carrera.
+- **Enriquecimiento de la API REST:**
+  - Endpoint `GET /api/v1/reservations/<id>` ampliado con objetos relacionales anidados: `classroom` (código, edificio, piso, capacidad, descripción, virtualidad), `commission` (código, código compuesto, materia), `user` (docente, nombre, apellido, correo), duración en minutos y enlaces virtuales.
+  - Endpoint `POST /api/v1/admin/commissions` con validación estricta de existencia de asignatura y resolución inteligente de unicidad.
+
+---
+
+## [2.0.0] - 2026-09-18
+### Añadido
+- **Reingeniería de Arquitectura Fullstack (Desacople Monolito -> Backend + BFF):**
+  - Desacople completo del backend Python/Flask como una **API REST pura** bajo `/api/v1/` retornando exclusivamente JSON.
+  - Implementación del **Frontend BFF** en Node.js + Express con renderizado de servidor mediante Nunjucks.
+  - Autenticación sin estado (*Stateless*) basada en tokens JWT firmados con algoritmo HS256.
+  - Almacenamiento seguro del token de acceso en cookies del navegador con directivas `HttpOnly`, `SameSite=Lax` y `Secure`.
+  - Inyección transparente del token `Bearer` en peticiones internas mediante cliente Axios centralizado.
+- **Dashboards Personalizados por Rol Institucional:**
+  - **Dashboard de Bedelía (`/dashboard?role=bedelia`):** Métricas operativas de campus físico y virtual, cartelera del día y panel de aprobación de solicitudes pendientes.
+  - **Dashboard de Docente (`/dashboard?role=docente`):** Sesiones del día con botones directos para ingresar a reuniones virtuales (Meet/Teams/Zoom) y formulario de solicitud de aulas.
+  - **Dashboard de Alumno (`/dashboard?role=alumno`):** Brújula de cursada *"¿Dónde curso hoy?"* con ubicación por piso/aula o enlace virtual, junto al calendario de exámenes y entregas.
+  - **Dashboard de Administrador (`/dashboard?role=admin`):** Cockpit institucional de capacidad, usuarios, auditoría RBAC y distribución de comisiones.
+  - Selector dinámico de vista previa de roles en el banner superior para administradores.
+- **Cartelera del Día Interactiva (`/schedule/today_schedule`):**
+  - Grilla estructurada en bloques horarios (07:00 a 21:00 hs) con métricas en tiempo real de ocupación y reservas confirmadas/pendientes.
+  - Filtro dinámico para ocultar clases virtuales (`hide_virtual=1`) y segmentación por pisos o turnos.
+- **Seguridad Enterprise (SecurityFilterChain):**
+  - Pipeline centralizado de cabeceras de blindaje OWASP (`nosniff`, `SAMEORIGIN`, `X-XSS-Protection`, `Strict-Transport-Security`).
+  - Rate limiting dinámico contra ataques de fuerza bruta en endpoints de autenticación.
+
+### Corregido
+- **Resolución de Colisión de Horarios en Clases Virtuales (Importador de Google Sheets):**
+  - Corrección de la búsqueda de duplicados en `sheets_importer.py` que limitaba indebidamente la unicidad a `(classroom_id, start_time, end_time)`.
+  - Habilitación de concurrencia ilimitada para el aula virtual (`Campus Virtual · VIRTUAL`) mediante discriminación por `commission_id`.
+  - El total de reservas registradas aumentó de **363 a 643** (incorporando **280 clases virtuales** que eran descartadas por falso conflicto).
+  - Generación y guardado automático de enlaces institucionales de Google Meet (`https://meet.google.com/edu-{materia}-{comision}`).
+
+---
+
+## [1.0.0] - 2026-09-04
+### Añadido
+- **Versión Monolítica Base (`legacy_admin-edu-space`):**
+  - Aplicación monolítica en Flask con plantillas Jinja2 y persistencia SQLAlchemy (SQLite / PostgreSQL).
+  - Modelado de datos inicial para sedes, aulas físicas, materias, comisiones, usuarios y reservas.
+  - Sistema de roles inicial (Admin, Bedelía, Docente, Alumno) basado en sesión tradicional de Flask-Login.
+  - Calendario de reservas mensual y semanal con FullCalendar.
+  - Prototipo experimental de algoritmo genético para optimización de ocupación áulica.
+  - Módulo de sincronización inicial con planillas de Google Sheets.

CHANGELOG_MVP.md

@@ -0,0 +1,50 @@
+# CHANGELOG MVP — Admin Edu-Space (UniCABA)
+
+Registro de hitos y versiones correspondientes a las Fases del [ROADMAP_MVP.md](./ROADMAP_MVP.md).
+
+---
+
+## [Fase 2: Co-docencia, Matriz de Conflictos y Regla Diaria] — v2.6.0 (2026-09-19)
+**Estado:** ✅ 100% Completada
+
+### Estadio 2.1 — Modelo y Gestión Integral de Co-docencia
+* **Modelo `CommissionTeacher`:** Soporte para múltiples docentes por comisión en base de datos (`commission_teachers`), admitiendo roles académicos diferenciados (`Titular`, `Adjunto`, `JTP`, `Ayudante`) y flag `is_primary`.
+* **API REST de Cátedras:** Endpoints `POST /api/v1/commissions/<id>/teachers` y `DELETE /api/v1/commissions/<id>/teachers/<user_id>` con serialización completa de cátedra en comisiones.
+* **Interfaz de Gestión:** Tarjeta interactiva *"Equipo Docente / Cátedra"* en `/admin/commission_detail` para incorporar y desvincular profesores con rol dinámico, y visualización de badges en `/admin/commissions_list`.
+
+### Estadio 2.2 — Matriz de Conflictos y Validación Integral
+* **Conflicto Físico:** Bloqueo estricto e infranqueable de superposiciones de reservas en la misma aula física (`ReservationRepository.find_overlapping`).
+* **Conflicto Docente:** Detección de doble asignación simultánea para un mismo docente en diferentes aulas o formatos.
+* **Excepción Justificada por Co-docencia:** Si un docente asignado presenta solapamiento pero la comisión cuenta con co-docentes registrados en `CommissionTeacher`, la matriz de validación autoriza la reserva validando la cobertura del equipo de cátedra.
+* **Conflicto de Aforo:** Bloqueo estricto cuando `expected_attendees > classroom.capacity` en espacios físicos.
+* **Endpoint de Pre-validación:** `POST /api/v1/reservations/check-conflicts` para validación asíncrona de conflictos físicos, docentes y de aforo antes del commit.
+
+### Estadio 2.3 — Regla de Restricción Diaria del Alumno y Motor de Excepciones
+* **Servicio `EnrollmentService`:** Lógica de matriculación académica con análisis de días de cursada por comisión y verificación de cupos.
+* **Regla Restrictiva:** Un alumno no puede cursar dos asignaturas regulares el mismo día de la semana.
+* **Excepción Automática por Curso Corto:** Atributo `is_short_course` en modelo `Subject`; si una de las materias es un taller o curso corto, el sistema autoriza la cursada simultánea en el mismo día.
+* **Excepción Expresa de Bedelía:** Campos `allow_same_day_exception` y `exception_reason` en `StudentEnrollment`. La oficina de Bedelía puede autorizar la matriculación simultánea mediante switch justificado en la interfaz.
+* **Endpoints de Matrícula:** `GET/POST /api/v1/commissions/<id>/enrollments`, `DELETE/PUT /api/v1/commissions/<id>/enrollments/<student_id>`.
+* **UI en Detalle de Comisión:** Formulario de matriculación con toggle de autorización de Bedelía, motivo de excepción y tabla de inscriptos con badges de estado.
+
+### Cobertura de Pruebas
+* Suite completa en `backend/tests/test_phase2_rules.py` validando los 6 criterios de aceptación (conflicto físico, aforo, co-docencia, restricción diaria, bypass de curso corto y bypass de Bedelía). 6/6 tests aprobados con 100% de éxito.
+
+### Complementos y Seguridad Transversal
+* **Dashboard de Bedelía:** Integración de paneles en tiempo real para análisis de **Comisiones Sin Reserva** y grilla de **Aulas Disponibles** (Filtros Semana/Mes) conectando frontend UI con el servicio analítico backend.
+* **Auditoría Automatizada (Fase 1):** Implantación de un pipeline de seguridad local/Gitea que aísla dependencias de desarrollo (`requirements-dev.txt`) y ejecuta controles SAST, DAST y SCA (Bandit, pip-audit, njsscan y Schemathesis) sin vulnerabilidades detectadas.
+---
+
+## [Fase 1: Paridad Legacy y Estabilización] — v2.5.0 / v2.4.0 (2026-09-19)
+**Estado:** ✅ 100% Completada
+* Seguridad automatizada SAST/DAST/SCA (Bandit, pip-audit, schemathesis, njsscan, npm audit).
+* Tipificaciones de documentos argentinos y extranjeros, perfiles extendidos de usuarios con email personal e institucional.
+* Gestión completa de aulas físicas vs virtuales con percentiles de asignación y métricas de ocupación real.
+* Reingeniería del modal de edición y eliminación segura de asignaturas.
+
+---
+
+## [Fase 0: Desacople y Arquitectura Base] — v2.0.0 (2026-09-18)
+**Estado:** ✅ 100% Completada
+* Desacople arquitectónico completo: Backend Flask RESTful (`/api/v1/`) + Frontend BFF Node.js/Express con Nunjucks.
+* Autenticación basada en tokens JWT con sincronización de estado de sesión.

ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md

@@ -0,0 +1,223 @@
+# Estado Actual de la Migración y Arquitectura Objetivo
+## Sistema Integral de Gestión de Aulas, Cursadas y Seguimiento Académico — UniCABA
+
+**Rol:** Arquitecto de Software y Analista Funcional Senior  
+**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)  
+**Fecha de Actualización:** 19 de Septiembre de 2026  
+**Rama Activa:** `testing`  
+
+---
+
+## 1. De Dónde Venimos: La Versión Monolítica (`legacy_admin-edu-space`)
+
+La versión original del sistema correspondía a un monolito clásico desarrollado en Python (Flask) con renderizado del lado del servidor mediante plantillas Jinja2 y ORM SQLAlchemy:
+
+```
+[Cliente Web / Navegador]
+           │
+           ▼ (HTTP / HTML)
+┌────────────────────────────────────────────────────────┐
+│  Monolito Legacy (legacy_admin-edu-space)               │
+│  - Rutas Flask con render_template (Jinja2)             │
+│  - Sesión en Cookies de Flask (Flask-Login con estado) │
+│  - Consultas directas SQLAlchemy acopladas a vistas    │
+│  - Base de Datos (SQLite / PostgreSQL)                 │
+└────────────────────────────────────────────────────────┘
+```
+
+### Fortalezas Heredadas del Monolito
+1. **Modelado de Dominio Inicial:** Entidades base para Sedes (`Building`), Aulas (`Classroom`), Materias (`Subject`), Comisiones (`Commission`), Reservas (`Reservation`) y Usuarios (`User`).
+2. **Importador de Planillas Oficiales:** Módulo de sincronización con Google Sheets para alimentar la cartelera con la oferta de comisiones y clases.
+3. **Algoritmo Genético Experimental:** Prototipo de optimización predictiva para asignación de aulas físicas según aforo y equipamiento.
+
+### Limitaciones Críticas que Forzaron la Migración
+* **Acoplamiento Servidor-Vista:** Lógica de negocio mezclada dentro de controladores web y macros de plantillas Jinja2, impidiendo el consumo móvil (app institucional) o integraciones externas (SIU Guaraní, Moodle).
+* **Fallas Graves en Virtualidad:** El importador de Google Sheets descartaba más del 75% de las clases virtuales por asumir que el aula `Campus Virtual · VIRTUAL` sufría colisiones físicas de horario ante comisiones simultáneas.
+* **Falta de Perspectiva por Rol:** El dashboard era único y uniforme; no distinguía entre el trabajo administrativo de Bedelía, la consulta rápida de cursada del Alumno, o la gestión evaluativa del Docente.
+* **Escalabilidad y Seguridad:** Autenticación dependiente de la sesión en memoria del servidor web, sin soporte de tokens JWT sin estado ni separación de responsabilidades (BFF pattern).
+
+---
+
+## 2. Dónde Estamos Actualmente: Arquitectura Desacoplada Backend-BFF
+
+La infraestructura ha sido transformada en un modelo desacoplado y de alta disponibilidad:
+
+```
+                  [ Navegador Web / Cliente ]
+                               │
+                               │ (HTTP / HTML + Cookies HttpOnly)
+                               ▼
+        ┌──────────────────────────────────────────────┐
+        │        Frontend BFF (Node.js + Express)      │
+        │        Puerto: 3000                           │
+        │  - Renderizado Nunjucks con herencia limpia  │
+        │  - Orquestación y agregación de UI           │
+        │  - Gestión de Cookie JWT y Contexto de Rol   │
+        │  - Cliente Axios con Interceptor Bearer      │
+        └──────────────────────┬───────────────────────┘
+                               │
+                               │ (REST JSON / JWT Bearer)
+                               ▼
+        ┌──────────────────────────────────────────────┐
+        │        Backend Core API (Python + Flask)     │
+        │        Puerto: 5000                           │
+        │  - Endpoints RESTful bajo /api/v1/           │
+        │  - Autenticación Stateless JWT (HS256)       │
+        │  - Pipeline Enterprise SecurityFilterChain   │
+        │  - Capa de Servicios y DTOs (Pydantic)       │
+        │  - Persistencia SQLAlchemy (Transaccional)   │
+        └──────────────────────┬───────────────────────┘
+                               │
+                               ▼
+                    [ Base de Datos SQLite / PG ]
+```
+
+### Estado de Implementación al Día de la Fecha
+
+| Componente / Módulo | Estado en Legacy | Estado Actual (Backend API + BFF) | Nivel de Paridad |
+| :--- | :--- | :--- | :---: |
+| **Autenticación & Sesión** | Flask-Login basado en sesión de servidor | Autenticación REST JWT con cookie HttpOnly segura y RBAC centralizado | **120% (Superado)** |
+| **Dashboards por Rol** | Dashboard monolítico único para todos | 4 Dashboards especializados (`admin`, `bedelia`, `docente`, `alumno`) con selector dinámico | **150% (Superado)** |
+| **Campus Virtual & Enlaces** | Colisión de clases virtuales; pérdida de enlaces Meet | Aulas virtuales concurrentes sin límite, auto-generación de enlaces Google Meet por comisión | **140% (Superado)** |
+| **Importador Google Sheets** | 363 reservas importadas (colisiones masivas) | 643 reservas totales (388 virtuales) sin colisión horaria entre comisiones | **100% (Paridad Total)** |
+| **Cartelera del Día (`today_schedule`)** | Vista Jinja con bloques rígidos | Timeline interactivo por horas (7 a 21 hs), filtros por piso/turno y switch `hide_virtual` | **110% (Superado)** |
+| **Ficha de Reserva (`view_reservation`)** | Vista monolítica rígida | Acoplada al BFF con relaciones anidadas completas, edición en cascada, confirmación y cancelación | **100% (Paridad Total)** |
+| **Gestión de Comisiones (`commissions_list`)** | Lista plana sin modal de creación en admin | Modal `#modalAddCommission` con vinculación obligatoria a Asignatura, docente, cupo, horarios y Meet | **125% (Superado)** |
+| **Calendario FullCalendar** | Feed JSON básico | Endpoint `/api/v1/reservations` con discriminación cromática (`#6366F1` virtuales) | **100% (Paridad Total)** |
+
+---
+
+## 3. A Dónde Queremos Ir: El Sistema Integral UniCABA
+
+El objetivo institucional es consolidar la plataforma como el **ERP Académico y Gestor de Espacios Oficial de UniCABA**, dando soporte a las dinámicas pedagógicas físicas y digitales de la universidad.
+
+### A. Entorno Físico vs. Campus Virtual
+1. **Edificio Físico (Central):**
+   - Espacios con aforo estrictamente limitado, asignación por piso/ala y equipamiento técnico (proyectores, laboratorios informáticos, acústica).
+   - Validación matemática de no-solapamiento temporal para evitar doble asignación de aula física.
+2. **Campus Virtual:**
+   - Capacidad física infinita; asignación lógica de salas vinculadas a la plataforma oficial (Google Meet institucional, Zoom o Microsoft Teams).
+   - Control de concurrencia temporal de docentes y estudiantes (evitar que un docente o alumno deba estar en dos salas remotas al mismo tiempo).
+
+---
+
+## 4. Reglas de Negocio del Sistema Objetivo
+
+### 1. Perfiles y Permisos (RBAC Avanzado)
+* **Administrador General (Superadmin):**
+  * Gobernanza total del sistema, configuración de periodos y parametrización de reglas de conflicto.
+  * **Modo Impersonación / Vista Previa:** Visualización en tiempo real del sistema desde la perspectiva exacta de cualquier usuario (Bedelía, Docente, Alumno) para soporte y auditoría.
+  * Flexibilidad académica para autorizar excepciones de cursada simultánea y apertura de comisiones extraordinarias.
+* **Bedelía / Gestión Operativa:**
+  * Administración integral del inventario físico (Sedes, Edificios, Pisos, Aulas) y virtual.
+  * Creación y parametrización de Ciclos Lectivos, Asignaturas y Comisiones.
+  * **Asignación Docente Co-docente:** Posibilidad de asignar más de un profesor a una misma comisión (equipo de cátedra: titulares, adjuntos, ayudantes).
+  * Gestión de cupos máximos, padrón de alumnos matriculados y resolución de conflictos de asignación.
+  * Supervisión de hitos evaluativos institucionales.
+* **Docente:**
+  * Vista segmentada estrictamente a sus comisiones asignadas.
+  * Calendario de clases presenciales y accesos directos a sesiones de videoconferencia.
+  * Gestión del calendario de evaluación: carga de fechas de parciales, recuperatorios, entregas de trabajos prácticos y finales.
+  * Matriz ágil de carga y edición de calificaciones y estados de regularidad.
+* **Alumno:**
+  * Acceso enfocado a sus materias cursadas en el periodo lectivo activo.
+  * Brújula de cursada diaria (*¿Dónde curso hoy?* con sede, piso y aula física o enlace virtual).
+  * Calendario unificado de entregas de TPs, parciales y finales con avisos preventivos.
+  * Consulta histórica de notas y retroalimentaciones pedagógicas.
+
+### 2. Estructura Académica y Ciclo Lectivo
+* **Ciclo Lectivo Flexible:** Estructurado por Año (ej. `2026`) y Periodos estándar (`1C`, `2C`, `Anual`), permitiendo el alta de "Cursos Cortos Intensivos" o trayectos formativos extracurriculares con fechas especiales.
+* **Restricción Diaria de Cursada del Estudiante:**
+  * **Regla por defecto:** Un estudiante universitario no puede cursar dos asignaturas regulares el mismo día calendario.
+  * **Excepción parametrizable:** Se autoriza la coincidencia en el mismo día si una de las materias corresponde a un curso corto intensivo o mediante autorización explícita de Bedelía/Secretaría Académica.
+
+### 3. Matriz de Conflictos y Validaciones de Solapamiento
+```mermaid
+flowchart TD
+    Req([Solicitud de Asignación / Reserva]) --> V1{¿Es Aula Física?}
+    V1 -- Sí --> C1{¿Aula ocupada en ese día y horario?}
+    C1 -- Sí --> Err1[BLOQUEO: Conflicto Físico Infranqueable]
+    C1 -- No --> C2{¿Aforo de alumnos <= Capacidad aula?}
+    C2 -- No --> Err2[BLOQUEO: Aforo Excedido]
+    C2 -- Sí --> V2
+    V1 -- No (Virtual) --> V2
+
+    V2{¿Docente en otra clase en el mismo horario?}
+    V2 -- Sí --> C3{¿Comisión cuenta con Co-Docencia?}
+    C3 -- No --> Err3[BLOQUEO: Conflicto Docente]
+    C3 -- Sí --> Warn1[ALERTA: Excepción Co-Docente Justificada]
+    C3 --> V3
+    V2 -- No --> V3
+
+    V3{¿Alumno cursa otra materia regular el mismo día?}
+    V3 -- Sí --> C4{¿Es Curso Corto o Autorizado?}
+    C4 -- No --> Err4[BLOQUEO: Regla Restricción Diaria]
+    C4 -- Sí --> Ok[ASIGNACIÓN EXITOSA]
+    V3 -- No --> Ok
+```
+
+---
+
+## 5. Diseño Técnico: Base de Datos Relacional Normalizada
+
+Para soportar las reglas de co-docencia, inscripciones, evaluaciones y restricciones de día, el esquema de datos evolucionará hacia la siguiente estructura:
+
+### Entidades Principales
+1. **`academic_terms` (Ciclos Lectivos):** `id`, `name`, `code` (ej. '2026-1C'), `year`, `term_type` ('1C', '2C', 'ANUAL', 'CORTO'), `start_date`, `end_date`, `is_active`.
+2. **`subjects` (Materias / Asignaturas):** `id`, `code`, `name`, `career_id`, `is_short_course` (boolean), `credits`, `active`.
+3. **`commissions` (Comisiones de Cursada):** `id`, `subject_id`, `term_id`, `code`, `shift`, `schedule_display`, `max_students`, `virtual_link`, `active`.
+4. **`commission_teachers` (Co-docencia / Equipo Docente):** `id`, `commission_id`, `teacher_id`, `role` ('TITULAR', 'ADJUNTO', 'AYUDANTE'), `can_grade` (boolean).
+5. **`commission_schedules` (Asignación Horaria y Espacial):**
+   * `id`, `commission_id`, `day_of_week` (1=Lunes .. 7=Domingo), `start_time`, `end_time`, `classroom_id` (física o virtual), `is_virtual`.
+   * *Constraint de Integridad:* `UNIQUE(classroom_id, day_of_week, start_time, end_time)` para aulas no virtuales.
+6. **`enrollments` (Inscripciones de Alumnos):** `id`, `commission_id`, `student_id`, `status` ('REGULAR', 'CONDICIONAL', 'LIBRE', 'PROMOVIDO'), `enrolled_at`, `allow_same_day_exception` (boolean).
+7. **`evaluation_milestones` (Hitos Evaluativos):** `id`, `commission_id`, `milestone_type_id`, `title`, `date`, `start_time`, `weight_percentage`, `is_mandatory`.
+8. **`student_grades` (Calificaciones y Actas):** `id`, `milestone_id`, `student_id`, `numeric_score`, `concept_score`, `feedback`, `graded_by_teacher_id`, `graded_at`.
+
+---
+
+## 6. Diseño de Contratos de API RESTful (Backend Core)
+
+### A. Módulo de Comisiones y Co-docencia
+* `GET /api/v1/commissions`: Filtro por término académico, carrera, asignatura, turno y estado.
+* `POST /api/v1/commissions`: Alta de comisión vinculada a una asignatura con generación automática de Meet.
+* `POST /api/v1/commissions/{id}/teachers`: Asignación de docentes con rol en cátedra (co-docencia).
+* `DELETE /api/v1/commissions/{id}/teachers/{teacher_id}`: Desvinculación de docente.
+
+### B. Módulo de Matriz de Conflictos y Validación
+* `POST /api/v1/schedules/validate`:
+  * **Payload:** `{ commission_id, classroom_id, day_of_week, start_time, end_time, teacher_ids, student_ids }`
+  * **Respuesta:** `{ valid: boolean, conflicts: [ { type: 'PHYSICAL'|'TEACHER'|'STUDENT_DAILY', message, details } ] }`
+
+### C. Módulo de Hitos Evaluativos y Libro de Calificaciones
+* `GET /api/v1/commissions/{id}/milestones`: Listado de exámenes, entregas y parciales.
+* `POST /api/v1/commissions/{id}/milestones`: Creación de hito evaluativo.
+* `GET /api/v1/commissions/{id}/gradebook`: Matriz completa de alumnos y notas de la comisión.
+* `PUT /api/v1/commissions/{id}/gradebook`: Carga masiva o individual de calificaciones por docente.
+
+### D. Modo Impersonación de Superadmin
+* Cabecera HTTP: `X-Impersonate-User: {user_id}`
+* Procesamiento en `authMiddleware`: Si el token emisor corresponde al rol `SUPERADMIN`, el contexto de ejecución adopta los permisos y vistas del usuario destino para auditoría, dejando registro en `audit_logs`.
+
+---
+
+## 7. Directrices UI/UX para el Frontend BFF
+
+1. **Panel de Bedelía:**
+   - Grilla interactiva semanal (tipo TimeGrid) donde los bloques de comisiones se visualizan codificados por color según edificio, aula física o aula virtual.
+   - Detección inmediata de colisiones con carteles de advertencia flotantes antes de confirmar cambios.
+2. **Matriz de Carga Rápida para Docentes:**
+   - Tabla editable en línea (*spreadsheet-like*) para volcar notas de parciales y entregas sin recargar la página, con autoguardado asíncrono.
+3. **Perspectiva del Alumno:**
+   - Interfaz simplificada con diseño enfocado en dispositivos móviles, mostrando en la tarjeta de inicio la clase del momento con botón directo para ingresar a la videollamada o indicador de piso y aula física.
+
+---
+
+## 8. Conclusión del Diagnóstico
+
+El sistema ha superado con éxito la fase de desacople inicial y estabilización de virtualidad:
+- Se logró paridad total con `legacy_admin-edu-space` en importación de cronograma y cartelera.
+- Se eliminaron las fallas de colisión virtual y se establecieron los 4 dashboards por rol.
+- Se completó el acople de la ficha de reserva (`schedule.view_reservation`) y la creación asistida de comisiones en el BFF.
+
+Las siguientes etapas se concentrarán en la consolidación de las reglas académicas complejas (co-docencia, restricción diaria de cursada, matriz de conflictos y libro de calificaciones) detalladas en el **`ROADMAP_MVP.md`**.

README.md

@@ -1,6 +1,8 @@
 # Panel de Administración Edu-Space (UniCABA)
 
-Plataforma integral de gestión áulica, asignación de espacios, control de horarios y reservas académicas para la **Universidad de la Ciudad de Buenos Aires (UniCABA)**, desarrollada con **Python / Flask**, **SQLAlchemy**, **PostgreSQL** y **Bootstrap 5**.
+Plataforma integral de gestión áulica, asignación de espacios, control de horarios y reservas académicas para la **Universidad de la Ciudad de Buenos Aires (UniCABA)**. 
+
+El proyecto se basa en una arquitectura **desacoplada (Frontend / Backend)** en formato monorepo.
 
 ---
 
@@ -10,369 +12,108 @@ Plataforma integral de gestión áulica, asignación de espacios, control de hor
 
 ---
 
-## ✨ Características Principales
+## 🏗️ Arquitectura del Proyecto (Monorepo)
 
-### 🛡️ 1. Control de Accesos RBAC Granular (Matriz estilo FortiGate)
+El repositorio está dividido en dos aplicaciones principales que interactúan mediante una API REST y un patrón Backend-For-Frontend (BFF).
-* **Gestión por Módulos:** Permisos independientes por cada área del sistema:
-  1. **Aulas y Espacios:** Creación, edición, capacidad y estado de aulas físicas y virtuales.
-  2. **Edificios y Sedes:** Administración de sedes, pisos y arquitectura edilicia.
-  3. **Reservas de Aulas:** Solicitud, aprobación, confirmación y cancelación.
-  4. **Cartelera y Cronograma:** Calendario interactivo, visualización diaria y comisiones.
-  5. **Gestión Académica:** Carreras, asignaturas, códigos y comisiones.
-  6. **Sincronización Sheets:** Importador y sincronizador de Google Sheets.
-  7. **Optimizador IA:** Algoritmo genético de distribución y resolución de conflictos.
-  8. **Usuarios y Accesos RBAC:** Cuentas, roles y matriz de permisos.
-* **Niveles de Permiso Granulares:** `Ninguno`, `Solo Lectura` o `Lectura y Escritura`.
-* **Controles Rápidos:** Botón *"Establecer Todos"* para configuración masiva inmediata.
-* **Roles Predefinidos:** `Admin` (control total), `Docente`, `Operador` y `Consulta`.
-
-### 📊 2. Sincronización e Importación desde Google Sheets
-* Integración directa con la cartelera académica de UniCABA en Google Sheets.
-* Extracción e importación normalizada de los 5 campos clave:
-  * **Código Académico:** Códigos reales de asignatura (ej. `INGA0003`, `ASIG00165`).
-  * **Asignatura:** Nombre oficial de la materia.
-  * **Aula:** Mapeo a aulas físicas (PB a 4.° piso) o aula `VIRTUAL` ($\infty$).
-  * **Carrera:** Normalización y vinculación relacional con entidades de carrera.
-  * **Horarios y Turnos:** Detección automática de franjas horarias y delimitadores de bloque (`Turno Mañana` y `Turno Tarde / Vespertino`).
-
-### 📅 3. Calendario Interactivo de Reservas (FullCalendar)
-* **Visualización Semanal, Mensual y Diaria:** Grilla ágil de alta legibilidad con jerarquía visual:
-  * Asignatura destacada en tipografía grande y negrita.
-  * Badges con código de materia, aula asignada, turno y franja horaria.
-* **Filtros Dinámicos Combinables:**
-  * Filtrar por **Aula**.
-  * Filtrar por **Materia / Asignatura**.
-  * Filtrar por **Carrera**.
-  * Filtrar por **Turno** (`Turno Mañana` / `Turno Tarde`).
-  * Filtrar por **Piso / Planta** (`Planta Baja`, `Piso 1`, `Piso 2`, `Piso 3`, `Piso 4`).
-  * **Switch "Ocultar Aulas Virtuales":** Aísla la ocupación física real en el edificio central excluyendo los eventos virtuales de capacidad infinita.
-* **Ficha Modal Instantánea:** Vista previa detallada al hacer clic en cualquier evento.
-
-### 📋 4. Cartelera del Día y Listado de Reservas
-* **Cartelera del Día (`/schedule/today`):**
-  * **Vista Cronológica (Timeline):** Bloques horarios de 07:00 a 22:00 hs con indicador de ocupación.
-  * **Vista en Tabla:** Lista ordenada con acciones rápidas y detalles de comisión.
-  * Filtros directos por piso, turno y switch para ocultar virtuales.
-* **Listado Paginado de Reservas (`/schedule/list`):**
-  * Paginación de 20 registros por página preservando filtros aplicados.
-  * Búsqueda por texto, estado (`Confirmada`, `Pendiente`, `Cancelada`), rango de fechas y piso.
-
-### 🏫 5. Gestión de Aulas con Capacidad Infinita ($\infty$)
-* Soporte nativo para el símbolo **`∞`** o `0` para designar aulas virtuales o espacios sin aforo restringido.
-* Botón de un solo clic `Ilimitada (∞)` en formularios de alta y edición con leyendas explicativas.
-* Badges distintivos `∞ Ilimitada` en listados, tarjetas y fichas técnicas.
-
-### 🤖 6. Optimizador Inteligente de Aulas (Algoritmo Genético)
-* Motor de optimización heurística para asignación automática de aulas a comisiones.
-* Pondera capacidad requerida vs. capacidad de aula, equipamiento tecnológico y minimización de desplazamientos entre pisos.
-
-### 🎨 7. Experiencia de Usuario, Temas y Localización
-* **Tema Oscuro / Claro:** Alternador con botón flotante y persistencia en `localStorage` y perfil de usuario.
-* **Soporte Multilingüe:** Internacionalización integral (Español e Inglés) compilada con GNU gettext (`pybabel`).
-* **Tarjetas Estadísticas Interactivas:** Accesos directos rápidos desde el panel general hacia las distintas secciones operativas.
-
-### 🏛️ 8. Sistema Integral de Gestión Institucional (8 Módulos)
-El menú desplegable **Gestión** en la barra de navegación organiza las áreas operativas de la universidad:
-* **Espacios e Infraestructura:**
-  * **Edificios y Sedes (`/buildings/list`):** Administración de edificios físicos, arquitectura y estado edilicio.
-  * **Aulas Presenciales (`/classrooms/list?view_mode=physical`):** Catálogo de aulas físicas por piso, capacidades y zócalos compactos con métricas de ocupación en tiempo real (día, semana, mes).
-  * **Aulas Virtuales con Reunión (`/classrooms/list?view_mode=virtual`):** Campus Virtual con salas a demanda agrupadas por comisión, capacidad ilimitada ($\infty$) y enlaces directos de acceso a videollamadas (Zoom, Google Meet, Microsoft Teams).
-  * **Gestión de Ocupación y Métricas (`/admin/occupancy-metrics`):** Dashboard analítico de tasas de ocupación horaria (día, semana, mes), horas pico, distribución por turno y comparativa física vs. virtual.
-* **Gestión Académica:**
-  * **Carreras (`/admin/careers`):** ABM de carreras universitarias y planes de estudio con contador de asignaturas y comisiones activas.
-  * **Asignaturas (`/admin/subjects`):** Catálogo institucional de materias con créditos, departamentos y filtros por carrera y estado.
-  * **Comisiones y Cursadas (`/schedule/commissions`):** Gestión de cursadas, turnos, docentes, enlaces virtuales e hitos de evaluación.
-  * **Ciclo Lectivo (`/admin/academic-terms`):** Modelo y panel de administración de períodos académicos, cuatrimestres y activación del ciclo lectivo en curso.
-* **Administración & Seguridad:**
-  * **Usuarios y Roles RBAC:** Cuentas, asignación de permisos matriciales y auditoría.
-  * **Tipificaciones de Hitos:** Catálogo de tipos de hitos de evaluación académica.
-  * **Sincronización Sheets:** Integración con Google Sheets para actualización en lote.
-
----
-
-## 🛠️ Stack Tecnológico
-
-| Componente | Tecnología |
-| :--- | :--- |
-| **Backend** | Python 3.12+ / Flask |
-| **Base de Datos** | PostgreSQL 16+ / SQLAlchemy ORM |
-| **Seguridad & Sesiones** | Flask-Login / Werkzeug / CSRF Protect |
-| **Formularios** | Flask-WTF / WTForms |
-| **Internacionalización** | Flask-Babel / GNU gettext |
-| **Frontend** | Bootstrap 5.3, Bootstrap Icons, Vanilla JS, CSS Variables |
-| **Calendario** | FullCalendar 5.11 |
-
----
-
-## 🚀 Despliegue en Proxmox VE (LXC) con Entorno Virtual `venv`
-
-El sistema está especialmente optimizado para ejecutarse en contenedores **LXC (Debian 12 Bookworm o Ubuntu 22.04/24.04 LTS)** dentro de **Proxmox VE**, utilizando un entorno virtual nativo de Python (`venv`), el motor **PostgreSQL** instalado en el propio contenedor y el servidor WSGI **Gunicorn** gestionado como servicio por **systemd**.
-
----
-
-### 📋 Paso 1: Creación del Contenedor LXC en Proxmox VE
-
-Podés crear el contenedor desde la interfaz Web de Proxmox (*Create CT*) o por terminal Proxmox con `pct create`:
-
-* **Plantilla (Template):** `debian-12-standard` (*Recomendado*) o `ubuntu-22.04-standard` / `ubuntu-24.04-standard`.
-* **CPU:** 1 a 2 vCPU.
-* **Memoria RAM:** 1024 MB a 2048 MB (Swap: 512 MB).
-* **Disco:** 8 GB a 15 GB (almacenamiento `local-lvm` o `zfs`).
-* **Red (Network):** Modo Bridge `vmbr0` con IP estática en tu red local o DHCP (ej: `192.168.1.150/24`, Gateway: `192.168.1.1`).
-* **Opciones del Contenedor:**
-  * *Unprivileged container:* Sí (marcado por defecto, compatible).
-  * *Features (Características):* Habilitar **Nesting (`nesting=1`)** en `CT > Opciones > Características` (requerido para systemd).
-
----
-
-### ⚡ Paso 2: Instalación Automatizada con `install.sh`
-
-1. **Ingresar a la consola del contenedor LXC:**
-   Desde la Web UI de Proxmox (consola noVNC) o desde el shell de tu nodo Proxmox:
-   ```bash
-   pct enter <ID_DEL_CONTENEDOR>
-   ```
-
-2. **Clonar el repositorio y lanzar el instalador:**
-   ```bash
-   apt update && apt install -y git
-   git clone https://gitea.oemspot.com.ar/carlostellocba/admin-edu-space.git
-   cd admin-edu-space
-   bash install.sh
-   ```
-
-3. **Flujo de Ejecución Automatizado en el LXC:**
-   * **Migración segura fuera de `/root`:** Si el repositorio se clonó en `/root`, el instalador lo traslada automáticamente a `/opt/admin-edu-space` para garantizar que el usuario del servicio (`eduspace`) tenga acceso de lectura y ejecución.
-   * **Locales UTF-8:** Configura `en_US.UTF-8` y `es_AR.UTF-8` para asegurar la internacionalización con `Flask-Babel` y prevenir errores de encoding.
-   * **Motor PostgreSQL:** Instala el motor PostgreSQL, inicia el servicio y verifica conectividad activa con bucle de espera.
-   * **Restauración del Snapshot Oficial ([classrooms_db.sql](file:///c:/Workspace/admin-edu-space/classrooms_db.sql)):**
-     * Detecta el volcado completo de datos.
-     * Crea la base de datos `classrooms_db` y el usuario `eduspace_user`.
-     * Restaura **25 aulas** (físicas y Campus Virtual $\infty$), **206 comisiones**, **206 materias**, **412 reservas históricas**, **24 carreras**, matrices RBAC y cuentas de acceso.
-     * Otorga privilegios totales (`GRANT ALL`) en el esquema `public`, todas las tablas y **todas las secuencias** al usuario `eduspace_user`.
-     * Ejecuta `init_db.py` de forma idempotente para validar roles y coherencia.
-   * **Entorno Virtual Python (`venv`):** Crea el entorno aislado en `/opt/admin-edu-space/venv` e instala todas las dependencias oficiales (`Flask`, `SQLAlchemy`, `Gunicorn`, etc.).
-   * **Servicio Systemd de Producción:** Configura el servicio `admin-edu-space.service` gestionado por **Gunicorn** (3 workers, puerto 5000), con reinicio automático ante fallos y habilitado al inicio del contenedor.
-
----
-
-### 🌐 Paso 3: Acceso Inmediato a la Aplicación
-
-Al finalizar la instalación, el script mostrará la dirección IP del contenedor:
-* **URL:** **`http://<IP-DEL-LXC>:5000`** (ejemplo: `http://192.168.1.150:5000`)
-* **Email Administrador:** `admin@edu-space.com`
-* **Contraseña Administrador:** `admin123`
-
----
-
-### 🛠️ Comandos de Gestión del Servicio en el LXC
-
-```bash
-# Consultar estado en tiempo real
-systemctl status admin-edu-space
-
-# Seguir logs de la aplicación
-journalctl -u admin-edu-space -f
-
-# Reiniciar la aplicación
-systemctl restart admin-edu-space
-
-# Detener el servicio
-systemctl stop admin-edu-space
-```
-
----
-
-### 💾 Generación de Backups y Migración a Otros Contenedores LXC
-
-Para respaldar la base de datos en ejecución o clonarla a otro contenedor LXC:
-
-```bash
-# Dentro del contenedor LXC:
-cd /opt/admin-edu-space
-bash backup_db.sh
-```
-
-* El script genera un archivo fechado en `backups/classrooms_db_YYYYMMDD_HHMMSS.sql`.
-* Actualiza automáticamente el archivo principal [classrooms_db.sql](file:///c:/Workspace/admin-edu-space/classrooms_db.sql).
-* **Para migrar a otro contenedor:** Podés transferir `classrooms_db.sql` mediante SCP o Git y ejecutar `bash install.sh` en el nuevo LXC.
-
----
-
-### 💻 Instalación Manual para Desarrollo Local (con `venv`)
-
-Si deseás correr el proyecto en una máquina de desarrollo (Windows / Linux / macOS) sin usar el instalador de Proxmox:
-
-1. **Crear y activar el entorno virtual:**
-   * En Windows (PowerShell):
-     ```powershell
-     python -m venv venv
-     .\venv\Scripts\Activate.ps1
-     ```
-   * En Linux / macOS:
-     ```bash
-     python3 -m venv venv
-     source venv/bin/activate
-     ```
-
-2. **Instalar dependencias:**
-   ```bash
-   pip install -r requirements.txt
-   ```
-
-3. **Configurar base de datos local y restaurar snapshot:**
-   ```bash
-   cp .env.example .env
-   
-   # Crear base de datos en PostgreSQL local y cargar datos
-   sudo -u postgres psql -c "CREATE DATABASE classrooms_db;"
-   sudo -u postgres psql -d classrooms_db < classrooms_db.sql
-   ```
-
-4. **Compilar catálogos de traducción:**
-   ```bash
-   pybabel compile -d translations
-   ```
-
-5. **Iniciar el servidor:**
-   ```bash
-   python wsgi.py
-   ```
-   Disponible en: **`http://localhost:5000`**
-
----
-
-## 🔑 Credenciales Predeterminadas
-
-| Usuario | Correo Electrónico | Contraseña | Rol |
-| :--- | :--- | :--- | :--- |
-| **Administrador del Sistema** | `admin@edu-space.com` | `admin123` | `Admin` (Acceso Total) |
-
-> ⚠️ **Seguridad:** Cambiá la contraseña del administrador desde la interfaz web inmediatamente después del primer inicio de sesión.
-
----
-
-## 📁 Estructura del Proyecto
 
 ```text
-admin-edu-space/
+/
-├── app/
+├── backend/                  # API REST Backend (Python / Flask)
-│   ├── __init__.py                  # Factoría de la aplicación Flask y extensiones
+│   ├── app/                  # Lógica de negocio, base de datos y endpoints
-│   ├── forms/                       # Formularios Flask-WTF con validación CSRF
+│   ├── tests/                # Pruebas unitarias e integración
-│   │   ├── auth.py                  # Login, perfil y cambio de clave
+│   └── requirements.txt      # Dependencias de Python
-│   │   ├── building.py              # Sedes y edificios
+│
-│   │   ├── classroom.py             # Aulas y capacidades (con soporte ∞)
+├── frontend/                 # Backend-For-Frontend (Node.js / Express)
-│   │   └── reservation.py           # Reservas de aulas y horarios
+│   ├── src/                  # Controladores, middleware, servicios (Axios)
-│   ├── models/                      # Modelos relacionales SQLAlchemy
+│   ├── views/                # Plantillas Nunjucks (.html)
-│   │   ├── academic_term.py         # Ciclos lectivos y períodos académicos (activo/histórico)
+│   ├── public/               # Archivos estáticos (CSS, JS cliente)
-│   │   ├── building.py              # Sedes y edificios institucionales
+│   └── package.json          # Dependencias de Node.js
-│   │   ├── career.py                # Carreras y titulaciones universitarias
+│
-│   │   ├── classroom.py             # Aulas físicas y virtuales con capacidades
+├── docs/                     # Historial de cambios y documentación técnica
-│   │   ├── genetic_algorithm.py     # Estructuras de optimización heurística
+└── unicaba_prerequitos/      # Requisitos académicos y de negocio
-│   │   ├── milestone.py             # Tipificaciones de hitos académicos y exámenes
-│   │   ├── reservation.py           # Reservas horarias, estados y turnos
-│   │   ├── role.py                  # Roles y matriz de permisos granulares RBAC
-│   │   ├── subject.py               # Asignaturas, materias y comisiones de cursada
-│   │   └── user.py                  # Usuarios, credenciales y asignación de roles
-│   ├── routes/                      # Controladores y rutas modulares (Blueprints)
-│   │   ├── admin.py                 # Carreras, Asignaturas, Ciclo Lectivo, Tipificaciones, Métricas, Usuarios y Roles
-│   │   ├── auth.py                  # Autenticación, sesiones y perfil
-│   │   ├── buildings.py             # Gestión de sedes y edificios
-│   │   ├── classrooms.py            # Aulas presenciales vs. Campus Virtual a demanda y métricas de uso
-│   │   ├── genetic_algorithm.py     # Optimizador heurístico de asignación de espacios
-│   │   ├── main.py                  # Dashboard principal y métricas rápidas
-│   │   └── schedule.py              # Calendario interactivo, cartelera del día, comisiones y reservas
-│   ├── services/                    # Servicios y lógica de negocio
-│   │   └── sheets_importer.py       # Parser y sincronizador bidireccional de Google Sheets
-│   ├── static/                      # Recursos estáticos web (CSS, JS, imágenes institucionales)
-│   └── templates/                   # Vistas Jinja2 renderizadas con Bootstrap 5
-├── config/                          # Configuraciones de entorno (desarrollo, testing, prod)
-├── translations/                    # Catálogos GNU gettext compilados (es / en)
-├── classrooms_db.sql                # Snapshot completo de base de datos (PostgreSQL 14+)
-├── install.sh                       # Instalador automatizado para Proxmox VE LXC (venv + PostgreSQL)
-├── backup_db.sh                     # Script para generar nuevos backups y actualizar snapshot
-├── init_db.py                       # Inicializador DDL y sincronizador de esquema/roles
-├── CHANGELOG_SESSION.md             # Historial técnico cronológico
-├── requirements.txt                 # Dependencias Python (incluye Gunicorn)
-├── .env.example                     # Plantilla de variables de entorno
-└── wsgi.py                          # Punto de entrada de la aplicación Flask
 ```
 
----
+### 🐍 Backend (Python + Flask)
+- Funciona exclusivamente como una **REST API** que expone endpoints bajo `/api/v1/` retornando **JSON**.
+- Encargado de la persistencia de datos (SQLAlchemy / PostgreSQL), lógica de negocio dura, JWT auth service, seguridad, y algoritmos de optimización (Módulo Predictivo).
+- **Prohibido** retornar HTML o utilizar Jinja2/`render_template` en este entorno.
 
-## 🚀 Roadmap Académico & Propuesta de Evolución Tecnológica
+### 🟢 Frontend BFF (Node.js + Express)
-
+- Aplicación de servicio que renderiza las vistas para el cliente mediante **Nunjucks**.
-En respuesta a los requerimientos y sugerencias docentes, se formaliza el plan de evolución arquitectónica, estándares de seguridad y entrega de valor institucional para la plataforma **Admin Edu-Space (UniCABA)**.
+- Gestiona la sesión segura del usuario almacenando el token JWT recibido de Flask en una **Cookie HttpOnly**.
-
+- Actúa como proxy de conexión con el Backend de Python empleando **Axios** (inyectando el Bearer token interceptado).
-### 💡 1. Propuesta de Mejora Integral
+- Utiliza **Chart.js** y JS vanilla en el lado del cliente para visualizaciones interactivas.
-
-#### A. Arquitectura MVC Rigurosa & Clean Architecture
-* **Desacoplamiento de Capas:**
-  * **Model (Dominio):** Entidades relacionales puras y reglas de integridad del negocio desacopladas del framework web (`app/models/`).
-  * **View (Presentación):** Vistas web en Jinja2 con Bootstrap 5 y respuestas JSON estructuradas para clientes API/móviles.
-  * **Controller (Controladores/Blueprints):** Controladores delgados en `app/routes/` enfocados exclusivamente en la orquestación HTTP y redirección.
-  * **Service Layer & Repositories (`app/services/` & `app/repositories/`):** Aislamiento de la lógica de negocio (detección de colisiones, algoritmo genético de asignación, ETL de Google Sheets) y operaciones de persistencia encapsuladas.
-* **DTOs y Validación de Entrada:** Incorporación de esquemas tipados (Pydantic / Marshmallow) para filtrar y sanitizar datos de entrada antes de interactuar con el ORM, eliminando validaciones ad-hoc en los controladores.
-
-#### B. Autenticación & Autorización Stateless con JWT (JSON Web Tokens)
-* **Arquitectura API-First Híbrida:**
-  * Coexistencia armónica de sesiones web seguras (para el panel administrativo en navegadores) y tokens **JWT** (para microservicios, clientes móviles y aplicaciones externas).
-  * **Esquema Dual de Tokens (Dual Token Pattern):**
-    * `Access Token` (firmado con RS256/HS256, expiración corta de 15 minutos) con claims contextuales (`sub`, `roles`, `permissions`, `exp`).
-    * `Refresh Token` (almacenado en cookie segura `HttpOnly`, `Secure`, `SameSite=Strict`, expiración de 7 días) para renovación silenciosa sin reingreso de credenciales.
-  * **Mecanismo de Revocación Inmediata (Token Blacklist):** Almacenamiento en caché distribuida (Redis) para invalidación instantánea ante cierres de sesión forzados o rotación de contraseñas.
-
-#### C. Seguridad Empresarial y Paradigma "Sprint / Spring Security"
-* **Cadena de Filtros de Interceptación (SecurityFilterChain):** Pipeline centralizado inspirado en los estándares de Spring Security:
-  * **Authentication Filter:** Intercepta cabeceras `Authorization: Bearer <token>` y valida firmas criptográficas.
-  * **Security Headers Filter:** Inyección obligatoria de cabeceras de blindaje HTTP (HSTS, CSP, X-Frame-Options: DENY, X-Content-Type-Options: nosniff).
-  * **Rate Limiting Filter:** Prevención de ataques de fuerza bruta y DDoS en endpoints sensibles mediante límites dinámicos (`Flask-Limiter` / Redis).
-* **Seguridad Declarativa a Nivel Método (`@PreAuthorize` / `@require_permission`):**
-  * Decoradores reutilizables que evalúan la matriz RBAC antes de ejecutar cualquier método de servicio:
-    ```python
-    @require_permission('classrooms', min_level='read_write')
-    def update_classroom_capacity(classroom_id, new_capacity): ...
-    ```
-* **Bitácora Inmutable de Auditoría (Audit Trail):** Registro trazable de eventos críticos (creación/modificación de reservas, cambios de roles y accesos fallidos) con IP de origen, usuario actuante, timestamp y delta de cambios.
 
 ---
 
-### 📅 2. Planificación de Sprints (Roadmap)
+## 🎯 Dashboards Personalizados por Rol
 
-| Sprint / Fase | Objetivo Principal | Entregables Clave | Hito de Evaluación |
+La plataforma cuenta con paneles adaptados a las necesidades operativas de cada perfil institucional:
-| :--- | :--- | :--- | :--- |
+
-| **Sprint 1** | **Refactorización MVC & Capa de Servicios** | • Extracción de lógica de controladores a `app/services/`<br>• Implementación del patrón Repository para aulas y reservas<br>• DTOs de validación con esquemas Pydantic | Controladores limpios (< 60 líneas por endpoint) y separación estricta de responsabilidades. |
+* **Administrador (`/dashboard?role=admin`):** Cockpit institucional con métricas globales, auditoría de seguridad RBAC, tendencias mensuales y panel interactivo de **Estado y Percentiles de Asignación de Aulas Físicas** (asignadas vs disponibles en número y porcentaje).
-| **Sprint 2** | **Autenticación Stateless JWT & API Gateway** | • Endpoints `/api/auth/login`, `/refresh`, `/logout`<br>• Decoradores `@jwt_required` y claim parser<br>• Middleware Bearer Token para interoperabilidad | Autenticación y consumo seguro desde Postman y aplicaciones externas sin cookies de sesión. |
+* **Bedelía (`/dashboard?role=bedelia`):** Control operativo del campus en tiempo real, balance de aulas presenciales asignadas (96.3%) y libres (3.7%), cartelera del día y bandeja de aprobación de reservas pendientes.
-| **Sprint 3** | **Sprint Security & Gobernanza RBAC Avanzada** | • Pipeline `SecurityFilterChain` centralizado<br>• Decorador `@require_permission(module, level)` a nivel servicio<br>• Rate Limiting en login y endpoints públicos<br>• Módulo de auditoría inmutable de eventos (`AuditLog`) | Aprobación de pentest simulado OWASP Top 10 y matriz de permisos auditada. |
+* **Docente / Profesor (`/dashboard?role=docente`):** Sesiones del día con accesos directos a videollamadas y gestión de comisiones.
-| **Sprint 4** | **Optimizador Heurístico & Alta Concurrencia** | • Paralelización del algoritmo genético con multiprocessing/workers<br>• Colas asíncronas para optimizaciones pesadas<br>• Integración con microservicio Spring Boot vía REST/JWT | Optimización de 200+ comisiones en menos de 5 segundos con 0 colisiones horarias. |
+* **Alumno / Estudiante (`/dashboard?role=alumno`):** Brújula de cursada *"¿Dónde curso hoy?"* con ubicación por piso y aula o enlace virtual, junto al cronograma de exámenes y entregas de TPs.
+
+> **Modo Vista Previa:** Los usuarios con perfil administrador o directivo pueden previsualizar cualquier perspectiva utilizando el selector de roles en la barra superior o pasando el parámetro `?role={admin|bedelia|docente|alumno}` en la URL.
 
 ---
 
-### 💎 3. Valor Agregado & Retorno Institucional
+## ☁️ Sincronización Google Sheets, Configuración Global & Purga Académica
 
-1. **Eficiencia Edilicia y Reducción del Desperdicio de Espacio:**
+El sistema incluye sincronización automatizada con las planillas oficiales de cursada de UniCABA:
-   - Maximiza el aprovechamiento de las aulas físicas de la Sede Central (**Tte. Gral. Juan Domingo Perón 802**), pasando de una asignación manual y empírica a un modelo algorítmico basado en capacidad real, accesibilidad de pisos y equipamiento.
+* **Configuración Global Dinámica:** Selección y persistencia de la URL de Google Sheets directamente desde la interfaz web (`/admin/google_sheets_import`) sin valores fijos en el código.
-2. **Ahorro de Tiempo Operativo (85% de reducción):**
+* **Herramienta de Purga y Reinicio (`reset_academic_data`):** Módulo CLI y web para limpiar selectivamente reservas, aulas, asignaturas, comisiones o carreras, garantizando pruebas limpias desde cero y preservando siempre usuarios y credenciales.
-   - Automatiza la resolución de conflictos de solapamiento horario en horarios pico (Turno Vespertino, 17:30 a 21:30 hs) y agiliza la sincronización con la cartelera de Google Sheets en lote.
+* **Concurrencia Virtual Ilimitada:** Reconocimiento de espacios áulicos remotos (`Campus Virtual · VIRTUAL`), permitiendo la coexistencia de múltiples comisiones en la misma franja horaria sin colisiones de agenda.
-3. **Interoperabilidad Universal:**
+* **Catálogo Presencial con Cursadas Asignadas:** Listado de aulas físicas con cálculo de ocupación real (semana/mes), vista previa de asignaturas y enlaces directos a calendario y ficha del espacio.
-   - La arquitectura desacoplada y la capa JWT permiten que cualquier otro sistema de la universidad (SIU Guaraní, Campus Virtual Moodle, App de estudiantes, backend Spring Boot institucional) consulte en tiempo real la disponibilidad áulica.
+* **Enlaces de Videollamada Automáticos:** Generación de enlaces seguros (Google Meet / Teams) para acceso instantáneo de docentes y estudiantes.
-4. **Despliegue de Alta Eficiencia (Bajo Costo de Infraestructura):**
+* **Filtros en Cartelera:** Opciones para filtrar por turno, piso u ocultar aulas virtuales mediante el switch dedicado en `/schedule/today_schedule`.
-   - A diferencia de arquitecturas pesadas basadas en contenedores Docker o Kubernetes que demandan múltiples gigabytes de RAM, **Admin Edu-Space corre de forma nativa en un contenedor Proxmox VE LXC consumiendo menos de 180MB de memoria**, garantizando alta disponibilidad con costos de hardware mínimos.
 
 ---
 
-### 🧩 4. Desafíos Técnicos (Challenges)
+## 📅 Ficha de Reserva & Gestión de Comisiones
 
-* **Challenge 1: Resolución Heurística de Horarios Áulicos (NP-Hard Problem):**
+* **Ficha de Reserva Detallada (`/schedule/view_reservation?id={id}`):** Información completa del espacio físico o virtual asignado, capacidad y asistencia prevista, comisión académica vinculada, docente a cargo, botones de acción inmediata (*Modificar Reserva*, *Confirmar Reserva*, *Cancelar Reserva*) y acceso con un clic a la sala de videollamada.
-  - La asignación de 206 asignaturas, 400+ reservas y 25 aulas considerando restricciones duras (no colisión horaria, capacidad no superada) y blandas (mismo docente en pisos cercanos, turnos consolidados) representa un problema de complejidad NP-Hard resuelto mediante un **Algoritmo Genético** con operadores de cruce y mutación adaptativa.
+* **Gestión de Comisiones y Vinculación con Asignaturas (`/admin/commissions_list`):**
-* **Challenge 2: Sincronización Masiva Tolerante a Fallos:**
+  - Botón y modal interactivo **Nueva Comisión** (`#modalAddCommission`) para registrar comisiones y vincularlas directamente a su **Asignatura / Materia**, indicando cuatrimestre, año, turno, cupo y docente responsable.
-  - El parser ETL de Google Sheets normaliza datos no estructurados de la cartelera académica, resolviendo discrepancias ortográficas, turnos implícitos y formatos dispares de hora sin interrumpir la operación continua.
+  - Generación automática de enlace institucional de Google Meet cuando no se especifica un enlace propio.
-* **Challenge 3: Portabilidad Extrema en Proxmox LXC sin Docker:**
+  - Tabla operativa con visualización explícita del código de comisión, nombre de materia, código de asignatura y carrera.
-  - Desarrollo de un instalador auto-recuperable ([install.sh](file:///c:/Workspace/admin-edu-space/install.sh)) capaz de levantar PostgreSQL nativo en Debian 12 y 13 dentro de `tmpfs`, gestionar clusters con `pg_createcluster`, operar de forma autónoma con o sin `sudo`, y garantizar persistencia íntegra de base de datos entre dispositivos.
 
 ---
 
-## 📄 Licencia
+## 🚀 Instalación y Despliegue Local
 
-Este proyecto forma parte del sistema de gestión institucional y educativa de **UniCABA**. Todos los derechos reservados.
+### Requisitos previos
+- Node.js (v18 o superior)
+- Python 3.10+
+- PostgreSQL / SQLite
 
+### 1. Iniciar el Backend (Flask)
+```bash
+cd backend
+python -m venv venv
+# Activar venv (Windows: venv\Scripts\activate, Linux/Mac: source venv/bin/activate)
+pip install -r requirements.txt
+flask run --port=5000
+```
+*(El backend quedará escuchando en http://localhost:5000)*
+
+### 2. Iniciar el Frontend (Node/Express)
+```bash
+cd frontend
+npm install
+npm run dev
+# o en su defecto:
+node src/app.js
+```
+*(El frontend quedará escuchando en http://localhost:3000)*
+
+---
+
+## 📚 Documentación Técnica & Changelogs
+* [Estado de la Migración y Arquitectura Objetivo UniCABA](ESTADO_MIGRACION_Y_ARQUITECTURA_OBJETIVO.md)
+* [Roadmap MVP: Fases y Estadios del Proyecto](ROADMAP_MVP.md)
+* [Changelog Oficial del Proyecto](CHANGELOG.md)
+* [Changelog Detallado: Clases Virtuales y Dashboards](docs/CHANGELOG_VIRTUAL_CLASSES_AND_DASHBOARDS.md)
+* [Auditoría y Sesión de Reingeniería](docs/CHANGELOG_SESSION.md)
+* [Guía de Integración de Cronograma](docs/SCHEDULE_INTEGRATION_GUIDE.md)

ROADMAP_MVP.md

@@ -0,0 +1,131 @@
+# ROADMAP MVP — Sistema Integral UniCABA
+## Gestión de Espacios Áulicos, Actividad de Cursada y Seguimiento Académico
+
+**Institución:** Universidad de la Ciudad de Buenos Aires (UniCABA)  
+**Versión:** 2.6.0  
+**Fecha de Actualización:** 19 de Septiembre de 2026  
+**Rama Base:** `testing`  
+
+---
+
+## 🗺️ Visión del Proyecto
+Construir y evolucionar la plataforma de gestión académica y espacial de **UniCABA** hacia un sistema integral de clase universitaria, desacoplado en una arquitectura **Backend RESTful (Python/Flask) + Frontend BFF (Node.js/Express/Nunjucks)**, capaz de gobernar tanto los espacios físicos de la sede central como la dinámica áulica del campus virtual, garantizando una experiencia fluida para **Administradores**, **Bedelía**, **Docentes** y **Estudiantes**.
+
+---
+
+## 📊 Estado Global de Progreso
+
+```
+Fase 0: Desacople y Arquitectura Base    [████████████████████] 100% (Completado)
+Fase 1: Paridad Legacy y Estabilización  [████████████████████] 100% (Completado)
+Fase 2: Co-docencia y Matriz Conflictos  [████████████████████] 100% (Completado)
+Fase 3: Hitos Evaluativos y Calificaciones[░░░░░░░░░░░░░░░░░░░░]   0% (Próxima)
+Fase 4: UI/UX Drag & Drop e Impersonación[░░░░░░░░░░░░░░░░░░░░]   0% (Planificada)
+Fase 5: Despliegue Producción e Integrac.[░░░░░░░░░░░░░░░░░░░░]   0% (Planificada)
+```
+
+---
+
+## 🚀 Detalle de Fases y Estadios
+
+### Fase 0: Desacople y Arquitectura Base ✅ *(Completada)*
+* **Objetivo:** Separar el monolito Jinja2 legacy en dos servicios independientes de alto rendimiento.
+* **Entregables:**
+  * [x] Creación del Backend Flask como API REST pura bajo `/api/v1/` retornando exclusivamente JSON.
+  * [x] Implementación del Frontend BFF en Node.js + Express con renderizado de plantillas mediante Nunjucks.
+  * [x] Autenticación desacoplada mediante JWT (`access_token`) transportado en Cookie `HttpOnly` segura.
+  * [x] Pipeline de seguridad `SecurityFilterChain` con cabeceras de blindaje OWASP y rate limiting dinámico.
+  * [x] Cliente HTTP Axios centralizado con inyección automática de Bearer token y manejo de sesiones.
+
+---
+
+### Fase 1: Paridad Legacy, Estabilización de Virtualidad y BFF Core ✅ *(Completada)*
+* **Objetivo:** Alcanzar paridad funcional total con la versión legacy, subsanando defectos críticos de virtualidad y dotando de interfaz específica a cada rol.
+* **Entregables:**
+  * [x] **Importador de Google Sheets Corregido:**
+    * Eliminación de la colisión de horarios en el aula virtual única (`Campus Virtual · VIRTUAL`).
+    * Incremento de reservas registradas de 363 a 643 (incorporando 280 clases virtuales que se descartaban).
+    * Generación y persistencia automática de enlaces de Google Meet institucional por comisión y reserva.
+  * [x] **Dashboards Especializados por Rol:**
+    * Dashboard interactivo para **Bedelía** (aulas físicas, salas virtuales, aprobaciones pendientes).
+    * Dashboard interactivo para **Docente** (clases del día, comisiones, enlaces directos a Meet).
+    * Dashboard interactivo para **Alumno** (brújula de cursada *"¿Dónde curso hoy?"*, hitos y calendario).
+    * Cockpit institucional para **Admin** (métricas de capacidad, auditoría RBAC, demanda mensual).
+    * Selector dinámico de vista previa / roles en tiempo real (`?role=...`).
+  * [x] **Cartelera del Día (`today_schedule`):**
+    * Grilla temporal por bloques horarios (07:00 a 21:00 hs) con indicadores físicos y virtuales.
+    * Filtro dinámico para ocultar clases virtuales (`hide_virtual=1`) y segmentación por piso o turno.
+  * [x] **Acople de Ficha de Reserva (`schedule.view_reservation`):**
+    * Ruteo en BFF (`/schedule/view_reservation?id=...` y `/view/:id`).
+    * Endpoint REST `/api/v1/reservations/<id>` con enriquecimiento relacional (aula, comisión, docente).
+    * Soporte para modificar reserva (`edit_reservation`) con selectores en cascada, confirmación y cancelación.
+  * [x] **Gestión de Comisiones (`admin/commissions_list`):**
+    * Botón y modal interactivo `+ Nueva Comisión` (`#modalAddCommission`).
+    * Vinculación obligatoria y explícita a la **Asignatura / Materia**, indicando cuatrimestre, año lectivo, turno, docente a cargo, cupo y enlace virtual.
+    * Visualización en tabla de la materia vinculada con su código y carrera asociada.
+
+---
+
+### Fase 2: Co-docencia, Matriz de Conflictos y Regla Diaria ✅ *(100% Completado)*
+* **Objetivo:** Implementar las reglas de negocio académicas complejas para asignación de cátedras y cursada de alumnos.
+* **Estadios:**
+  1. **Estadio 2.1 — Modelo de Co-docencia:**
+     - [x] Tabla relacional `commission_teachers` para soportar múltiples docentes por comisión (titulares, adjuntos, ayudantes).
+     - [x] Endpoints `/api/v1/commissions/<id>/teachers` para asociar y desvincular docentes de cátedra.
+     - [x] Adaptación de vistas de Bedelía y Comisiones para visualizar el equipo docente completo.
+  2. **Estadio 2.2 — Matriz de Conflictos y Validación:**
+     - [x] Validación estricta de conflicto físico: bloqueo de doble asignación de aula en mismo día y horario.
+     - [x] Validación de conflicto docente: detección de superposición horaria del profesor, con soporte de excepción justificada cuando la comisión cuenta con co-docencia.
+     - [x] Validación de aforo: bloqueo cuando la cantidad de alumnos excede la capacidad del aula física.
+  3. **Estadio 2.3 — Regla de Restricción Diaria del Alumno:**
+     - [x] Validación al matricular: un alumno no puede cursar dos asignaturas regulares en el mismo día calendario.
+     - [x] Excepción parametrizable: autorización automática si al menos una de las materias es un "curso corto" (`is_short_course`) o si existe autorización manual de Bedelía (`allow_same_day_exception`).
+
+---
+
+### Fase 3: Gestión de Hitos Evaluativos y Libro de Calificaciones 📅 *(Planificada)*
+* **Objetivo:** Proveer al cuerpo docente y estudiantil el seguimiento completo de instancias evaluativas.
+* **Estadios:**
+  1. **Estadio 3.1 — Calendario de Evaluación por Comisión:**
+     - [ ] Programación de parciales, recuperatorios, entregas de trabajos prácticos y exámenes finales.
+     - [ ] Notificaciones preventivas en el dashboard del alumno con cuenta regresiva para exámenes.
+  2. **Estadio 3.2 — Libro de Calificaciones (*Gradebook*):**
+     - [ ] Matriz de carga rápida de notas para docentes con autoguardado asíncrono.
+     - [ ] Consulta individualizada de calificaciones y retroalimentaciones pedagógicas para alumnos.
+     - [ ] Cierre de actas de regularidad y promoción para Bedelía.
+
+---
+
+### Fase 4: UI/UX Avanzada para Bedelía & Modo Impersonación 🖥️ *(Planificada)*
+* **Objetivo:** Dotar a la oficina de Bedelía y a la Administración de herramientas interactivas de última generación.
+* **Estadios:**
+  1. **Estadio 4.1 — Grilla Semanal Interactiva (Drag-and-Drop):**
+     - [ ] Interfaz tipo TimeGrid interactiva con arrastre de comisiones para asignación rápida de aulas y turnos.
+     - [ ] Detección visual en tiempo real de aulas ocupadas o incompatibles.
+  2. **Estadio 4.2 — Modo Impersonación del Superadmin:**
+     - [ ] Funcionalidad de *login as* o vista previa con cabecera `X-Impersonate-User` para replicar exactamente lo que ve cualquier docente o alumno.
+     - [ ] Trazabilidad obligatoria de acciones bajo impersonación en el registro de auditoría (`audit_logs`).
+  3. **Estadio 4.3 — Integración del Optimizador Genético:**
+     - [ ] Acople del motor predictivo de algoritmos genéticos a la base de datos real para sugerir redistribución óptima de aulas según aforo.
+
+---
+
+### Fase 5: Producción Institucional, CI/CD e Integraciones 🏢 *(Planificada)*
+* **Objetivo:** Puesta en marcha definitiva en la infraestructura de servidores de UniCABA.
+* **Estadios:**
+  1. **Estadio 5.1 — Despliegue e Infraestructura:**
+     - [ ] `docker-compose.yml` productivo orquestando Flask (Gunicorn), Node.js BFF (PM2) y PostgreSQL 15.
+     - [ ] Proxy inverso Nginx con certificados SSL/TLS y compresión Brotli/Gzip.
+  2. **Estadio 5.2 — Integraciones Universitarias:**
+     - [ ] Módulo de exportación/importación compatible con SIU Guaraní 3.
+     - [ ] Sincronización automática de aulas virtuales con Moodle institucional.
+  3. **Estadio 5.3 — Pruebas de Carga y Hardening:**
+     - [ ] Pruebas de estrés de concurrencia en días pico de inicio de cuatrimestre (10.000 solicitudes simultáneas).
+
+---
+
+## 📈 Criterios de Aceptación del MVP
+1. **Zero Colisiones Físicas:** Imposibilidad absoluta de asignar dos materias simultáneas a una misma aula física.
+2. **Virtualidad Fluida:** Acceso con un clic a reuniones virtuales válidas para el 100% de las comisiones remotas.
+3. **Roles Seguros:** Separación total de permisos donde ningún alumno o docente acceda a configuración global ni a datos privados de otras comisiones.
+4. **Respuesta Sub-segundo:** Carga de carteleras y calendarios en menos de 300 ms en el BFF Node.js.

SECURITY_AUDIT_REPORT.md

@@ -0,0 +1,99 @@
+# Informe de Auditoría y Seguridad Automatizada (Python & Node.js)
+**Proyecto:** Edu-Space Admin Architecture  
+**Fecha:** Septiembre 2026  
+**Entorno:** Backend Flask (REST API) + Node.js BFF (Express)  
+**Estado General:** Aprobado ✅ (0 vulnerabilidades conocidas, 0 fallos críticos SAST/DAST)
+
+---
+
+## 1. Resumen Ejecutivo
+Se completó la implementación del **Plan de Auditoría y Seguridad Automatizada** que cubre el ciclo de vida completo de las dos capas backend de la plataforma:
+- **Capa Core API (Python / Flask)**: Análisis Estático (SAST), Análisis de Dependencias de Terceros (SCA), Pruebas Dinámicas / Fuzzing contra especificación OpenAPI (DAST).
+- **Capa BFF / Frontend Server (Node.js / Express)**: Análisis Estático (SAST), Análisis de Dependencias (SCA) y Blindaje Activo con cabeceras HTTP (`helmet`) y limitador de tasa (`express-rate-limit`).
+
+---
+
+## 2. Fase 1: Backend Python (Flask API)
+
+### 2.1. Análisis Estático de Código Fuente (SAST) - `Bandit`
+- **Herramienta:** Bandit v1.8.3 (`backend/venv/Scripts/bandit.exe`)
+- **Comando:** `bandit -r ./app -ll -ii`
+- **Líneas Escaneadas:** 8.456 líneas de código Python.
+- **Hallazgo Inicial:** 1 advertencia de severidad Media (CWE-22 / B310 en `backend/app/services/sheets_importer.py` por uso de `urllib.request.urlopen` sin validación estricta del esquema URL).
+- **Remediación Aplicada:**
+  - Se incorporó validación explícita de esquema (`url.startswith('https://')` o `url.startswith('http://')`) previo a la invocación de `urlopen`.
+  - Se colocó anotación `# nosec B310` justificando la protección criptográfica/red implementada.
+- **Resultado Actual:** **0 problemas identificados** (Medium/High = 0).
+
+### 2.2. Auditoría de Dependencias de Terceros (SCA) - `Pip-Audit`
+- **Herramienta:** Pip-Audit v2.10.1 con base de datos OSV (`backend/venv/Scripts/pip-audit.exe`)
+- **Comando:** `pip-audit -s osv --progress-spinner off -r requirements.txt`
+- **Hallazgo Inicial:** 24 vulnerabilidades conocidas asociadas a dependencias desactualizadas (`Flask==3.0.0`, `Werkzeug==3.0.1`, `requests==2.31.0`, `bleach==6.1.0`, `python-dotenv==1.0.0`).
+- **Remediaciones Aplicadas:**
+  - Actualización de `Flask` a `>=3.1.3`
+  - Actualización de `Werkzeug` a `>=3.1.6` (instalada v3.1.8)
+  - Actualización de `requests` a `>=2.32.4` (instalada v2.34.2)
+  - Actualización de `bleach` a `>=6.4.0`
+  - Actualización de `python-dotenv` a `>=1.2.2` (instalada v1.2.3)
+- **Resultado Actual:** **No known vulnerabilities found** (0 CVEs pendientes).
+
+### 2.3. Pruebas Dinámicas y Fuzzing de API REST (DAST) - `Schemathesis`
+- **Herramienta:** Schemathesis v4.27.4 (`backend/venv/Scripts/st.exe`)
+- **Especificación OpenAPI:** Implementada en `backend/app/routes/api/openapi.py` (`/api/v1/openapi.json`) bajo el estándar OpenAPI 3.0.3.
+- **Comando:** `st run http://127.0.0.1:5000/api/v1/openapi.json --checks not_a_server_error --max-examples=10`
+- **Hallazgo Inicial:** Fuzzing detectó un error 500 no controlado en `POST /api/v1/auth/login` cuando el payload enviado consistía en un arreglo JSON anómalo (`[null, null]`) en vez de un objeto/diccionario, provocando un `TypeError` en el constructor de Pydantic (`LoginDTO(**data)`).
+- **Remediación Aplicada:**
+  - Se agregó validación de tipo `if not isinstance(data, dict): return jsonify({'error': 'BadRequest', 'message': '...'}), 400` tanto en `/login` como en `/refresh`.
+- **Resultado Actual:** **114 casos de prueba generados y superados con éxito**, **0 errores 500 del servidor**.
+
+---
+
+## 3. Fase 2: Backend Node.js (Express BFF)
+
+### 3.1. Análisis Estático de Código Fuente (SAST) - `njsscan`
+- **Herramienta:** NodeJsScan (`backend/venv/Scripts/njsscan.exe`)
+- **Comando:** `njsscan ./frontend/src`
+- **Reglas Evaluadas:** Inyecciones de código, llamadas inseguras a `eval()`, omisión de headers de seguridad, credenciales hardcodeadas, CORS inseguro.
+- **Resultado:** **No issues found** (0 vulnerabilidades).
+
+### 3.2. Blindaje de Middleware (`helmet` & `express-rate-limit`)
+- **Paquetes Instalados:** `helmet`, `express-rate-limit`.
+- **Configuración en `frontend/src/app.js`:**
+  - `app.disable('x-powered-by')`: Oculta el motor Express para prevenir finger-printing de atacantes.
+  - `helmet`: Aplica cabeceras HTTP de protección:
+    - `X-Content-Type-Options: nosniff`
+    - `X-Frame-Options: SAMEORIGIN` (prevención de Clickjacking)
+    - `Strict-Transport-Security: max-age=31536000; includeSubDomains` (HSTS)
+    - `Cross-Origin-Opener-Policy: same-origin`
+    - `Cross-Origin-Resource-Policy: same-origin`
+  - `express-rate-limit`:
+    - Endpoint `/auth/login`: Límite estricto de 30 peticiones por ventana de 15 minutos por IP para mitigar ataques de fuerza bruta de credenciales.
+    - Endpoints `/api`: Límite de 180 peticiones por minuto por IP para mitigar saturación y scraping.
+
+### 3.3. Auditoría de Dependencias (SCA) - `npm audit`
+- **Herramienta:** `npm audit` nativo (v11.x)
+- **Comando:** `cmd.exe /c npm audit` en `frontend/`
+- **Resultado:** **found 0 vulnerabilities** en 108 paquetes analizados.
+
+---
+
+## 4. Script de Auditoría Automatizada Unificada
+
+Se diseñó y probó el script automatizado [security_audit.bat](file:///c:/Users/Soporte%20IT/workspace/admin-edu-space/security_audit.bat) en la raíz del repositorio, ejecutable en un solo paso:
+```cmd
+security_audit.bat
+```
+El script ejecuta secuencialmente los 5 controles de seguridad y genera un reporte en consola para desarrolladores y pipelines de integración continua.
+
+---
+
+## 5. Matriz de Resultados
+
+| Control | Capa | Herramienta | Estado Previo | Estado Final |
+|---|---|---|---|---|
+| **SAST (Python)** | Flask API | `bandit` | 1 Advertencia Media (B310) | **0 Problemas (100% Limpio)** ✅ |
+| **SCA (Python)** | Flask API | `pip-audit` | 24 Vulnerabilidades (CVEs) | **0 Vulnerabilidades** ✅ |
+| **DAST (Python)** | Flask API | `schemathesis` | 1 Fallo HTTP 500 (payload fuzzing) | **0 Fallos (114/114 Pasados)** ✅ |
+| **SAST (Node.js)**| Express BFF| `njsscan` | Sin controles previos | **0 Problemas (100% Limpio)** ✅ |
+| **SCA (Node.js)** | Express BFF| `npm audit` | No auditado con Helmet | **0 Vulnerabilidades** ✅ |
+| **Blindaje HTTP** | Express BFF| `helmet` + `rate-limit` | Cabeceras por defecto | **Protegido con HSTS, nosniff, limiters** ✅ |

app/__init__.py

@@ -1,112 +0,0 @@
-from flask import Flask, request, session
-from flask_sqlalchemy import SQLAlchemy
-from flask_migrate import Migrate
-from flask_login import LoginManager
-from flask_cors import CORS
-from flask_babel import Babel, gettext as _
-from config.config import Config
-
-# Initialize extensions
-db = SQLAlchemy()
-migrate = Migrate()
-login_manager = LoginManager()
-cors = CORS()
-babel = Babel()
-
-def create_app(config_class=Config):
-    app = Flask(__name__)
-    app.config.from_object(config_class)
-    
-    # Initialize extensions with app
-    db.init_app(app)
-    migrate.init_app(app, db)
-    login_manager.init_app(app)
-    cors.init_app(app)
-    
-    # Login manager configuration
-    login_manager.login_view = 'auth.login'
-    login_manager.login_message = 'Por favor inicia sesión para acceder a esta página.'
-    login_manager.login_message_category = 'info'
-    
-# Import models to ensure they are registered
-    from app.models import user
-    # Register blueprints
-    from app.routes import auth_bp, classrooms_bp, buildings_bp, main_bp, schedule_bp, genetic_bp, genetic_web_bp, admin_bp
-    
-    app.register_blueprint(auth_bp, url_prefix="/")
-    app.register_blueprint(classrooms_bp, url_prefix="/classrooms")
-    app.register_blueprint(buildings_bp)
-    app.register_blueprint(main_bp, url_prefix="/")
-    app.register_blueprint(schedule_bp, url_prefix="/schedule")
-    app.register_blueprint(genetic_bp)
-    app.register_blueprint(genetic_web_bp)
-    app.register_blueprint(admin_bp)
-    
-    # Language selector function
-    def get_locale():
-        # 1. Parámetro explícito en la URL (?lang=es o ?lang=en)
-        lang = request.args.get('lang')
-        if lang and lang in app.config['LANGUAGES']:
-            session['language'] = lang
-            return lang
-        
-        # 2. Si el usuario está autenticado y tiene idioma configurado en su perfil, prevalece en toda la sesión
-        from flask_login import current_user
-        if current_user.is_authenticated and getattr(current_user, 'preferred_language', None):
-            if current_user.preferred_language in app.config['LANGUAGES']:
-                return current_user.preferred_language
-        
-        # 3. En la pantalla de Login (usuario no autenticado):
-        # El idioma predeterminado del login debe ser español o respetar el idioma del navegador.
-        # No debe verse afectado por cookies o sesiones residuales de otros usuarios.
-        is_login = (request.endpoint == 'auth.login' or request.path.rstrip('/') == '/login')
-        if is_login:
-            # Solo si el usuario cambió el idioma explícitamente en el selector del login
-            if session.get('login_lang_explicit') in app.config['LANGUAGES']:
-                return session['login_lang_explicit']
-            
-            # Detectar según el navegador del usuario (soporta es-419, es-AR, es-ES, etc.)
-            if request.accept_languages:
-                for accepted_lang, _quality in request.accept_languages:
-                    primary = accepted_lang.split('-')[0].lower()
-                    if primary in app.config['LANGUAGES']:
-                        return primary
-            
-            # Idioma predeterminado por defecto del login: Español
-            return 'es'
-        
-        # 4. Para otras rutas: verificar si hay idioma en sesión (ej. selector manual)
-        if 'language' in session and session['language'] in app.config['LANGUAGES']:
-            return session['language']
-        
-        # 5. Detección automática del navegador por defecto (soporta subtags regionales)
-        if request.accept_languages:
-            for accepted_lang, _quality in request.accept_languages:
-                primary = accepted_lang.split('-')[0].lower()
-                if primary in app.config['LANGUAGES']:
-                    return primary
-
-        # Fallback del sistema: Español
-        return app.config['BABEL_DEFAULT_LOCALE']
-
-
-    # Babel context processor
-    @app.context_processor
-    def inject_conf_vars():
-        return dict(
-            languages=app.config['LANGUAGES'],
-            current_lang=str(get_locale())
-        )
-
-    
-    # Configure Babel
-    babel.init_app(app, locale_selector=get_locale)
-    
-    # Register localized date and datetime formatters for Jinja2 templates
-    from flask_babel import format_date, format_datetime
-    app.jinja_env.globals['format_date'] = format_date
-    app.jinja_env.globals['format_datetime'] = format_datetime
-    app.jinja_env.filters['format_date'] = format_date
-    app.jinja_env.filters['format_datetime'] = format_datetime
-    
-    return app

app/routes/main.py

@@ -1,158 +0,0 @@
-from flask import Blueprint, render_template, jsonify, redirect, url_for, session, request, flash
-from flask_login import login_required, current_user
-from app import db
-from app.models.reservation import Reservation
-from app.models.classroom import Classroom
-from app.models.subject import Subject
-from app.models.subject import Commission
-from datetime import datetime, timedelta
-from sqlalchemy import func
-from flask_babel import gettext as _
-
-main_bp = Blueprint('main', __name__)
-
-@main_bp.route('/')
-@login_required
-def dashboard():
-    """Main dashboard page"""
-# Get statistics
-    try:
-        total_classrooms = Classroom.query.filter_by(is_active=True).count()
-    except:
-        total_classrooms = 0
-        
-    try:
-        total_subjects = Subject.query.filter_by(is_active=True).count()
-    except:
-        total_subjects = 0
-    
-    # Get today's reservations
-    today = datetime.utcnow().date()
-    try:
-        today_reservations = Reservation.query.filter(
-            func.date(Reservation.start_time) == today
-        ).count()
-    except:
-        today_reservations = 0
-    
-    # Get this week's reservations
-    week_start = today - timedelta(days=today.weekday())
-    week_end = week_start + timedelta(days=6)
-    try:
-        week_reservations = Reservation.query.filter(
-            func.date(Reservation.start_time) >= week_start,
-            func.date(Reservation.start_time) <= week_end
-        ).count()
-    except:
-        week_reservations = 0
-    
-    # Get upcoming reservations (next 7 days)
-    try:
-        upcoming_reservations = Reservation.query.filter(
-            Reservation.start_time >= datetime.utcnow(),
-            Reservation.start_time <= datetime.utcnow() + timedelta(days=7)
-        ).limit(10).all()
-    except:
-        upcoming_reservations = []
-    
-    stats = {
-        'total_classrooms': total_classrooms,
-        'total_subjects': total_subjects,
-        'today_reservations': today_reservations,
-        'week_reservations': week_reservations
-    }
-    
-    return render_template('dashboard.html', 
-                         stats=stats, 
-                         upcoming_reservations=upcoming_reservations)
-
-@main_bp.route('/api/dashboard-stats')
-@login_required
-def dashboard_stats_api():
-    """API endpoint for dashboard statistics"""
-    # Get today's data
-    today = datetime.utcnow().date()
-    today_reservations = Reservation.query.filter(
-        func.date(Reservation.start_time) == today
-    ).count()
-    
-    # Get this week's data
-    week_start = today - timedelta(days=today.weekday())
-    week_end = week_start + timedelta(days=6)
-    week_reservations = Reservation.query.filter(
-        func.date(Reservation.start_time) >= week_start,
-        func.date(Reservation.start_time) <= week_end
-    ).count()
-    
-    # Get monthly data for chart
-    current_date = datetime.utcnow()
-    monthly_data = []
-    
-    for i in range(12):
-        month_date = current_date - timedelta(days=30 * i)
-        month_start = month_date.replace(day=1)
-        month_end = (month_start + timedelta(days=32)).replace(day=1) - timedelta(days=1)
-        
-        monthly_reservations = Reservation.query.filter(
-            func.date(Reservation.start_time) >= month_start.date(),
-            func.date(Reservation.start_time) <= month_end.date()
-        ).count()
-        
-        monthly_data.append({
-            'month': month_start.strftime('%Y-%m'),
-            'reservations': monthly_reservations
-        })
-    
-    return jsonify({
-        'today_reservations': today_reservations,
-        'week_reservations': week_reservations,
-        'monthly_data': list(reversed(monthly_data))
-    })
-
-@main_bp.route('/genetic-optimizer')
-@login_required
-def genetic_optimizer():
-    """Serve the genetic algorithm optimization interface"""
-    if not (current_user.has_permission('optimizer', 'read') or (current_user.role and current_user.role.upper() == 'ADMIN')):
-        flash(_('No tienes permisos para acceder a la herramienta de optimización.'), 'danger')
-        return redirect(url_for('main.dashboard'))
-    
-    return render_template('genetic_optimizer.html')
-
-@main_bp.route('/set_language/<language>')
-def set_language(language=None):
-    if language not in ['en', 'es']:
-        language = 'es'
-    
-    session['language'] = language
-    
-    # Si se selecciona el idioma desde la pantalla de login, registrar la selección explícita
-    if request.referrer and 'login' in request.referrer:
-        session['login_lang_explicit'] = language
-    
-    if current_user.is_authenticated:
-        current_user.preferred_language = language
-        db.session.commit()
-        
-    return redirect(request.referrer or url_for('main.dashboard'))
-
-
-@main_bp.route('/api/milestone-types')
-def api_milestone_types():
-    """Retorna las tipificaciones de hitos activas en JSON para consumo de frontend/mobile"""
-    from app.models.milestone import MilestoneType, BASE_MILESTONE_TYPES
-    if MilestoneType.query.count() == 0:
-        for item in BASE_MILESTONE_TYPES:
-            mt = MilestoneType(
-                name=item['name'],
-                code=item['code'],
-                color=item['color'],
-                description=item['description'],
-                sort_order=item['sort_order'],
-                is_active=True
-            )
-            db.session.add(mt)
-        db.session.commit()
-
-    types = MilestoneType.query.filter_by(is_active=True).order_by(MilestoneType.sort_order.asc(), MilestoneType.id.asc()).all()
-    return jsonify([t.to_dict() for t in types])␍

app/services/__init__.py

@@ -1,3 +0,0 @@
-from .sheets_importer import GoogleSheetsImporter
-
-__all__ = ['GoogleSheetsImporter']

app/templates/admin/import.html

@@ -1,242 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}{% trans %}Import from Google Sheets{% endtrans %} - Edu-Space Admin{% endblock %}
-
-{% block content %}
-<div class="container-fluid pt-5 mt-4">
-    <!-- Header -->
-    <div class="d-flex justify-content-between align-items-center mb-4">
-        <div>
-            <h1 class="h3 mb-1">
-                <i class="bi bi-file-earmark-spreadsheet text-success me-2"></i>{% trans %}Google Sheets Academic Sync{% endtrans %}
-            </h1>
-            <p class="text-muted small mb-0">{% trans %}Extract and synchronize classrooms, careers, subjects, and weekly schedules directly from the official Google Sheet.{% endtrans %}</p>
-        </div>
-        <div>
-            <a href="{{ url_for('main.dashboard') }}" class="btn btn-outline-secondary">
-                <i class="bi bi-arrow-left me-1"></i>{% trans %}Dashboard{% endtrans %}
-            </a>
-        </div>
-    </div>
-
-    <!-- Metrics Cards -->
-    <div class="row g-3 mb-4">
-        <div class="col-sm-6 col-xl-2">
-            <div class="card border-0 shadow-sm text-center p-3 h-100">
-                <div class="text-primary mb-1"><i class="bi bi-mortarboard fs-3"></i></div>
-                <div class="h4 mb-0 fw-bold">{{ metrics.total_careers }}</div>
-                <small class="text-muted">{% trans %}Careers{% endtrans %}</small>
-            </div>
-        </div>
-        <div class="col-sm-6 col-xl-2">
-            <div class="card border-0 shadow-sm text-center p-3 h-100">
-                <div class="text-info mb-1"><i class="bi bi-book fs-3"></i></div>
-                <div class="h4 mb-0 fw-bold">{{ metrics.total_subjects }}</div>
-                <small class="text-muted">{% trans %}Subjects{% endtrans %}</small>
-            </div>
-        </div>
-        <div class="col-sm-6 col-xl-2">
-            <div class="card border-0 shadow-sm text-center p-3 h-100">
-                <div class="text-success mb-1"><i class="bi bi-door-open fs-3"></i></div>
-                <div class="h4 mb-0 fw-bold">{{ metrics.total_classrooms }}</div>
-                <small class="text-muted">{% trans %}Classrooms{% endtrans %}</small>
-            </div>
-        </div>
-        <div class="col-sm-6 col-xl-3">
-            <div class="card border-0 shadow-sm text-center p-3 h-100">
-                <div class="text-warning mb-1"><i class="bi bi-people fs-3"></i></div>
-                <div class="h4 mb-0 fw-bold">{{ metrics.total_commissions }}</div>
-                <small class="text-muted">{% trans %}Commissions{% endtrans %}</small>
-            </div>
-        </div>
-        <div class="col-sm-6 col-xl-3">
-            <div class="card border-0 shadow-sm text-center p-3 h-100">
-                <div class="text-danger mb-1"><i class="bi bi-calendar-check fs-3"></i></div>
-                <div class="h4 mb-0 fw-bold">{{ metrics.total_reservations }}</div>
-                <small class="text-muted">{% trans %}Calendar Classes{% endtrans %}</small>
-            </div>
-        </div>
-    </div>
-
-    <!-- Sync Action Banner -->
-    <div class="card border-0 shadow-sm mb-4">
-        <div class="card-body p-4">
-            <div class="row align-items-center">
-                <div class="col-lg-8 mb-3 mb-lg-0">
-                    <div class="d-flex align-items-center mb-2">
-                        <span class="badge bg-success-subtle text-success border border-success-subtle px-3 py-1 me-2 fw-semibold">
-                            <i class="bi bi-cloud-check me-1"></i>Google Sheets Live Integration
-                        </span>
-                        <span class="badge bg-light text-muted border">UniCABA 2026</span>
-                    </div>
-                    <h4 class="h5 mb-2 fw-bold">{% trans %}Official Schedule Board (Cartelera de Aulas){% endtrans %}</h4>
-                    <p class="text-muted small mb-2">
-                        {% trans %}Reads published CSV sheets for all 6 days of the week, automatically creating or updating academic careers, classrooms, subject codes, commissions, and weekly calendar entries without duplicating records.{% endtrans %}
-                    </p>
-                    <div class="d-flex flex-wrap gap-1">
-                        {% for s in metrics.sheets %}
-                            <span class="badge bg-body-tertiary text-secondary border small">
-                                <i class="bi bi-calendar-event me-1 text-primary"></i>{{ s.name }}
-                            </span>
-                        {% endfor %}
-                    </div>
-                </div>
-                <div class="col-lg-4 text-lg-end">
-                    <form method="POST" id="syncForm" onsubmit="startSync()">
-                        <button type="submit" id="syncBtn" class="btn btn-success btn-lg px-4 py-2 shadow fw-semibold">
-                            <i class="bi bi-arrow-repeat me-2"></i>{% trans %}Sync Data Now{% endtrans %}
-                        </button>
-                    </form>
-                    <div id="syncSpinner" class="d-none mt-2 text-muted small">
-                        <div class="spinner-border spinner-border-sm text-success me-1" role="status"></div>
-                        {% trans %}Connecting to Google Sheets and processing records...{% endtrans %}
-                    </div>
-                </div>
-            </div>
-        </div>
-    </div>
-
-    <!-- Sync Results (if just completed) -->
-    {% if stats %}
-    <div class="card border-0 shadow-sm mb-4">
-        <div class="card-header bg-success bg-opacity-10 text-success py-3">
-            <h5 class="card-title h6 mb-0 fw-bold">
-                <i class="bi bi-check-circle-fill me-2"></i>{% trans %}Synchronization Report{% endtrans %}
-            </h5>
-        </div>
-        <div class="card-body">
-            <div class="row g-3 text-center mb-3">
-                <div class="col-md-2">
-                    <div class="p-2 border rounded bg-body-tertiary">
-                        <div class="fw-bold fs-5">{{ stats.total_rows_processed }}</div>
-                        <small class="text-muted">{% trans %}Rows Processed{% endtrans %}</small>
-                    </div>
-                </div>
-                <div class="col-md-2">
-                    <div class="p-2 border rounded bg-body-tertiary">
-                        <div class="fw-bold fs-5 text-primary">+{{ stats.careers_created }}</div>
-                        <small class="text-muted">{% trans %}Careers Created{% endtrans %}</small>
-                    </div>
-                </div>
-                <div class="col-md-2">
-                    <div class="p-2 border rounded bg-body-tertiary">
-                        <div class="fw-bold fs-5 text-success">+{{ stats.classrooms_created }}</div>
-                        <small class="text-muted">{% trans %}Classrooms Created{% endtrans %}</small>
-                    </div>
-                </div>
-                <div class="col-md-2">
-                    <div class="p-2 border rounded bg-body-tertiary">
-                        <div class="fw-bold fs-5 text-info">+{{ stats.subjects_created }}</div>
-                        <small class="text-muted">{% trans %}Subjects Created{% endtrans %}</small>
-                    </div>
-                </div>
-                <div class="col-md-2">
-                    <div class="p-2 border rounded bg-body-tertiary">
-                        <div class="fw-bold fs-5 text-warning">+{{ stats.commissions_created }}</div>
-                        <small class="text-muted">{% trans %}Commissions Created{% endtrans %}</small>
-                    </div>
-                </div>
-                <div class="col-md-2">
-                    <div class="p-2 border rounded bg-body-tertiary">
-                        <div class="fw-bold fs-5 text-danger">+{{ stats.reservations_created }}</div>
-                        <small class="text-muted">{% trans %}Reservations Created{% endtrans %}</small>
-                    </div>
-                </div>
-            </div>
-
-            {% if stats.errors %}
-                <div class="alert alert-warning mb-0 small">
-                    <h6 class="alert-heading fw-bold mb-1">{% trans %}Warnings / Errors detected:{% endtrans %}</h6>
-                    <ul class="mb-0 ps-3">
-                        {% for err in stats.errors %}
-                            <li>{{ err }}</li>
-                        {% endfor %}
-                    </ul>
-                </div>
-            {% endif %}
-        </div>
-    </div>
-    {% endif %}
-
-    <!-- Database Preview Table -->
-    <div class="card border-0 shadow-sm">
-        <div class="card-header bg-body-tertiary d-flex justify-content-between align-items-center py-3">
-            <h5 class="card-title h6 mb-0">
-                <i class="bi bi-table text-primary me-2"></i>{% trans %}Recently Synchronized Subjects & Comissions{% endtrans %}
-            </h5>
-            <a href="{{ url_for('schedule.calendar_view') }}" class="btn btn-outline-primary btn-sm">
-                <i class="bi bi-calendar3 me-1"></i>{% trans %}View Calendar{% endtrans %}
-            </a>
-        </div>
-        <div class="table-responsive">
-            <table class="table table-hover align-middle mb-0">
-                <thead class="bg-body-tertiary">
-                    <tr>
-                        <th class="ps-4">{% trans %}Code{% endtrans %}</th>
-                        <th>{% trans %}Subject Name{% endtrans %}</th>
-                        <th>{% trans %}Career{% endtrans %}</th>
-                        <th>{% trans %}Commissions{% endtrans %}</th>
-                        <th>{% trans %}Status{% endtrans %}</th>
-                    </tr>
-                </thead>
-                <tbody>
-                    {% for s in recent_subjects %}
-                    <tr>
-                        <td class="ps-4">
-                            <span class="badge bg-secondary-subtle text-secondary font-monospace border">
-                                {{ s.code }}
-                            </span>
-                        </td>
-                        <td>
-                            <div class="fw-semibold">{{ s.name }}</div>
-                        </td>
-                        <td>
-                            <span class="badge badge-brand small">
-                                {{ s.career_obj.name if s.career_obj else (s.department or _('General')) }}
-                            </span>
-                        </td>
-                        <td>
-                            <span class="small text-muted">
-                                {{ s.commissions|length }} {% trans %}commission(s){% endtrans %}
-                            </span>
-                        </td>
-                        <td>
-                            {% if s.is_active %}
-                                <span class="badge bg-success-subtle text-success border border-success-subtle small">
-                                    <i class="bi bi-check-circle me-1"></i>{% trans %}Active{% endtrans %}
-                                </span>
-                            {% else %}
-                                <span class="badge bg-secondary small">{% trans %}Inactive{% endtrans %}</span>
-                            {% endif %}
-                        </td>
-                    </tr>
-                    {% else %}
-                    <tr>
-                        <td colspan="5" class="text-center py-5 text-muted">
-                            <i class="bi bi-cloud-arrow-down fs-1 d-block mb-2 text-secondary"></i>
-                            {% trans %}No subjects in database yet. Click "Sync Data Now" to import.{% endtrans %}
-                        </td>
-                    </tr>
-                    {% endfor %}
-                </tbody>
-            </table>
-        </div>
-    </div>
-</div>
-{% endblock %}
-
-{% block extra_js %}
-<script>
-function startSync() {
-    const btn = document.getElementById('syncBtn');
-    const spinner = document.getElementById('syncSpinner');
-    if (btn) {
-        btn.disabled = true;
-        btn.innerHTML = '<span class="spinner-border spinner-border-sm me-2" role="status"></span>Sincronizando...';
-    }
-    if (spinner) {
-        spinner.classList.remove('d-none');
-    }
-}
-</script>
-{% endblock %}

app/templates/admin/subjects/list.html

@@ -1,306 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}{% trans %}Gestión de Asignaturas{% endtrans %} - Edu-Space Admin{% endblock %}
-
-{% block content %}
-<div class="container-fluid pt-5 mt-4">
-    <!-- Header -->
-    <div class="d-flex flex-column flex-md-row justify-content-between align-items-md-center gap-3 mb-4">
-        <div>
-            <h1 class="h3 fw-bold mb-1">
-                <i class="bi bi-book text-primary me-2"></i>{% trans %}Gestión de Asignaturas y Materias{% endtrans %}
-            </h1>
-            <p class="text-muted mb-0 small">
-                {% trans %}Catálogo institucional de asignaturas, códigos, créditos académicos y carreras vinculadas.{% endtrans %}
-            </p>
-        </div>
-        <div class="d-flex gap-2">
-            {% if can_edit %}
-            <button type="button" class="btn btn-primary" data-bs-toggle="modal" data-bs-target="#modalAddSubject">
-                <i class="bi bi-plus-lg me-1"></i>{% trans %}Nueva Asignatura{% endtrans %}
-            </button>
-            {% endif %}
-            <a href="{{ url_for('schedule.commissions_view') }}" class="btn btn-outline-secondary">
-                <i class="bi bi-diagram-3 me-1"></i>{% trans %}Ver Comisiones{% endtrans %}
-            </a>
-        </div>
-    </div>
-
-    <!-- Filters Bar -->
-    <div class="card border-0 shadow-sm mb-4">
-        <div class="card-body py-2">
-            <form method="GET" class="row g-2 align-items-center">
-                <!-- Buscador -->
-                <div class="col-md-4">
-                    <div class="input-group input-group-sm">
-                        <span class="input-group-text bg-body-tertiary"><i class="bi bi-search"></i></span>
-                        <input type="text" name="search" class="form-control" 
-                               placeholder="{% trans %}Buscar por código, nombre o departamento...{% endtrans %}" 
-                               value="{{ search }}">
-                    </div>
-                </div>
-
-                <!-- Filtro Carrera -->
-                <div class="col-md-4">
-                    <div class="input-group input-group-sm">
-                        <span class="input-group-text bg-body-tertiary"><i class="bi bi-mortarboard text-primary"></i></span>
-                        <select name="career_id" class="form-select form-select-sm" onchange="this.form.submit()">
-                            <option value="">{% trans %}Todas las carreras{% endtrans %}</option>
-                            {% for c in careers %}
-                                <option value="{{ c.id }}" {% if career_filter == c.id %}selected{% endif %}>{{ c.name }}</option>
-                            {% endfor %}
-                        </select>
-                    </div>
-                </div>
-
-                <!-- Filtro Estado -->
-                <div class="col-md-2">
-                    <select name="active" class="form-select form-select-sm" onchange="this.form.submit()">
-                        <option value="">{% trans %}Todos los estados{% endtrans %}</option>
-                        <option value="true" {% if active_filter == 'true' %}selected{% endif %}>{% trans %}Solo activas{% endtrans %}</option>
-                        <option value="false" {% if active_filter == 'false' %}selected{% endif %}>{% trans %}Solo inactivas{% endtrans %}</option>
-                    </select>
-                </div>
-
-                <div class="col-md-2 text-md-end">
-                    <button type="submit" class="btn btn-sm btn-primary me-1">
-                        <i class="bi bi-funnel me-1"></i>{% trans %}Filtrar{% endtrans %}
-                    </button>
-                    <a href="{{ url_for('admin.subjects_list') }}" class="btn btn-sm btn-outline-secondary">
-                        <i class="bi bi-x-circle me-1"></i>{% trans %}Limpiar{% endtrans %}
-                    </a>
-                </div>
-            </form>
-        </div>
-    </div>
-
-    <!-- Subjects Table -->
-    <div class="card border-0 shadow-sm">
-        <div class="table-responsive">
-            <table class="table table-hover align-middle mb-0">
-                <thead class="table-light">
-                    <tr>
-                        <th>{% trans %}Código{% endtrans %}</th>
-                        <th>{% trans %}Nombre de la Asignatura{% endtrans %}</th>
-                        <th>{% trans %}Carrera{% endtrans %}</th>
-                        <th>{% trans %}Departamento{% endtrans %}</th>
-                        <th>{% trans %}Créditos{% endtrans %}</th>
-                        <th>{% trans %}Comisiones{% endtrans %}</th>
-                        <th>{% trans %}Estado{% endtrans %}</th>
-                        {% if can_edit %}
-                        <th class="text-end">{% trans %}Acciones{% endtrans %}</th>
-                        {% endif %}
-                    </tr>
-                </thead>
-                <tbody>
-                    {% for s in subjects %}
-                    <tr>
-                        <td>
-                            <span class="badge font-monospace bg-primary-subtle text-primary border">{{ s.code }}</span>
-                        </td>
-                        <td>
-                            <span class="fw-bold text-body">{{ s.name }}</span>
-                            {% if s.description %}
-                            <small class="text-muted d-block text-truncate" style="max-width: 300px;">{{ s.description }}</small>
-                            {% endif %}
-                        </td>
-                        <td>
-                            {% if s.career_obj %}
-                            <span class="badge bg-secondary-subtle text-secondary border">
-                                <i class="bi bi-mortarboard me-1"></i>{{ s.career_obj.name }}
-                            </span>
-                            {% else %}
-                            <span class="text-muted small">General</span>
-                            {% endif %}
-                        </td>
-                        <td>
-                            <span class="small text-muted">{{ s.department or '-' }}</span>
-                        </td>
-                        <td>
-                            <span class="badge bg-light text-dark border">{{ s.credits }} cr.</span>
-                        </td>
-                        <td>
-                            <span class="badge bg-info-subtle text-info border">
-                                <i class="bi bi-diagram-3 me-1"></i>{{ s.commissions|length if s.commissions else 0 }}
-                            </span>
-                        </td>
-                        <td>
-                            <span class="badge rounded-pill {% if s.is_active %}bg-success-subtle text-success border border-success-subtle{% else %}bg-secondary-subtle text-secondary border{% endif %}">
-                                {% if s.is_active %}{% trans %}Activa{% endtrans %}{% else %}{% trans %}Inactiva{% endtrans %}{% endif %}
-                            </span>
-                        </td>
-                        {% if can_edit %}
-                        <td class="text-end">
-                            <div class="btn-group btn-group-sm">
-                                <button type="button" class="btn btn-outline-secondary py-0 px-2" 
-                                        data-bs-toggle="modal" data-bs-target="#modalEditSubject{{ s.id }}" 
-                                        title="{% trans %}Editar Asignatura{% endtrans %}">
-                                    <i class="bi bi-pencil"></i>
-                                </button>
-                                <form method="POST" action="{{ url_for('admin.subject_toggle', id=s.id) }}" class="d-inline">
-                                    <button type="submit" class="btn btn-outline-warning py-0 px-2" 
-                                            title="{% if s.is_active %}{% trans %}Desactivar{% endtrans %}{% else %}{% trans %}Activar{% endtrans %}{% endif %}">
-                                        <i class="bi {% if s.is_active %}bi-pause{% else %}bi-play{% endif %}"></i>
-                                    </button>
-                                </form>
-                            </div>
-
-                            <!-- Modal Editar Asignatura -->
-                            <div class="modal fade text-start" id="modalEditSubject{{ s.id }}" tabindex="-1" aria-hidden="true">
-                                <div class="modal-dialog">
-                                    <div class="modal-content">
-                                        <form method="POST" action="{{ url_for('admin.subject_edit', id=s.id) }}">
-                                            <div class="modal-header">
-                                                <h5 class="modal-title h6 fw-bold">
-                                                    <i class="bi bi-pencil-square text-primary me-2"></i>{% trans %}Editar Asignatura{% endtrans %}
-                                                </h5>
-                                                <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
-                                            </div>
-                                            <div class="modal-body">
-                                                <div class="row g-2 mb-3">
-                                                    <div class="col-md-5">
-                                                        <label class="form-label small fw-semibold">{% trans %}Código{% endtrans %} *</label>
-                                                        <input type="text" name="code" class="form-control form-control-sm font-monospace" value="{{ s.code }}" required>
-                                                    </div>
-                                                    <div class="col-md-7">
-                                                        <label class="form-label small fw-semibold">{% trans %}Créditos{% endtrans %}</label>
-                                                        <input type="number" name="credits" class="form-control form-control-sm" value="{{ s.credits }}" min="1" max="20">
-                                                    </div>
-                                                </div>
-                                                <div class="mb-3">
-                                                    <label class="form-label small fw-semibold">{% trans %}Nombre de la Asignatura{% endtrans %} *</label>
-                                                    <input type="text" name="name" class="form-control form-control-sm" value="{{ s.name }}" required>
-                                                </div>
-                                                <div class="mb-3">
-                                                    <label class="form-label small fw-semibold">{% trans %}Carrera Vinculada{% endtrans %}</label>
-                                                    <select name="career_id" class="form-select form-select-sm">
-                                                        <option value="">{% trans %}Sin carrera específica (General){% endtrans %}</option>
-                                                        {% for c in careers %}
-                                                            <option value="{{ c.id }}" {% if s.career_id == c.id %}selected{% endif %}>{{ c.name }}</option>
-                                                        {% endfor %}
-                                                    </select>
-                                                </div>
-                                                <div class="mb-3">
-                                                    <label class="form-label small fw-semibold">{% trans %}Departamento / Área{% endtrans %}</label>
-                                                    <input type="text" name="department" class="form-control form-control-sm" value="{{ s.department or '' }}">
-                                                </div>
-                                                <div class="mb-3">
-                                                    <label class="form-label small fw-semibold">{% trans %}Descripción / Objetivos{% endtrans %}</label>
-                                                    <textarea name="description" class="form-control form-control-sm" rows="2">{{ s.description or '' }}</textarea>
-                                                </div>
-                                                <div class="form-check">
-                                                    <input class="form-check-input" type="checkbox" name="is_active" id="activeSubj{{ s.id }}" {% if s.is_active %}checked{% endif %}>
-                                                    <label class="form-check-label small" for="activeSubj{{ s.id }}">{% trans %}Asignatura Activa{% endtrans %}</label>
-                                                </div>
-                                            </div>
-                                            <div class="modal-footer">
-                                                <button type="button" class="btn btn-sm btn-secondary" data-bs-dismiss="modal">{% trans %}Cancelar{% endtrans %}</button>
-                                                <button type="submit" class="btn btn-sm btn-primary">{% trans %}Guardar Cambios{% endtrans %}</button>
-                                            </div>
-                                        </form>
-                                    </div>
-                                </div>
-                            </div>
-                        </td>
-                        {% endif %}
-                    </tr>
-                    {% else %}
-                    <tr>
-                        <td colspan="8" class="text-center py-5 text-muted">
-                            <i class="bi bi-book fs-1 d-block mb-2"></i>
-                            {% trans %}No se encontraron asignaturas con los criterios indicados.{% endtrans %}
-                        </td>
-                    </tr>
-                    {% endfor %}
-                </tbody>
-            </table>
-        </div>
-
-        <!-- Paginación -->
-        {% if pagination.pages > 1 %}
-        <div class="card-footer bg-body-tertiary border-0 py-2">
-            <nav aria-label="Subjects pagination">
-                <ul class="pagination pagination-sm justify-content-center mb-0">
-                    {% if pagination.has_prev %}
-                    <li class="page-item">
-                        <a class="page-link" href="{{ url_for('admin.subjects_list', page=pagination.prev_num, search=search, career_id=career_filter, active=active_filter) }}">{% trans %}Anterior{% endtrans %}</a>
-                    </li>
-                    {% endif %}
-                    
-                    {% for p in pagination.iter_pages(left_edge=2, right_edge=2, left_current=2, right_current=2) %}
-                        {% if p %}
-                            <li class="page-item {% if p == pagination.page %}active{% endif %}">
-                                <a class="page-link" href="{{ url_for('admin.subjects_list', page=p, search=search, career_id=career_filter, active=active_filter) }}">{{ p }}</a>
-                            </li>
-                        {% else %}
-                            <li class="page-item disabled"><span class="page-link">…</span></li>
-                        {% endif %}
-                    {% endfor %}
-                    
-                    {% if pagination.has_next %}
-                    <li class="page-item">
-                        <a class="page-link" href="{{ url_for('admin.subjects_list', page=pagination.next_num, search=search, career_id=career_filter, active=active_filter) }}">{% trans %}Siguiente{% endtrans %}</a>
-                    </li>
-                    {% endif %}
-                </ul>
-            </nav>
-        </div>
-        {% endif %}
-    </div>
-</div>
-
-<!-- Modal Nueva Asignatura -->
-{% if can_edit %}
-<div class="modal fade" id="modalAddSubject" tabindex="-1" aria-hidden="true">
-    <div class="modal-dialog">
-        <div class="modal-content">
-            <form method="POST" action="{{ url_for('admin.subject_add') }}">
-                <div class="modal-header">
-                    <h5 class="modal-title h6 fw-bold">
-                        <i class="bi bi-book text-primary me-2"></i>{% trans %}Nueva Asignatura{% endtrans %}
-                    </h5>
-                    <button type="button" class="btn-close" data-bs-dismiss="modal" aria-label="Close"></button>
-                </div>
-                <div class="modal-body">
-                    <div class="row g-2 mb-3">
-                        <div class="col-md-5">
-                            <label class="form-label small fw-semibold">{% trans %}Código{% endtrans %} *</label>
-                            <input type="text" name="code" class="form-control form-control-sm font-monospace" placeholder="ej. ASIG0015" required>
-                        </div>
-                        <div class="col-md-7">
-                            <label class="form-label small fw-semibold">{% trans %}Créditos{% endtrans %}</label>
-                            <input type="number" name="credits" class="form-control form-control-sm" value="4" min="1" max="20">
-                        </div>
-                    </div>
-                    <div class="mb-3">
-                        <label class="form-label small fw-semibold">{% trans %}Nombre de la Asignatura{% endtrans %} *</label>
-                        <input type="text" name="name" class="form-control form-control-sm" placeholder="ej. Álgebra Lineal" required>
-                    </div>
-                    <div class="mb-3">
-                        <label class="form-label small fw-semibold">{% trans %}Carrera Vinculada{% endtrans %}</label>
-                        <select name="career_id" class="form-select form-select-sm">
-                            <option value="">{% trans %}Sin carrera específica (General){% endtrans %}</option>
-                            {% for c in careers %}
-                                <option value="{{ c.id }}">{{ c.name }}</option>
-                            {% endfor %}
-                        </select>
-                    </div>
-                    <div class="mb-3">
-                        <label class="form-label small fw-semibold">{% trans %}Departamento / Área{% endtrans %}</label>
-                        <input type="text" name="department" class="form-control form-control-sm" placeholder="ej. Ciencias Exactas, Informática">
-                    </div>
-                    <div class="mb-3">
-                        <label class="form-label small fw-semibold">{% trans %}Descripción{% endtrans %}</label>
-                        <textarea name="description" class="form-control form-control-sm" rows="2" placeholder="Programa de la materia..."></textarea>
-                    </div>
-                </div>
-                <div class="modal-footer">
-                    <button type="button" class="btn btn-sm btn-secondary" data-bs-dismiss="modal">{% trans %}Cancelar{% endtrans %}</button>
-                    <button type="submit" class="btn btn-sm btn-primary">{% trans %}Crear Asignatura{% endtrans %}</button>
-                </div>
-            </form>
-        </div>
-    </div>
-</div>
-{% endif %}
-{% endblock %}

app/templates/admin/users/form.html

@@ -1,107 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}{% if user %}{% trans %}Edit User{% endtrans %}: {{ user.name }}{% else %}{% trans %}New User{% endtrans %}{% endif %} - Edu-Space Admin{% endblock %}
-
-{% block content %}
-<div class="container-fluid pt-5 mt-4">
-    <!-- Header -->
-    <div class="d-flex justify-content-between align-items-center mb-4">
-        <div>
-            <h1 class="h3 mb-1">
-                <i class="bi bi-person-gear text-primary me-2"></i>
-                {% if user %}{% trans %}Edit User Account{% endtrans %}{% else %}{% trans %}Create User Account{% endtrans %}{% endif %}
-            </h1>
-            <p class="text-muted small mb-0">{% trans %}Configure user credentials, profile information, and role assignment.{% endtrans %}</p>
-        </div>
-        <div>
-            <a href="{{ url_for('admin.users_list') }}" class="btn btn-outline-secondary">
-                <i class="bi bi-arrow-left me-1"></i>{% trans %}Back to Users{% endtrans %}
-            </a>
-        </div>
-    </div>
-
-    <div class="row">
-        <div class="col-lg-6 mx-auto">
-            <div class="card border-0 shadow-sm">
-                <div class="card-header bg-body-tertiary py-3">
-                    <h5 class="card-title h6 mb-0">
-                        <i class="bi bi-person-vcard text-primary me-2"></i>{% trans %}Account Details{% endtrans %}
-                    </h5>
-                </div>
-                <div class="card-body p-4">
-                    <form method="POST">
-                        <div class="mb-3">
-                            <label for="name" class="form-label fw-semibold">{% trans %}Full Name{% endtrans %} <span class="text-danger">*</span></label>
-                            <input type="text" class="form-control" id="name" name="name" 
-                                   value="{{ user.name if user else '' }}" required 
-                                   placeholder="{% trans %}e.g. María González{% endtrans %}">
-                        </div>
-
-                        <div class="mb-3">
-                            <label for="email" class="form-label fw-semibold">{% trans %}Email Address{% endtrans %} <span class="text-danger">*</span></label>
-                            <input type="email" class="form-control" id="email" name="email" 
-                                   value="{{ user.email if user else '' }}" required 
-                                   placeholder="{% trans %}e.g. mgonzalez@edu-space.com{% endtrans %}">
-                        </div>
-
-                        <div class="mb-3">
-                            <label for="password" class="form-label fw-semibold">
-                                {% trans %}Password{% endtrans %} {% if not user %}<span class="text-danger">*</span>{% endif %}
-                            </label>
-                            <input type="password" class="form-control" id="password" name="password" 
-                                   {% if not user %}required{% endif %}
-                                   placeholder="{% if user %}{% trans %}Leave empty to keep current password{% endtrans %}{% else %}{% trans %}At least 6 characters{% endtrans %}{% endif %}">
-                            {% if user %}
-                                <small class="text-muted d-block mt-1">
-                                    {% trans %}Only fill this in if you want to reset this user's password.{% endtrans %}
-                                </small>
-                            {% endif %}
-                        </div>
-
-                        <div class="mb-3">
-                            <label for="role_id" class="form-label fw-semibold">{% trans %}Role / Access Group{% endtrans %} <span class="text-danger">*</span></label>
-                            <select class="form-select" id="role_id" name="role_id" required>
-                                <option value="" disabled {% if not user or not user.role_id %}selected{% endif %}>{% trans %}Select a role...{% endtrans %}</option>
-                                {% for r in roles %}
-                                    <option value="{{ r.id }}" {% if user and user.role_id == r.id %}selected{% endif %}>
-                                        {{ r.name }} - {{ r.description or '' }}
-                                    </option>
-                                {% endfor %}
-                            </select>
-                            <small class="text-muted d-block mt-1">
-                                <a href="{{ url_for('admin.roles_list') }}" target="_blank" class="text-decoration-none">
-                                    <i class="bi bi-box-arrow-up-right me-1"></i>{% trans %}View or manage roles and permissions{% endtrans %}
-                                </a>
-                            </small>
-                        </div>
-
-                        <div class="mb-4 form-check form-switch">
-                            <input class="form-check-input" type="checkbox" role="switch" id="is_active" name="is_active" 
-                                   {% if not user or user.is_active %}checked{% endif %}
-                                   {% if user and user.id == current_user.id %}disabled{% endif %}>
-                            <label class="form-check-label fw-semibold" for="is_active">
-                                {% trans %}Active Account{% endtrans %}
-                            </label>
-                            <small class="text-muted d-block">
-                                {% trans %}Inactive users are prevented from signing in to the platform.{% endtrans %}
-                            </small>
-                            {% if user and user.id == current_user.id %}
-                                <input type="hidden" name="is_active" value="on">
-                            {% endif %}
-                        </div>
-
-                        <div class="d-flex justify-content-between align-items-center pt-2">
-                            <a href="{{ url_for('admin.users_list') }}" class="btn btn-outline-secondary">
-                                {% trans %}Cancel{% endtrans %}
-                            </a>
-                            <button type="submit" class="btn btn-primary px-4 fw-semibold">
-                                <i class="bi bi-check-lg me-1"></i>{% trans %}Save User{% endtrans %}
-                            </button>
-                        </div>
-                    </form>
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
-{% endblock %}

app/templates/auth/login.html

@@ -1,115 +0,0 @@
-<!DOCTYPE html>
-<html lang="{{ current_lang }}" data-bs-theme="dark">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{% trans %}Login - Edu-Space Admin{% endtrans %}</title>
-    
-    <!-- Favicon -->
-    <link rel="icon" type="image/png" href="{{ url_for('static', filename='img/favicon.png') }}">
-    
-    <!-- Script Anti-Flicker para Modo Claro / Oscuro -->
-    <script>
-        (function() {
-            const storedTheme = localStorage.getItem('theme');
-            const theme = storedTheme || (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
-            document.documentElement.setAttribute('data-bs-theme', theme);
-        })();
-    </script>
-    
-    <!-- Bootstrap 5 CSS -->
-    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
-    <link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.0/font/bootstrap-icons.css" rel="stylesheet">
-    <!-- Design System Theme -->
-    <link href="{{ url_for('static', filename='css/theme.css') }}" rel="stylesheet">
-</head>
-<body>
-    <div class="auth-wrapper">
-        <div class="auth-card">
-            <!-- Header con Controles Superiores & Logo Oficial -->
-            <div class="auth-header">
-                <div class="auth-controls">
-                    <button class="theme-toggle-btn" type="button" aria-label="Cambiar tema" title="Modo Claro/Oscuro">
-                        <i class="bi bi-moon-stars-fill"></i>
-                    </button>
-                    {% include 'partials/language_switcher.html' %}
-                </div>
-                
-                <img src="{{ url_for('static', filename='img/logo_unicaba.png') }}" alt="UniCABA" class="auth-logo">
-                <h4 class="fw-bold mb-1">Edu-Space Admin</h4>
-                <p class="text-muted small mb-0">{% trans %}Classroom Management System{% endtrans %}</p>
-            </div>
-            
-            <div class="px-4 pb-4 pt-2">
-                <!-- Flash Messages -->
-                {% with messages = get_flashed_messages(with_categories=true) %}
-                    {% if messages %}
-                        {% for category, message in messages %}
-                            <div class="alert alert-{{ 'danger' if category == 'error' else category }} alert-dismissible fade show rounded-3 py-2 small" role="alert">
-                                {{ message }}
-                                <button type="button" class="btn-close py-2" data-bs-dismiss="alert"></button>
-                            </div>
-                        {% endfor %}
-                    {% endif %}
-                {% endwith %}
-                
-                <form method="POST" novalidate>
-                    {{ form.hidden_tag() }}
-                    
-                    <div class="mb-3">
-                        <label for="email" class="form-label small fw-semibold text-muted">{{ form.email.label.text }}</label>
-                        <div class="input-group">
-                            <span class="input-group-text bg-body-tertiary border-end-0 text-muted">
-                                <i class="bi bi-envelope"></i>
-                            </span>
-                            <input type="email" class="form-control border-start-0 ps-0" id="email" name="email" 
-                                   value="{{ form.email.data or '' }}" required 
-                                   placeholder="{% trans %}Enter your email{% endtrans %}">
-                        </div>
-                        {% for error in form.email.errors %}
-                            <div class="text-danger small mt-1">{{ error }}</div>
-                        {% endfor %}
-                    </div>
-                    
-                    <div class="mb-3">
-                        <label for="password" class="form-label small fw-semibold text-muted">{{ form.password.label.text }}</label>
-                        <div class="input-group">
-                            <span class="input-group-text bg-body-tertiary border-end-0 text-muted">
-                                <i class="bi bi-lock"></i>
-                            </span>
-                            <input type="password" class="form-control border-start-0 ps-0" id="password" name="password" 
-                                   required placeholder="{% trans %}Enter your password{% endtrans %}">
-                        </div>
-                        {% for error in form.password.errors %}
-                            <div class="text-danger small mt-1">{{ error }}</div>
-                        {% endfor %}
-                    </div>
-                    
-                    <div class="mb-4 form-check">
-                        {{ form.remember_me(class="form-check-input") }}
-                        <label class="form-check-label text-muted small" for="remember_me">
-                            {{ form.remember_me.label.text }}
-                        </label>
-                    </div>
-                    
-                    <div class="d-grid">
-                        <button type="submit" class="btn btn-primary btn-lg fw-semibold py-2">
-                            <i class="bi bi-box-arrow-in-right me-1"></i> {{ form.submit.label.text }}
-                        </button>
-                    </div>
-                </form>
-                
-                <div class="text-center mt-4">
-                    <small class="text-muted d-inline-flex align-items-center">
-                        <i class="bi bi-shield-check text-primary me-1"></i> 
-                        {% trans %}Secure Login • All access is logged{% endtrans %}
-                    </small>
-                </div>
-            </div>
-        </div>
-    </div>
-    
-    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
-    <script src="{{ url_for('static', filename='js/theme-toggle.js') }}"></script>
-</body>
-</html>

app/templates/base.html

@@ -1,221 +0,0 @@
-<!DOCTYPE html>
-<html lang="{{ current_lang }}" data-bs-theme="dark">
-<head>
-    <meta charset="UTF-8">
-    <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>{% block title %}{% trans %}Edu-Space Admin{% endtrans %}{% endblock %}</title>
-    
-    <!-- Favicon -->
-    <link rel="icon" type="image/png" href="{{ url_for('static', filename='img/favicon.png') }}">
-    
-    <!-- Script Anti-Flicker para Modo Claro / Oscuro -->
-    <script>
-        (function() {
-            let userTheme = "{{ current_user.theme_preference if (current_user and current_user.is_authenticated) else '' }}";
-            let theme = userTheme;
-            if (!theme || theme === 'auto') {
-                const storedTheme = localStorage.getItem('theme');
-                theme = storedTheme || (window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light');
-            }
-            document.documentElement.setAttribute('data-bs-theme', theme);
-        })();
-    </script>
-    
-    <!-- Bootstrap 5 CSS -->
-    <link href="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/css/bootstrap.min.css" rel="stylesheet">
-    <!-- Bootstrap Icons -->
-    <link href="https://cdn.jsdelivr.net/npm/bootstrap-icons@1.10.0/font/bootstrap-icons.css" rel="stylesheet">
-    <!-- Design System & Custom Theme -->
-    <link href="{{ url_for('static', filename='css/theme.css') }}" rel="stylesheet">
-    <link href="{{ url_for('static', filename='css/style.css') }}" rel="stylesheet">
-    
-    {% block extra_css %}{% endblock %}
-</head>
-<body data-user-authenticated="{{ 'true' if (current_user and current_user.is_authenticated) else 'false' }}">
-    {% if current_user.is_authenticated %}
-    <!-- Navigation -->
-    <nav class="navbar navbar-expand-lg navbar-dark navbar-app fixed-top">
-        <div class="container-fluid">
-            <a class="navbar-brand d-flex align-items-center" href="{{ url_for('main.dashboard') }}">
-                <img src="{{ url_for('static', filename='img/logo_unicaba_mini.png') }}" alt="Logo UniCABA" class="navbar-logo me-2">
-                <span>Edu-Space Admin</span>
-            </a>
-            
-            <button class="navbar-toggler" type="button" data-bs-toggle="collapse" data-bs-target="#navbarNav">
-                <span class="navbar-toggler-icon"></span>
-            </button>
-            
-            <div class="collapse navbar-collapse" id="navbarNav">
-                <ul class="navbar-nav me-auto">
-                    <li class="nav-item">
-                        <a class="nav-link" href="{{ url_for('main.dashboard') }}">
-                            <i class="bi bi-speedometer2"></i> {% trans %}Dashboard{% endtrans %}
-                        </a>
-                    </li>
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown">
-                            <i class="bi bi-door-open"></i> {% trans %}Classrooms{% endtrans %}
-                        </a>
-                        <ul class="dropdown-menu">
-                            <li><a class="dropdown-item" href="{{ url_for('classrooms.list_classrooms') }}">
-                                <i class="bi bi-list"></i> {% trans %}All Classrooms{% endtrans %}
-                            </a></li>
-                            {% if current_user.has_permission('classrooms', 'read_write') %}
-                            <li><a class="dropdown-item" href="{{ url_for('classrooms.add_classroom') }}">
-                                <i class="bi bi-plus-circle"></i> {% trans %}Add Classroom{% endtrans %}
-                            </a></li>
-                            {% endif %}
-                            <li><hr class="dropdown-divider"></li>
-                            <li><a class="dropdown-item" href="{{ url_for('buildings.list_buildings') }}">
-                                <i class="bi bi-buildings"></i> {% trans %}Buildings{% endtrans %}
-                            </a></li>
-                        </ul>
-                    </li>
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown">
-                            <i class="bi bi-calendar3"></i> {% trans %}Schedule{% endtrans %}
-                        </a>
-                        <ul class="dropdown-menu">
-                            <li><a class="dropdown-item" href="{{ url_for('schedule.calendar_view') }}">
-                                <i class="bi bi-calendar-week"></i> {% trans %}Calendar View{% endtrans %}
-                            </a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('schedule.list_reservations') }}">
-                                <i class="bi bi-list-check"></i> {% trans %}All Reservations{% endtrans %}
-                            </a></li>
-                            {% if current_user.has_permission('reservations', 'read_write') %}
-                            <li><a class="dropdown-item" href="{{ url_for('schedule.add_reservation') }}">
-                                <i class="bi bi-plus-circle"></i> {% trans %}New Reservation{% endtrans %}
-                            </a></li>
-                            {% endif %}
-                            <li><a class="dropdown-item" href="{{ url_for('schedule.today_schedule') }}">
-                                <i class="bi bi-calendar-today"></i> {% trans %}Today's Schedule{% endtrans %}
-                            </a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('schedule.commissions_view') }}">
-                                <i class="bi bi-diagram-3 me-2 text-primary"></i>{% trans %}Comisiones y Cursadas{% endtrans %}
-                            </a></li>
-                            {% if current_user.has_permission('optimizer', 'read') or (current_user.role and current_user.role|upper == 'ADMIN') %}
-                            <li><hr class="dropdown-divider"></li>
-                            <li><a class="dropdown-item" href="{{ url_for('genetic_algorithm_web.genetic_optimizer') }}">
-                                <i class="bi bi-cpu text-info me-2"></i>{% trans %}Optimizador de Aulas (IA){% endtrans %}
-                            </a></li>
-                            {% endif %}
-                        </ul>
-                    </li>
-                    {% if current_user.is_authenticated and current_user.can_manage() %}
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle" href="#" role="button" data-bs-toggle="dropdown">
-                            <i class="bi bi-shield-lock"></i> {% trans %}Gestión{% endtrans %}
-                        </a>
-                        <ul class="dropdown-menu shadow-sm" style="min-width: 260px;">
-                            <!-- Espacios & Infraestructura -->
-                            <li class="dropdown-header text-uppercase small fw-bold text-muted py-1" style="font-size: 0.68rem; letter-spacing: 0.5px;">{% trans %}Espacios e Infraestructura{% endtrans %}</li>
-                            <li><a class="dropdown-item" href="{{ url_for('buildings.list_buildings') }}"><i class="bi bi-buildings me-2 text-secondary"></i>{% trans %}Edificios y Sedes{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('classrooms.list_classrooms', view_mode='physical') }}"><i class="bi bi-door-open me-2 text-primary"></i>{% trans %}Aulas Presenciales{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('classrooms.list_classrooms', view_mode='virtual') }}"><i class="bi bi-camera-video me-2 text-info"></i>{% trans %}Aulas Virtuales (Reunión){% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.occupancy_metrics') }}"><i class="bi bi-graph-up-arrow me-2 text-success"></i>{% trans %}Gestión de Ocupación, Métricas{% endtrans %}</a></li>
-                            
-                            <li><hr class="dropdown-divider my-1"></li>
-                            <!-- Gestión Académica -->
-                            <li class="dropdown-header text-uppercase small fw-bold text-muted py-1" style="font-size: 0.68rem; letter-spacing: 0.5px;">{% trans %}Gestión Académica{% endtrans %}</li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.careers_list') }}"><i class="bi bi-mortarboard me-2 text-primary"></i>{% trans %}Carreras{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.subjects_list') }}"><i class="bi bi-book me-2 text-info"></i>{% trans %}Asignaturas{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('schedule.commissions_view') }}"><i class="bi bi-diagram-3 me-2 text-primary"></i>{% trans %}Comisiones y Cursadas{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.academic_terms_list') }}"><i class="bi bi-calendar-range me-2 text-warning"></i>{% trans %}Ciclo Lectivo{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('schedule.list_reservations') }}"><i class="bi bi-calendar-check me-2 text-warning"></i>{% trans %}Gestión de Reservas{% endtrans %}</a></li>
-
-                            <li><hr class="dropdown-divider my-1"></li>
-                            <!-- Administración & Sistema -->
-                            <li class="dropdown-header text-uppercase small fw-bold text-muted py-1" style="font-size: 0.68rem; letter-spacing: 0.5px;">{% trans %}Administración & Seguridad{% endtrans %}</li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.users_list') }}"><i class="bi bi-people me-2"></i>{% trans %}Usuarios{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.roles_list') }}"><i class="bi bi-person-badge me-2"></i>{% trans %}Roles y Permisos{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.milestone_types_list') }}"><i class="bi bi-tags me-2 text-secondary"></i>{% trans %}Tipificaciones de Hitos{% endtrans %}</a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('admin.google_sheets_import') }}"><i class="bi bi-file-earmark-spreadsheet me-2 text-success"></i>{% trans %}Sincronización Sheets{% endtrans %}</a></li>
-                        </ul>
-                    </li>
-                    {% endif %}
-                </ul>
-                
-                <ul class="navbar-nav align-items-center">
-                    <!-- Theme Mode Toggle Button -->
-                    <li class="nav-item me-2">
-                        <button class="theme-toggle-btn" type="button" aria-label="Cambiar tema" title="Modo Claro/Oscuro">
-                            <i class="bi bi-moon-stars-fill"></i>
-                        </button>
-                    </li>
-
-                    <!-- Language Switcher -->
-                    <li class="nav-item me-2">
-                        {% include 'partials/language_switcher.html' %}
-                    </li>
-                    
-                    <!-- User Dropdown with Avatar -->
-                    <li class="nav-item dropdown">
-                        <a class="nav-link dropdown-toggle d-flex align-items-center py-1" href="#" role="button" data-bs-toggle="dropdown">
-                            <span class="user-avatar-small">{{ current_user.name[:1]|upper if current_user.name else 'U' }}</span>
-                            <span>{{ current_user.first_name }}</span>
-                        </a>
-                        <ul class="dropdown-menu dropdown-menu-end shadow-sm border-0">
-                            <li>
-                                <div class="px-3 py-2 border-bottom">
-                                    <small class="text-muted d-block">{% trans %}Signed in as{% endtrans %}</small>
-                                    <span class="fw-bold small">{{ current_user.email }}</span>
-                                </div>
-                            </li>
-                            <li><a class="dropdown-item" href="{{ url_for('auth.profile') }}">
-                                <i class="bi bi-person me-2"></i> {% trans %}Profile{% endtrans %}
-                            </a></li>
-                            <li><a class="dropdown-item" href="{{ url_for('auth.change_password') }}">
-                                <i class="bi bi-key me-2"></i> {% trans %}Change Password{% endtrans %}
-                            </a></li>
-                            <li><hr class="dropdown-divider"></li>
-                            <li><a class="dropdown-item text-danger" href="{{ url_for('auth.logout') }}">
-                                <i class="bi bi-box-arrow-right me-2"></i> {% trans %}Logout{% endtrans %}
-                            </a></li>
-                        </ul>
-                    </li>
-                </ul>
-            </div>
-        </div>
-    </nav>
-    {% endif %}
-    
-    <!-- Flash Messages -->
-    <div class="toast-container position-fixed bottom-0 end-0 p-3" style="z-index: 1080;">
-        {% with messages = get_flashed_messages(with_categories=true) %}
-            {% if messages %}
-                {% for category, message in messages %}
-                    <div class="toast align-items-center text-white bg-{{ 'danger' if category == 'error' else 'success' if category == 'success' else 'info' if category == 'info' else 'warning' }} border-0 shadow" role="alert">
-                        <div class="d-flex">
-                            <div class="toast-body">
-                                {{ message }}
-                            </div>
-                            <button type="button" class="btn-close btn-close-white me-2 m-auto" data-bs-dismiss="toast"></button>
-                        </div>
-                    </div>
-                {% endfor %}
-            {% endif %}
-        {% endwith %}
-    </div>
-    
-    <!-- Main Content -->
-    {% block content %}{% endblock %}
-    
-    <!-- Bootstrap JS -->
-    <script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
-    <!-- jQuery -->
-    <script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
-    <!-- Theme Toggle JS -->
-    <script src="{{ url_for('static', filename='js/theme-toggle.js') }}"></script>
-    <!-- Custom JS -->
-    <script src="{{ url_for('static', filename='js/main.js') }}"></script>
-    
-    <!-- Show flash messages -->
-    <script>
-        $(document).ready(function() {
-            $('.toast').toast('show');
-        });
-    </script>
-    
-    {% block extra_js %}{% endblock %}
-</body>
-</html>

app/templates/dashboard.html

@@ -1,301 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}{% trans %}Dashboard - Edu-Space Admin{% endtrans %}{% endblock %}
-
-{% block content %}
-{% if current_user.is_authenticated %}
-<div class="container-fluid pt-5 mt-4">
-{% endif %}
-<div class="row mb-4">
-    <div class="col-12">
-        <h1 class="h3 mb-1">
-            <i class="bi bi-speedometer2 text-primary me-2"></i>{% trans %}Panel de Control{% endtrans %}
-        </h1>
-        <p class="text-muted small mb-0">{% trans %}Resumen general de espacios, materias y reservas académicas{% endtrans %}</p>
-    </div>
-</div>
-
-<!-- Statistics Cards with Direct Shortcuts -->
-<div class="row mb-4 g-3">
-    <!-- 1. Total Aulas -->
-    <div class="col-md-6 col-xl-3">
-        <a href="{{ url_for('classrooms.list_classrooms') }}" class="text-decoration-none text-reset d-block h-100">
-            <div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all">
-                <div class="card-body p-3">
-                    <div class="d-flex justify-content-between align-items-center">
-                        <div>
-                            <span class="text-muted small fw-semibold text-uppercase">{% trans %}Total de Aulas{% endtrans %}</span>
-                            <h2 class="mb-0 fw-bold mt-1 text-primary">{{ stats.total_classrooms }}</h2>
-                        </div>
-                        <div class="bg-primary bg-opacity-10 rounded-circle p-3 text-primary">
-                            <i class="bi bi-door-open fs-3"></i>
-                        </div>
-                    </div>
-                    <div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-primary small fw-semibold">
-                        <span>{% trans %}Ver todas las aulas{% endtrans %}</span>
-                        <i class="bi bi-arrow-right"></i>
-                    </div>
-                </div>
-            </div>
-        </a>
-    </div>
-    
-    <!-- 2. Total Materias -->
-    <div class="col-md-6 col-xl-3">
-        <a href="{{ url_for('schedule.commissions_view') }}" class="text-decoration-none text-reset d-block h-100">
-            <div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all">
-                <div class="card-body p-3">
-                    <div class="d-flex justify-content-between align-items-center">
-                        <div>
-                            <span class="text-muted small fw-semibold text-uppercase">{% trans %}Total de Materias{% endtrans %}</span>
-                            <h2 class="mb-0 fw-bold mt-1 text-success">{{ stats.total_subjects }}</h2>
-                        </div>
-                        <div class="bg-success bg-opacity-10 rounded-circle p-3 text-success">
-                            <i class="bi bi-book fs-3"></i>
-                        </div>
-                    </div>
-                    <div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-success small fw-semibold">
-                        <span>{% trans %}Gestionar materias{% endtrans %}</span>
-                        <i class="bi bi-arrow-right"></i>
-                    </div>
-                </div>
-            </div>
-        </a>
-    </div>
-    
-    <!-- 3. Reservas de Hoy -->
-    <div class="col-md-6 col-xl-3">
-        <a href="{{ url_for('schedule.today_schedule') }}" class="text-decoration-none text-reset d-block h-100">
-            <div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all">
-                <div class="card-body p-3">
-                    <div class="d-flex justify-content-between align-items-center">
-                        <div>
-                            <span class="text-muted small fw-semibold text-uppercase">{% trans %}Reservas de Hoy{% endtrans %}</span>
-                            <h2 class="mb-0 fw-bold mt-1 text-info">{{ stats.today_reservations }}</h2>
-                        </div>
-                        <div class="bg-info bg-opacity-10 rounded-circle p-3 text-info">
-                            <i class="bi bi-calendar-check fs-3"></i>
-                        </div>
-                    </div>
-                    <div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-info small fw-semibold">
-                        <span>{% trans %}Ver cartelera de hoy{% endtrans %}</span>
-                        <i class="bi bi-arrow-right"></i>
-                    </div>
-                </div>
-            </div>
-        </a>
-    </div>
-    
-    <!-- 4. Esta Semana -->
-    <div class="col-md-6 col-xl-3">
-        <a href="{{ url_for('schedule.calendar_view') }}" class="text-decoration-none text-reset d-block h-100">
-            <div class="card border-0 shadow-sm h-100 dashboard-stat-card transition-all">
-                <div class="card-body p-3">
-                    <div class="d-flex justify-content-between align-items-center">
-                        <div>
-                            <span class="text-muted small fw-semibold text-uppercase">{% trans %}Esta Semana{% endtrans %}</span>
-                            <h2 class="mb-0 fw-bold mt-1 text-warning">{{ stats.week_reservations }}</h2>
-                        </div>
-                        <div class="bg-warning bg-opacity-10 rounded-circle p-3 text-warning">
-                            <i class="bi bi-calendar-week fs-3"></i>
-                        </div>
-                    </div>
-                    <div class="d-flex align-items-center justify-content-between pt-3 mt-2 border-top text-warning small fw-semibold">
-                        <span>{% trans %}Abrir calendario semanal{% endtrans %}</span>
-                        <i class="bi bi-arrow-right"></i>
-                    </div>
-                </div>
-            </div>
-        </a>
-    </div>
-</div>
-
-<div class="row">
-    <!-- Monthly Chart -->
-    <div class="col-md-8 mb-4">
-        <div class="card border-0 shadow-sm">
-            <div class="card-header border-0 py-3 bg-body-tertiary">
-                <h5 class="mb-0 h6 fw-bold">
-                    <i class="bi bi-graph-up text-primary me-2"></i>{% trans %}Reservas Mensuales{% endtrans %}
-                </h5>
-            </div>
-            <div class="card-body">
-                <canvas id="monthlyChart" height="100"></canvas>
-            </div>
-        </div>
-    </div>
-    
-    <!-- Quick Actions -->
-    <div class="col-md-4 mb-4">
-        <div class="card border-0 shadow-sm">
-            <div class="card-header border-0 py-3 bg-body-tertiary">
-                <h5 class="mb-0 h6 fw-bold">
-                    <i class="bi bi-lightning text-warning me-2"></i>{% trans %}Accesos Rápidos{% endtrans %}
-                </h5>
-            </div>
-            <div class="card-body p-3">
-                <div class="d-grid gap-2">
-                    <a href="{{ url_for('schedule.calendar_view') }}" class="btn btn-outline-primary text-start">
-                        <i class="bi bi-calendar3 me-2"></i>{% trans %}Calendario de Reservas{% endtrans %}
-                    </a>
-                    <a href="{{ url_for('schedule.today_schedule') }}" class="btn btn-outline-info text-start">
-                        <i class="bi bi-calendar-day me-2"></i>{% trans %}Cartelera del Día{% endtrans %}
-                    </a>
-                    {% if current_user.has_permission('optimizer', 'read') or (current_user.role and current_user.role|upper == 'ADMIN') %}
-                    <a href="{{ url_for('genetic_algorithm_web.genetic_optimizer') }}" class="btn btn-outline-info text-start">
-                        <i class="bi bi-cpu me-2"></i>{% trans %}Optimizador de Aulas (IA){% endtrans %}
-                    </a>
-                    {% endif %}
-                    <a href="{{ url_for('classrooms.list_classrooms') }}" class="btn btn-outline-secondary text-start">
-                        <i class="bi bi-door-open me-2"></i>{% trans %}Listado de Aulas{% endtrans %}
-                    </a>
-                    <a href="{{ url_for('buildings.list_buildings') }}" class="btn btn-outline-secondary text-start">
-                        <i class="bi bi-buildings me-2"></i>{% trans %}Gestión de Edificios{% endtrans %}
-                    </a>
-                    {% if current_user.has_permission('reservations', 'read_write') %}
-                    <a href="{{ url_for('schedule.add_reservation') }}" class="btn btn-outline-success text-start">
-                        <i class="bi bi-calendar-plus me-2"></i>{% trans %}Nueva Reserva{% endtrans %}
-                    </a>
-                    {% endif %}
-                    {% if current_user.has_permission('classrooms', 'read_write') %}
-                    <a href="{{ url_for('classrooms.add_classroom') }}" class="btn btn-outline-primary text-start">
-                        <i class="bi bi-plus-circle me-2"></i>{% trans %}Crear Nueva Aula{% endtrans %}
-                    </a>
-                    {% endif %}
-                </div>
-            </div>
-        </div>
-    </div>
-</div>
-
-<!-- Upcoming Reservations -->
-<div class="row">
-    <div class="col-12">
-        <div class="card border-0 shadow-sm">
-            <div class="card-header border-0 py-3 bg-body-tertiary d-flex justify-content-between align-items-center">
-                <h5 class="mb-0 h6 fw-bold">
-                    <i class="bi bi-clock-history text-info me-2"></i>{% trans %}Próximas Reservas (Próximos 7 Días){% endtrans %}
-                </h5>
-                <a href="{{ url_for('schedule.calendar_view') }}" class="btn btn-sm btn-outline-primary">
-                    {% trans %}Ver en Calendario{% endtrans %}
-                </a>
-            </div>
-            <div class="card-body p-0">
-                {% if upcoming_reservations %}
-                    <div class="table-responsive">
-                        <table class="table table-hover align-middle mb-0">
-                            <thead class="table-light small text-uppercase">
-                                <tr>
-                                    <th class="ps-3">{% trans %}Horario{% endtrans %}</th>
-                                    <th>{% trans %}Aula{% endtrans %}</th>
-                                    <th>{% trans %}Asignatura / Código{% endtrans %}</th>
-                                    <th>{% trans %}Turno / Comisión{% endtrans %}</th>
-                                    <th>{% trans %}Estado{% endtrans %}</th>
-                                    <th class="text-end pe-3">{% trans %}Acciones{% endtrans %}</th>
-                                </tr>
-                            </thead>
-                            <tbody>
-                                {% for reservation in upcoming_reservations %}
-                                <tr>
-                                    <td class="ps-3">
-                                        <div class="fw-bold font-monospace text-primary fs-6">
-                                            <i class="bi bi-clock text-warning me-1"></i>{{ reservation.start_time.strftime('%H:%M') }} - {{ reservation.end_time.strftime('%H:%M') }} hs
-                                        </div>
-                                    </td>
-                                    <td>
-                                        <span class="badge bg-secondary-subtle text-secondary border font-monospace">
-                                            {{ reservation.classroom.code if reservation.classroom else 'Sin Aula' }}
-                                        </span>
-                                    </td>
-                                    <td>
-                                        <div class="fw-semibold text-primary">{{ reservation.subject_name }}</div>
-                                        <small class="text-muted font-monospace">{{ reservation.subject_code }}</small>
-                                    </td>
-                                    <td>
-                                        <span class="badge bg-info-subtle text-info border me-1">
-                                            {{ reservation.shift or 'Tarde' }}
-                                        </span>
-                                        <small class="text-muted">{{ reservation.commission.code if reservation.commission else 'C1' }}</small>
-                                    </td>
-                                    <td>
-                                        {% if reservation.status == 'CONFIRMED' or reservation.status.value == 'CONFIRMED' %}
-                                            <span class="badge bg-success-subtle text-success border border-success-subtle">
-                                                <i class="bi bi-check-circle me-1"></i>{% trans %}Confirmada{% endtrans %}
-                                            </span>
-                                        {% else %}
-                                            <span class="badge bg-warning-subtle text-warning border border-warning-subtle">
-                                                <i class="bi bi-clock me-1"></i>{% trans %}Pendiente{% endtrans %}
-                                            </span>
-                                        {% endif %}
-                                    </td>
-                                    <td class="text-end pe-3">
-                                        <a href="{{ url_for('schedule.view_reservation', id=reservation.id) }}" 
-                                           class="btn btn-sm btn-outline-secondary py-0 px-2" title="{% trans %}Ver Ficha{% endtrans %}">
-                                            <i class="bi bi-eye"></i>
-                                        </a>
-                                    </td>
-                                </tr>
-                                {% endfor %}
-                            </tbody>
-                        </table>
-                    </div>
-                {% else %}
-                    <div class="text-center py-5">
-                        <i class="bi bi-calendar-x text-muted fs-1 d-block mb-2"></i>
-                        <h6 class="fw-bold">{% trans %}No hay reservas para los próximos 7 días{% endtrans %}</h6>
-                        <p class="text-muted small">{% trans %}Puedes programar nuevas reservas desde el calendario.{% endtrans %}</p>
-                    </div>
-                {% endif %}
-            </div>
-        </div>
-    </div>
-</div>
-{% if current_user.is_authenticated %}
-</div>
-{% endif %}
-{% endblock %}
-
-{% block extra_js %}
-<script src="https://cdn.jsdelivr.net/npm/chart.js"></script>
-<script>
-$(document).ready(function() {
-    // Fetch monthly data and create chart
-    $.get('/api/dashboard-stats')
-        .done(function(data) {
-            const ctx = document.getElementById('monthlyChart').getContext('2d');
-            new Chart(ctx, {
-                type: 'line',
-                data: {
-                    labels: data.monthly_data.map(item => item.month),
-                    datasets: [{
-                        label: 'Reservations',
-                        data: data.monthly_data.map(item => item.reservations),
-                        borderColor: '#667eea',
-                        backgroundColor: 'rgba(102, 126, 234, 0.1)',
-                        borderWidth: 2,
-                        fill: true,
-                        tension: 0.4
-                    }]
-                },
-                options: {
-                    responsive: true,
-                    maintainAspectRatio: false,
-                    plugins: {
-                        legend: {
-                            display: false
-                        }
-                    },
-                    scales: {
-                        y: {
-                            beginAtZero: true,
-                            ticks: {
-                                stepSize: 1
-                            }
-                        }
-                    }
-                }
-            });
-        });
-});
-</script>
-{% endblock %}

app/templates/schedule/list.html

@@ -1,286 +0,0 @@
-{% extends "base.html" %}
-
-{% block title %}{% trans %}Listado de Reservas{% endtrans %} - Edu-Space Admin{% endblock %}
-
-{% block content %}
-<div class="container-fluid pt-5 mt-4">
-    <!-- Header -->
-    <div class="row mb-4 align-items-center">
-        <div class="col-md-7">
-            <h1 class="h3 mb-1">
-                <i class="bi bi-calendar-check text-primary me-2"></i>{% trans %}Listado de Reservas{% endtrans %}
-            </h1>
-            <p class="text-muted small mb-0">{% trans %}Registro histórico y programación completa de clases y asignación de aulas{% endtrans %}</p>
-        </div>
-        <div class="col-md-5 text-md-end mt-3 mt-md-0">
-            {% if current_user.has_permission('reservations', 'read_write') %}
-            <a href="{{ url_for('schedule.add_reservation') }}" class="btn btn-success me-2">
-                <i class="bi bi-plus-circle me-1"></i>{% trans %}Nueva Reserva{% endtrans %}
-            </a>
-            {% endif %}
-            <a href="{{ url_for('schedule.calendar_view') }}" class="btn btn-outline-primary me-2">
-                <i class="bi bi-calendar3 me-1"></i>{% trans %}Ver Calendario{% endtrans %}
-            </a>
-            <a href="{{ url_for('schedule.today_schedule') }}" class="btn btn-outline-info">
-                <i class="bi bi-calendar-day me-1"></i>{% trans %}Cartelera de Hoy{% endtrans %}
-            </a>
-        </div>
-    </div>
-
-    <!-- Filters Card -->
-    <div class="card border-0 shadow-sm mb-4">
-        <div class="card-body p-3">
-            <form method="GET" action="{{ url_for('schedule.list_reservations') }}" class="row g-2 align-items-end">
-                <!-- Search text -->
-                <div class="col-lg-3 col-md-6">
-                    <label class="form-label small fw-bold text-muted mb-1">
-                        <i class="bi bi-search me-1"></i>{% trans %}Buscar{% endtrans %}
-                    </label>
-                    <input type="text" name="search" class="form-control form-control-sm" placeholder="Materia, código o aula..." value="{{ search or '' }}">
-                </div>
-
-                <!-- Status Filter -->
-                <div class="col-lg-2 col-md-3">
-                    <label class="form-label small fw-bold text-muted mb-1">
-                        <i class="bi bi-shield-check me-1"></i>{% trans %}Estado{% endtrans %}
-                    </label>
-                    <select name="status" class="form-select form-select-sm">
-                        <option value="all" {% if status_filter == 'all' or not status_filter %}selected{% endif %}>{% trans %}Todos los estados{% endtrans %}</option>
-                        <option value="confirmed" {% if status_filter == 'confirmed' %}selected{% endif %}>{% trans %}Confirmadas{% endtrans %}</option>
-                        <option value="pending" {% if status_filter == 'pending' %}selected{% endif %}>{% trans %}Pendientes{% endtrans %}</option>
-                        <option value="cancelled" {% if status_filter == 'cancelled' %}selected{% endif %}>{% trans %}Canceladas{% endtrans %}</option>
-                    </select>
-                </div>
-
-                <!-- Floor Filter -->
-                <div class="col-lg-2 col-md-3">
-                    <label class="form-label small fw-bold text-muted mb-1">
-                        <i class="bi bi-layers me-1"></i>{% trans %}Piso{% endtrans %}
-                    </label>
-                    <select name="floor" class="form-select form-select-sm">
-                        <option value="">{% trans %}Todos los pisos{% endtrans %}</option>
-                        {% for f in available_floors %}
-                            <option value="{{ f }}" {% if floor_filter == f|string %}selected{% endif %}>
-                                {% if f == 0 %}{% trans %}Planta Baja{% endtrans %}{% else %}{% trans %}Piso{% endtrans %} {{ f }}{% endif %}
-                            </option>
-                        {% endfor %}
-                    </select>
-                </div>
-
-                <!-- Aula Filter -->
-                <div class="col-lg-3 col-md-4">
-                    <label class="form-label small fw-bold text-muted mb-1">
-                        <i class="bi bi-door-open text-primary me-1"></i>{% trans %}Aula / Espacio{% endtrans %}
-                    </label>
-                    <select name="classroom_id" class="form-select form-select-sm">
-                        <option value="">{% trans %}Todas las aulas{% endtrans %}</option>
-                        {% for c in all_classrooms %}
-                            <option value="{{ c.id }}" {% if classroom_id == c.id %}selected{% endif %}>{{ c.building_name }} - {{ c.code }}</option>
-                        {% endfor %}
-                    </select>
-                </div>
-
-                <!-- Shift Filter -->
-                <div class="col-lg-2 col-md-3">
-                    <label class="form-label small fw-bold text-muted mb-1">
-                        <i class="bi bi-brightness-high text-warning me-1"></i>{% trans %}Turno{% endtrans %}
-                    </label>
-                    <select name="shift" class="form-select form-select-sm">
-                        <option value="">{% trans %}Todos los turnos{% endtrans %}</option>
-                        <option value="Mañana" {% if shift_filter == 'Mañana' %}selected{% endif %}>{% trans %}Turno Mañana{% endtrans %}</option>
-                        <option value="Tarde" {% if shift_filter == 'Tarde' %}selected{% endif %}>{% trans %}Turno Tarde{% endtrans %}</option>
-                    </select>
-                </div>
-
-                <!-- Date Range From -->
-                <div class="col-lg-2 col-md-3">
-                    <label class="form-label small fw-bold text-muted mb-1">
-                        <i class="bi bi-calendar-event me-1"></i>{% trans %}Desde Fecha{% endtrans %}
-                    </label>
-                    <input type="date" name="date_from" class="form-control form-control-sm" value="{{ date_from or '' }}">
-                </div>
-
-                <!-- Date Range To -->
-                <div class="col-lg-2 col-md-3">
-                    <label class="form-label small fw-bold text-muted mb-1">
-                        <i class="bi bi-calendar-event me-1"></i>{% trans %}Hasta Fecha{% endtrans %}
-                    </label>
-                    <input type="date" name="date_to" class="form-control form-control-sm" value="{{ date_to or '' }}">
-                </div>
-
-                <!-- Row 2: Hide Virtual, Submit, Clear -->
-                <div class="col-lg-6 col-md-6 pt-2">
-                    <div class="form-check form-switch pt-1">
-                        <input class="form-check-input" type="checkbox" role="switch" name="hide_virtual" value="1" id="hideVirtualList" {% if hide_virtual %}checked{% endif %}>
-                        <label class="form-check-label fw-semibold small text-dark" for="hideVirtualList">
-                            <i class="bi bi-laptop me-1 text-primary"></i>{% trans %}Ocultar Aulas Virtuales{% endtrans %}
-                            <span class="badge bg-secondary-subtle text-secondary border ms-1" style="font-size: 0.72rem;">{% trans %}Capacidad ilimitada{% endtrans %}</span>
-                        </label>
-                    </div>
-                </div>
-
-                <div class="col-lg-6 col-md-6 pt-2 text-md-end d-flex justify-content-md-end gap-2">
-                    <button type="submit" class="btn btn-primary btn-sm px-3">
-                        <i class="bi bi-funnel me-1"></i>{% trans %}Filtrar{% endtrans %}
-                    </button>
-                    <a href="{{ url_for('schedule.list_reservations') }}" class="btn btn-outline-secondary btn-sm px-3">
-                        <i class="bi bi-arrow-counterclockwise me-1"></i>{% trans %}Limpiar{% endtrans %}
-                    </a>
-                </div>
-            </form>
-        </div>
-    </div>
-
-    <!-- Reservations Table -->
-    {% if reservations and reservations.items %}
-    <div class="card border-0 shadow-sm">
-        <div class="card-header bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center">
-            <h5 class="mb-0 h6 fw-bold">
-                <i class="bi bi-table text-primary me-2"></i>{% trans %}Registros Encontrados{% endtrans %}
-                <span class="badge bg-secondary-subtle text-secondary border ms-2">{{ reservations.total }} {% trans %}reservas{% endtrans %}</span>
-            </h5>
-            <small class="text-muted">{% trans %}Página{% endtrans %} {{ reservations.page }} {% trans %}de{% endtrans %} {{ reservations.pages }}</small>
-        </div>
-        <div class="card-body p-0">
-            <div class="table-responsive">
-                <table class="table table-hover align-middle mb-0">
-                    <thead class="table-light small text-uppercase">
-                        <tr>
-                            <th class="ps-3">{% trans %}Fecha y Horario{% endtrans %}</th>
-                            <th>{% trans %}Aula / Piso{% endtrans %}</th>
-                            <th>{% trans %}Asignatura / Código{% endtrans %}</th>
-                            <th>{% trans %}Turno / Comisión{% endtrans %}</th>
-                            <th>{% trans %}Capacidad{% endtrans %}</th>
-                            <th>{% trans %}Estado{% endtrans %}</th>
-                            <th class="text-end pe-3">{% trans %}Acciones{% endtrans %}</th>
-                        </tr>
-                    </thead>
-                    <tbody>
-                        {% for reservation in reservations.items %}
-                        <tr>
-                            <td class="ps-3">
-                                <div class="fw-bold">{{ reservation.start_time.strftime('%d/%m/%Y') }}</div>
-                                <small class="text-muted font-monospace">{{ reservation.start_time.strftime('%H:%M') }} - {{ reservation.end_time.strftime('%H:%M') }} hs</small>
-                            </td>
-                            <td>
-                                <span class="badge bg-secondary-subtle text-secondary border font-monospace">
-                                    {{ reservation.classroom.code if reservation.classroom else 'Sin Aula' }}
-                                </span>
-                                <small class="text-muted d-block">
-                                    {% if reservation.classroom and reservation.classroom.floor == 0 %}PB{% elif reservation.classroom %}Piso {{ reservation.classroom.floor }}{% endif %}
-                                    {% if reservation.classroom and reservation.classroom.building %} · {{ reservation.classroom.building }}{% endif %}
-                                </small>
-                            </td>
-                            <td>
-                                <div class="fw-bold text-primary">{{ reservation.subject_name }}</div>
-                                <small class="badge bg-secondary-subtle text-secondary font-monospace">{{ reservation.subject_code }}</small>
-                            </td>
-                            <td>
-                                <span class="badge bg-info-subtle text-info border me-1">
-                                    {{ reservation.shift or 'Tarde' }}
-                                </span>
-                                <small class="text-muted">{{ reservation.commission.code if reservation.commission else 'C1' }}</small>
-                            </td>
-                            <td>
-                                <span class="small">{{ reservation.expected_attendees }} / {{ reservation.classroom.capacity if reservation.classroom else '-' }}</span>
-                            </td>
-                            <td>
-                                {% if reservation.status == 'CONFIRMED' or reservation.status.value == 'CONFIRMED' %}
-                                    <span class="badge bg-success-subtle text-success border border-success-subtle">
-                                        <i class="bi bi-check-circle me-1"></i>{% trans %}Confirmada{% endtrans %}
-                                    </span>
-                                {% elif reservation.status == 'PENDING' or reservation.status.value == 'PENDING' %}
-                                    <span class="badge bg-warning-subtle text-warning border border-warning-subtle">
-                                        <i class="bi bi-clock me-1"></i>{% trans %}Pendiente{% endtrans %}
-                                    </span>
-                                {% else %}
-                                    <span class="badge bg-danger-subtle text-danger border border-danger-subtle">
-                                        {% trans %}Cancelada{% endtrans %}
-                                    </span>
-                                {% endif %}
-                            </td>
-                            <td class="text-end pe-3">
-                                {% if reservation.effective_virtual_link %}
-                                <a href="{{ reservation.effective_virtual_link }}" target="_blank" 
-                                   class="btn btn-sm btn-outline-success py-0 px-2 me-1" title="{% trans %}Unirse a Clase Virtual (Zoom/Meet){% endtrans %}">
-                                    <i class="bi bi-camera-video"></i>
-                                </a>
-                                {% endif %}
-                                {% if current_user.can_edit_reservation(reservation) %}
-                                <a href="{{ url_for('schedule.edit_reservation', id=reservation.id) }}" 
-                                   class="btn btn-sm btn-outline-warning py-0 px-2 me-1" title="{% trans %}Modificar Reserva{% endtrans %}">
-                                    <i class="bi bi-pencil"></i>
-                                </a>
-                                {% endif %}
-                                <a href="{{ url_for('schedule.view_reservation', id=reservation.id) }}" 
-                                   class="btn btn-sm btn-outline-secondary py-0 px-2" title="{% trans %}Ver Ficha{% endtrans %}">
-                                    <i class="bi bi-eye"></i>
-                                </a>
-                                {% if current_user.has_permission('reservations', 'read_write') and (reservation.status == 'PENDING' or reservation.status.value == 'PENDING') %}
-                                <a href="{{ url_for('schedule.confirm_reservation', id=reservation.id) }}" 
-                                   class="btn btn-sm btn-outline-success py-0 px-2 ms-1" title="{% trans %}Confirmar{% endtrans %}">
-                                    <i class="bi bi-check-lg"></i>
-                                </a>
-                                {% endif %}
-                            </td>
-                        </tr>
-                        {% endfor %}
-                    </tbody>
-                </table>
-            </div>
-
-            <!-- Pagination -->
-            {% if reservations.pages > 1 %}
-            <div class="card-footer bg-body-tertiary border-0 py-3 d-flex justify-content-between align-items-center">
-                <small class="text-muted">{% trans %}Mostrando 20 registros por página{% endtrans %}</small>
-                <nav>
-                    <ul class="pagination pagination-sm mb-0">
-                        {% if reservations.has_prev %}
-                        <li class="page-item">
-                            <a class="page-link" href="{{ url_for('schedule.list_reservations', page=reservations.prev_num, status=status_filter, date_from=date_from, date_to=date_to, floor=floor_filter, shift=shift_filter, classroom_id=classroom_id or '', hide_virtual='1' if hide_virtual else '', search=search) }}">
-                                <i class="bi bi-chevron-left"></i>
-                            </a>
-                        </li>
-                        {% endif %}
-
-                        {% for p in reservations.iter_pages(left_edge=2, left_current=2, right_current=2, right_edge=2) %}
-                            {% if p %}
-                                {% if p == reservations.page %}
-                                <li class="page-item active"><span class="page-link">{{ p }}</span></li>
-                                {% else %}
-                                <li class="page-item">
-                                    <a class="page-link" href="{{ url_for('schedule.list_reservations', page=p, status=status_filter, date_from=date_from, date_to=date_to, floor=floor_filter, shift=shift_filter, classroom_id=classroom_id or '', hide_virtual='1' if hide_virtual else '', search=search) }}">{{ p }}</a>
-                                </li>
-                                {% endif %}
-                            {% else %}
-                                <li class="page-item disabled"><span class="page-link">…</span></li>
-                            {% endif %}
-                        {% endfor %}
-
-                        {% if reservations.has_next %}
-                        <li class="page-item">
-                            <a class="page-link" href="{{ url_for('schedule.list_reservations', page=reservations.next_num, status=status_filter, date_from=date_from, date_to=date_to, floor=floor_filter, shift=shift_filter, classroom_id=classroom_id or '', hide_virtual='1' if hide_virtual else '', search=search) }}">
-                                <i class="bi bi-chevron-right"></i>
-                            </a>
-                        </li>
-                        {% endif %}
-                    </ul>
-                </nav>
-            </div>
-            {% endif %}
-        </div>
-    </div>
-    {% else %}
-    <div class="card border-0 shadow-sm">
-        <div class="card-body text-center py-5">
-            <i class="bi bi-calendar-x text-muted fs-1 d-block mb-3"></i>
-            <h5 class="fw-bold">{% trans %}No se encontraron reservas{% endtrans %}</h5>
-            <p class="text-muted small mb-3">{% trans %}No hay registros que coincidan con los criterios de búsqueda o filtros seleccionados.{% endtrans %}</p>
-            <a href="{{ url_for('schedule.list_reservations') }}" class="btn btn-outline-primary btn-sm">
-                <i class="bi bi-arrow-counterclockwise me-1"></i>{% trans %}Restablecer Todos los Filtros{% endtrans %}
-            </a>
-        </div>
-    </div>
-    {% endif %}
-</div>
-{% endblock %}

backend/app/__init__.py

@@ -0,0 +1,99 @@
+from flask import Flask, request, session
+from flask_sqlalchemy import SQLAlchemy
+from flask_migrate import Migrate
+from flask_cors import CORS
+from flask_babel import Babel, gettext as _
+from config.config import Config
+
+# Initialize extensions
+db = SQLAlchemy()
+migrate = Migrate()
+cors = CORS()
+babel = Babel()
+
+def create_app(config_class=Config):
+    app = Flask(__name__)
+    app.config.from_object(config_class)
+    
+    # Initialize extensions with app
+    db.init_app(app)
+    migrate.init_app(app, db)
+    cors.init_app(app)
+    
+    # Import models to ensure they are registered
+    from app.models import user
+    # Register REST API (v1) Blueprints with Stateless JWT support
+    from app.routes.api.auth import api_auth_bp
+    from app.routes.api.classrooms import api_classrooms_bp
+    from app.routes.api.reservations import api_reservations_bp
+    from app.routes.api.optimizer import api_optimizer_bp
+    from app.routes.api.dashboard import api_dashboard_bp
+    from app.routes.api.admin import api_admin_bp
+    from app.routes.api.openapi import api_openapi_bp
+    from app.security import SecurityFilterChain
+
+    # Register API v1 blueprints
+    app.register_blueprint(api_auth_bp)
+    app.register_blueprint(api_classrooms_bp)
+    app.register_blueprint(api_reservations_bp)
+    app.register_blueprint(api_optimizer_bp)
+    app.register_blueprint(api_dashboard_bp)
+    app.register_blueprint(api_openapi_bp)
+    app.register_blueprint(api_admin_bp, url_prefix='/api/v1')
+    app.register_blueprint(api_admin_bp, url_prefix='/api/v1/admin', name='api_admin_prefixed')
+
+    # Initialize Enterprise Security Pipeline (SecurityFilterChain)
+    SecurityFilterChain(app)
+    
+    # Language selector function
+    def get_locale():
+        # 1. Si el usuario está autenticado y tiene idioma configurado explícitamente en su perfil, prevalece.
+        from flask_login import current_user
+        if current_user.is_authenticated:
+            if getattr(current_user, 'preferred_language', None) and current_user.preferred_language in app.config['LANGUAGES']:
+                return current_user.preferred_language
+            # El idioma por defecto siempre será español a menos que se configure a mano
+            return app.config['BABEL_DEFAULT_LOCALE']
+        
+        # 2. Parámetro explícito en la URL (?lang=es o ?lang=en) (para usuarios no autenticados o login)
+        lang = request.args.get('lang')
+        if lang and lang in app.config['LANGUAGES']:
+            session['language'] = lang
+            return lang
+            
+        # 3. Si ya hay un idioma guardado en la sesión
+        if 'language' in session and session['language'] in app.config['LANGUAGES']:
+            return session['language']
+            
+        # 4. Primera vez que se accede a la web (sin sesión): respetar el idioma del navegador
+        if request.accept_languages:
+            for accepted_lang, _quality in request.accept_languages:
+                primary = accepted_lang.split('-')[0].lower()
+                if primary in app.config['LANGUAGES']:
+                    session['language'] = primary  # Se guarda para la sesión actual
+                    return primary
+
+        # Fallback del sistema: Español
+        return app.config['BABEL_DEFAULT_LOCALE']
+
+
+    # Babel context processor
+    @app.context_processor
+    def inject_conf_vars():
+        return dict(
+            languages=app.config['LANGUAGES'],
+            current_lang=str(get_locale())
+        )
+
+    
+    # Configure Babel
+    babel.init_app(app, locale_selector=get_locale)
+    
+    # Register localized date and datetime formatters for Jinja2 templates
+    from flask_babel import format_date, format_datetime
+    app.jinja_env.globals['format_date'] = format_date
+    app.jinja_env.globals['format_datetime'] = format_datetime
+    app.jinja_env.filters['format_date'] = format_date
+    app.jinja_env.filters['format_datetime'] = format_datetime
+    
+    return app

backend/app/constants/__init__.py

@@ -0,0 +1 @@
+from .document_types import DOCUMENT_TYPES, DOCUMENT_TYPE_MAP, get_document_type, validate_document, format_document

backend/app/constants/document_types.py

@@ -0,0 +1,160 @@
+import re
+
+DOCUMENT_TYPES = [
+    {
+        'code': 'DNI',
+        'name': 'Documento Nacional de Identidad',
+        'short_name': 'DNI',
+        'category': 'Nacional',
+        'description': 'Documento oficial para ciudadanos argentinos nativos, naturalizados y residentes permanentes.',
+        'regex': r'^\d{7,8}$',
+        'placeholder': 'Ej: 38123456 (7 u 8 dígitos sin puntos)',
+        'mask_example': '38.123.456'
+    },
+    {
+        'code': 'CUIL',
+        'name': 'Código Único de Identificación Laboral (CUIL/CUIT)',
+        'short_name': 'CUIL',
+        'category': 'Nacional / Laboral',
+        'description': 'Identificador fiscal y laboral en Argentina (11 dígitos).',
+        'regex': r'^\d{11}$|^\d{2}-\d{8}-\d{1}$',
+        'placeholder': 'Ej: 20381234567 o 20-38123456-7',
+        'mask_example': '20-38123456-7'
+    },
+    {
+        'code': 'PAS',
+        'name': 'Pasaporte Argentino',
+        'short_name': 'Pasaporte ARG',
+        'category': 'Internacional',
+        'description': 'Pasaporte emitido por la República Argentina para viajes y acreditación internacional.',
+        'regex': r'^[a-zA-Z0-9]{6,12}$',
+        'placeholder': 'Ej: AAB123456',
+        'mask_example': 'PAS AAB123456'
+    },
+    {
+        'code': 'PASEXT',
+        'name': 'Pasaporte Extranjero',
+        'short_name': 'Pasaporte Extranjero',
+        'category': 'Internacional / Extranjero',
+        'description': 'Pasaporte oficial emitido por país de origen (docentes invitados, alumnos de intercambio).',
+        'regex': r'^[a-zA-Z0-9\-\.]{4,20}$',
+        'placeholder': 'Ej: US987654321 / B1234567',
+        'mask_example': 'PASEXT US987654321'
+    },
+    {
+        'code': 'DNIEXT',
+        'name': 'DNI para Extranjeros (Residente)',
+        'short_name': 'DNI Extranjero',
+        'category': 'Extranjero / Residente',
+        'description': 'DNI argentino otorgado a ciudadanos extranjeros con radicación o residencia temporaria.',
+        'regex': r'^[a-zA-Z0-9]{7,10}$',
+        'placeholder': 'Ej: 94123456 o E94123456',
+        'mask_example': 'DNI-EXT 94.123.456'
+    },
+    {
+        'code': 'CI',
+        'name': 'Cédula de Identidad (PFA / Policía Provincial)',
+        'short_name': 'Cédula Identidad',
+        'category': 'Nacional (Histórico)',
+        'description': 'Cédula de Identidad emitida por Policía Federal Argentina o Policías Provinciales.',
+        'regex': r'^\d{6,9}$',
+        'placeholder': 'Ej: 6123456',
+        'mask_example': 'CI 6.123.456'
+    },
+    {
+        'code': 'CIEXT',
+        'name': 'Cédula de Identidad Extranjera (Mercosur)',
+        'short_name': 'Cédula Mercosur',
+        'category': 'Regional / Mercosur',
+        'description': 'Cédula de Identidad emitida por países miembros o asociados al Mercosur (Brasil, Uruguay, etc.).',
+        'regex': r'^[a-zA-Z0-9\-\.]{5,18}$',
+        'placeholder': 'Ej: RG12345678 (Brasil) o 4.123.456-7 (Uruguay)',
+        'mask_example': 'CI-EXT 12345678'
+    },
+    {
+        'code': 'LC',
+        'name': 'Libreta Cívica',
+        'short_name': 'Libreta Cívica',
+        'category': 'Histórico Nacional',
+        'description': 'Documento histórico nacional para ciudadanas mujeres argentinas.',
+        'regex': r'^\d{6,8}$',
+        'placeholder': 'Ej: 5123456',
+        'mask_example': 'LC 5.123.456'
+    },
+    {
+        'code': 'LE',
+        'name': 'Libreta de Enrolamiento',
+        'short_name': 'Libreta Enrolamiento',
+        'category': 'Histórico Nacional',
+        'description': 'Documento histórico nacional para ciudadanos varones argentinos.',
+        'regex': r'^\d{6,8}$',
+        'placeholder': 'Ej: 4123456',
+        'mask_example': 'LE 4.123.456'
+    }
+]
+
+DOCUMENT_TYPE_MAP = {doc['code']: doc for doc in DOCUMENT_TYPES}
+
+def get_document_type(code):
+    """Devuelve la especificación de un tipo de documento o None."""
+    if not code:
+        return None
+    return DOCUMENT_TYPE_MAP.get(str(code).strip().upper())
+
+def validate_document(doc_type, doc_number):
+    """
+    Valida un número de documento según las reglas de negocio de su tipificación.
+    Retorna (is_valid: bool, cleaned_number: str, error_message: str|None).
+    """
+    if not doc_type:
+        return False, '', 'Debe especificar el tipo de documento.'
+    
+    spec = get_document_type(doc_type)
+    if not spec:
+        return False, '', f"El tipo de documento '{doc_type}' no está registrado en el catálogo oficial."
+    
+    if not doc_number:
+        return True, '', None  # Document number may be optional if pending registration
+    
+    cleaned = str(doc_number).strip().upper()
+    # Si es DNI, LC, LE, CI podemos remover puntos y guiones intermedios para validar y almacenar de forma uniforme
+    if spec['code'] in ['DNI', 'LC', 'LE', 'CI', 'DNIEXT']:
+        numeric_only = re.sub(r'[\.\-\s]', '', cleaned)
+        if re.match(spec['regex'], numeric_only):
+            return True, numeric_only, None
+        return False, cleaned, f"Formato inválido para {spec['name']}. Debe contener {spec['placeholder']}."
+    
+    elif spec['code'] == 'CUIL':
+        numeric_only = re.sub(r'[\.\-\s]', '', cleaned)
+        if re.match(r'^\d{11}$', numeric_only):
+            return True, numeric_only, None
+        return False, cleaned, "El CUIL debe contener 11 dígitos numéricos (ej. 20-38123456-7)."
+        
+    else:
+        # Pasaportes o Cédulas Extranjeras
+        if re.match(spec['regex'], cleaned):
+            return True, cleaned, None
+        return False, cleaned, f"Formato inválido para {spec['name']} ({spec['placeholder']})."
+
+def format_document(doc_type, doc_number):
+    """
+    Formatea visualmente un número de documento con puntos/guiones estándar.
+    """
+    if not doc_number:
+        return ''
+    raw = str(doc_number).strip().upper()
+    dtype = (doc_type or 'DNI').upper()
+    
+    if dtype in ['DNI', 'LC', 'LE', 'CI']:
+        clean = re.sub(r'\D', '', raw)
+        if len(clean) == 8:
+            return f"{clean[:2]}.{clean[2:5]}.{clean[5:]}"
+        elif len(clean) == 7:
+            return f"{clean[:1]}.{clean[1:4]}.{clean[4:]}"
+        return clean
+    elif dtype == 'CUIL':
+        clean = re.sub(r'\D', '', raw)
+        if len(clean) == 11:
+            return f"{clean[:2]}-{clean[2:10]}-{clean[10:]}"
+        return clean
+    return raw

backend/app/forms/auth.py

@@ -4,11 +4,14 @@ from wtforms.validators import DataRequired, Email, Length
 from flask_babel import lazy_gettext as _l
 
 class LoginForm(FlaskForm):
-    email = StringField(_l('Email'), validators=[
+    email = StringField(_l('Email'), 
-        DataRequired(),
+        validators=[
-        Email(),
+            DataRequired(),
-        Length(max=120)
+            Email(),
-    ])
+            Length(max=120)
+        ],
+        filters=[lambda x: x.strip().lower() if x else '']
+    )
     password = PasswordField(_l('Password'), validators=[DataRequired()])
     remember_me = BooleanField(_l('Remember me'))
     submit = SubmitField(_l('Sign In'))

backend/app/models/__init__.py

@@ -3,11 +3,14 @@ from .building import Building
 from .classroom import Classroom, ClassroomResource
 from .career import Career
 from .academic_term import AcademicTerm
-from .subject import Subject, Commission
+from .subject import Subject, Commission, CommissionTeacher
 from .reservation import Reservation, ReservationStatus
 from .genetic_algorithm import GeneticAlgorithm, ReservationOptimizer
 from .role import Role, Permission, SYSTEM_MODULES
 from .milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES
+from .audit_log import AuditLog
+from .enrollment import StudentEnrollment
+from .setting import SystemSetting
 
 __all__ = [
     'User',
@@ -18,6 +21,7 @@ __all__ = [
     'AcademicTerm',
     'Subject', 
     'Commission',
+    'CommissionTeacher',
     'Reservation',
     'ReservationStatus',
     'GeneticAlgorithm',
@@ -27,5 +31,8 @@ __all__ = [
     'SYSTEM_MODULES',
     'MilestoneType',
     'AcademicMilestone',
-    'BASE_MILESTONE_TYPES'
+    'BASE_MILESTONE_TYPES',
+    'AuditLog',
+    'StudentEnrollment',
+    'SystemSetting'
 ]

backend/app/models/audit_log.py

@@ -0,0 +1,25 @@
+from app import db
+from datetime import datetime
+
+class AuditLog(db.Model):
+    """
+    Bitácora inmutable de auditoría para registro de eventos críticos
+    y trazabilidad de operaciones institucionales.
+    """
+    __tablename__ = 'audit_logs'
+
+    id = db.Column(db.Integer, primary_key=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='SET NULL'), nullable=True)
+    user_email = db.Column(db.String(255), nullable=True)
+    action = db.Column(db.String(50), nullable=False, index=True)      # CREATE, UPDATE, DELETE, LOGIN, LOGOUT
+    module = db.Column(db.String(50), nullable=False, index=True)      # classrooms, reservations, auth, users
+    entity_id = db.Column(db.Integer, nullable=True)                  # ID del registro afectado
+    details = db.Column(db.Text, nullable=True)                       # Detalles de cambios o parámetros
+    ip_address = db.Column(db.String(45), nullable=True)              # Soporta IPv4 e IPv6
+    created_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=False, index=True)
+
+    # Relación con usuario
+    user = db.relationship('User', foreign_keys=[user_id], backref=db.backref('audit_records', lazy='dynamic'))
+
+    def __repr__(self):
+        return f"<AuditLog #{self.id} {self.action} on {self.module} by {self.user_email or 'System'}>"

backend/app/models/enrollment.py

@@ -0,0 +1,53 @@
+from app import db
+from datetime import datetime
+
+
+class StudentEnrollment(db.Model):
+    """Association table: student (User) ↔ Commission enrollment managed by Bedelía."""
+    __tablename__ = 'student_enrollments'
+
+    id = db.Column(db.Integer, primary_key=True)
+    student_id = db.Column(
+        db.Integer,
+        db.ForeignKey('users.id', ondelete='CASCADE'),
+        nullable=False,
+        index=True
+    )
+    commission_id = db.Column(
+        db.Integer,
+        db.ForeignKey('commissions.id', ondelete='CASCADE'),
+        nullable=False,
+        index=True
+    )
+    status = db.Column(db.String(20), nullable=False, default='activo')  # activo | retirado | condicional
+    enrolled_at = db.Column(db.DateTime, default=datetime.utcnow, nullable=False)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+    notes = db.Column(db.Text, nullable=True)
+    allow_same_day_exception = db.Column(db.Boolean, default=False, nullable=True)
+    exception_reason = db.Column(db.String(255), nullable=True)
+
+    # Unique constraint: a student can only be enrolled once per commission
+    __table_args__ = (
+        db.UniqueConstraint('student_id', 'commission_id', name='uq_student_commission'),
+    )
+
+    # Relationships
+    student = db.relationship('User', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
+    commission = db.relationship('Commission', backref=db.backref('enrollments', lazy='dynamic', cascade='all, delete-orphan'))
+
+    def to_dict(self):
+        return {
+            'id': self.id,
+            'student_id': self.student_id,
+            'student_name': self.student.name if self.student else None,
+            'student_email': self.student.email if self.student else None,
+            'commission_id': self.commission_id,
+            'status': self.status,
+            'enrolled_at': self.enrolled_at.isoformat() if self.enrolled_at else None,
+            'notes': self.notes,
+            'allow_same_day_exception': bool(self.allow_same_day_exception),
+            'exception_reason': self.exception_reason
+        }
+
+    def __repr__(self):
+        return f'<StudentEnrollment student={self.student_id} commission={self.commission_id} status={self.status}>'

backend/app/models/genetic_algorithm.py

@@ -46,10 +46,31 @@ class Individual:
         self.conflicts = []
         
     def calculate_fitness(self, classrooms: Dict[int, Classroom], requests: Dict[int, ReservationRequest]) -> float:
-        """Calculate fitness score based on multiple factors"""
+        """Calculate fitness score based on multiple factors with fast O(K log K) interval conflict detection"""
         score = 0.0
         self.conflicts = []
         
+        # Pre-group genes by classroom to calculate conflicts in O(K log K)
+        by_classroom = {}
+        for g in self.genes:
+            by_classroom.setdefault(g.classroom_id, []).append(g)
+
+        conflict_count_by_id = {}
+        for cid, room_genes in by_classroom.items():
+            if len(room_genes) <= 1:
+                continue
+            # Sort chronologically
+            room_genes.sort(key=lambda x: x.start_time)
+            for i in range(len(room_genes)):
+                g_i = room_genes[i]
+                for j in range(i + 1, len(room_genes)):
+                    g_j = room_genes[j]
+                    if g_i.end_time > g_j.start_time:
+                        conflict_count_by_id[id(g_i)] = conflict_count_by_id.get(id(g_i), 0) + 1
+                        conflict_count_by_id[id(g_j)] = conflict_count_by_id.get(id(g_j), 0) + 1
+                    else:
+                        break  # Gene j and subsequent ones start later than gene i ends
+
         for gene in self.genes:
             classroom = classrooms.get(gene.classroom_id)
             request = requests.get(gene.commission_id)
@@ -66,20 +87,21 @@ class Individual:
             score += time_score * 0.3
             
             # Factor 3: Conflict penalty (20% weight)
-            conflict_score = self._calculate_conflict_penalty(gene, self.genes)
+            c_count = conflict_count_by_id.get(id(gene), 0)
+            if c_count > 0:
+                conflict_score = -c_count * 0.5
+                self.conflicts.append({
+                    'gene': gene,
+                    'conflict_type': 'time_overlap'
+                })
+            else:
+                conflict_score = 1.0
             score += conflict_score * 0.2
             
             # Factor 4: Resource matching (10% weight)
             resource_score = self._calculate_resource_score(classroom, request.subject_requirements)
             score += resource_score * 0.1
                 
-            # Store conflicts for debugging
-            if conflict_score < 0:
-                self.conflicts.append({
-                    'gene': gene,
-                    'conflict_type': 'time_overlap'
-                })
-                
         self.fitness = score
         return score
     
@@ -89,7 +111,7 @@ class Individual:
             return 0.0  # Overfilled classroom
         
         # Calculate efficiency: closer capacity match = higher score
-        waste_ratio = (classroom.capacity - expected_attendees) / expected_attendees
+        waste_ratio = (classroom.capacity - expected_attendees) / max(1, expected_attendees)
         if waste_ratio <= 0.1:  # Less than 10% waste
             return 1.0
         elif waste_ratio <= 0.3:  # Less than 30% waste
@@ -107,12 +129,12 @@ class Individual:
         if time_diff <= 0.5:  # Within 30 minutes
             return 1.0
         elif time_diff <= request.flexibility_hours:  # Within flexible window
-            return 0.8 - (time_diff / request.flexibility_hours) * 0.3
+            return 0.8 - (time_diff / max(1, request.flexibility_hours)) * 0.3
         else:
             return max(0.0, 0.5 - (time_diff - request.flexibility_hours) * 0.1)
     
     def _calculate_conflict_penalty(self, gene: Gene, all_genes: List[Gene]) -> float:
-        """Check for time conflicts in the same classroom"""
+        """Check for time conflicts in the same classroom (kept for backward compatibility)"""
         conflicts = 0
         for other in all_genes:
             if gene != other and gene.classroom_id == other.classroom_id:
@@ -127,9 +149,6 @@ class Individual:
         """Check if classroom meets subject requirements"""
         if not requirements:
             return 1.0
-            
-        # This would need to be implemented based on actual classroom resources
-        # For now, return a default score
         return 0.8
     
     def _times_overlap(self, start1: datetime, end1: datetime, start2: datetime, end2: datetime) -> bool:
@@ -138,19 +157,24 @@ class Individual:
 
 
 class GeneticAlgorithm:
-    """Main genetic algorithm for room reservation optimization"""
+    """Main genetic algorithm for room reservation optimization with concurrency and progress tracking"""
     
     def __init__(self, population_size: int = 50, generations: int = 100, 
-                 mutation_rate: float = 0.1, crossover_rate: float = 0.8):
+                 mutation_rate: float = 0.1, crossover_rate: float = 0.8,
+                 workers: int = 4):
         self.population_size = population_size
         self.generations = generations
         self.mutation_rate = mutation_rate
         self.crossover_rate = crossover_rate
+        self.workers = max(1, workers)
         
     def optimize_reservations(self, requests: List[ReservationRequest], 
                            available_classrooms: List[Classroom],
-                           start_date: datetime, end_date: datetime) -> Individual:
+                           start_date: datetime, end_date: datetime,
-        """Run genetic algorithm to find optimal reservation schedule"""
+                           progress_callback=None) -> Individual:
+        """Run genetic algorithm with high concurrency to find optimal reservation schedule"""
+        import concurrent.futures
+
         classrooms_dict = {c.id: c for c in available_classrooms}
         requests_dict = {r.commission_id: r for r in requests}
         
@@ -159,18 +183,29 @@ class GeneticAlgorithm:
         
         # Evolve population
         for generation in range(self.generations):
-            # Calculate fitness for all individuals
+            # Calculate fitness for all individuals concurrently when workers > 1
-            for individual in population:
+            if self.workers > 1 and len(population) > 10:
-                individual.calculate_fitness(classrooms_dict, requests_dict)
+                with concurrent.futures.ThreadPoolExecutor(max_workers=self.workers) as executor:
+                    futures = [executor.submit(ind.calculate_fitness, classrooms_dict, requests_dict) for ind in population]
+                    concurrent.futures.wait(futures)
+            else:
+                for individual in population:
+                    individual.calculate_fitness(classrooms_dict, requests_dict)
             
             # Sort by fitness (best first)
             population.sort(key=lambda x: x.fitness, reverse=True)
             
+            # Report progress if callback is provided
+            if progress_callback:
+                pct = int(((generation + 1) / self.generations) * 100)
+                best_fit = population[0].fitness if population else 0.0
+                progress_callback(generation + 1, self.generations, pct, best_fit)
+            
             # Create new generation
             new_population = []
             
             # Elitism: keep best 10%
-            elite_size = int(self.population_size * 0.1)
+            elite_size = max(2, int(self.population_size * 0.1))
             new_population.extend(population[:elite_size])
             
             # Crossover and mutation for remaining
@@ -196,7 +231,9 @@ class GeneticAlgorithm:
             
             population = new_population[:self.population_size]
         
-        # Return best individual from final generation
+        # Calculate fitness for final generation
+        for individual in population:
+            individual.calculate_fitness(classrooms_dict, requests_dict)
         population.sort(key=lambda x: x.fitness, reverse=True)
         return population[0]
     
@@ -284,13 +321,14 @@ class GeneticAlgorithm:
 class ReservationOptimizer:
     """High-level interface for the reservation optimization system"""
     
-    def __init__(self):
+    def __init__(self, population_size: int = 50, generations: int = 100, workers: int = 4):
-        self.ga = GeneticAlgorithm()
+        self.ga = GeneticAlgorithm(population_size=population_size, generations=generations, workers=workers)
     
     def optimize_schedule(self, commission_ids: List[int], 
                          admin_user_id: int,
                          start_date: datetime = None,
-                         end_date: datetime = None) -> Dict:
+                         end_date: datetime = None,
+                         progress_callback = None) -> Dict:
         """Optimize reservation schedule for given commissions"""
         
         # Default date range if not provided
@@ -325,7 +363,7 @@ class ReservationOptimizer:
         classrooms = Classroom.query.filter_by(is_active=True).all()
         
         # Run genetic algorithm
-        best_individual = self.ga.optimize_reservations(requests, classrooms, start_date, end_date)
+        best_individual = self.ga.optimize_reservations(requests, classrooms, start_date, end_date, progress_callback=progress_callback)
         
         # Convert to reservation format
         optimized_reservations = []

backend/app/models/reservation.py

@@ -95,8 +95,8 @@ class Reservation(db.Model):
     @property
     def is_virtual(self):
         """Verifica si la reserva es virtual por aula o por contar con enlace virtual"""
-        if self.classroom and self.classroom.is_virtual:
+        if self.classroom:
-            return True
+            return bool(self.classroom.is_virtual)
         if self.effective_virtual_link:
             return True
         return False

backend/app/models/role.py

@@ -72,6 +72,13 @@ SYSTEM_MODULES = [
         'name_en': 'Occupancy Metrics',
         'icon': 'bi-graph-up',
         'description': 'Visualización y análisis de porcentajes de ocupación por aula (día, semana y mes).'
+    },
+    {
+        'id': 'enrollment',
+        'name': 'Inscripciones y Cursadas',
+        'name_en': 'Enrollments & Courses',
+        'icon': 'bi-diagram-3',
+        'description': 'Gestión de inscripciones de alumnos a comisiones y asignación de docentes.'
     }
 ]
 

backend/app/models/setting.py

@@ -0,0 +1,50 @@
+from app import db
+from datetime import datetime
+
+class SystemSetting(db.Model):
+    """
+    Parámetros de configuración del sistema persistentes en base de datos.
+    Permite almacenar enlaces de integración (e.g. Google Sheets), flags globales y metadatos.
+    """
+    __tablename__ = 'system_settings'
+
+    id = db.Column(db.Integer, primary_key=True)
+    key = db.Column(db.String(100), unique=True, nullable=False, index=True)
+    value = db.Column(db.Text, nullable=True)
+    description = db.Column(db.String(255), nullable=True)
+    updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
+
+    @classmethod
+    def get_value(cls, key, default=None):
+        try:
+            record = cls.query.filter_by(key=key).first()
+            if record and record.value is not None and record.value.strip() != '':
+                return record.value
+        except Exception:
+            pass
+        return default
+
+    @classmethod
+    def set_value(cls, key, value, description=None):
+        record = cls.query.filter_by(key=key).first()
+        if not record:
+            record = cls(key=key, value=value, description=description)
+            db.session.add(record)
+        else:
+            record.value = value
+            if description:
+                record.description = description
+            record.updated_at = datetime.utcnow()
+        db.session.commit()
+        return record
+
+    def to_dict(self):
+        return {
+            'key': self.key,
+            'value': self.value,
+            'description': self.description,
+            'updated_at': self.updated_at.isoformat() if self.updated_at else None
+        }
+
+    def __repr__(self):
+        return f'<SystemSetting {self.key}={self.value}>'

backend/app/models/subject.py

@@ -12,6 +12,7 @@ class Subject(db.Model):
     credits = db.Column(db.Integer, nullable=False, default=4)
     career_id = db.Column(db.Integer, db.ForeignKey('careers.id', ondelete='SET NULL'), nullable=True)
     is_active = db.Column('active', db.Boolean, default=True, nullable=False)  # Maps to active column in DB
+    is_short_course = db.Column(db.Boolean, default=False, nullable=True)  # True para talleres/cursos cortos
     created_at = db.Column(db.DateTime, default=datetime.utcnow)
     updated_at = db.Column(db.DateTime, default=datetime.utcnow, onupdate=datetime.utcnow)
     
@@ -30,6 +31,7 @@ class Subject(db.Model):
             'career_id': self.career_id,
             'career_name': self.career_obj.name if self.career_obj else None,
             'is_active': self.is_active,
+            'is_short_course': bool(self.is_short_course),
             'created_at': self.created_at.isoformat() if self.created_at else None,
             'updated_at': self.updated_at.isoformat() if self.updated_at else None
         }
@@ -73,6 +75,35 @@ class Commission(db.Model):
     def teacher_name(self):
         return f"{self.teacher.first_name} {self.teacher.last_name}" if self.teacher else "TBD"
 
+    @property
+    def teachers(self):
+        """Retorna la lista de docentes asignados.
+        Si teachers_association tiene registros, los retorna ordenados (Titular primero).
+        Si está vacía pero teacher_id está configurado, devuelve el docente titular.
+        """
+        if hasattr(self, 'teachers_association') and self.teachers_association and len(self.teachers_association) > 0:
+            res = [ta.to_dict() for ta in self.teachers_association]
+            res.sort(key=lambda x: (not x.get('is_primary', False), x.get('role', '') != 'Titular'))
+            return res
+        if self.teacher:
+            return [{
+                'id': 0,
+                'commission_id': self.id,
+                'user_id': self.teacher.id,
+                'name': self.teacher.name,
+                'email': self.teacher.email,
+                'role': 'Titular',
+                'is_primary': True
+            }]
+        return []
+
+    @property
+    def teacher_names(self):
+        t_list = self.teachers
+        if not t_list:
+            return "Sin asignar"
+        return ", ".join([f"{t['name']} ({t['role']})" for t in t_list])
+    
     # Unique constraint
     __table_args__ = (db.UniqueConstraint('subject_id', 'code', 'semester', 'year'),)
     
@@ -84,7 +115,10 @@ class Commission(db.Model):
             'code': self.code,
             'semester': self.semester,
             'year': self.year,
+            'teacher_id': self.teacher_id,
             'teacher_name': self.teacher_name,
+            'teachers': self.teachers,
+            'teacher_names': self.teacher_names,
             'max_students': self.max_students,
             'current_students': self.current_students,
             'schedule': self.schedule,
@@ -93,6 +127,7 @@ class Commission(db.Model):
             'active': self.active,
             'created_at': self.created_at.isoformat() if self.created_at else None,
             'updated_at': self.updated_at.isoformat() if self.updated_at else None,
+            'full_code': self.get_full_code(),
             'subject': self.subject.to_dict() if self.subject else None
         }
     
@@ -115,3 +150,36 @@ class Commission(db.Model):
     
     def __repr__(self):
         return f'<Commission {self.get_full_code()}>'
+
+
+class CommissionTeacher(db.Model):
+    """Modelo de asignación de múltiples docentes a una comisión (Co-Docencia / Cátedra)."""
+    __tablename__ = 'commission_teachers'
+    
+    id = db.Column(db.Integer, primary_key=True)
+    commission_id = db.Column(db.Integer, db.ForeignKey('commissions.id', ondelete='CASCADE'), nullable=False, index=True)
+    user_id = db.Column(db.Integer, db.ForeignKey('users.id', ondelete='CASCADE'), nullable=False, index=True)
+    role = db.Column(db.String(50), default='Titular', nullable=False)  # Titular, Adjunto, JTP, Ayudante
+    is_primary = db.Column(db.Boolean, default=False, nullable=False)
+    created_at = db.Column(db.DateTime, default=datetime.utcnow)
+    
+    # Relationships
+    commission = db.relationship('Commission', backref=db.backref('teachers_association', cascade='all, delete-orphan', lazy='joined'))
+    teacher = db.relationship('User', backref=db.backref('commission_assignments', cascade='all, delete-orphan', lazy='joined'))
+    
+    __table_args__ = (db.UniqueConstraint('commission_id', 'user_id'),)
+
+    def to_dict(self):
+        return {
+            'id': self.id,
+            'commission_id': self.commission_id,
+            'user_id': self.user_id,
+            'name': self.teacher.name if self.teacher else 'Docente',
+            'email': self.teacher.email if self.teacher else '',
+            'role': self.role or 'Titular',
+            'is_primary': self.is_primary,
+            'created_at': self.created_at.isoformat() if self.created_at else None
+        }
+
+    def __repr__(self):
+        return f'<CommissionTeacher Commission:{self.commission_id} User:{self.user_id} Role:{self.role}>'

backend/app/models/user.py

@@ -1,9 +1,8 @@
-from app import db, login_manager
+from app import db
-from flask_login import UserMixin
 from werkzeug.security import generate_password_hash, check_password_hash
 from datetime import datetime
 
-class User(UserMixin, db.Model):
+class User(db.Model):
     __tablename__ = 'users'
     
     id = db.Column(db.Integer, primary_key=True)
@@ -18,16 +17,30 @@ class User(UserMixin, db.Model):
     theme_preference = db.Column(db.String(10), default='auto', nullable=False)
     role_id = db.Column(db.Integer, db.ForeignKey('roles.id', ondelete='SET NULL'), nullable=True)
     
-    # Virtual fields for future compatibility
+    # Extended personal, contact and identity document fields
-    @property
+    first_name = db.Column(db.String(100), nullable=True)
-    def first_name(self):
+    last_name = db.Column(db.String(100), nullable=True)
+    phone = db.Column(db.String(50), nullable=True)
+    personal_email = db.Column(db.String(255), nullable=True)
+    address = db.Column(db.String(255), nullable=True)
+    document_type = db.Column(db.String(20), default='DNI', nullable=True)
+    document_number = db.Column(db.String(30), nullable=True, index=True)
+    
+    def get_first_name(self):
+        if self.first_name:
+            return self.first_name
         return self.name.split()[0] if self.name else ''
     
-    @property
+    def get_last_name(self):
-    def last_name(self):
+        if self.last_name:
-        parts = self.name.split()
+            return self.last_name
+        parts = self.name.split() if self.name else []
         return ' '.join(parts[1:]) if len(parts) > 1 else ''
 
+    def get_formatted_document(self):
+        from app.constants.document_types import format_document
+        return format_document(self.document_type, self.document_number)
+    
     # Relationships
     reservations = db.relationship('Reservation', backref='user', lazy=True, cascade='all, delete-orphan')
     
@@ -45,6 +58,43 @@ class User(UserMixin, db.Model):
             return True
         return str(self.role).upper() in ['ADMIN', 'ADMINISTRADOR']
         
+    def get_institutional_role(self):
+        """Returns normalized institutional role: 'admin', 'bedelia', 'docente', 'alumno'"""
+        raw = ''
+        if self.role_obj and self.role_obj.name:
+            raw = self.role_obj.name.lower().strip()
+        elif self.role:
+            raw = str(self.role).lower().strip()
+            
+        if 'admin' in raw:
+            return 'admin'
+        if 'bedel' in raw:
+            return 'bedelia'
+        if 'docent' in raw or 'prof' in raw or 'teacher' in raw:
+            return 'docente'
+        if 'alumn' in raw or 'estud' in raw or 'student' in raw:
+            return 'alumno'
+        return 'docente'
+
+    def is_bedelia(self):
+        return self.get_institutional_role() == 'bedelia'
+
+    def is_docente(self):
+        return self.get_institutional_role() == 'docente'
+
+    def is_alumno(self):
+        return self.get_institutional_role() == 'alumno'
+
+    @property
+    def role_badge_display(self):
+        role_map = {
+            'admin': {'label': 'Administrador', 'class': 'badge-admin', 'icon': 'bi-shield-check', 'color': 'primary'},
+            'bedelia': {'label': 'Bedelía', 'class': 'badge-bedelia', 'icon': 'bi-building-gear', 'color': 'warning'},
+            'docente': {'label': 'Profesor / Docente', 'class': 'badge-docente', 'icon': 'bi-person-video3', 'color': 'info'},
+            'alumno': {'label': 'Alumno / Estudiante', 'class': 'badge-alumno', 'icon': 'bi-mortarboard', 'color': 'success'}
+        }
+        return role_map.get(self.get_institutional_role(), {'label': self.role or 'Docente', 'class': 'bg-secondary', 'icon': 'bi-person', 'color': 'secondary'})
+
     def has_permission(self, module, min_level='read'):
         """Check if user has granular permission on a given module"""
         if self.is_admin():
@@ -57,6 +107,7 @@ class User(UserMixin, db.Model):
         """Check if user can access the Management / Admin section"""
         return (
             self.is_admin() or 
+            self.is_bedelia() or
             self.has_permission('users', 'read') or 
             self.has_permission('milestone_types', 'read') or
             self.has_permission('import', 'read') or
@@ -95,8 +146,18 @@ class User(UserMixin, db.Model):
         return {
             'id': self.id,
             'email': self.email,
+            'institutional_email': self.email,
+            'personal_email': self.personal_email or '',
             'name': self.name,
+            'first_name': self.get_first_name(),
+            'last_name': self.get_last_name(),
+            'phone': self.phone or '',
+            'address': self.address or '',
+            'document_type': self.document_type or 'DNI',
+            'document_number': self.document_number or '',
+            'document_formatted': self.get_formatted_document(),
             'role': self.role,
+            'role_id': self.role_id,
             'is_active': self.is_active,
             'created_at': self.created_at.isoformat() if self.created_at else None,
             'last_login': self.last_login.isoformat() if self.last_login else None,
@@ -106,8 +167,3 @@ class User(UserMixin, db.Model):
     
 def __repr__(self):
         return f'<User {self.email}>'
-
-@login_manager.user_loader
-def load_user(user_id):
-    """Load user from database by ID"""
-    return User.query.get(int(user_id))

backend/app/repositories/__init__.py

@@ -0,0 +1,12 @@
+"""Módulo de Repositorios para persistencia y consultas desacopladas."""
+from app.repositories.base_repository import BaseRepository
+from app.repositories.classroom_repository import ClassroomRepository
+from app.repositories.reservation_repository import ReservationRepository
+from app.repositories.user_repository import UserRepository
+
+__all__ = [
+    'BaseRepository',
+    'ClassroomRepository',
+    'ReservationRepository',
+    'UserRepository'
+]

backend/app/repositories/base_repository.py

@@ -0,0 +1,47 @@
+from typing import TypeVar, Generic, Type, Optional, List
+from app import db
+
+T = TypeVar('T')
+
+class BaseRepository(Generic[T]):
+    """Repositorio base con operaciones CRUD genéricas y seguras."""
+    
+    def __init__(self, model_class: Type[T]):
+        self.model_class = model_class
+
+    def get_by_id(self, entity_id: int) -> Optional[T]:
+        """Obtiene una entidad por su ID numérico."""
+        if not entity_id:
+            return None
+        return db.session.get(self.model_class, entity_id)
+
+    def get_all(self, order_by=None) -> List[T]:
+        """Obtiene todas las entidades opcionalmente ordenadas."""
+        query = self.model_class.query
+        if order_by is not None:
+            query = query.order_by(order_by)
+        return query.all()
+
+    def save(self, entity: T, commit: bool = True) -> T:
+        """Agrega o actualiza una entidad en la sesión."""
+        db.session.add(entity)
+        if commit:
+            db.session.commit()
+        return entity
+
+    def delete(self, entity: T, commit: bool = True) -> bool:
+        """Elimina una entidad de la sesión."""
+        if entity:
+            db.session.delete(entity)
+            if commit:
+                db.session.commit()
+            return True
+        return False
+
+    def commit(self):
+        """Confirma la transacción actual."""
+        db.session.commit()
+
+    def rollback(self):
+        """Revierte la transacción actual."""
+        db.session.rollback()

backend/app/repositories/classroom_repository.py

@@ -0,0 +1,59 @@
+from typing import Optional, List
+from sqlalchemy import func
+from app.models.classroom import Classroom
+from app.repositories.base_repository import BaseRepository
+from app import db
+
+class ClassroomRepository(BaseRepository[Classroom]):
+    """Repositorio especializado en operaciones de persistencia y filtrado de aulas."""
+
+    def __init__(self):
+        super().__init__(Classroom)
+
+    def get_by_code_and_building(self, building_id: int, code: str, floor: str) -> Optional[Classroom]:
+        """Busca un aula por edificio, código y piso para verificar duplicados."""
+        return Classroom.query.filter_by(
+            building_id=building_id,
+            code=code.strip(),
+            floor=str(floor).strip()
+        ).first()
+
+    def get_active_classrooms(self, building_id: Optional[int] = None, floor: Optional[str] = None,
+                              only_virtual: bool = False, only_physical: bool = False) -> List[Classroom]:
+        """Retorna aulas activas con filtros opcionales de edificio, piso y modalidad."""
+        query = Classroom.query.filter_by(is_active=True)
+
+        if building_id:
+            query = query.filter_by(building_id=building_id)
+
+        if floor:
+            query = query.filter_by(floor=str(floor).strip())
+
+        classrooms = query.order_by(Classroom.floor.asc(), Classroom.code.asc()).all()
+
+        if only_virtual:
+            return [c for c in classrooms if c.is_virtual]
+        elif only_physical:
+            return [c for c in classrooms if not c.is_virtual]
+
+        return classrooms
+
+    def get_virtual_classrooms(self) -> List[Classroom]:
+        """Obtiene todas las salas virtuales activas."""
+        return [c for c in self.get_active_classrooms() if c.is_virtual]
+
+    def get_physical_classrooms(self) -> List[Classroom]:
+        """Obtiene todas las aulas físicas activas."""
+        return [c for c in self.get_active_classrooms() if not c.is_virtual]
+
+    def search(self, term: str) -> List[Classroom]:
+        """Búsqueda de aulas por código, edificio o descripción."""
+        if not term:
+            return self.get_all(order_by=Classroom.code.asc())
+        term_clean = f"%{term.strip()}%"
+        return Classroom.query.filter(
+            Classroom.is_active == True,
+            (Classroom.code.ilike(term_clean)) |
+            (Classroom.building.ilike(term_clean)) |
+            (Classroom.description.ilike(term_clean))
+        ).order_by(Classroom.code.asc()).all()

backend/app/repositories/reservation_repository.py

@@ -0,0 +1,80 @@
+from typing import Optional, List
+from datetime import datetime, date, time
+from sqlalchemy.orm import joinedload
+from sqlalchemy import and_, or_
+from app.models.reservation import Reservation, ReservationStatus
+from app.repositories.base_repository import BaseRepository
+from app import db
+
+class ReservationRepository(BaseRepository[Reservation]):
+    """Repositorio para la persistencia y consulta de reservas de aulas."""
+
+    def __init__(self):
+        super().__init__(Reservation)
+
+    def find_conflicts(self, classroom_id: int, start_time: datetime, end_time: datetime,
+                       exclude_reservation_id: Optional[int] = None) -> List[Reservation]:
+        """
+        Encuentra reservas activas que se solapan en el mismo aula y franja horaria.
+        Condición de solapamiento: (start_time < existing.end_time) AND (end_time > existing.start_time).
+        """
+        query = Reservation.query.filter(
+            Reservation.classroom_id == classroom_id,
+            Reservation.status != ReservationStatus.CANCELLED.value,
+            Reservation.start_time < end_time,
+            Reservation.end_time > start_time
+        )
+
+        if exclude_reservation_id:
+            query = query.filter(Reservation.id != exclude_reservation_id)
+
+        return query.all()
+
+    def get_by_date_range(self, start_dt: datetime, end_dt: datetime,
+                          classroom_id: Optional[int] = None) -> List[Reservation]:
+        """Obtiene reservas dentro de una ventana temporal con carga ansiosa de relaciones."""
+        query = Reservation.query.options(
+            joinedload(Reservation.classroom),
+            joinedload(Reservation.commission),
+            joinedload(Reservation.user)
+        ).filter(
+            Reservation.start_time >= start_dt,
+            Reservation.start_time <= end_dt,
+            Reservation.status != ReservationStatus.CANCELLED.value
+        )
+
+        if classroom_id:
+            query = query.filter(Reservation.classroom_id == classroom_id)
+
+        return query.order_by(Reservation.start_time.asc()).all()
+
+    def get_by_teacher(self, teacher_id: int) -> List[Reservation]:
+        """Obtiene reservas asignadas a un docente."""
+        return Reservation.query.filter_by(
+            user_id=teacher_id
+        ).order_by(Reservation.start_time.desc()).all()
+
+    def get_by_commission(self, commission_id: int) -> List[Reservation]:
+        """Obtiene todas las reservas asociadas a una comisión."""
+        return Reservation.query.filter_by(
+            commission_id=commission_id
+        ).order_by(Reservation.start_time.asc()).all()
+
+    def find_teacher_conflicts(self, teacher_id: int, start_time: datetime, end_time: datetime,
+                               exclude_reservation_id: Optional[int] = None) -> List[Reservation]:
+        """
+        Encuentra reservas activas donde el docente ya está asignado en la misma franja horaria.
+        Condición de solapamiento: (start_time < existing.end_time) AND (end_time > existing.start_time).
+        """
+        query = Reservation.query.options(
+            joinedload(Reservation.classroom),
+            joinedload(Reservation.commission)
+        ).filter(
+            Reservation.user_id == teacher_id,
+            Reservation.status != ReservationStatus.CANCELLED.value,
+            Reservation.start_time < end_time,
+            Reservation.end_time > start_time
+        )
+        if exclude_reservation_id:
+            query = query.filter(Reservation.id != exclude_reservation_id)
+        return query.all()

backend/app/repositories/user_repository.py

@@ -0,0 +1,34 @@
+from typing import Optional, List
+from sqlalchemy import func
+from app.models.user import User
+from app.repositories.base_repository import BaseRepository
+
+class UserRepository(BaseRepository[User]):
+    """Repositorio para la gestión de usuarios, credenciales y roles."""
+
+    def __init__(self):
+        super().__init__(User)
+
+    def get_by_email(self, email: str) -> Optional[User]:
+        """Obtiene un usuario por su dirección de email normalizada."""
+        if not email:
+            return None
+        return User.query.filter(func.lower(User.email) == email.strip().lower()).first()
+
+    def get_active_users(self) -> List[User]:
+        """Obtiene todos los usuarios con cuenta activa."""
+        return User.query.filter_by(is_active=True).order_by(User.name.asc()).all()
+
+    def get_by_role(self, role_name: str) -> List[User]:
+        """Obtiene usuarios por nombre de rol."""
+        return User.query.filter(
+            User.is_active == True,
+            func.lower(User.role) == role_name.strip().lower()
+        ).order_by(User.name.asc()).all()
+
+    def get_teachers(self) -> List[User]:
+        """Obtiene lista de docentes y profesores activos."""
+        return User.query.filter(
+            User.is_active == True,
+            User.role.in_(['TEACHER', 'DOCENTE', 'PROFESOR', 'teacher', 'docente'])
+        ).order_by(User.name.asc()).all()

backend/app/routes/__init__.py

@@ -5,5 +5,6 @@ from .buildings import buildings_bp
 from .schedule import schedule_bp
 from .genetic_algorithm import genetic_bp, genetic_web_bp
 from .admin import admin_bp
+from .my_subjects import my_subjects_bp
 
-__all__ = ['main_bp', 'auth_bp', 'classrooms_bp', 'buildings_bp', 'schedule_bp', 'genetic_bp', 'genetic_web_bp', 'admin_bp']
+__all__ = ['main_bp', 'auth_bp', 'classrooms_bp', 'buildings_bp', 'schedule_bp', 'genetic_bp', 'genetic_web_bp', 'admin_bp', 'my_subjects_bp']

backend/app/routes/admin.py

@@ -5,6 +5,7 @@ from app import db
 from app.models.user import User
 from app.models.role import Role, Permission, SYSTEM_MODULES, ACCESS_LEVELS
 from app.models.milestone import MilestoneType, AcademicMilestone, BASE_MILESTONE_TYPES
+from app.models.audit_log import AuditLog
 from app.utils.decorators import admin_required, permission_required
 from sqlalchemy import or_
 import re
@@ -1116,4 +1117,303 @@ def occupancy_metrics():
     )
 
 
+# ---------------------------------------------------------
+# AUDIT LOGS
+# ---------------------------------------------------------
 
+@admin_bp.route('/audit-logs')
+@admin_required
+def audit_logs():
+    """Vista de bitácora de auditoría del sistema"""
+    page = request.args.get('page', 1, type=int)
+    module_filter = request.args.get('module', '').strip()
+    action_filter = request.args.get('action', '').strip()
+    search = request.args.get('search', '').strip()
+    per_page = 20
+
+    query = AuditLog.query
+
+    if module_filter:
+        query = query.filter(AuditLog.module == module_filter)
+    if action_filter:
+        query = query.filter(AuditLog.action == action_filter)
+    if search:
+        query = query.filter(
+            or_(
+                AuditLog.user_email.ilike(f'%{search}%'),
+                AuditLog.details.ilike(f'%{search}%'),
+                AuditLog.ip_address.ilike(f'%{search}%')
+            )
+        )
+
+    pagination = query.order_by(AuditLog.created_at.desc()).paginate(page=page, per_page=per_page, error_out=False)
+    
+    # Módulos y acciones únicas para los selectores de filtro
+    modules = [r[0] for r in db.session.query(AuditLog.module).distinct().all() if r[0]]
+    actions = [r[0] for r in db.session.query(AuditLog.action).distinct().all() if r[0]]
+
+    return render_template(
+        'admin/audit_logs.html',
+        pagination=pagination,
+        audit_logs=pagination.items,
+        modules=modules,
+        actions=actions,
+        current_module=module_filter,
+        current_action=action_filter,
+        search=search
+    )
+
+
+
+
+# ---------------------------------------------------------
+# 5. GESTION DE COMISIONES (BEDELIA / ADMIN)
+# ---------------------------------------------------------
+
+@admin_bp.route('/commissions')
+@login_required
+def commissions_list():
+    """List all commissions with filters - accessible by Bedelia and Admin"""
+    if not (current_user.has_permission('enrollment', 'read_write') or current_user.is_admin() or current_user.is_bedelia()):
+        abort(403)
+
+    from app.models.subject import Subject, Commission
+    from app.models.user import User
+
+    search = request.args.get('search', '').strip()
+    subject_filter = request.args.get('subject_id', type=int)
+    teacher_filter = request.args.get('teacher_id', type=int)
+    shift_filter = request.args.get('shift', '').strip()
+    active_filter = request.args.get('active', 'true').strip()
+    page = request.args.get('page', 1, type=int)
+    per_page = 20
+
+    query = Commission.query.join(Subject, Commission.subject_id == Subject.id)
+
+    if search:
+        query = query.filter(
+            or_(
+                Commission.code.ilike(f'%{search}%'),
+                Subject.name.ilike(f'%{search}%'),
+                Subject.code.ilike(f'%{search}%'),
+            )
+        )
+    if subject_filter:
+        query = query.filter(Commission.subject_id == subject_filter)
+    if teacher_filter:
+        query = query.filter(Commission.teacher_id == teacher_filter)
+    if shift_filter:
+        query = query.filter(Commission.shift.ilike(f'%{shift_filter}%'))
+    if active_filter in ['true', 'false']:
+        query = query.filter(Commission.active == (active_filter == 'true'))
+
+    pagination = query.order_by(Subject.name.asc(), Commission.code.asc()).paginate(
+        page=page, per_page=per_page, error_out=False
+    )
+
+    subjects = Subject.query.filter_by(is_active=True).order_by(Subject.name.asc()).all()
+    teachers = User.query.filter(
+        or_(User.role.ilike('%DOCENTE%'), User.role.ilike('%docent%'), User.role.ilike('%ADMIN%'))
+    ).filter_by(is_active=True).order_by(User.name.asc()).all()
+
+    can_edit = (
+        current_user.has_permission('academic', 'read_write') or
+        current_user.is_admin() or
+        current_user.is_bedelia()
+    )
+
+    return render_template(
+        'admin/commissions/list.html',
+        commissions=pagination.items,
+        pagination=pagination,
+        subjects=subjects,
+        teachers=teachers,
+        search=search,
+        subject_filter=subject_filter,
+        teacher_filter=teacher_filter,
+        shift_filter=shift_filter,
+        active_filter=active_filter,
+        can_edit=can_edit
+    )
+
+
+@admin_bp.route('/commissions/<int:id>')
+@login_required
+def commission_detail(id):
+    """Detail view of a commission: enrolled students and teacher assignment"""
+    if not (current_user.has_permission('enrollment', 'read_write') or current_user.is_admin() or current_user.is_bedelia()):
+        abort(403)
+
+    from app.models.subject import Commission
+    from app.models.enrollment import StudentEnrollment
+    from app.models.user import User
+
+    commission = Commission.query.get_or_404(id)
+    enrollments = (
+        StudentEnrollment.query
+        .filter_by(commission_id=id)
+        .order_by(StudentEnrollment.enrolled_at.asc())
+        .all()
+    )
+
+    teachers = User.query.filter(
+        or_(User.role.ilike('%DOCENTE%'), User.role.ilike('%docent%'))
+    ).filter_by(is_active=True).order_by(User.name.asc()).all()
+
+    students = User.query.filter(
+        or_(User.role.ilike('%ALUMNO%'), User.role.ilike('%alumn%'), User.role.ilike('%estud%'))
+    ).filter_by(is_active=True).order_by(User.name.asc()).all()
+
+    enrolled_ids = {e.student_id for e in enrollments}
+    can_edit = (
+        current_user.has_permission('academic', 'read_write') or
+        current_user.is_admin() or
+        current_user.is_bedelia()
+    )
+
+    return render_template(
+        'admin/commissions/detail.html',
+        commission=commission,
+        enrollments=enrollments,
+        teachers=teachers,
+        students=students,
+        enrolled_ids=enrolled_ids,
+        can_edit=can_edit
+    )
+
+
+@admin_bp.route('/commissions/<int:id>/assign-teacher', methods=['POST'])
+@login_required
+def commission_assign_teacher(id):
+    """Assign or change the teacher of a commission"""
+    if not (
+        current_user.has_permission('academic', 'read_write') or
+        current_user.is_admin() or
+        current_user.is_bedelia()
+    ):
+        abort(403)
+
+    from app.models.subject import Commission
+    from app.models.user import User
+
+    commission = Commission.query.get_or_404(id)
+    teacher_id = request.form.get('teacher_id', type=int)
+
+    if teacher_id:
+        teacher = User.query.get(teacher_id)
+        if not teacher or not teacher.is_active:
+            flash(_('El docente seleccionado no existe o esta inactivo.'), 'error')
+            return redirect(url_for('admin.commission_detail', id=id))
+        commission.teacher_id = teacher_id
+        db.session.commit()
+        flash(_('Docente asignado exitosamente a la comision.'), 'success')
+    else:
+        commission.teacher_id = None
+        db.session.commit()
+        flash(_('Se removio la asignacion de docente.'), 'warning')
+
+    return redirect(url_for('admin.commission_detail', id=id))
+
+
+@admin_bp.route('/commissions/<int:id>/enroll-student', methods=['POST'])
+@login_required
+def commission_enroll_student(id):
+    """Enroll a student into a commission"""
+    if not (
+        current_user.has_permission('academic', 'read_write') or
+        current_user.is_admin() or
+        current_user.is_bedelia()
+    ):
+        abort(403)
+
+    from app.models.subject import Commission
+    from app.models.enrollment import StudentEnrollment
+    from app.models.user import User
+
+    commission = Commission.query.get_or_404(id)
+    student_id = request.form.get('student_id', type=int)
+    notes = request.form.get('notes', '').strip()
+
+    if not student_id:
+        flash(_('Debes seleccionar un alumno.'), 'error')
+        return redirect(url_for('admin.commission_detail', id=id))
+
+    student = User.query.get(student_id)
+    if not student or not student.is_active:
+        flash(_('El alumno seleccionado no existe o esta inactivo.'), 'error')
+        return redirect(url_for('admin.commission_detail', id=id))
+
+    existing = StudentEnrollment.query.filter_by(student_id=student_id, commission_id=id).first()
+    if existing:
+        flash(_('El alumno ya esta inscripto en esta comision.'), 'warning')
+        return redirect(url_for('admin.commission_detail', id=id))
+
+    enrollment = StudentEnrollment(
+        student_id=student_id,
+        commission_id=id,
+        status='activo',
+        notes=notes or None
+    )
+    db.session.add(enrollment)
+    commission.current_students = (commission.current_students or 0) + 1
+    db.session.commit()
+
+    flash(_('Alumno inscripto exitosamente en la comision.'), 'success')
+    return redirect(url_for('admin.commission_detail', id=id))
+
+
+@admin_bp.route('/commissions/<int:id>/unenroll-student/<int:student_id>', methods=['POST'])
+@login_required
+def commission_unenroll_student(id, student_id):
+    """Remove a student from a commission"""
+    if not (
+        current_user.has_permission('academic', 'read_write') or
+        current_user.is_admin() or
+        current_user.is_bedelia()
+    ):
+        abort(403)
+
+    from app.models.subject import Commission
+    from app.models.enrollment import StudentEnrollment
+
+    commission = Commission.query.get_or_404(id)
+    enrollment = StudentEnrollment.query.filter_by(
+        student_id=student_id, commission_id=id
+    ).first_or_404()
+
+    db.session.delete(enrollment)
+    if commission.current_students and commission.current_students > 0:
+        commission.current_students -= 1
+    db.session.commit()
+
+    flash(_('Alumno dado de baja de la comision.'), 'success')
+    return redirect(url_for('admin.commission_detail', id=id))
+
+
+@admin_bp.route('/commissions/<int:id>/update-enrollment/<int:student_id>', methods=['POST'])
+@login_required
+def commission_update_enrollment(id, student_id):
+    """Update enrollment status for a student"""
+    if not (
+        current_user.has_permission('academic', 'read_write') or
+        current_user.is_admin() or
+        current_user.is_bedelia()
+    ):
+        abort(403)
+
+    from app.models.enrollment import StudentEnrollment
+
+    enrollment = StudentEnrollment.query.filter_by(
+        student_id=student_id, commission_id=id
+    ).first_or_404()
+
+    new_status = request.form.get('status', 'activo')
+    if new_status not in ['activo', 'retirado', 'condicional']:
+        new_status = 'activo'
+
+    enrollment.status = new_status
+    enrollment.notes = request.form.get('notes', enrollment.notes or '')
+    db.session.commit()
+
+    flash(_('Estado de inscripcion actualizado.'), 'success')
+    return redirect(url_for('admin.commission_detail', id=id))

backend/app/routes/api/__init__.py

@@ -0,0 +1,12 @@
+"""Paquete de rutas API RESTful (v1) con soporte Stateless JWT."""
+from app.routes.api.auth import api_auth_bp
+from app.routes.api.classrooms import api_classrooms_bp
+from app.routes.api.reservations import api_reservations_bp
+from app.routes.api.optimizer import api_optimizer_bp
+
+__all__ = [
+    'api_auth_bp',
+    'api_classrooms_bp',
+    'api_reservations_bp',
+    'api_optimizer_bp'
+]

backend/app/routes/api/auth.py

@@ -0,0 +1,113 @@
+from flask import Blueprint, request, jsonify, g, make_response
+from pydantic import ValidationError
+import jwt
+
+from app.services.user_service import UserService
+from app.services.jwt_service import JWTService
+from app.schemas.auth_dto import LoginDTO, RefreshTokenDTO
+from app.utils.jwt_decorators import jwt_required
+
+api_auth_bp = Blueprint('api_auth', __name__, url_prefix='/api/v1/auth')
+user_service = UserService()
+
+@api_auth_bp.route('/login', methods=['POST'])
+def login():
+    """
+    Endpoint de autenticación para obtener par de tokens (Access + Refresh).
+    """
+    data = request.get_json(silent=True)
+    if not isinstance(data, dict):
+        return jsonify({'error': 'BadRequest', 'message': 'El cuerpo de la solicitud debe ser un objeto JSON.'}), 400
+    try:
+        dto = LoginDTO(**data)
+    except ValidationError as e:
+        return jsonify({'error': 'ValidationError', 'details': e.errors()}), 400
+
+    user = user_service.authenticate(dto.email, dto.password)
+    if not user:
+        return jsonify({
+            'error': 'Unauthorized',
+            'message': 'Credenciales de acceso incorrectas o cuenta inactiva.'
+        }), 401
+
+    tokens = JWTService.generate_tokens(user)
+    profile = user_service.get_profile_data(user)
+
+    response_data = {
+        'access_token': tokens['access_token'],
+        'refresh_token': tokens['refresh_token'],
+        'token_type': tokens['token_type'],
+        'expires_in': tokens['expires_in'],
+        'user': profile
+    }
+
+    resp = make_response(jsonify(response_data), 200)
+    # Almacenar refresh token en cookie segura HttpOnly
+    resp.set_cookie(
+        'refresh_token',
+        tokens['refresh_token'],
+        httponly=True,
+        samesite='Lax',
+        max_age=7 * 24 * 3600,
+        path='/api/v1/auth/refresh'
+    )
+    return resp
+
+@api_auth_bp.route('/refresh', methods=['POST'])
+def refresh():
+    """
+    Renovación silenciosa del Access Token utilizando el Refresh Token.
+    """
+    data = request.get_json(silent=True)
+    if not isinstance(data, dict):
+        data = {}
+    refresh_token = data.get('refresh_token') or request.cookies.get('refresh_token')
+
+    if not refresh_token:
+        return jsonify({
+            'error': 'BadRequest',
+            'message': 'Refresh token no suministrado en el cuerpo ni en cookies.'
+        }), 400
+
+    try:
+        payload = JWTService.decode_token(refresh_token, expected_type='refresh')
+        user_id = int(payload.get('sub'))
+        user = user_service.get_by_id(user_id)
+
+        if not user or not user.is_active:
+            return jsonify({
+                'error': 'Unauthorized',
+                'message': 'Usuario no encontrado o inactivo.'
+            }), 401
+
+        new_access_token = JWTService.create_access_token(user)
+        return jsonify({
+            'access_token': new_access_token,
+            'token_type': 'Bearer',
+            'expires_in': int(JWTService.ACCESS_TOKEN_EXPIRES.total_seconds())
+        }), 200
+
+    except jwt.ExpiredSignatureError:
+        return jsonify({'error': 'TokenExpired', 'message': 'El refresh token ha expirado. Reingrese credenciales.'}), 401
+    except jwt.InvalidTokenError as e:
+        return jsonify({'error': 'InvalidToken', 'message': str(e)}), 401
+
+@api_auth_bp.route('/logout', methods=['POST'])
+@jwt_required
+def logout():
+    """
+    Cierre de sesión: revoca el token de acceso activo y limpia cookies.
+    """
+    JWTService.revoke_token(g.jwt_token)
+    resp = make_response(jsonify({'message': 'Sesión finalizada y token revocado exitosamente.'}), 200)
+    resp.delete_cookie('refresh_token', path='/api/v1/auth/refresh')
+    return resp
+
+@api_auth_bp.route('/me', methods=['GET'])
+@jwt_required
+def get_current_user():
+    """
+    Retorna el perfil y los permisos del usuario autenticado vía JWT.
+    """
+    profile = user_service.get_profile_data(g.jwt_user)
+    return jsonify(profile), 200

backend/app/routes/api/classrooms.py

@@ -0,0 +1,119 @@
+from flask import Blueprint, request, jsonify, g
+from pydantic import ValidationError
+
+from app.services.classroom_service import ClassroomService
+from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO, ClassroomResponseDTO
+from app.utils.jwt_decorators import jwt_required, jwt_role_required
+
+api_classrooms_bp = Blueprint('api_classrooms', __name__, url_prefix='/api/v1/classrooms')
+classroom_service = ClassroomService()
+
+@api_classrooms_bp.route('', methods=['GET'])
+@jwt_required
+def list_classrooms():
+    """Lista aulas con filtros opcionales (building_id, floor, mode)."""
+    building_id = request.args.get('building_id', type=int)
+    floor = request.args.get('floor')
+    mode = request.args.get('mode', '').lower()
+
+    only_virtual = mode == 'virtual'
+    only_physical = mode == 'physical'
+
+    classrooms = classroom_service.list_classrooms(
+        building_id=building_id,
+        floor=floor,
+        only_virtual=only_virtual,
+        only_physical=only_physical
+    )
+
+    result = []
+    for c in classrooms:
+        result.append({
+            'id': c.id,
+            'code': c.code,
+            'building': c.building_name,
+            'building_id': c.building_id,
+            'floor': c.floor,
+            'floor_display': c.floor_display,
+            'capacity': c.capacity,
+            'is_virtual': c.is_virtual,
+            'location_display': c.location_display,
+            'description': c.description,
+            'is_active': c.is_active
+        })
+
+    return jsonify({'total': len(result), 'classrooms': result}), 200
+
+@api_classrooms_bp.route('/<int:classroom_id>', methods=['GET'])
+@jwt_required
+def get_classroom(classroom_id: int):
+    """Obtiene el detalle de un aula por ID."""
+    c = classroom_service.get_classroom(classroom_id)
+    if not c:
+        return jsonify({'error': 'NotFound', 'message': f'Aula {classroom_id} no encontrada.'}), 404
+
+    return jsonify({
+        'id': c.id,
+        'code': c.code,
+        'building': c.building_name,
+        'building_id': c.building_id,
+        'floor': c.floor,
+        'floor_display': c.floor_display,
+        'capacity': c.capacity,
+        'is_virtual': c.is_virtual,
+        'location_display': c.location_display,
+        'description': c.description,
+        'is_active': c.is_active
+    }), 200
+
+@api_classrooms_bp.route('', methods=['POST'])
+@jwt_role_required('ADMIN', 'ADMINISTRADOR', 'BEDELIA')
+def create_classroom():
+    """Crea una nueva aula validando el contrato con ClassroomCreateDTO."""
+    data = request.get_json(silent=True) or {}
+    try:
+        dto = ClassroomCreateDTO(**data)
+    except ValidationError as e:
+        return jsonify({'error': 'ValidationError', 'details': e.errors()}), 400
+
+    try:
+        classroom = classroom_service.create_classroom(dto)
+        return jsonify({
+            'message': 'Aula creada exitosamente.',
+            'id': classroom.id,
+            'code': classroom.code,
+            'location_display': classroom.location_display
+        }), 201
+    except ValueError as e:
+        return jsonify({'error': 'ConflictOrValidation', 'message': str(e)}), 400
+
+@api_classrooms_bp.route('/<int:classroom_id>', methods=['PUT'])
+@jwt_role_required('ADMIN', 'ADMINISTRADOR', 'BEDELIA')
+def update_classroom(classroom_id: int):
+    """Actualiza los datos de un aula."""
+    data = request.get_json(silent=True) or {}
+    try:
+        dto = ClassroomUpdateDTO(**data)
+    except ValidationError as e:
+        return jsonify({'error': 'ValidationError', 'details': e.errors()}), 400
+
+    try:
+        classroom = classroom_service.update_classroom(classroom_id, dto)
+        return jsonify({
+            'message': 'Aula actualizada exitosamente.',
+            'id': classroom.id,
+            'code': classroom.code,
+            'capacity': classroom.capacity
+        }), 200
+    except ValueError as e:
+        return jsonify({'error': 'ConflictOrValidation', 'message': str(e)}), 400
+
+@api_classrooms_bp.route('/<int:classroom_id>', methods=['DELETE'])
+@jwt_role_required('ADMIN', 'ADMINISTRADOR')
+def delete_classroom(classroom_id: int):
+    """Elimina o desactiva un aula."""
+    deleted = classroom_service.delete_classroom(classroom_id)
+    if not deleted:
+        return jsonify({'error': 'NotFound', 'message': f'Aula {classroom_id} no encontrada.'}), 404
+
+    return jsonify({'message': f'Aula {classroom_id} eliminada/desactivada correctamente.'}), 200

backend/app/routes/api/dashboard.py

@@ -0,0 +1,338 @@
+from flask import Blueprint, jsonify, request
+from app.utils.jwt_decorators import jwt_required
+from app.models.classroom import Classroom
+from app.models.subject import Subject
+from app.models.user import User
+from app.models.reservation import Reservation
+from app.models.audit_log import AuditLog
+from datetime import datetime, timedelta
+from sqlalchemy import func
+from app import db
+
+from app.models.milestone import AcademicMilestone
+from app.models.subject import Commission
+
+api_dashboard_bp = Blueprint('api_dashboard', __name__, url_prefix='/api/v1/dashboard')
+
+def serialize_reservation(r):
+    subject_name = (r.commission.subject.name if (r.commission and r.commission.subject) else r.purpose) or 'Actividad Académica'
+    subject_code = (r.commission.subject.code if (r.commission and r.commission.subject) else '')
+    classroom_code = r.classroom.code if r.classroom else 'Sin Aula'
+    is_virtual = ('virtual' in classroom_code.lower()) or (getattr(r.classroom, 'is_virtual', False) if r.classroom else False)
+    return {
+        'id': r.id,
+        'start_time': r.start_time.strftime('%H:%M') if r.start_time else '',
+        'end_time': r.end_time.strftime('%H:%M') if r.end_time else '',
+        'date_display': r.start_time.strftime('%d/%m') if r.start_time else '',
+        'classroom': {
+            'id': r.classroom_id,
+            'code': classroom_code,
+            'is_virtual': is_virtual,
+            'location_display': getattr(r.classroom, 'location_display', f'Sede Central · {classroom_code}') if r.classroom else 'Sin Aula'
+        },
+        'subject_name': subject_name,
+        'subject_code': subject_code,
+        'shift': r.shift or 'Mañana',
+        'commission': {
+            'id': r.commission_id,
+            'code': r.commission.code if r.commission else 'COM-1'
+        },
+        'status': str(r.status.value if hasattr(r.status, 'value') else r.status),
+        'user': {
+            'id': r.user_id,
+            'name': r.user.name if r.user else 'Docente'
+        },
+        'virtual_link': r.virtual_link or ('https://meet.google.com/edu-space-' + classroom_code.lower().replace(' ', '-') if is_virtual else '')
+    }
+
+def serialize_milestone(m):
+    return {
+        'id': m.id,
+        'title': m.title,
+        'materia_codigo': m.materia_codigo,
+        'subject_name': m.subject.name if (hasattr(m, 'subject') and m.subject) else m.materia_codigo,
+        'date': m.date.strftime('%d/%m/%Y') if m.date else '',
+        'type_obj': {
+            'name': m.type_obj.name if m.type_obj else 'Evaluación',
+            'color': m.type_obj.color if m.type_obj else '#0d6efd'
+        },
+        'classroom': m.classroom or 'Sede Central',
+        'link': m.link or '',
+        'notes': m.notes or ''
+    }
+
+@api_dashboard_bp.route('/stats', methods=['GET'])
+@jwt_required
+def get_stats():
+    """Retorna estadísticas clave y datos operativos para el Dashboard."""
+    today = datetime.utcnow().date()
+    
+    try:
+        total_classrooms = Classroom.query.filter_by(is_active=True).count()
+        total_subjects = Subject.query.filter_by(is_active=True).count()
+        total_users = User.query.filter_by(is_active=True).count()
+        
+        # Aulas presenciales y virtuales
+        all_active_classrooms = Classroom.query.filter_by(is_active=True).all()
+        virtual_classrooms_list = [
+            c for c in all_active_classrooms 
+            if getattr(c, 'is_virtual', False) 
+            or 'virtual' in (c.building or '').lower() 
+            or 'virtual' in (c.code or '').lower()
+        ]
+        virtual_classrooms = len(virtual_classrooms_list)
+
+        physical_classrooms_list = [
+            c for c in all_active_classrooms 
+            if c not in virtual_classrooms_list
+        ]
+        total_physical_count = len(physical_classrooms_list)
+        physical_classrooms = total_physical_count
+        physical_ids = set(c.id for c in physical_classrooms_list)
+
+        # 1. Asignación General del Cuatrimestre / Cronograma
+        assigned_all_ids = set(
+            r[0] for r in db.session.query(Reservation.classroom_id)
+            .filter(Reservation.classroom_id.isnot(None)).distinct().all()
+        )
+        assigned_physical_ids = physical_ids.intersection(assigned_all_ids)
+        assigned_classrooms = len(assigned_physical_ids)
+        unassigned_classrooms = max(0, total_physical_count - assigned_classrooms)
+
+        assigned_pct = round((assigned_classrooms / max(1, total_physical_count)) * 100, 1) if total_physical_count > 0 else 0.0
+        unassigned_pct = round(100.0 - assigned_pct, 1) if total_physical_count > 0 else 0.0
+
+        # 2. Asignación Operativa del Día de Hoy
+        assigned_today_ids = set(
+            r[0] for r in db.session.query(Reservation.classroom_id).filter(
+                Reservation.classroom_id.isnot(None),
+                func.date(Reservation.start_time) == today
+            ).distinct().all()
+        )
+        assigned_today_physical_ids = physical_ids.intersection(assigned_today_ids)
+        assigned_today_count = len(assigned_today_physical_ids)
+        unassigned_today_count = max(0, total_physical_count - assigned_today_count)
+
+        assigned_today_pct = round((assigned_today_count / max(1, total_physical_count)) * 100, 1) if total_physical_count > 0 else 0.0
+        unassigned_today_pct = round(100.0 - assigned_today_pct, 1) if total_physical_count > 0 else 0.0
+        
+        today_reservations_q = Reservation.query.filter(
+            func.date(Reservation.start_time) == today
+        ).order_by(Reservation.start_time.asc()).all()
+        today_reservations = len(today_reservations_q)
+        
+        pending_reservations_q = Reservation.query.filter(
+            Reservation.status == 'PENDING'
+        ).order_by(Reservation.start_time.asc()).all()
+        pending_count = len(pending_reservations_q)
+        
+        upcoming_reservations_q = Reservation.query.filter(
+            Reservation.start_time >= datetime.utcnow()
+        ).order_by(Reservation.start_time.asc()).limit(10).all()
+        
+        milestones_q = AcademicMilestone.query.filter(
+            AcademicMilestone.is_active == True
+        ).order_by(AcademicMilestone.date.asc()).limit(10).all()
+
+        recent_audits = AuditLog.query.order_by(AuditLog.created_at.desc()).limit(6).all()
+        audit_data = [{
+            'created_at': a.created_at.strftime('%Y-%m-%d %H:%M') if a.created_at else None,
+            'action_type': a.action_type,
+            'ip_address': a.ip_address,
+            'user_email': getattr(a.user, 'email', 'System') if hasattr(a, 'user') else 'System'
+        } for a in recent_audits]
+        
+        occupancy_rate = min(100, int((today_reservations / max(1, physical_classrooms * 3)) * 100)) if physical_classrooms > 0 else 0
+
+        pending_reservations = [serialize_reservation(r) for r in pending_reservations_q]
+        today_schedule_list = [serialize_reservation(r) for r in today_reservations_q]
+        upcoming_reservations = [serialize_reservation(r) for r in upcoming_reservations_q]
+        milestones = [serialize_milestone(m) for m in milestones_q]
+
+        # ---- Bedelía: Comisiones sin aula asignada (semana y mes) ----
+        import calendar
+        # Calcular rango de semana actual (lunes a domingo)
+        today_dt = datetime.utcnow()
+        week_start = today_dt - timedelta(days=today_dt.weekday())  # lunes
+        week_start = week_start.replace(hour=0, minute=0, second=0, microsecond=0)
+        week_end = week_start + timedelta(days=6, hours=23, minutes=59, seconds=59)
+
+        # Calcular rango del mes actual
+        month_start = today_dt.replace(day=1, hour=0, minute=0, second=0, microsecond=0)
+        last_day = calendar.monthrange(today_dt.year, today_dt.month)[1]
+        month_end = today_dt.replace(day=last_day, hour=23, minute=59, second=59, microsecond=0)
+
+        # Comisiones activas totales
+        all_active_commissions = Commission.query.filter_by(active=True).all()
+        total_active_commissions = len(all_active_commissions)
+
+        # IDs de comisiones que SÍ tienen reserva en la semana
+        comm_ids_with_res_week = set(
+            r[0] for r in db.session.query(Reservation.commission_id).filter(
+                Reservation.commission_id.isnot(None),
+                Reservation.start_time >= week_start,
+                Reservation.start_time <= week_end
+            ).distinct().all()
+        )
+        # IDs de comisiones que SÍ tienen reserva en el mes
+        comm_ids_with_res_month = set(
+            r[0] for r in db.session.query(Reservation.commission_id).filter(
+                Reservation.commission_id.isnot(None),
+                Reservation.start_time >= month_start,
+                Reservation.start_time <= month_end
+            ).distinct().all()
+        )
+
+        unassigned_commissions_week = []
+        unassigned_commissions_month = []
+        for comm in all_active_commissions:
+            comm_data = {
+                'id': comm.id,
+                'code': comm.code,
+                'full_code': comm.get_full_code(),
+                'subject_name': comm.subject.name if comm.subject else 'Sin materia',
+                'subject_code': comm.subject.code if comm.subject else '',
+                'teacher_name': comm.teacher_name,
+                'schedule': comm.schedule or 'Sin horario',
+                'shift': comm.shift or 'Sin turno',
+                'max_students': comm.max_students,
+                'current_students': comm.current_students
+            }
+            if comm.id not in comm_ids_with_res_week:
+                unassigned_commissions_week.append(comm_data)
+            if comm.id not in comm_ids_with_res_month:
+                unassigned_commissions_month.append(comm_data)
+
+        # ---- Bedelía: Aulas disponibles (sin reservas) en la semana y mes ----
+        classroom_ids_used_week = set(
+            r[0] for r in db.session.query(Reservation.classroom_id).filter(
+                Reservation.classroom_id.isnot(None),
+                Reservation.start_time >= week_start,
+                Reservation.start_time <= week_end
+            ).distinct().all()
+        )
+        classroom_ids_used_month = set(
+            r[0] for r in db.session.query(Reservation.classroom_id).filter(
+                Reservation.classroom_id.isnot(None),
+                Reservation.start_time >= month_start,
+                Reservation.start_time <= month_end
+            ).distinct().all()
+        )
+
+        available_classrooms_week = []
+        available_classrooms_month = []
+        for c in all_active_classrooms:
+            c_data = {
+                'id': c.id,
+                'code': c.code,
+                'building': c.building or 'Sin edificio',
+                'floor': c.floor or '',
+                'capacity': c.capacity,
+                'is_virtual': getattr(c, 'is_virtual', False) or 'virtual' in (c.building or '').lower() or 'virtual' in (c.code or '').lower()
+            }
+            if c.id not in classroom_ids_used_week:
+                available_classrooms_week.append(c_data)
+            if c.id not in classroom_ids_used_month:
+                available_classrooms_month.append(c_data)
+
+    except Exception as e:
+        print(f"Error fetching stats: {e}")
+        total_classrooms = 0
+        total_subjects = 0
+        total_users = 0
+        today_reservations = 0
+        pending_count = 0
+        physical_classrooms = 0
+        virtual_classrooms = 0
+        occupancy_rate = 0
+        assigned_classrooms = 0
+        assigned_pct = 0.0
+        unassigned_classrooms = 0
+        unassigned_pct = 0.0
+        assigned_today_count = 0
+        assigned_today_pct = 0.0
+        unassigned_today_count = 0
+        unassigned_today_pct = 0.0
+        audit_data = []
+        pending_reservations = []
+        today_schedule_list = []
+        upcoming_reservations = []
+        unassigned_commissions_week = []
+        unassigned_commissions_month = []
+        available_classrooms_week = []
+        available_classrooms_month = []
+        total_active_commissions = 0
+        milestones = []
+
+    # Mocked monthly data for chart since complex SQL group by month might differ based on dialect (SQLite vs Postgres)
+    monthly_data = [
+        {"month": "Ene", "reservations": 120},
+        {"month": "Feb", "reservations": 180},
+        {"month": "Mar", "reservations": 250},
+        {"month": "Abr", "reservations": 220},
+        {"month": "May", "reservations": 300},
+        {"month": "Jun", "reservations": 310},
+        {"month": "Jul", "reservations": 200},
+        {"month": "Ago", "reservations": 350},
+        {"month": "Sep", "reservations": 420},
+        {"month": "Oct", "reservations": 480},
+        {"month": "Nov", "reservations": 520},
+        {"month": "Dic", "reservations": 210}
+    ]
+
+    return jsonify({
+        'status': 'success',
+        'stats': {
+            'total_classrooms': total_classrooms,
+            'active_subjects': total_subjects,
+            'total_active_users': total_users,
+            'today_reservations': today_reservations,
+            'pending_count': pending_count,
+            'physical_classrooms': physical_classrooms,
+            'virtual_classrooms': virtual_classrooms,
+            'occupancy_rate': occupancy_rate,
+            'assigned_classrooms': assigned_classrooms,
+            'assigned_classrooms_pct': assigned_pct,
+            'unassigned_classrooms': unassigned_classrooms,
+            'unassigned_classrooms_pct': unassigned_pct,
+            'assigned_today_classrooms': assigned_today_count,
+            'assigned_today_pct': assigned_today_pct,
+            'unassigned_today_classrooms': unassigned_today_count,
+            'unassigned_today_pct': unassigned_today_pct,
+            'total_active_commissions': total_active_commissions
+        },
+        'audit_logs': audit_data,
+        'monthly_data': monthly_data,
+        'pending_reservations': pending_reservations,
+        'today_schedule_list': today_schedule_list,
+        'upcoming_reservations': upcoming_reservations,
+        'milestones': milestones,
+        'bedelia': {
+            'unassigned_commissions_week': unassigned_commissions_week,
+            'unassigned_commissions_month': unassigned_commissions_month,
+            'available_classrooms_week': available_classrooms_week,
+            'available_classrooms_month': available_classrooms_month
+        }
+    }), 200
+
+@api_dashboard_bp.route('/sync-sheets', methods=['POST'])
+@jwt_required
+def sync_google_sheets():
+    """Ejecuta la sincronización real con las hojas de cálculo de Google Sheets."""
+    from app.services.sheets_importer import GoogleSheetsImporter
+    try:
+        data = request.get_json(silent=True) or {}
+        custom_url = data.get('sheets_url') or data.get('base_url')
+        importer = GoogleSheetsImporter(base_url=custom_url)
+        stats = importer.sync()
+        return jsonify({
+            'status': 'success',
+            'stats': stats,
+            'source_url': importer.base_url
+        }), 200
+    except Exception as e:
+        return jsonify({
+            'status': 'error',
+            'message': str(e)
+        }), 500
+

backend/app/routes/api/openapi.py

@@ -0,0 +1,242 @@
+from flask import Blueprint, jsonify
+
+api_openapi_bp = Blueprint('api_openapi', __name__, url_prefix='/api/v1')
+
+OPENAPI_SPEC = {
+    "openapi": "3.0.3",
+    "info": {
+        "title": "Edu-Space REST API",
+        "description": "Enterprise Academic & Physical Space Management REST API with JWT Authentication and Role-Based Access Control.",
+        "version": "1.0.0"
+    },
+    "servers": [
+        {
+            "url": "http://127.0.0.1:5000",
+            "description": "Local Flask Backend Server"
+        }
+    ],
+    "components": {
+        "securitySchemes": {
+            "bearerAuth": {
+                "type": "http",
+                "scheme": "bearer",
+                "bearerFormat": "JWT"
+            }
+        },
+        "schemas": {
+            "LoginRequest": {
+                "type": "object",
+                "required": ["email", "password"],
+                "properties": {
+                    "email": {
+                        "type": "string",
+                        "format": "email",
+                        "example": "admin@eduspace.com"
+                    },
+                    "password": {
+                        "type": "string",
+                        "format": "password",
+                        "example": "Admin123!"
+                    }
+                }
+            },
+            "LoginResponse": {
+                "type": "object",
+                "properties": {
+                    "access_token": {"type": "string"},
+                    "refresh_token": {"type": "string"},
+                    "token_type": {"type": "string", "example": "Bearer"},
+                    "expires_in": {"type": "integer"},
+                    "user": {"type": "object"}
+                }
+            },
+            "ErrorResponse": {
+                "type": "object",
+                "properties": {
+                    "error": {"type": "string"},
+                    "message": {"type": "string"}
+                }
+            },
+            "UserResponse": {
+                "type": "object",
+                "properties": {
+                    "id": {"type": "integer"},
+                    "email": {"type": "string"},
+                    "first_name": {"type": "string"},
+                    "last_name": {"type": "string"},
+                    "role": {"type": "string"},
+                    "is_active": {"type": "boolean"}
+                }
+            },
+            "SubjectResponse": {
+                "type": "object",
+                "properties": {
+                    "id": {"type": "integer"},
+                    "name": {"type": "string"},
+                    "code": {"type": "string"},
+                    "career": {"type": "string"}
+                }
+            },
+            "ClassroomResponse": {
+                "type": "object",
+                "properties": {
+                    "id": {"type": "integer"},
+                    "name": {"type": "string"},
+                    "capacity": {"type": "integer"},
+                    "building": {"type": "string"},
+                    "floor": {"type": "string"}
+                }
+            }
+        }
+    },
+    "paths": {
+        "/api/v1/auth/login": {
+            "post": {
+                "summary": "Authenticate user and issue JWT tokens",
+                "tags": ["Authentication"],
+                "requestBody": {
+                    "required": True,
+                    "content": {
+                        "application/json": {
+                            "schema": {
+                                "$ref": "#/components/schemas/LoginRequest"
+                            }
+                        }
+                    }
+                },
+                "responses": {
+                    "200": {
+                        "description": "Authentication successful",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "$ref": "#/components/schemas/LoginResponse"
+                                }
+                            }
+                        }
+                    },
+                    "400": {
+                        "description": "Validation error",
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ErrorResponse"}
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Unauthorized / Bad credentials",
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ErrorResponse"}
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/auth/me": {
+            "get": {
+                "summary": "Get authenticated user profile",
+                "tags": ["Authentication"],
+                "security": [{"bearerAuth": []}],
+                "responses": {
+                    "200": {
+                        "description": "Current user profile",
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/UserResponse"}
+                            }
+                        }
+                    },
+                    "401": {
+                        "description": "Missing or invalid token",
+                        "content": {
+                            "application/json": {
+                                "schema": {"$ref": "#/components/schemas/ErrorResponse"}
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/classrooms": {
+            "get": {
+                "summary": "List all physical classrooms and facilities",
+                "tags": ["Classrooms"],
+                "security": [{"bearerAuth": []}],
+                "responses": {
+                    "200": {
+                        "description": "List of classrooms",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "array",
+                                    "items": {"$ref": "#/components/schemas/ClassroomResponse"}
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/admin/users": {
+            "get": {
+                "summary": "List all users (Admin only)",
+                "tags": ["Admin - Users"],
+                "security": [{"bearerAuth": []}],
+                "responses": {
+                    "200": {
+                        "description": "List of users",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "array",
+                                    "items": {"$ref": "#/components/schemas/UserResponse"}
+                                }
+                            }
+                        }
+                    },
+                    "403": {
+                        "description": "Forbidden - Requires admin role"
+                    }
+                }
+            }
+        },
+        "/api/v1/admin/subjects": {
+            "get": {
+                "summary": "List all academic subjects (Admin only)",
+                "tags": ["Admin - Academic"],
+                "security": [{"bearerAuth": []}],
+                "responses": {
+                    "200": {
+                        "description": "List of subjects",
+                        "content": {
+                            "application/json": {
+                                "schema": {
+                                    "type": "array",
+                                    "items": {"$ref": "#/components/schemas/SubjectResponse"}
+                                }
+                            }
+                        }
+                    }
+                }
+            }
+        },
+        "/api/v1/openapi.json": {
+            "get": {
+                "summary": "Get OpenAPI 3.0.3 specification JSON",
+                "tags": ["Documentation"],
+                "responses": {
+                    "200": {
+                        "description": "OpenAPI Specification"
+                    }
+                }
+            }
+        }
+    }
+}
+
+@api_openapi_bp.route('/openapi.json', methods=['GET'])
+def get_openapi_spec():
+    """Serves the OpenAPI 3.0 specification for Schemathesis / DAST and Swagger UI."""
+    return jsonify(OPENAPI_SPEC)

backend/app/routes/api/optimizer.py

@@ -0,0 +1,105 @@
+from flask import Blueprint, request, jsonify, g
+from pydantic import ValidationError
+
+from app.schemas.optimizer_dto import OptimizerJobRequestDTO, SpringBootSyncPayloadDTO
+from app.services.optimizer_service import OptimizerService
+from app.utils.jwt_decorators import jwt_required
+
+api_optimizer_bp = Blueprint('api_optimizer', __name__, url_prefix='/api/v1/optimizer')
+
+
+@api_optimizer_bp.route('/jobs', methods=['POST'])
+@jwt_required
+def submit_optimization_job():
+    """
+    Despacha un trabajo de optimización heurística asíncrono.
+    Retorna inmediatamente con HTTP 202 Accepted y el identificador de trabajo para sondeo.
+    """
+    data = request.get_json(silent=True) or {}
+    try:
+        dto = OptimizerJobRequestDTO(**data)
+    except ValidationError as ex:
+        return jsonify({
+            'error': 'UnprocessableEntity',
+            'message': 'Error de validación en los parámetros del optimizador.',
+            'details': ex.errors()
+        }), 422
+
+    user_id = g.current_user.id if hasattr(g, 'current_user') and g.current_user else 1
+
+    job = OptimizerService.submit_job(
+        commission_ids=dto.commission_ids,
+        admin_user_id=user_id,
+        start_date=dto.start_date,
+        end_date=dto.end_date,
+        generations=dto.generations,
+        population_size=dto.population_size,
+        workers=dto.workers
+    )
+
+    return jsonify({
+        'job_id': job.job_id,
+        'status': job.status.value,
+        'poll_url': f'/api/v1/optimizer/jobs/{job.job_id}',
+        'message': 'Trabajo de optimización puesto en cola con éxito.'
+    }), 202
+
+
+@api_optimizer_bp.route('/jobs/<string:job_id>', methods=['GET'])
+@jwt_required
+def get_optimization_job(job_id: str):
+    """
+    Obtiene el estado, progreso y resultados de un trabajo de optimización en cola.
+    """
+    job = OptimizerService.get_job(job_id)
+    if not job:
+        return jsonify({
+            'error': 'NotFound',
+            'message': f'Trabajo de optimización {job_id} no encontrado.'
+        }), 404
+
+    return jsonify(job.to_dict()), 200
+
+
+@api_optimizer_bp.route('/jobs', methods=['GET'])
+@jwt_required
+def list_optimization_jobs():
+    """
+    Lista los trabajos de optimización más recientes.
+    """
+    limit = request.args.get('limit', default=20, type=int)
+    jobs = OptimizerService.list_jobs(limit=limit)
+    return jsonify({
+        'total': len(jobs),
+        'jobs': jobs
+    }), 200
+
+
+@api_optimizer_bp.route('/spring-boot/sync', methods=['POST'])
+@jwt_required
+def sync_with_spring_boot():
+    """
+    Endpoint interoperable para la sincronización y resolución de horarios con microservicios Spring Boot.
+    Recibe el payload en formato Spring Boot (camelCase) y retorna el cronograma optimizado.
+    """
+    data = request.get_json(silent=True) or {}
+    try:
+        dto = SpringBootSyncPayloadDTO(**data)
+    except ValidationError as ex:
+        return jsonify({
+            'error': 'UnprocessableEntity',
+            'message': 'Error de validación en el payload Spring Boot.',
+            'details': ex.errors()
+        }), 422
+
+    user_id = g.current_user.id if hasattr(g, 'current_user') and g.current_user else 1
+
+    try:
+        result = OptimizerService.sync_with_spring_boot(dto, admin_user_id=user_id)
+        return jsonify(result), 200
+    except Exception as ex:
+        return jsonify({
+            'requestId': dto.requestId,
+            'status': 'ERROR',
+            'error': str(ex)
+        }), 500

backend/app/routes/api/reservations.py

@@ -0,0 +1,292 @@
+from flask import Blueprint, request, jsonify, g
+from datetime import datetime, timedelta, date
+from pydantic import ValidationError
+
+from app.services.reservation_service import ReservationService
+from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO
+from app.utils.jwt_decorators import jwt_required, jwt_role_required
+
+api_reservations_bp = Blueprint('api_reservations', __name__, url_prefix='/api/v1/reservations')
+reservation_service = ReservationService()
+
+@api_reservations_bp.route('', methods=['GET'])
+@jwt_required
+def list_reservations():
+    """Consulta de reservas por rango de fechas y/o aula."""
+    start_str = request.args.get('start_date')
+    end_str = request.args.get('end_date')
+    classroom_id = request.args.get('classroom_id', type=int)
+
+    now = datetime.utcnow()
+    try:
+        start_dt = datetime.strptime(start_str, '%Y-%m-%d') if start_str else now.replace(hour=0, minute=0, second=0)
+    except ValueError:
+        return jsonify({'error': 'BadRequest', 'message': 'Formato inválido de start_date (debe ser YYYY-MM-DD).'}), 400
+
+    try:
+        end_dt = datetime.strptime(end_str, '%Y-%m-%d').replace(hour=23, minute=59, second=59) if end_str else start_dt + timedelta(days=7)
+    except ValueError:
+        return jsonify({'error': 'BadRequest', 'message': 'Formato inválido de end_date (debe ser YYYY-MM-DD).'}), 400
+
+    hide_virtual = request.args.get('hide_virtual', '0') in ['1', 'true', 'True']
+    floor = request.args.get('floor')
+    shift = request.args.get('shift')
+    search = request.args.get('search')
+
+    reservations = reservation_service.list_reservations(start_dt, end_dt, classroom_id=classroom_id)
+    result = []
+    for r in reservations:
+        is_virt = bool(r.is_virtual or (r.classroom and r.classroom.is_virtual))
+        if hide_virtual and is_virt:
+            continue
+        if floor and r.classroom and str(r.classroom.floor).strip().lower() != str(floor).strip().lower():
+            continue
+        if shift and r.shift and shift.lower() not in r.shift.lower():
+            continue
+        if search:
+            s_lower = search.lower()
+            subj_n = (r.subject_name or '').lower()
+            subj_c = (r.subject_code or '').lower()
+            c_name = (r.classroom.code if r.classroom else '').lower()
+            u_name = (r.user.name if r.user else '').lower()
+            if s_lower not in subj_n and s_lower not in subj_c and s_lower not in c_name and s_lower not in u_name:
+                continue
+
+        result.append({
+            'id': r.id,
+            'classroom_id': r.classroom_id,
+            'classroom_name': r.classroom.code if r.classroom else None,
+            'classroom': {
+                'id': r.classroom.id,
+                'code': r.classroom.code,
+                'code_display': getattr(r.classroom, 'code_display', r.classroom.code),
+                'floor': r.classroom.floor,
+                'floor_display': getattr(r.classroom, 'floor_display', f"Piso {r.classroom.floor}"),
+                'building': getattr(r.classroom, 'building_name', r.classroom.building),
+                'is_virtual': getattr(r.classroom, 'is_virtual', False),
+                'location_display': getattr(r.classroom, 'location_display', r.classroom.code)
+            } if r.classroom else None,
+            'commission_id': r.commission_id,
+            'commission': {
+                'id': r.commission.id,
+                'code': r.commission.code,
+                'virtual_link': r.commission.virtual_link,
+                'max_students': r.commission.max_students
+            } if r.commission else None,
+            'teacher_name': r.user.name if r.user else None,
+            'user': {
+                'id': r.user.id,
+                'name': r.user.name,
+                'email': r.user.email
+            } if r.user else None,
+            'start_time': r.start_time.isoformat(),
+            'end_time': r.end_time.isoformat(),
+            'purpose': r.purpose,
+            'subject_name': r.subject_name,
+            'subject_code': r.subject_code,
+            'status': str(r.status.value if hasattr(r.status, 'value') else r.status),
+            'shift': r.shift or 'Mañana',
+            'virtual_link': r.virtual_link,
+            'effective_virtual_link': r.effective_virtual_link,
+            'is_virtual': is_virt,
+            'expected_attendees': r.expected_attendees or 30,
+            'notes': r.notes or ''
+        })
+
+    return jsonify({
+        'total': len(result),
+        'start_date': start_dt.strftime('%Y-%m-%d'),
+        'end_date': end_dt.strftime('%Y-%m-%d'),
+        'reservations': result
+    }), 200
+
+@api_reservations_bp.route('/<int:reservation_id>', methods=['GET'])
+@jwt_required
+def get_reservation(reservation_id: int):
+    """Obtiene el detalle de una reserva específica con sus relaciones completas."""
+    r = reservation_service.get_reservation(reservation_id)
+    if not r:
+        return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
+
+    duration_min = int((r.end_time - r.start_time).total_seconds() / 60) if (r.start_time and r.end_time) else 120
+    is_virt = bool(r.is_virtual or (r.classroom and r.classroom.is_virtual))
+
+    return jsonify({
+        'id': r.id,
+        'classroom_id': r.classroom_id,
+        'classroom_name': r.classroom.code if r.classroom else None,
+        'location_display': getattr(r.classroom, 'location_display', r.classroom.code if r.classroom else None),
+        'classroom': {
+            'id': r.classroom.id,
+            'code': r.classroom.code,
+            'code_display': getattr(r.classroom, 'code_display', r.classroom.code),
+            'building_name': getattr(r.classroom, 'building_name', getattr(r.classroom, 'building', 'Edificio Central')),
+            'floor': r.classroom.floor,
+            'floor_display': getattr(r.classroom, 'floor_display', f"Piso {r.classroom.floor}"),
+            'capacity': r.classroom.capacity,
+            'capacity_display': getattr(r.classroom, 'capacity_display', str(r.classroom.capacity)),
+            'description': getattr(r.classroom, 'description', '') or '',
+            'is_virtual': getattr(r.classroom, 'is_virtual', False)
+        } if r.classroom else None,
+        'commission_id': r.commission_id,
+        'commission': {
+            'id': r.commission.id,
+            'code': r.commission.code,
+            'full_code': r.commission.get_full_code() if hasattr(r.commission, 'get_full_code') else r.commission.code,
+            'virtual_link': r.commission.virtual_link,
+            'max_students': r.commission.max_students,
+            'current_students': getattr(r.commission, 'current_students', 0),
+            'subject': {
+                'id': r.commission.subject.id,
+                'name': r.commission.subject.name,
+                'code': r.commission.subject.code
+            } if (r.commission and r.commission.subject) else None
+        } if r.commission else None,
+        'teacher_id': r.user_id,
+        'teacher_name': r.user.name if r.user else None,
+        'user': {
+            'id': r.user.id,
+            'name': r.user.name,
+            'first_name': getattr(r.user, 'first_name', r.user.name.split()[0] if r.user.name else 'Usuario'),
+            'last_name': getattr(r.user, 'last_name', ' '.join(r.user.name.split()[1:]) if r.user.name and len(r.user.name.split()) > 1 else ''),
+            'email': r.user.email
+        } if r.user else None,
+        'start_time': r.start_time.isoformat(),
+        'end_time': r.end_time.isoformat(),
+        'duration': duration_min,
+        'purpose': r.purpose,
+        'status': str(r.status.value if hasattr(r.status, 'value') else r.status),
+        'shift': r.shift or 'Mañana',
+        'virtual_link': r.virtual_link,
+        'effective_virtual_link': r.effective_virtual_link,
+        'is_virtual': is_virt,
+        'expected_attendees': r.expected_attendees or 30,
+        'notes': r.notes or '',
+        'can_be_cancelled': r.can_be_cancelled() if hasattr(r, 'can_be_cancelled') else True
+    }), 200
+
+@api_reservations_bp.route('', methods=['POST'])
+@jwt_required
+def create_reservation():
+    """Crea una reserva aplicando validación DTO y detección de colisiones."""
+    data = request.get_json(silent=True) or {}
+    
+    # Inyectar usuario autenticado si no se especifica
+    if 'user_id' not in data:
+        data['user_id'] = g.jwt_user.id
+
+    try:
+        dto = ReservationCreateDTO(**data)
+    except ValidationError as e:
+        return jsonify({'error': 'ValidationError', 'details': e.errors()}), 400
+
+    try:
+        reservation = reservation_service.create_reservation(dto)
+        return jsonify({
+            'message': 'Reserva creada exitosamente.',
+            'id': reservation.id,
+            'classroom_id': reservation.classroom_id,
+            'start_time': reservation.start_time.isoformat(),
+            'end_time': reservation.end_time.isoformat(),
+            'status': str(reservation.status)
+        }), 201
+    except ValueError as e:
+        return jsonify({'error': 'ConflictOrValidation', 'message': str(e)}), 409
+
+@api_reservations_bp.route('/<int:reservation_id>', methods=['PUT'])
+@jwt_required
+def update_reservation(reservation_id: int):
+    """Modifica una reserva existente."""
+    data = request.get_json(silent=True) or {}
+    try:
+        dto = ReservationUpdateDTO(**data)
+    except ValidationError as e:
+        return jsonify({'error': 'ValidationError', 'details': e.errors()}), 400
+
+    try:
+        reservation = reservation_service.update_reservation(reservation_id, dto)
+        return jsonify({
+            'message': 'Reserva actualizada exitosamente.',
+            'id': reservation.id,
+            'start_time': reservation.start_time.isoformat(),
+            'end_time': reservation.end_time.isoformat(),
+            'status': str(reservation.status)
+        }), 200
+    except ValueError as e:
+        return jsonify({'error': 'ConflictOrValidation', 'message': str(e)}), 409
+
+@api_reservations_bp.route('/<int:reservation_id>', methods=['DELETE'])
+@jwt_required
+def cancel_reservation(reservation_id: int):
+    """Cancela una reserva."""
+    cancelled = reservation_service.cancel_reservation(reservation_id)
+    if not cancelled:
+        return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
+
+    return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200
+
+@api_reservations_bp.route('/<int:reservation_id>/cancel', methods=['POST'])
+@jwt_required
+def cancel_reservation_post(reservation_id: int):
+    """Cancela una reserva (endpoint POST compatible con formularios)."""
+    cancelled = reservation_service.cancel_reservation(reservation_id)
+    if not cancelled:
+        return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
+
+    return jsonify({'message': f'Reserva {reservation_id} cancelada correctamente.'}), 200
+
+@api_reservations_bp.route('/<int:reservation_id>/confirm', methods=['POST'])
+@jwt_required
+def confirm_reservation(reservation_id: int):
+    """Confirma una reserva cambiando su estado a CONFIRMED."""
+    confirmed = reservation_service.confirm_reservation(reservation_id)
+    if not confirmed:
+        return jsonify({'error': 'NotFound', 'message': f'Reserva {reservation_id} no encontrada.'}), 404
+
+    return jsonify({'message': f'Reserva {reservation_id} confirmada correctamente.'}), 200
+
+@api_reservations_bp.route('/check-conflicts', methods=['POST'])
+@jwt_required
+def check_conflicts_endpoint():
+    """
+    Evalúa la matriz completa de conflictos (físico, docente y aforo) en tiempo real.
+    """
+    data = request.get_json(silent=True)
+    if not isinstance(data, dict):
+        return jsonify({'error': 'BadRequest', 'message': 'El cuerpo de la solicitud debe ser un objeto JSON.'}), 400
+
+    classroom_id = data.get('classroom_id')
+    start_str = data.get('start_time')
+    end_str = data.get('end_time')
+
+    if not classroom_id or not start_str or not end_str:
+        return jsonify({'error': 'BadRequest', 'message': 'classroom_id, start_time y end_time son obligatorios.'}), 400
+
+    try:
+        start_time = datetime.fromisoformat(str(start_str).replace('Z', '+00:00'))
+        end_time = datetime.fromisoformat(str(end_str).replace('Z', '+00:00'))
+    except ValueError:
+        return jsonify({'error': 'BadRequest', 'message': 'Formato inválido de fecha/hora (ISO 8601 esperado).'}), 400
+
+    teacher_id = data.get('teacher_id')
+    commission_id = data.get('commission_id')
+    expected_attendees = data.get('expected_attendees')
+    allow_co_teaching = bool(data.get('allow_co_teaching_exception', False))
+    exclude_id = data.get('exclude_id')
+
+    try:
+        matrix = reservation_service.check_full_conflicts_matrix(
+            classroom_id=int(classroom_id),
+            start_time=start_time,
+            end_time=end_time,
+            teacher_id=int(teacher_id) if teacher_id else None,
+            commission_id=int(commission_id) if commission_id else None,
+            expected_attendees=int(expected_attendees) if expected_attendees is not None else None,
+            allow_co_teaching_exception=allow_co_teaching,
+            exclude_id=int(exclude_id) if exclude_id else None
+        )
+        return jsonify(matrix), 200
+    except ValueError as e:
+        return jsonify({'error': 'ValidationError', 'message': str(e)}), 400
+
+

backend/app/routes/auth.py

@@ -8,15 +8,18 @@ from datetime import datetime
 
 auth_bp = Blueprint('auth', __name__)
 
+from sqlalchemy import func
+
 @auth_bp.route('/login', methods=['GET', 'POST'])
 def login():
-    """Handle user login"""
+    """Handle user login with case-insensitive email lookup and whitespace trimming"""
     if current_user.is_authenticated:
         return redirect(url_for('main.dashboard'))
     
     form = LoginForm()
     if form.validate_on_submit():
-        user = User.query.filter_by(email=form.email.data).first()
+        clean_email = (form.email.data or '').strip().lower()
+        user = User.query.filter(func.lower(User.email) == clean_email).first()
         
         if user and user.check_password(form.password.data):
             if not user.is_active:
@@ -26,6 +29,19 @@ def login():
             login_user(user, remember=form.remember_me.data)
             user.update_last_login()
 
+            # Registrar en bitácora de auditoría
+            try:
+                from app.services.audit_service import AuditService
+                AuditService.log(
+                    action='LOGIN',
+                    module='auth',
+                    user_id=user.id,
+                    user_email=user.email,
+                    details=f"Inicio de sesión exitoso ({user.role})"
+                )
+            except Exception:
+                pass
+            
             # Si el usuario tiene idioma configurado en su perfil, sobrescribe el navegador en toda la sesión
             if user.preferred_language and user.preferred_language in ['es', 'en']:
                 session['language'] = user.preferred_language
@@ -42,6 +58,15 @@ def login():
             flash(_('¡Bienvenido de nuevo, %(name)s!', name=user_full_name), 'success')
             return redirect(next_page)
         else:
+            try:
+                from app.services.audit_service import AuditService
+                AuditService.log(
+                    action='LOGIN_FAILED',
+                    module='auth',
+                    details=f"Intento fallido de login con email: {clean_email}"
+                )
+            except Exception:
+                pass
             flash(_('Correo electrónico o contraseña inválidos.'), 'error')
     
     return render_template('auth/login.html', form=form)

backend/app/routes/classrooms.py

@@ -58,29 +58,37 @@ def add_classroom():
 
             cap_raw = str(form.capacity.data or '').strip()
             if cap_raw in ['∞', 'inf', 'INF', 'Infinity', 'infinity', '0', 'ilimitada', 'Ilimitada', 'sin limite', 'Sin límite']:
-                cap_val = 0
+                cap_val = 9999
             else:
                 cap_val = int(cap_raw)
 
-            classroom = Classroom(
+            from app.services.classroom_service import ClassroomService
+            from app.schemas.classroom_dto import ClassroomCreateDTO
+            from app.services.audit_service import AuditService
+
+            dto = ClassroomCreateDTO(
                 building_id=building.id,
-                building=building.name,
                 code=room_code,
                 floor=floor_val,
                 capacity=cap_val,
                 description=form.description.data,
                 is_active=form.is_active.data
             )
+            classroom_service = ClassroomService()
+            classroom = classroom_service.create_classroom(dto)
 
-            db.session.add(classroom)
+            # Registrar en bitácora inmutable de auditoría
-            db.session.commit()
+            AuditService.log('CREATE', 'classrooms', entity_id=classroom.id, details={'code': classroom.code, 'building': building.name})
 
             flash(f'Aula {classroom.location_display} creada exitosamente.', 'success')
             return redirect(url_for('classrooms.list_classrooms'))
 
+        except ValueError as ve:
+            flash(str(ve), 'error')
+            return render_template('classrooms/add.html', form=form, building_floors=building_floors, title='Add Classroom')
         except Exception as e:
             db.session.rollback()
-            flash(f'Error creating classroom: {str(e)}', 'error')
+            flash(f'Error al crear el aula: {str(e)}', 'error')
 
     return render_template('classrooms/add.html', form=form, building_floors=building_floors, title='Add Classroom')
 

backend/app/routes/genetic_algorithm.py

@@ -39,8 +39,8 @@ def optimize_reservations():
             except ValueError:
                 return jsonify({'error': 'Invalid end_date format. Use ISO format.'}), 400
         
-        # Check if user has permission (admin or teacher)
+        # Check if user has permission (admin, teacher or RBAC optimizer write)
-        if current_user.role not in ['ADMIN', 'teacher']:
+        if not (current_user.is_admin() or current_user.has_permission('optimizer', 'read_write') or current_user.role in ['ADMIN', 'teacher']):
             return jsonify({'error': 'Insufficient permissions to optimize reservations'}), 403
         
         # Initialize optimizer and run optimization
@@ -84,7 +84,7 @@ def apply_optimization():
             return jsonify({'error': 'reservations must be a list'}), 400
         
         # Check if user has permission
-        if current_user.role not in ['ADMIN', 'teacher']:
+        if not (current_user.is_admin() or current_user.has_permission('optimizer', 'read_write') or current_user.role in ['ADMIN', 'teacher']):
             return jsonify({'error': 'Insufficient permissions to apply reservations'}), 403
         
         # Initialize optimizer and apply reservations

backend/app/routes/main.py

@@ -0,0 +1,333 @@
+from flask import Blueprint, render_template, jsonify, redirect, url_for, session, request, flash
+from flask_login import login_required, current_user
+from app import db
+from app.models.reservation import Reservation
+from app.models.classroom import Classroom
+from app.models.subject import Subject
+from app.models.subject import Commission
+from datetime import datetime, timedelta
+from sqlalchemy import func
+from flask_babel import gettext as _
+
+main_bp = Blueprint('main', __name__)
+
+@main_bp.route('/')
+@login_required
+def dashboard():
+    """Role-personalized institutional dashboard page"""
+    from app.models.user import User
+    from app.models.milestone import AcademicMilestone
+    from app.models.audit_log import AuditLog
+
+    actual_role = current_user.get_institutional_role()
+    view_as = request.args.get('view_as', '').lower().strip()
+    
+    # Allow admins and management roles to preview dashboard perspectives
+    if view_as in ['admin', 'bedelia', 'docente', 'alumno'] and (current_user.is_admin() or current_user.can_manage()):
+        role = view_as
+    else:
+        role = actual_role
+
+    today = datetime.utcnow().date()
+    
+    # Common core statistics
+    try:
+        total_classrooms = Classroom.query.filter_by(is_active=True).count()
+    except Exception:
+        total_classrooms = 0
+        
+    try:
+        total_subjects = Subject.query.filter_by(is_active=True).count()
+    except Exception:
+        total_subjects = 0
+    
+    try:
+        today_reservations = Reservation.query.filter(
+            func.date(Reservation.start_time) == today
+        ).count()
+    except Exception:
+        today_reservations = 0
+    
+    week_start = today - timedelta(days=today.weekday())
+    week_end = week_start + timedelta(days=6)
+    try:
+        week_reservations = Reservation.query.filter(
+            func.date(Reservation.start_time) >= week_start,
+            func.date(Reservation.start_time) <= week_end
+        ).count()
+    except Exception:
+        week_reservations = 0
+    
+    stats = {
+        'total_classrooms': total_classrooms,
+        'total_subjects': total_subjects,
+        'today_reservations': today_reservations,
+        'week_reservations': week_reservations
+    }
+    
+    role_data = {}
+
+    if role == 'admin':
+        # 1. Admin Institutional Cockpit
+        try:
+            total_users = User.query.filter_by(is_active=True).count()
+        except Exception:
+            total_users = 0
+
+        try:
+            pending_count = Reservation.query.filter(
+                Reservation.status == 'PENDING'
+            ).count()
+        except Exception:
+            pending_count = 0
+
+        try:
+            recent_audits = AuditLog.query.order_by(AuditLog.created_at.desc()).limit(6).all()
+        except Exception:
+            recent_audits = []
+
+        try:
+            upcoming_reservations = Reservation.query.filter(
+                Reservation.start_time >= datetime.utcnow(),
+                Reservation.start_time <= datetime.utcnow() + timedelta(days=7)
+            ).order_by(Reservation.start_time.asc()).limit(8).all()
+        except Exception:
+            upcoming_reservations = []
+
+        stats.update({
+            'total_users': total_users,
+            'pending_reservations': pending_count
+        })
+        role_data = {
+            'recent_audits': recent_audits,
+            'upcoming_reservations': upcoming_reservations
+        }
+
+    elif role == 'bedelia':
+        # 2. Bedelía Operations & Facilities Control
+        try:
+            physical_classrooms = Classroom.query.filter_by(is_active=True).filter(
+                ~Classroom.room_number.ilike('%VIRTUAL%') & ~Classroom.building.ilike('%VIRTUAL%')
+            ).count()
+            virtual_classrooms = total_classrooms - physical_classrooms
+            if virtual_classrooms < 0:
+                virtual_classrooms = 0
+        except Exception:
+            physical_classrooms = total_classrooms
+            virtual_classrooms = 0
+
+        try:
+            pending_reservations = Reservation.query.filter(
+                Reservation.status == 'PENDING'
+            ).order_by(Reservation.start_time.asc()).limit(10).all()
+            pending_count = len(pending_reservations)
+        except Exception:
+            pending_reservations = []
+            pending_count = 0
+
+        try:
+            today_schedule_list = Reservation.query.filter(
+                func.date(Reservation.start_time) == today
+            ).order_by(Reservation.start_time.asc()).limit(12).all()
+        except Exception:
+            today_schedule_list = []
+
+        occupancy_rate = min(100, int((today_reservations / max(1, physical_classrooms * 3)) * 100)) if physical_classrooms > 0 else 0
+
+        stats.update({
+            'physical_classrooms': physical_classrooms,
+            'virtual_classrooms': virtual_classrooms,
+            'pending_count': pending_count,
+            'occupancy_rate': occupancy_rate
+        })
+        role_data = {
+            'pending_reservations': pending_reservations,
+            'today_schedule_list': today_schedule_list
+        }
+
+    elif role == 'docente':
+        # 3. Docente (Profesor) Academic & Classroom Workflow
+        try:
+            my_today_classes = Reservation.query.filter(
+                Reservation.user_id == current_user.id,
+                func.date(Reservation.start_time) == today
+            ).order_by(Reservation.start_time.asc()).all()
+        except Exception:
+            my_today_classes = []
+
+        try:
+            my_upcoming_reservations = Reservation.query.filter(
+                Reservation.user_id == current_user.id,
+                Reservation.start_time >= datetime.utcnow()
+            ).order_by(Reservation.start_time.asc()).limit(8).all()
+        except Exception:
+            my_upcoming_reservations = []
+
+        try:
+            my_total_reservations = Reservation.query.filter(
+                Reservation.user_id == current_user.id
+            ).count()
+        except Exception:
+            my_total_reservations = 0
+
+        try:
+            virtual_classrooms = Classroom.query.filter_by(is_active=True).filter(
+                (Classroom.room_number.ilike('%VIRTUAL%')) | (Classroom.building.ilike('%VIRTUAL%'))
+            ).limit(4).all()
+        except Exception:
+            virtual_classrooms = []
+
+        stats.update({
+            'my_today_count': len(my_today_classes),
+            'my_total_reservations': my_total_reservations,
+            'virtual_rooms_count': len(virtual_classrooms)
+        })
+        role_data = {
+            'my_today_classes': my_today_classes,
+            'my_upcoming_reservations': my_upcoming_reservations,
+            'virtual_classrooms': virtual_classrooms
+        }
+
+    elif role == 'alumno':
+        # 4. Alumno (Estudiante) Daily Guide & Timetable
+        try:
+            today_classes = Reservation.query.filter(
+                func.date(Reservation.start_time) == today,
+                Reservation.status == 'CONFIRMED'
+            ).order_by(Reservation.start_time.asc()).limit(12).all()
+        except Exception:
+            today_classes = []
+
+        try:
+            upcoming_milestones = AcademicMilestone.query.filter(
+                AcademicMilestone.date >= datetime.utcnow(),
+                AcademicMilestone.is_active == True
+            ).order_by(AcademicMilestone.date.asc()).limit(6).all()
+        except Exception:
+            upcoming_milestones = []
+
+        try:
+            virtual_rooms = Classroom.query.filter_by(is_active=True).filter(
+                (Classroom.room_number.ilike('%VIRTUAL%')) | (Classroom.building.ilike('%VIRTUAL%'))
+            ).limit(4).all()
+        except Exception:
+            virtual_rooms = []
+
+        stats.update({
+            'today_classes_count': len(today_classes),
+            'milestones_count': len(upcoming_milestones)
+        })
+        role_data = {
+            'today_classes': today_classes,
+            'upcoming_milestones': upcoming_milestones,
+            'virtual_rooms': virtual_rooms
+        }
+
+    # Backward compatibility for upcoming_reservations
+    upcoming_reservations = role_data.get('upcoming_reservations', [])
+    if not upcoming_reservations:
+        try:
+            upcoming_reservations = Reservation.query.filter(
+                Reservation.start_time >= datetime.utcnow(),
+                Reservation.start_time <= datetime.utcnow() + timedelta(days=7)
+            ).order_by(Reservation.start_time.asc()).limit(6).all()
+        except Exception:
+            upcoming_reservations = []
+
+    return render_template('dashboard.html',
+                         role=role,
+                         actual_role=actual_role,
+                         stats=stats,
+                         role_data=role_data,
+                         upcoming_reservations=upcoming_reservations)
+
+@main_bp.route('/api/dashboard-stats')
+@login_required
+def dashboard_stats_api():
+    """API endpoint for dashboard statistics"""
+    # Get today's data
+    today = datetime.utcnow().date()
+    today_reservations = Reservation.query.filter(
+        func.date(Reservation.start_time) == today
+    ).count()
+    
+    # Get this week's data
+    week_start = today - timedelta(days=today.weekday())
+    week_end = week_start + timedelta(days=6)
+    week_reservations = Reservation.query.filter(
+        func.date(Reservation.start_time) >= week_start,
+        func.date(Reservation.start_time) <= week_end
+    ).count()
+    
+    # Get monthly data for chart
+    current_date = datetime.utcnow()
+    monthly_data = []
+    
+    for i in range(12):
+        month_date = current_date - timedelta(days=30 * i)
+        month_start = month_date.replace(day=1)
+        month_end = (month_start + timedelta(days=32)).replace(day=1) - timedelta(days=1)
+        
+        monthly_reservations = Reservation.query.filter(
+            func.date(Reservation.start_time) >= month_start.date(),
+            func.date(Reservation.start_time) <= month_end.date()
+        ).count()
+        
+        monthly_data.append({
+            'month': month_start.strftime('%Y-%m'),
+            'reservations': monthly_reservations
+        })
+    
+    return jsonify({
+        'today_reservations': today_reservations,
+        'week_reservations': week_reservations,
+        'monthly_data': list(reversed(monthly_data))
+    })
+
+@main_bp.route('/genetic-optimizer')
+@login_required
+def genetic_optimizer():
+    """Serve the genetic algorithm optimization interface"""
+    if not (current_user.has_permission('optimizer', 'read') or (current_user.role and current_user.role.upper() == 'ADMIN')):
+        flash(_('No tienes permisos para acceder a la herramienta de optimización.'), 'danger')
+        return redirect(url_for('main.dashboard'))
+    
+    return render_template('genetic_optimizer.html')
+
+@main_bp.route('/set_language/<language>')
+def set_language(language=None):
+    if language not in ['en', 'es']:
+        language = 'es'
+    
+    session['language'] = language
+    
+    # Si se selecciona el idioma desde la pantalla de login, registrar la selección explícita
+    if request.referrer and 'login' in request.referrer:
+        session['login_lang_explicit'] = language
+    
+    if current_user.is_authenticated:
+        current_user.preferred_language = language
+        db.session.commit()
+        
+    return redirect(request.referrer or url_for('main.dashboard'))
+
+
+@main_bp.route('/api/milestone-types')
+def api_milestone_types():
+    """Retorna las tipificaciones de hitos activas en JSON para consumo de frontend/mobile"""
+    from app.models.milestone import MilestoneType, BASE_MILESTONE_TYPES
+    if MilestoneType.query.count() == 0:
+        for item in BASE_MILESTONE_TYPES:
+            mt = MilestoneType(
+                name=item['name'],
+                code=item['code'],
+                color=item['color'],
+                description=item['description'],
+                sort_order=item['sort_order'],
+                is_active=True
+            )
+            db.session.add(mt)
+        db.session.commit()
+
+    types = MilestoneType.query.filter_by(is_active=True).order_by(MilestoneType.sort_order.asc(), MilestoneType.id.asc()).all()
+    return jsonify([t.to_dict() for t in types])␍

backend/app/routes/my_subjects.py

@@ -0,0 +1,126 @@
+from flask import Blueprint, render_template, abort
+from flask_login import login_required, current_user
+from app import db
+from app.models.subject import Commission
+from app.models.enrollment import StudentEnrollment
+from app.models.classroom import Classroom
+
+my_subjects_bp = Blueprint('my_subjects', __name__, url_prefix='/mis-materias')
+
+
+@my_subjects_bp.route('/')
+@login_required
+def my_subjects_list():
+    """Show the commissions assigned to the current user (teacher or student)."""
+    role = current_user.get_institutional_role()
+
+    commissions = []
+
+    if role in ['admin', 'bedelia']:
+        # Admin/Bedelia: see all active commissions
+        commissions = (
+            Commission.query
+            .filter_by(active=True)
+            .order_by(Commission.year.desc(), Commission.semester.asc(), Commission.code.asc())
+            .all()
+        )
+        view_mode = 'all'
+
+    elif role == 'docente':
+        # Teacher: only commissions where they are assigned as teacher
+        commissions = (
+            Commission.query
+            .filter_by(teacher_id=current_user.id, active=True)
+            .order_by(Commission.year.desc(), Commission.semester.asc(), Commission.code.asc())
+            .all()
+        )
+        view_mode = 'teacher'
+
+    elif role == 'alumno':
+        # Student: only commissions where they are enrolled
+        enrollments = (
+            StudentEnrollment.query
+            .filter_by(student_id=current_user.id, status='activo')
+            .all()
+        )
+        commission_ids = [e.commission_id for e in enrollments]
+        commissions = (
+            Commission.query
+            .filter(Commission.id.in_(commission_ids), Commission.active == True)
+            .order_by(Commission.year.desc(), Commission.semester.asc(), Commission.code.asc())
+            .all()
+        )
+        view_mode = 'student'
+    else:
+        commissions = []
+        view_mode = 'none'
+
+    return render_template(
+        'my_subjects/list.html',
+        commissions=commissions,
+        view_mode=view_mode,
+        role=role
+    )
+
+
+@my_subjects_bp.route('/<int:commission_id>')
+@login_required
+def my_subject_detail(commission_id):
+    """Detail view of a single commission for the current user."""
+    role = current_user.get_institutional_role()
+    commission = Commission.query.get_or_404(commission_id)
+
+    # Access control: make sure the user is allowed to see this commission
+    if role in ['admin', 'bedelia']:
+        pass  # full access
+    elif role == 'docente':
+        if commission.teacher_id != current_user.id:
+            abort(403)
+    elif role == 'alumno':
+        enrollment = StudentEnrollment.query.filter_by(
+            student_id=current_user.id,
+            commission_id=commission_id
+        ).first()
+        if not enrollment:
+            abort(403)
+    else:
+        abort(403)
+
+    # Get enrolled students (visible to teachers and admin/bedelia)
+    enrollments = []
+    if role in ['admin', 'bedelia', 'docente']:
+        enrollments = (
+            StudentEnrollment.query
+            .filter_by(commission_id=commission_id)
+            .order_by(StudentEnrollment.enrolled_at.asc())
+            .all()
+        )
+
+    # Try to get classroom info from reservations linked to this commission
+    from app.models.reservation import Reservation
+    from sqlalchemy import func
+    from datetime import datetime
+
+    # Recent or upcoming reservation linked to this commission
+    recent_reservation = (
+        Reservation.query
+        .filter(
+            Reservation.commission_id == commission_id,
+            Reservation.start_time >= datetime.utcnow()
+        )
+        .order_by(Reservation.start_time.asc())
+        .first()
+    )
+
+    classroom = None
+    if recent_reservation and recent_reservation.classroom_id:
+        classroom = Classroom.query.get(recent_reservation.classroom_id)
+
+    return render_template(
+        'my_subjects/detail.html',
+        commission=commission,
+        enrollments=enrollments,
+        classroom=classroom,
+        recent_reservation=recent_reservation,
+        role=role
+    )

backend/app/schemas/__init__.py

@@ -0,0 +1,16 @@
+"""Módulo de Data Transfer Objects (DTOs) y esquemas tipados con Pydantic."""
+from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO, ClassroomResponseDTO
+from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO, ReservationResponseDTO
+from app.schemas.auth_dto import LoginDTO, TokenResponseDTO, RefreshTokenDTO
+
+__all__ = [
+    'ClassroomCreateDTO',
+    'ClassroomUpdateDTO',
+    'ClassroomResponseDTO',
+    'ReservationCreateDTO',
+    'ReservationUpdateDTO',
+    'ReservationResponseDTO',
+    'LoginDTO',
+    'TokenResponseDTO',
+    'RefreshTokenDTO'
+]

backend/app/schemas/auth_dto.py

@@ -0,0 +1,16 @@
+from typing import Optional, Dict, Any, List
+from pydantic import BaseModel, Field, EmailStr
+
+class LoginDTO(BaseModel):
+    email: str = Field(..., description="Correo electrónico institucional")
+    password: str = Field(..., min_length=1, description="Contraseña de acceso")
+
+class TokenResponseDTO(BaseModel):
+    access_token: str
+    refresh_token: str
+    token_type: str = "Bearer"
+    expires_in: int = 900  # 15 minutos en segundos
+    user: Dict[str, Any]
+
+class RefreshTokenDTO(BaseModel):
+    refresh_token: str = Field(..., description="Token de refresco válido")

backend/app/schemas/classroom_dto.py

@@ -0,0 +1,44 @@
+from typing import Optional
+from pydantic import BaseModel, Field, field_validator
+
+class ClassroomBaseDTO(BaseModel):
+    code: str = Field(..., min_length=1, max_length=50, description="Código o nombre del aula (ej: Aula 101, VIRTUAL-A)")
+    floor: str = Field(default="PB", max_length=50, description="Piso o nivel (PB, Piso 1, etc.)")
+    capacity: int = Field(default=30, ge=1, le=10000, description="Capacidad máxima de estudiantes")
+    description: Optional[str] = Field(default=None, max_length=500, description="Detalles o equipamiento")
+    is_active: bool = Field(default=True, description="Estado operativo del aula")
+
+    @field_validator('code')
+    @classmethod
+    def clean_code(cls, v: str) -> str:
+        v = v.strip()
+        if not v:
+            raise ValueError("El código del aula no puede estar vacío.")
+        return v
+
+    @field_validator('floor')
+    @classmethod
+    def clean_floor(cls, v: str) -> str:
+        return str(v).strip() or "PB"
+
+class ClassroomCreateDTO(ClassroomBaseDTO):
+    building_id: Optional[int] = Field(default=None, description="ID del edificio asignado")
+    building_name: Optional[str] = Field(default=None, description="Nombre de edificio (para creación dinámica)")
+
+class ClassroomUpdateDTO(BaseModel):
+    building_id: Optional[int] = None
+    code: Optional[str] = None
+    floor: Optional[str] = None
+    capacity: Optional[int] = None
+    description: Optional[str] = None
+    is_active: Optional[bool] = None
+
+class ClassroomResponseDTO(ClassroomBaseDTO):
+    id: int
+    building_id: Optional[int] = None
+    building_name: str
+    is_virtual: bool
+    location_display: str
+
+    class Config:
+        from_attributes = True

backend/app/schemas/optimizer_dto.py

@@ -0,0 +1,49 @@
+from pydantic import BaseModel, Field, field_validator
+from typing import List, Optional, Dict, Any
+from datetime import datetime
+
+class OptimizerJobRequestDTO(BaseModel):
+    """Contrato de solicitud para iniciar una optimización heurística."""
+    commission_ids: List[int] = Field(..., min_length=1, description="Lista de IDs de comisiones a programar")
+    start_date: Optional[datetime] = Field(None, description="Fecha de inicio (ISO format)")
+    end_date: Optional[datetime] = Field(None, description="Fecha de fin (ISO format)")
+    generations: int = Field(default=80, ge=10, le=500, description="Cantidad de generaciones genéticas")
+    population_size: int = Field(default=40, ge=10, le=200, description="Tamaño de la población de cromosomas")
+    workers: int = Field(default=4, ge=1, le=16, description="Cantidad de hilos o workers concurrentes")
+
+    @field_validator('commission_ids')
+    @classmethod
+    def validate_ids(cls, v):
+        if not v or len(v) == 0:
+            raise ValueError("Debe suministrar al menos una comisión para optimizar.")
+        return list(set(v))
+
+
+class SpringBootCommissionDTO(BaseModel):
+    """Contrato de comisión en formato Spring Boot."""
+    commissionId: int
+    subjectCode: str
+    subjectName: str
+    expectedAttendees: int = Field(default=30, ge=1)
+    preferredShift: Optional[str] = "NOCHE"
+    preferredStart: datetime
+    preferredEnd: datetime
+
+
+class SpringBootClassroomDTO(BaseModel):
+    """Contrato de aula en formato Spring Boot."""
+    classroomId: int
+    roomNumber: str
+    capacity: int = Field(default=30, ge=1)
+    building: Optional[str] = "Edificio Central"
+    isVirtual: bool = False
+
+
+class SpringBootSyncPayloadDTO(BaseModel):
+    """Carga útil de sincronización interoperable con microservicios Spring Boot."""
+    requestId: str = Field(..., description="Identificador único de la petición externa")
+    campusCode: Optional[str] = "CENTRAL"
+    academicTerm: Optional[str] = "2026-1C"
+    commissions: List[SpringBootCommissionDTO] = Field(..., min_length=1)
+    classrooms: Optional[List[SpringBootClassroomDTO]] = None
+    options: Optional[Dict[str, Any]] = None

backend/app/schemas/reservation_dto.py

@@ -0,0 +1,44 @@
+from typing import Optional
+from datetime import datetime
+from pydantic import BaseModel, Field, model_validator
+
+class ReservationBaseDTO(BaseModel):
+    classroom_id: int = Field(..., description="ID del aula asignada")
+    commission_id: int = Field(..., description="ID de la comisión académica")
+    user_id: int = Field(..., description="ID del docente responsable")
+    start_time: datetime = Field(..., description="Fecha y hora de inicio")
+    end_time: datetime = Field(..., description="Fecha y hora de finalización")
+    purpose: str = Field(default="Clase regular", max_length=500, description="Motivo o título de la reserva")
+    expected_attendees: int = Field(default=20, ge=1, description="Cantidad estimada de asistentes")
+    shift: Optional[str] = Field(default=None, max_length=30, description="Turno (Mañana, Tarde, Vespertino, Noche)")
+    virtual_link: Optional[str] = Field(default=None, max_length=500, description="Enlace a sala virtual (Meet/Zoom)")
+    notes: Optional[str] = Field(default=None, description="Observaciones adicionales")
+    status: Optional[str] = Field(default="PENDING", description="Estado de la reserva")
+
+    @model_validator(mode='after')
+    def validate_time_range(self):
+        if self.end_time <= self.start_time:
+            raise ValueError("La hora de finalización debe ser posterior a la hora de inicio.")
+        return self
+
+class ReservationCreateDTO(ReservationBaseDTO):
+    allow_co_teaching_exception: Optional[bool] = Field(default=False, description="Excepción justificada si hay co-docencia")
+
+class ReservationUpdateDTO(BaseModel):
+    classroom_id: Optional[int] = None
+    start_time: Optional[datetime] = None
+    end_time: Optional[datetime] = None
+    purpose: Optional[str] = None
+    expected_attendees: Optional[int] = None
+    shift: Optional[str] = None
+    virtual_link: Optional[str] = None
+    notes: Optional[str] = None
+    status: Optional[str] = None
+    allow_co_teaching_exception: Optional[bool] = False
+
+class ReservationResponseDTO(ReservationBaseDTO):
+    id: int
+    created_at: Optional[datetime] = None
+
+    class Config:
+        from_attributes = True

backend/app/security/__init__.py

@@ -0,0 +1,8 @@
+"""Módulo de Seguridad Empresarial inspirado en Spring Security (SecurityFilterChain, RBAC y Auditoría)."""
+from app.security.filter_chain import SecurityFilterChain
+from app.security.decorators import require_permission
+
+__all__ = [
+    'SecurityFilterChain',
+    'require_permission'
+]

backend/app/security/decorators.py

@@ -0,0 +1,45 @@
+from functools import wraps
+from flask import request, jsonify, redirect, url_for, flash, abort, g
+from flask_login import current_user
+
+def require_permission(module: str, min_level: str = 'read'):
+    """
+    Decorador de seguridad declarativa a nivel de método inspirado en @PreAuthorize de Spring Security.
+    Verifica los privilegios del usuario autenticado (tanto en sesiones web como en API JWT).
+    
+    Niveles de permiso estándar:
+    - 'read': Permiso de lectura / consulta
+    - 'read_write': Permiso de modificación y creación
+    - 'admin': Permiso de control total
+    """
+    def decorator(f):
+        @wraps(f)
+        def decorated_function(*args, **kwargs):
+            user = None
+            # Evaluar contexto JWT primero si está presente
+            if hasattr(g, 'jwt_user') and g.jwt_user:
+                user = g.jwt_user
+            elif current_user and current_user.is_authenticated:
+                user = current_user
+
+            is_api = request.path.startswith('/api/') or request.is_json
+
+            if not user:
+                if is_api:
+                    return jsonify({'error': 'Unauthorized', 'message': 'Autenticación requerida.'}), 401
+                flash('Debe iniciar sesión para acceder a este recurso.', 'warning')
+                return redirect(url_for('auth.login', next=request.url))
+
+            # Comprobar privilegios en la matriz RBAC
+            if not user.has_permission(module, min_level):
+                if is_api:
+                    return jsonify({
+                        'error': 'Forbidden',
+                        'message': f'Permiso insuficiente en módulo "{module}". Nivel requerido: "{min_level}".'
+                    }), 403
+                flash(f'No posee permisos suficientes ({min_level}) para gestionar {module}.', 'danger')
+                abort(403)
+
+            return f(*args, **kwargs)
+        return decorated_function
+    return decorator

backend/app/security/filter_chain.py

@@ -0,0 +1,89 @@
+from flask import request, jsonify, g, render_template, Response
+from datetime import datetime, timedelta, timezone
+from typing import Dict, List, Tuple
+import time
+
+class SecurityFilterChain:
+    """
+    Pipeline centralizado de interceptación de seguridad (SecurityFilterChain)
+    inspirado en el patrón arquitectónico de Spring Security.
+    
+    Capas de filtrado activas:
+    1. Security Headers Filter (Blindaje HTTP en todas las respuestas).
+    2. Rate Limiting Filter (Protección contra fuerza bruta y DoS).
+    3. Bearer Token Context Filter (Inyección de identidad contextual).
+    """
+
+    def __init__(self, app=None):
+        # Registro de timestamps de peticiones por IP: ip -> [timestamps]
+        self._request_history: Dict[str, List[float]] = {}
+        # Límites por endpoint sensible (max_requests, window_seconds)
+        self._rate_limits = {
+            '/login': (15, 60),
+            '/api/v1/auth/login': (15, 60),
+            '/api/v1/auth/refresh': (30, 60)
+        }
+        if app:
+            self.init_app(app)
+
+    def init_app(self, app):
+        """Registra los filtros en el ciclo de vida de la aplicación Flask."""
+        app.before_request(self._execute_pre_filters)
+        app.after_request(self._execute_post_filters)
+
+    def _get_client_ip(self) -> str:
+        """Obtiene la IP real del cliente respetando proxies inversos de confianza."""
+        if request.headers.get('X-Forwarded-For'):
+            return request.headers.get('X-Forwarded-For').split(',')[0].strip()
+        return request.remote_addr or '127.0.0.1'
+
+    def _execute_pre_filters(self):
+        """Ejecuta los filtros previos al enrutamiento del controlador."""
+        path = request.path
+        
+        # 1. Rate Limiting Filter (solo para peticiones POST de autenticación sensible)
+        if path in self._rate_limits:
+            # Peticiones GET para cargar la interfaz web NO consumen intentos de fuerza bruta
+            if request.method != 'POST':
+                return
+
+            max_req, window = self._rate_limits[path]
+            client_ip = self._get_client_ip()
+            now = time.time()
+
+            # Limpiar historial fuera de la ventana
+            timestamps = self._request_history.get(client_ip, [])
+            timestamps = [t for t in timestamps if now - t < window]
+            
+            if len(timestamps) >= max_req:
+                retry_after = max(1, int(window - (now - timestamps[0])))
+                if path.startswith('/api/'):
+                    return jsonify({
+                        'error': 'TooManyRequests',
+                        'message': f'Límite de peticiones excedido. Reintente en {retry_after} segundos.'
+                    }), 429
+                
+                # Para la web, renderizar vista o respuesta legible
+                return Response(
+                    f"Demasiados intentos de autenticación desde su dirección IP. Por favor espere {retry_after} segundos antes de volver a intentar.",
+                    status=429,
+                    mimetype='text/plain; charset=utf-8'
+                )
+
+            timestamps.append(now)
+            self._request_history[client_ip] = timestamps
+
+    def _execute_post_filters(self, response):
+        """Inyecta cabeceras de blindaje HTTP (OWASP Secure Headers)."""
+        # Evitar ataques de MIME-Sniffing
+        response.headers['X-Content-Type-Options'] = 'nosniff'
+        # Mitigación de Clickjacking
+        response.headers['X-Frame-Options'] = 'SAMEORIGIN'
+        # Mitigación XSS en navegadores legacy
+        response.headers['X-XSS-Protection'] = '1; mode=block'
+        # Política de Referrer segura
+        response.headers['Referrer-Policy'] = 'strict-origin-when-cross-origin'
+        # Inyección HSTS (si es HTTPS o entorno de producción)
+        response.headers['Strict-Transport-Security'] = 'max-age=31536000; includeSubDomains'
+        
+        return response

backend/app/services/__init__.py

@@ -0,0 +1,19 @@
+from .sheets_importer import GoogleSheetsImporter
+from .classroom_service import ClassroomService
+from .reservation_service import ReservationService
+from .user_service import UserService
+from .jwt_service import JWTService
+from .audit_service import AuditService
+from .optimizer_service import OptimizerService, OptimizerJob, OptimizerJobStatus
+
+__all__ = [
+    'GoogleSheetsImporter',
+    'ClassroomService',
+    'ReservationService',
+    'UserService',
+    'JWTService',
+    'AuditService',
+    'OptimizerService',
+    'OptimizerJob',
+    'OptimizerJobStatus'
+]

backend/app/services/audit_service.py

@@ -0,0 +1,76 @@
+from typing import Optional, List, Dict, Any
+from flask import request, g, has_request_context
+from flask_login import current_user
+import json
+from app import db
+from app.models.audit_log import AuditLog
+from app.models.user import User
+
+class AuditService:
+    """Servicio para la captura y consulta de la bitácora inmutable de auditoría."""
+
+    @staticmethod
+    def log(action: str, module: str, entity_id: Optional[int] = None,
+            details: Optional[Any] = None, user: Optional[User] = None,
+            ip_address: Optional[str] = None) -> AuditLog:
+        """
+        Registra un evento de auditoría de forma segura, infiriendo el usuario e IP
+        desde el contexto actual de la petición si no se especifican.
+        """
+        user_id = None
+        user_email = None
+
+        # 1. Determinar usuario actuante
+        if user:
+            user_id = user.id
+            user_email = user.email
+        elif has_request_context():
+            if hasattr(g, 'jwt_user') and g.jwt_user:
+                user_id = g.jwt_user.id
+                user_email = g.jwt_user.email
+            elif current_user and current_user.is_authenticated:
+                user_id = current_user.id
+                user_email = current_user.email
+
+        # 2. Determinar IP de origen
+        if not ip_address and has_request_context():
+            if request.headers.get('X-Forwarded-For'):
+                ip_address = request.headers.get('X-Forwarded-For').split(',')[0].strip()
+            else:
+                ip_address = request.remote_addr
+
+        # 3. Serializar detalles si es estructura de datos
+        details_str = None
+        if details is not None:
+            if isinstance(details, (dict, list)):
+                try:
+                    details_str = json.dumps(details, ensure_ascii=False)
+                except Exception:
+                    details_str = str(details)
+            else:
+                details_str = str(details)
+
+        log_entry = AuditLog(
+            user_id=user_id,
+            user_email=user_email,
+            action=action.upper(),
+            module=module.lower(),
+            entity_id=entity_id,
+            details=details_str,
+            ip_address=ip_address
+        )
+        try:
+            db.session.add(log_entry)
+            db.session.commit()
+        except Exception:
+            db.session.rollback()
+
+        return log_entry
+
+    @staticmethod
+    def get_recent_logs(limit: int = 50, module: Optional[str] = None) -> List[AuditLog]:
+        """Obtiene las entradas más recientes de auditoría."""
+        query = AuditLog.query
+        if module:
+            query = query.filter_by(module=module.lower())
+        return query.order_by(AuditLog.created_at.desc()).limit(limit).all()

backend/app/services/classroom_service.py

@@ -0,0 +1,118 @@
+from typing import Optional, List, Dict, Any
+import re
+from sqlalchemy import func
+from app.models.classroom import Classroom
+from app.models.building import Building
+from app.repositories.classroom_repository import ClassroomRepository
+from app.schemas.classroom_dto import ClassroomCreateDTO, ClassroomUpdateDTO
+from app import db
+
+class ClassroomService:
+    """Capa de servicios para la lógica de negocio y validación de aulas."""
+
+    def __init__(self, repository: Optional[ClassroomRepository] = None):
+        self.repository = repository or ClassroomRepository()
+
+    def get_classroom(self, classroom_id: int) -> Optional[Classroom]:
+        """Obtiene un aula por su identificador."""
+        return self.repository.get_by_id(classroom_id)
+
+    def list_classrooms(self, building_id: Optional[int] = None, floor: Optional[str] = None,
+                        only_virtual: bool = False, only_physical: bool = False) -> List[Classroom]:
+        """Lista aulas filtradas según criterios de ubicación o modalidad."""
+        return self.repository.get_active_classrooms(
+            building_id=building_id,
+            floor=floor,
+            only_virtual=only_virtual,
+            only_physical=only_physical
+        )
+
+    def create_classroom(self, dto: ClassroomCreateDTO) -> Classroom:
+        """
+        Crea una nueva aula aplicando reglas de negocio:
+        - Resolución o creación dinámica del edificio.
+        - Unicidad de código por piso y edificio.
+        - Capacidad adaptativa para aulas virtuales.
+        """
+        building = None
+        if dto.building_id:
+            building = Building.query.get(dto.building_id)
+            if not building:
+                raise ValueError(f"El edificio con ID {dto.building_id} no existe.")
+        elif dto.building_name:
+            b_name = dto.building_name.strip()
+            building = Building.query.filter(func.lower(Building.name) == func.lower(b_name)).first()
+            if not building:
+                code_slug = re.sub(r'[^a-zA-Z0-9]+', '_', b_name.upper()).strip('_')
+                building = Building(name=b_name, code=code_slug, is_active=True)
+                db.session.add(building)
+                db.session.flush()
+        else:
+            raise ValueError("Debe especificar un edificio válido o el nombre de un nuevo edificio.")
+
+        # Verificar unicidad
+        existing = self.repository.get_by_code_and_building(building.id, dto.code, dto.floor)
+        if existing:
+            raise ValueError(f"Ya existe un aula con el código '{dto.code}' en el piso {dto.floor} de {building.name}.")
+
+        capacity = dto.capacity
+        is_virtual = ('VIRTUAL' in dto.code.upper()) or ('VIRTUAL' in building.name.upper())
+        if is_virtual and capacity < 999:
+            capacity = 9999
+
+        classroom = Classroom(
+            building_id=building.id,
+            building=building.name,
+            code=dto.code,
+            floor=dto.floor,
+            capacity=capacity,
+            description=dto.description,
+            is_active=dto.is_active
+        )
+        return self.repository.save(classroom)
+
+    def update_classroom(self, classroom_id: int, dto: ClassroomUpdateDTO) -> Classroom:
+        """Actualiza atributos de un aula existente."""
+        classroom = self.repository.get_by_id(classroom_id)
+        if not classroom:
+            raise ValueError(f"Aula con ID {classroom_id} no encontrada.")
+
+        building_id = dto.building_id if dto.building_id is not None else classroom.building_id
+        code = dto.code.strip() if dto.code is not None else classroom.code
+        floor = dto.floor.strip() if dto.floor is not None else classroom.floor
+
+        # Si cambia código, piso o edificio, validar colisión
+        if (building_id != classroom.building_id or code != classroom.code or floor != classroom.floor):
+            existing = self.repository.get_by_code_and_building(building_id, code, floor)
+            if existing and existing.id != classroom.id:
+                raise ValueError(f"Ya existe otra aula con el código '{code}' en el piso {floor}.")
+
+        if dto.building_id is not None:
+            building = Building.query.get(dto.building_id)
+            if building:
+                classroom.building_id = building.id
+                classroom.building = building.name
+        if dto.code is not None:
+            classroom.code = code
+        if dto.floor is not None:
+            classroom.floor = floor
+        if dto.capacity is not None:
+            classroom.capacity = dto.capacity
+        if dto.description is not None:
+            classroom.description = dto.description
+        if dto.is_active is not None:
+            classroom.is_active = dto.is_active
+
+        return self.repository.save(classroom)
+
+    def delete_classroom(self, classroom_id: int) -> bool:
+        """Elimina o desactiva un aula verificando dependencias."""
+        classroom = self.repository.get_by_id(classroom_id)
+        if not classroom:
+            return False
+        # Si tiene reservas históricas, se desactiva lógicamente para preservar integridad
+        if classroom.reservations:
+            classroom.is_active = False
+            self.repository.save(classroom)
+            return True
+        return self.repository.delete(classroom)

backend/app/services/enrollment_service.py

@@ -0,0 +1,220 @@
+import re
+from typing import Optional, List, Set, Dict, Any
+from datetime import datetime
+from app import db
+from app.models.user import User
+from app.models.subject import Commission, Subject
+from app.models.enrollment import StudentEnrollment
+from app.models.reservation import Reservation
+
+WEEKDAYS_MAP = {
+    0: 'lunes',
+    1: 'martes',
+    2: 'miercoles',
+    3: 'jueves',
+    4: 'viernes',
+    5: 'sabado',
+    6: 'domingo'
+}
+
+SPANISH_DAYS = ['lunes', 'martes', 'miercoles', 'miércoles', 'jueves', 'viernes', 'sabado', 'sábado', 'domingo']
+
+class EnrollmentService:
+    """
+    Servicio de matriculación y aplicación de reglas de negocio académicas (Fase 2 MVP):
+    - Control estricto de aforo y cupo de comisión.
+    - Prevención de doble inscripción.
+    - Regla de Restricción Diaria del Alumno (máximo 1 asignatura regular por día calendario).
+    - Soporte de excepciones automáticas por curso corto y excepciones autorizadas de Bedelía.
+    """
+
+    @staticmethod
+    def normalize_day(day_str: str) -> str:
+        d = day_str.lower().strip()
+        if 'miér' in d or 'mier' in d:
+            return 'miercoles'
+        if 'sáb' in d or 'sab' in d:
+            return 'sabado'
+        return d
+
+    @classmethod
+    def get_commission_days(cls, commission: Commission) -> Set[str]:
+        """Extrae el conjunto de días de cursada de la comisión desde schedule y reservas activas."""
+        days: Set[str] = set()
+        
+        # 1. Analizar texto del campo schedule
+        if commission.schedule:
+            sched_lower = commission.schedule.lower()
+            for d in SPANISH_DAYS:
+                if re.search(r'\b' + re.escape(d) + r'\b', sched_lower):
+                    days.add(cls.normalize_day(d))
+
+        # 2. Analizar reservas reales de la comisión
+        reservations = Reservation.query.filter(
+            Reservation.commission_id == commission.id,
+            Reservation.status != 'CANCELLED'
+        ).all()
+        for r in reservations:
+            if r.start_time:
+                weekday_idx = r.start_time.weekday()
+                if weekday_idx in WEEKDAYS_MAP:
+                    days.add(WEEKDAYS_MAP[weekday_idx])
+
+        return days
+
+    @classmethod
+    def list_enrollments(cls, commission_id: int) -> List[Dict[str, Any]]:
+        """Lista todos los alumnos matriculados en una comisión con información extendida."""
+        enrollments = StudentEnrollment.query.filter_by(commission_id=commission_id).all()
+        result = []
+        for enr in enrollments:
+            data = enr.to_dict()
+            if enr.student:
+                data['student'] = {
+                    'id': enr.student.id,
+                    'name': enr.student.name,
+                    'email': enr.student.email,
+                    'personal_email': getattr(enr.student, 'personal_email', None),
+                    'phone': getattr(enr.student, 'phone', None),
+                    'document_type': getattr(enr.student, 'document_type', None),
+                    'document_number': getattr(enr.student, 'document_number', None)
+                }
+            result.append(data)
+        return result
+
+    @classmethod
+    def enroll_student(cls, commission_id: int, student_id: int,
+                       notes: Optional[str] = None,
+                       allow_same_day_exception: bool = False,
+                       exception_reason: Optional[str] = None) -> StudentEnrollment:
+        """
+        Matricula a un estudiante en una comisión aplicando la regla de restricción diaria.
+        """
+        commission = Commission.query.get(commission_id)
+        if not commission or not commission.active:
+            raise ValueError(f"La comisión #{commission_id} no existe o no se encuentra activa.")
+
+        student = User.query.get(student_id)
+        if not student or not student.is_active:
+            raise ValueError(f"El alumno #{student_id} no existe o su cuenta se encuentra inactiva.")
+
+        # Verificar si ya está matriculado
+        existing = StudentEnrollment.query.filter_by(commission_id=commission_id, student_id=student_id).first()
+        if existing:
+            if existing.status == 'activo':
+                raise ValueError(f"El alumno {student.name} ya está matriculado activamente en esta comisión.")
+            # Si estaba retirado, se reactiva
+            existing.status = 'activo'
+            existing.notes = notes or existing.notes
+            existing.allow_same_day_exception = allow_same_day_exception
+            existing.exception_reason = exception_reason if allow_same_day_exception else None
+            commission.current_students = (commission.current_students or 0) + 1
+            db.session.commit()
+            return existing
+
+        # Verificar cupo máximo
+        if commission.max_students and (commission.current_students or 0) >= commission.max_students:
+            raise ValueError(f"La comisión ha alcanzado su cupo máximo de {commission.max_students} estudiantes.")
+
+        # ─── REGLA DE RESTRICCIÓN DIARIA DE CURSADA (ESTADIO 2.3) ───
+        target_subject = commission.subject
+        is_target_short_course = bool(target_subject and target_subject.is_short_course)
+        target_days = cls.get_commission_days(commission)
+
+        # Buscar otras inscripciones activas del estudiante
+        active_enrollments = StudentEnrollment.query.filter_by(
+            student_id=student_id,
+            status='activo'
+        ).all()
+
+        for enr in active_enrollments:
+            other_comm = enr.commission
+            if not other_comm or not other_comm.active:
+                continue
+
+            # Verificar si coinciden en el mismo ciclo/semestre/año
+            same_term = (
+                other_comm.year == commission.year and
+                other_comm.semester == commission.semester
+            )
+            if not same_term:
+                continue
+
+            other_subject = other_comm.subject
+            is_other_short_course = bool(other_subject and other_subject.is_short_course)
+
+            # Ambas son materias regulares: no pueden cursarse el mismo día sin excepción
+            if not is_target_short_course and not is_other_short_course:
+                other_days = cls.get_commission_days(other_comm)
+                overlapping_days = target_days.intersection(other_days)
+
+                if overlapping_days:
+                    if allow_same_day_exception:
+                        # Excepción otorgada expresamente por Bedelía
+                        if not exception_reason:
+                            exception_reason = "Autorización expresa de Bedelía para cursada simultánea en el mismo día."
+                    else:
+                        days_display = ", ".join([d.capitalize() for d in overlapping_days])
+                        other_name = other_subject.name if other_subject else other_comm.code
+                        raise ValueError(
+                            f"Restricción de cursada diaria: El alumno ya cursa la materia regular '{other_name}' "
+                            f"el día {days_display}. La normativa de UniCABA prohíbe cursar dos materias regulares "
+                            f"el mismo día calendario salvo curso corto o autorización explícita de Bedelía."
+                        )
+
+        enrollment = StudentEnrollment(
+            student_id=student_id,
+            commission_id=commission_id,
+            status='activo',
+            notes=notes,
+            allow_same_day_exception=allow_same_day_exception,
+            exception_reason=exception_reason if allow_same_day_exception else None
+        )
+        db.session.add(enrollment)
+        commission.current_students = (commission.current_students or 0) + 1
+        db.session.commit()
+        return enrollment
+
+    @classmethod
+    def unenroll_student(cls, commission_id: int, student_id: int) -> bool:
+        """Da de baja o retira a un alumno de una comisión."""
+        enrollment = StudentEnrollment.query.filter_by(
+            commission_id=commission_id,
+            student_id=student_id
+        ).first()
+        if not enrollment:
+            return False
+
+        commission = Commission.query.get(commission_id)
+        if commission and (commission.current_students or 0) > 0:
+            commission.current_students -= 1
+
+        db.session.delete(enrollment)
+        db.session.commit()
+        return True
+
+    @classmethod
+    def update_enrollment_status(cls, commission_id: int, student_id: int, status: str,
+                                notes: Optional[str] = None) -> Optional[StudentEnrollment]:
+        """Actualiza el estado de la matrícula (activo, condicional, retirado)."""
+        enrollment = StudentEnrollment.query.filter_by(
+            commission_id=commission_id,
+            student_id=student_id
+        ).first()
+        if not enrollment:
+            return None
+
+        old_status = enrollment.status
+        enrollment.status = status
+        if notes is not None:
+            enrollment.notes = notes
+
+        commission = Commission.query.get(commission_id)
+        if commission:
+            if old_status == 'activo' and status in ['retirado']:
+                commission.current_students = max(0, (commission.current_students or 1) - 1)
+            elif old_status in ['retirado'] and status == 'activo':
+                commission.current_students = (commission.current_students or 0) + 1
+
+        db.session.commit()
+        return enrollment

backend/app/services/jwt_service.py

@@ -0,0 +1,116 @@
+import jwt
+import uuid
+from datetime import datetime, timedelta, timezone
+from typing import Dict, Any, Optional
+from flask import current_app
+from app.models.user import User
+
+# Lista negra de tokens revocados en memoria (jti -> timestamp de expiración)
+_token_blacklist: Dict[str, datetime] = {}
+
+class JWTService:
+    """Servicio de emisión, verificación y revocación de tokens JWT (Dual Token Pattern)."""
+
+    ACCESS_TOKEN_EXPIRES = timedelta(days=1)
+    REFRESH_TOKEN_EXPIRES = timedelta(days=7)
+    ALGORITHM = "HS256"
+
+    @classmethod
+    def _clean_expired_blacklist(cls):
+        """Limpia periódicamente identificadores de tokens que ya han expirado naturalmente."""
+        now = datetime.now(timezone.utc)
+        expired_jtis = [jti for jti, exp in _token_blacklist.items() if exp < now]
+        for jti in expired_jtis:
+            _token_blacklist.pop(jti, None)
+
+    @classmethod
+    def _get_secret(cls) -> str:
+        """Obtiene la clave secreta desde la configuración de Flask."""
+        return current_app.config.get('SECRET_KEY', 'default-edu-space-secret-key')
+
+    @classmethod
+    def create_access_token(cls, user: User, expires_delta: Optional[timedelta] = None) -> str:
+        """Emite un token de acceso de corta duración (15 min) con claims de rol y permisos."""
+        now = datetime.now(timezone.utc)
+        delta = expires_delta or cls.ACCESS_TOKEN_EXPIRES
+        role_name = user.role_obj.name if user.role_obj else user.role
+        
+        # Mapeo de permisos para claims del token
+        permissions = {}
+        if user.role_obj and hasattr(user.role_obj, 'permissions'):
+            for p in user.role_obj.permissions:
+                permissions[p.module] = p.access_level
+
+        payload = {
+            'sub': str(user.id),
+            'email': user.email,
+            'name': user.name,
+            'role': role_name,
+            'is_admin': user.is_admin(),
+            'permissions': permissions,
+            'type': 'access',
+            'jti': str(uuid.uuid4()),
+            'iat': now,
+            'exp': now + delta
+        }
+        return jwt.encode(payload, cls._get_secret(), algorithm=cls.ALGORITHM)
+
+    @classmethod
+    def create_refresh_token(cls, user: User, expires_delta: Optional[timedelta] = None) -> str:
+        """Emite un token de refresco de larga duración (7 días) para renovación silenciosa."""
+        now = datetime.now(timezone.utc)
+        delta = expires_delta or cls.REFRESH_TOKEN_EXPIRES
+        payload = {
+            'sub': str(user.id),
+            'type': 'refresh',
+            'jti': str(uuid.uuid4()),
+            'iat': now,
+            'exp': now + delta
+        }
+        return jwt.encode(payload, cls._get_secret(), algorithm=cls.ALGORITHM)
+
+    @classmethod
+    def generate_tokens(cls, user: User) -> Dict[str, Any]:
+        """Genera el par de tokens (Access + Refresh) junto con los metadatos del usuario."""
+        access_token = cls.create_access_token(user)
+        refresh_token = cls.create_refresh_token(user)
+        return {
+            'access_token': access_token,
+            'refresh_token': refresh_token,
+            'token_type': 'Bearer',
+            'expires_in': int(cls.ACCESS_TOKEN_EXPIRES.total_seconds())
+        }
+
+    @classmethod
+    def decode_token(cls, token: str, expected_type: str = 'access') -> Dict[str, Any]:
+        """
+        Decodifica y valida la firma, expiración y tipo del token.
+        Lanza jwt.PyJWTError si el token es inválido, expirado o fue revocado.
+        """
+        cls._clean_expired_blacklist()
+        payload = jwt.decode(token, cls._get_secret(), algorithms=[cls.ALGORITHM])
+        
+        jti = payload.get('jti')
+        if jti and jti in _token_blacklist:
+            raise jwt.InvalidTokenError("El token ha sido revocado.")
+
+        token_type = payload.get('type')
+        if token_type != expected_type:
+            raise jwt.InvalidTokenError(f"Tipo de token inválido. Se esperaba '{expected_type}', recibido '{token_type}'.")
+
+        return payload
+
+    @classmethod
+    def revoke_token(cls, token: str) -> bool:
+        """Agrega el identificador del token a la lista negra hasta su fecha natural de expiración."""
+        try:
+            payload = jwt.decode(token, cls._get_secret(), algorithms=[cls.ALGORITHM], options={"verify_exp": False})
+            jti = payload.get('jti')
+            exp_ts = payload.get('exp')
+            if jti and exp_ts:
+                exp_dt = datetime.fromtimestamp(exp_ts, tz=timezone.utc)
+                _token_blacklist[jti] = exp_dt
+                return True
+        except Exception:
+            pass
+        return False

backend/app/services/optimizer_service.py

@@ -0,0 +1,282 @@
+import time
+import uuid
+import threading
+from datetime import datetime, timedelta
+from enum import Enum
+from typing import List, Dict, Any, Optional
+from flask import current_app
+
+from app.models.genetic_algorithm import (
+    ReservationOptimizer, 
+    GeneticAlgorithm, 
+    ReservationRequest, 
+    Classroom
+)
+from app.models.subject import Commission
+from app.schemas.optimizer_dto import SpringBootSyncPayloadDTO
+
+
+class OptimizerJobStatus(str, Enum):
+    PENDING = "PENDING"
+    RUNNING = "RUNNING"
+    COMPLETED = "COMPLETED"
+    FAILED = "FAILED"
+    CANCELLED = "CANCELLED"
+
+
+class OptimizerJob:
+    """Representa un trabajo asíncrono en la cola del optimizador heurístico."""
+
+    def __init__(self, job_id: str, params: Dict[str, Any]):
+        self.job_id = job_id
+        self.status = OptimizerJobStatus.PENDING
+        self.progress = 0
+        self.generation = 0
+        self.total_generations = params.get("generations", 80)
+        self.fitness_score = 0.0
+        self.total_requests = 0
+        self.assigned_reservations = 0
+        self.reservations: List[Dict[str, Any]] = []
+        self.conflicts: List[Dict[str, Any]] = []
+        self.error: Optional[str] = None
+        self.created_at = datetime.utcnow()
+        self.started_at: Optional[datetime] = None
+        self.completed_at: Optional[datetime] = None
+        self.execution_time_ms: Optional[float] = None
+        self.params = params
+
+    def to_dict(self) -> Dict[str, Any]:
+        return {
+            "job_id": self.job_id,
+            "status": self.status.value,
+            "progress": self.progress,
+            "generation": self.generation,
+            "total_generations": self.total_generations,
+            "fitness_score": round(self.fitness_score, 2),
+            "total_requests": self.total_requests,
+            "assigned_reservations": self.assigned_reservations,
+            "reservations": self.reservations,
+            "conflict_count": len(self.conflicts),
+            "conflicts": self.conflicts,
+            "error": self.error,
+            "created_at": self.created_at.isoformat() if self.created_at else None,
+            "started_at": self.started_at.isoformat() if self.started_at else None,
+            "completed_at": self.completed_at.isoformat() if self.completed_at else None,
+            "execution_time_ms": self.execution_time_ms,
+            "params": {k: v for k, v in self.params.items() if k not in ("app",)}
+        }
+
+
+class OptimizerService:
+    """
+    Servicio de alto rendimiento para el Optimizador Heurístico y Cola de Trabajos Asíncronos.
+    Soporta evaluación concurrente multi-hilo y sincronización interoperable con Spring Boot.
+    """
+
+    _jobs: Dict[str, OptimizerJob] = {}
+    _lock = threading.Lock()
+
+    @classmethod
+    def submit_job(
+        cls,
+        commission_ids: List[int],
+        admin_user_id: int,
+        start_date: Optional[datetime] = None,
+        end_date: Optional[datetime] = None,
+        generations: int = 80,
+        population_size: int = 40,
+        workers: int = 4,
+        app = None
+    ) -> OptimizerJob:
+        """
+        Registra y despacha un trabajo de optimización en segundo plano (asíncrono).
+        """
+        job_id = str(uuid.uuid4())
+        params = {
+            "commission_ids": commission_ids,
+            "admin_user_id": admin_user_id,
+            "start_date": start_date,
+            "end_date": end_date,
+            "generations": generations,
+            "population_size": population_size,
+            "workers": workers
+        }
+
+        job = OptimizerJob(job_id, params)
+        with cls._lock:
+            cls._jobs[job_id] = job
+
+        # Si no se pasó app explícitamente, intentar obtener current_app
+        if app is None:
+            try:
+                app = current_app._get_current_object()
+            except Exception:
+                app = None
+
+        thread = threading.Thread(
+            target=cls._run_job_worker,
+            args=(job_id, app),
+            daemon=True,
+            name=f"optimizer-worker-{job_id[:8]}"
+        )
+        thread.start()
+        return job
+
+    @classmethod
+    def _run_job_worker(cls, job_id: str, app):
+        """Worker en segundo plano para ejecutar el algoritmo genético."""
+        job = cls.get_job(job_id)
+        if not job:
+            return
+
+        def _execute():
+            t_start = time.perf_counter()
+            with cls._lock:
+                job.status = OptimizerJobStatus.RUNNING
+                job.started_at = datetime.utcnow()
+
+            def progress_callback(gen: int, total_gen: int, pct: int, best_fit: float):
+                with cls._lock:
+                    job.generation = gen
+                    job.total_generations = total_gen
+                    job.progress = pct
+                    job.fitness_score = best_fit
+
+            optimizer = ReservationOptimizer(
+                population_size=job.params.get("population_size", 40),
+                generations=job.params.get("generations", 80),
+                workers=job.params.get("workers", 4)
+            )
+
+            result = optimizer.optimize_schedule(
+                commission_ids=job.params["commission_ids"],
+                admin_user_id=job.params["admin_user_id"],
+                start_date=job.params.get("start_date"),
+                end_date=job.params.get("end_date"),
+                progress_callback=progress_callback
+            )
+
+            t_end = time.perf_counter()
+            exec_time_ms = round((t_end - t_start) * 1000, 2)
+
+            with cls._lock:
+                job.status = OptimizerJobStatus.COMPLETED
+                job.progress = 100
+                job.fitness_score = result.get("fitness_score", 0.0)
+                job.total_requests = result.get("total_requests", 0)
+                job.assigned_reservations = result.get("assigned_reservations", 0)
+                job.reservations = result.get("reservations", [])
+                job.conflicts = result.get("conflicts", [])
+                job.completed_at = datetime.utcnow()
+                job.execution_time_ms = exec_time_ms
+
+        try:
+            if app:
+                with app.app_context():
+                    _execute()
+            else:
+                _execute()
+        except Exception as ex:
+            with cls._lock:
+                job.status = OptimizerJobStatus.FAILED
+                job.error = str(ex)
+                job.completed_at = datetime.utcnow()
+
+    @classmethod
+    def get_job(cls, job_id: str) -> Optional[OptimizerJob]:
+        """Obtiene un trabajo por su identificador único."""
+        with cls._lock:
+            return cls._jobs.get(job_id)
+
+    @classmethod
+    def list_jobs(cls, limit: int = 50) -> List[Dict[str, Any]]:
+        """Lista los trabajos más recientes ordenados por fecha de creación desc."""
+        with cls._lock:
+            sorted_jobs = sorted(cls._jobs.values(), key=lambda j: j.created_at, reverse=True)
+            return [j.to_dict() for j in sorted_jobs[:limit]]
+
+    @classmethod
+    def sync_with_spring_boot(
+        cls,
+        payload: SpringBootSyncPayloadDTO,
+        admin_user_id: int = 1
+    ) -> Dict[str, Any]:
+        """
+        Procesa una carga de optimización interoperable proveniente de microservicios Spring Boot.
+        Garantiza respuesta conforme al contrato JSON del microservicio.
+        """
+        t_start = time.perf_counter()
+
+        # 1. Resolver aulas disponibles
+        if payload.classrooms and len(payload.classrooms) > 0:
+            classrooms = []
+            for c_dto in payload.classrooms:
+                room = Classroom(
+                    room_number=c_dto.roomNumber,
+                    capacity=c_dto.capacity,
+                    is_virtual=c_dto.isVirtual,
+                    is_active=True
+                )
+                room.id = c_dto.classroomId
+                classrooms.append(room)
+        else:
+            classrooms = Classroom.query.filter_by(is_active=True).all()
+
+        # 2. Generar ReservationRequests desde el DTO de Spring Boot
+        requests: List[ReservationRequest] = []
+        for c in payload.commissions:
+            req = ReservationRequest(
+                commission_id=c.commissionId,
+                expected_attendees=c.expectedAttendees,
+                purpose=f"Spring Boot Class: {c.subjectCode} - {c.subjectName}",
+                preferred_start_time=c.preferredStart,
+                preferred_end_time=c.preferredEnd,
+                priority=1,
+                flexibility_hours=2
+            )
+            requests.append(req)
+
+        # 3. Opciones de configuración de algoritmo
+        options = payload.options or {}
+        generations = options.get("generations", 60)
+        pop_size = options.get("populationSize", 30)
+        workers = options.get("workers", 4)
+
+        ga = GeneticAlgorithm(
+            population_size=pop_size,
+            generations=generations,
+            workers=workers
+        )
+
+        start_date = min(c.preferredStart for c in payload.commissions)
+        end_date = max(c.preferredEnd for c in payload.commissions)
+
+        best_individual = ga.optimize_reservations(requests, classrooms, start_date, end_date)
+
+        t_end = time.perf_counter()
+        exec_ms = round((t_end - t_start) * 1000, 2)
+
+        scheduled_assignments = []
+        for gene in best_individual.genes:
+            scheduled_assignments.append({
+                "commissionId": gene.commission_id,
+                "classroomId": gene.classroom_id,
+                "startTime": gene.start_time.isoformat() if gene.start_time else None,
+                "endTime": gene.end_time.isoformat() if gene.end_time else None,
+                "purpose": gene.purpose,
+                "expectedAttendees": gene.expected_attendees,
+                "status": "SCHEDULED"
+            })
+
+        return {
+            "requestId": payload.requestId,
+            "status": "SUCCESS",
+            "academicTerm": payload.academicTerm,
+            "campusCode": payload.campusCode,
+            "totalCommissions": len(payload.commissions),
+            "scheduledAssignments": scheduled_assignments,
+            "conflictCount": len(best_individual.conflicts),
+            "fitnessScore": round(best_individual.fitness, 2),
+            "executionTimeMs": exec_ms,
+            "timestamp": datetime.utcnow().isoformat() + "Z"
+        }

backend/app/services/reservation_service.py

@@ -0,0 +1,229 @@
+from typing import Optional, List, Dict, Any
+from datetime import datetime
+from app.models.reservation import Reservation, ReservationStatus
+from app.models.classroom import Classroom
+from app.models.subject import Commission, CommissionTeacher
+from app.repositories.reservation_repository import ReservationRepository
+from app.repositories.classroom_repository import ClassroomRepository
+from app.schemas.reservation_dto import ReservationCreateDTO, ReservationUpdateDTO
+from app import db
+
+class ReservationService:
+    """Capa de servicios para la orquestación y validación de reservas y cronograma."""
+
+    def __init__(self, reservation_repo: Optional[ReservationRepository] = None,
+                 classroom_repo: Optional[ClassroomRepository] = None):
+        self.reservation_repo = reservation_repo or ReservationRepository()
+        self.classroom_repo = classroom_repo or ClassroomRepository()
+
+    def get_reservation(self, reservation_id: int) -> Optional[Reservation]:
+        """Obtiene una reserva por su ID."""
+        return self.reservation_repo.get_by_id(reservation_id)
+
+    def list_reservations(self, start_dt: datetime, end_dt: datetime,
+                          classroom_id: Optional[int] = None) -> List[Reservation]:
+        """Obtiene reservas dentro de un rango temporal."""
+        return self.reservation_repo.get_by_date_range(start_dt, end_dt, classroom_id=classroom_id)
+
+    def check_conflicts(self, classroom_id: int, start_time: datetime, end_time: datetime,
+                        exclude_id: Optional[int] = None) -> List[Reservation]:
+        """Verifica si existen solapamientos en un aula específica."""
+        classroom = self.classroom_repo.get_by_id(classroom_id)
+        # Las aulas virtuales tienen concurrencia ilimitada (sin colisiones)
+        if classroom and classroom.is_virtual:
+            return []
+        return self.reservation_repo.find_conflicts(
+            classroom_id=classroom_id,
+            start_time=start_time,
+            end_time=end_time,
+            exclude_reservation_id=exclude_id
+        )
+
+    def check_teacher_conflicts(self, teacher_id: int, start_time: datetime, end_time: datetime,
+                                exclude_id: Optional[int] = None) -> List[Reservation]:
+        """Verifica si el docente ya tiene otra reserva en la misma franja horaria."""
+        if not teacher_id:
+            return []
+        return self.reservation_repo.find_teacher_conflicts(
+            teacher_id=teacher_id,
+            start_time=start_time,
+            end_time=end_time,
+            exclude_reservation_id=exclude_id
+        )
+
+    def check_full_conflicts_matrix(self, classroom_id: int, start_time: datetime, end_time: datetime,
+                                   teacher_id: Optional[int] = None,
+                                   commission_id: Optional[int] = None,
+                                   expected_attendees: Optional[int] = None,
+                                   allow_co_teaching_exception: bool = False,
+                                   exclude_id: Optional[int] = None) -> Dict[str, Any]:
+        """
+        Matriz completa de validación de conflictos (Fase 2 MVP):
+        1. Conflicto físico de aula (bloqueo estricto para aulas físicas).
+        2. Conflicto docente (detección con soporte de co-docencia).
+        3. Conflicto de aforo (capacidad física).
+        """
+        classroom = self.classroom_repo.get_by_id(classroom_id)
+        if not classroom or not classroom.is_active:
+            raise ValueError(f"El aula con ID {classroom_id} no existe o no se encuentra activa.")
+
+        commission = None
+        if commission_id:
+            commission = Commission.query.get(commission_id)
+            if not teacher_id and commission:
+                teacher_id = commission.teacher_id
+
+        # 1. Conflicto Físico
+        physical_conflicts = []
+        if not classroom.is_virtual:
+            physical_conflicts = self.check_conflicts(classroom_id, start_time, end_time, exclude_id=exclude_id)
+
+        # 2. Conflicto Docente y Co-docencia
+        teacher_conflicts = []
+        has_co_teaching_coverage = False
+        co_teachers_list = []
+
+        if teacher_id:
+            teacher_conflicts = self.check_teacher_conflicts(teacher_id, start_time, end_time, exclude_id=exclude_id)
+            if teacher_conflicts and commission:
+                # Comprobar si la comisión cuenta con equipo docente de respaldo
+                co_teachers = CommissionTeacher.query.filter_by(commission_id=commission.id).all()
+                other_teachers = [ct for ct in co_teachers if ct.user_id != teacher_id]
+                if other_teachers:
+                    has_co_teaching_coverage = True
+                    co_teachers_list = [
+                        {'id': ct.user_id, 'name': ct.teacher.name if ct.teacher else 'Docente', 'role': ct.role}
+                        for ct in other_teachers
+                    ]
+
+        # 3. Conflicto de Aforo
+        has_capacity_conflict = False
+        capacity_message = None
+        if not classroom.is_virtual and expected_attendees is not None:
+            if expected_attendees > classroom.capacity:
+                has_capacity_conflict = True
+                capacity_message = f"La cantidad esperada ({expected_attendees}) supera la capacidad del aula ({classroom.capacity})."
+
+        # Evaluación de Bloqueos
+        block_reasons = []
+        if physical_conflicts:
+            c_strs = [f"#{c.id} ({c.start_time.strftime('%H:%M')} a {c.end_time.strftime('%H:%M')})" for c in physical_conflicts]
+            block_reasons.append(f"Conflicto de horario en aula {classroom.code}: se solapa con las reservas {', '.join(c_strs)}.")
+
+        if has_capacity_conflict:
+            block_reasons.append(f"Conflicto de aforo: {capacity_message}")
+
+        if teacher_conflicts:
+            if has_co_teaching_coverage or allow_co_teaching_exception:
+                # Cobertura justificada por equipo de co-docencia
+                pass
+            else:
+                t_strs = [f"#{c.id} ({c.start_time.strftime('%H:%M')} a {c.end_time.strftime('%H:%M')})" for c in teacher_conflicts]
+                block_reasons.append(f"Conflicto de horario docente: el profesor ya tiene clases asignadas en {', '.join(t_strs)} y la comisión no cuenta con equipo de co-docencia.")
+
+        is_blocked = len(block_reasons) > 0
+        return {
+            'is_valid': not is_blocked,
+            'is_blocked': is_blocked,
+            'block_reasons': block_reasons,
+            'physical_conflicts': [c.to_dict() for c in physical_conflicts],
+            'teacher_conflicts': [c.to_dict() for c in teacher_conflicts],
+            'has_co_teaching_coverage': has_co_teaching_coverage,
+            'co_teachers': co_teachers_list,
+            'has_capacity_conflict': has_capacity_conflict,
+            'classroom': classroom.to_dict()
+        }
+
+    def create_reservation(self, dto: ReservationCreateDTO) -> Reservation:
+        """
+        Crea una nueva reserva aplicando la matriz integral de conflictos.
+        """
+        matrix = self.check_full_conflicts_matrix(
+            classroom_id=dto.classroom_id,
+            start_time=dto.start_time,
+            end_time=dto.end_time,
+            teacher_id=dto.user_id,
+            commission_id=dto.commission_id,
+            expected_attendees=dto.expected_attendees,
+            allow_co_teaching_exception=getattr(dto, 'allow_co_teaching_exception', False)
+        )
+        if matrix['is_blocked']:
+            raise ValueError(" | ".join(matrix['block_reasons']))
+
+        reservation = Reservation(
+            classroom_id=dto.classroom_id,
+            commission_id=dto.commission_id,
+            user_id=dto.user_id,
+            start_time=dto.start_time,
+            end_time=dto.end_time,
+            purpose=dto.purpose,
+            expected_attendees=dto.expected_attendees,
+            shift=dto.shift,
+            virtual_link=dto.virtual_link,
+            notes=dto.notes,
+            status=dto.status or 'CONFIRMED'
+        )
+        return self.reservation_repo.save(reservation)
+
+    def update_reservation(self, reservation_id: int, dto: ReservationUpdateDTO) -> Reservation:
+        """Actualiza una reserva existente verificando disponibilidad horaria y matriz de conflictos."""
+        reservation = self.reservation_repo.get_by_id(reservation_id)
+        if not reservation:
+            raise ValueError(f"Reserva con ID {reservation_id} no encontrada.")
+
+        classroom_id = dto.classroom_id or reservation.classroom_id
+        start_time = dto.start_time or reservation.start_time
+        end_time = dto.end_time or reservation.end_time
+        expected_attendees = dto.expected_attendees if dto.expected_attendees is not None else reservation.expected_attendees
+
+        matrix = self.check_full_conflicts_matrix(
+            classroom_id=classroom_id,
+            start_time=start_time,
+            end_time=end_time,
+            teacher_id=reservation.user_id,
+            commission_id=reservation.commission_id,
+            expected_attendees=expected_attendees,
+            allow_co_teaching_exception=getattr(dto, 'allow_co_teaching_exception', False),
+            exclude_id=reservation.id
+        )
+        if matrix['is_blocked']:
+            raise ValueError(" | ".join(matrix['block_reasons']))
+
+        if dto.classroom_id is not None:
+            reservation.classroom_id = dto.classroom_id
+        if dto.start_time is not None:
+            reservation.start_time = dto.start_time
+        if dto.end_time is not None:
+            reservation.end_time = dto.end_time
+        if dto.purpose is not None:
+            reservation.purpose = dto.purpose
+        if dto.expected_attendees is not None:
+            reservation.expected_attendees = dto.expected_attendees
+        if dto.shift is not None:
+            reservation.shift = dto.shift
+        if dto.virtual_link is not None:
+            reservation.virtual_link = dto.virtual_link
+        if dto.notes is not None:
+            reservation.notes = dto.notes
+        if dto.status is not None:
+            reservation.status = dto.status
+
+        return self.reservation_repo.save(reservation)
+
+    def cancel_reservation(self, reservation_id: int) -> bool:
+        """Cancela una reserva estableciendo su estado en CANCELLED."""
+        reservation = self.reservation_repo.get_by_id(reservation_id)
+        if not reservation:
+            return False
+        reservation.status = ReservationStatus.CANCELLED.value
+        self.reservation_repo.save(reservation)
+        return True
+
+    def confirm_reservation(self, reservation_id: int) -> bool:
+        """Confirma una reserva estableciendo su estado en CONFIRMED."""
+        reservation = self.reservation_repo.get_by_id(reservation_id)
+        if not reservation:
+            return False
+        reservation.status = ReservationStatus.CONFIRMED.value
+        self.reservation_repo.save(reservation)
+        return True

backend/app/services/sheets_importer.py

@@ -2,6 +2,7 @@ import urllib.request
 import csv
 import io
 import re
+import os
 from datetime import datetime, date, time, timedelta
 from app import db
 from app.models.classroom import Classroom
@@ -12,6 +13,34 @@ from app.models.user import User
 
 BASE_CSV_URL = 'https://docs.google.com/spreadsheets/d/e/2PACX-1vSc_T_BQjbn3uPelioCgx52UM5Py-qNhJN0TYPd1kmsN5jdb3Q8rAaIvNMF_2ZTzQt6bH--yIWQKrKR/pub?single=true&output=csv'
 
+def normalize_sheets_url(url):
+    """
+    Normaliza enlaces de Google Sheets (compartidos, de edición o publicados)
+    para obtener la URL base que acepta parámetro gid=<gid>&output=csv o format=csv.
+    """
+    if not url:
+        return BASE_CSV_URL
+    url = url.strip()
+    
+    # 1. Enlace publicado web (/d/e/2PACX-.../pub...)
+    if '/d/e/' in url:
+        base_match = re.match(r'^(https://docs\.google\.com/spreadsheets/d/e/[^/?#]+)/pub', url)
+        if base_match:
+            return f"{base_match.group(1)}/pub?single=true&output=csv"
+        clean = url.split('&gid=')[0].split('?gid=')[0]
+        sep = '&' if '?' in clean else '?'
+        if 'output=csv' not in clean:
+            clean = f"{clean}{sep}single=true&output=csv"
+        return clean
+
+    # 2. Enlace de edición o visualización (/d/<SPREADSHEET_ID>/edit...)
+    sheet_id_match = re.search(r'/spreadsheets/d/([a-zA-Z0-9-_]+)', url)
+    if sheet_id_match:
+        sheet_id = sheet_id_match.group(1)
+        return f"https://docs.google.com/spreadsheets/d/{sheet_id}/export?format=csv"
+
+    return url
+
 SHEETS_CONFIG = [
     { 'name': 'Lunes', 'gid': '1915752353', 'day_idx': 0 },
     { 'name': 'Martes', 'gid': '466778263', 'day_idx': 1 },
@@ -30,16 +59,30 @@ class GoogleSheetsImporter:
     """
 
     def __init__(self, base_url=None):
-        self.base_url = base_url or BASE_CSV_URL
+        if base_url:
+            self.base_url = normalize_sheets_url(base_url)
+        else:
+            configured_url = None
+            try:
+                from app.models.setting import SystemSetting
+                configured_url = SystemSetting.get_value('google_sheets_url')
+            except Exception:
+                pass
+            if not configured_url:
+                configured_url = os.getenv('GOOGLE_SHEETS_URL')
+            self.base_url = normalize_sheets_url(configured_url) if configured_url else BASE_CSV_URL
 
     def fetch_sheet_csv(self, gid):
         """Fetch CSV string for a specific sheet gid"""
-        url = f"{self.base_url}&gid={gid}"
+        separator = '&' if '?' in self.base_url else '?'
+        url = f"{self.base_url}{separator}gid={gid}"
+        if not (url.startswith('https://') or url.startswith('http://')):
+            raise ValueError(f"URL scheme not permitted: {url}")
         req = urllib.request.Request(
             url,
             headers={'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) EduSpace/2.0'}
         )
-        with urllib.request.urlopen(req, timeout=15) as resp:
+        with urllib.request.urlopen(req, timeout=25) as resp:  # nosec B310
             return resp.read().decode('utf-8', errors='replace')
 
     def parse_sheet_rows(self, csv_content, sheet_name):
@@ -366,16 +409,36 @@ class GoogleSheetsImporter:
                 # 5. Generate Calendar Reservations
                 t_start, t_end = self.parse_time_range(horario_raw)
                 if classroom and t_start and t_end and day_idx is not None:
+                    is_room_virtual = bool(classroom.is_virtual or 'VIRTUAL' in (classroom.code or '').upper())
+                    
+                    # Generar enlace de videollamada para clases virtuales si no tienen uno asignado
+                    v_link = None
+                    if is_room_virtual:
+                        clean_subj = re.sub(r'[^a-zA-Z0-9]', '', subject.code or 'cls').lower()
+                        clean_comm = re.sub(r'[^a-zA-Z0-9]', '', commission.code or 'c1').lower()
+                        v_link = f"https://meet.google.com/edu-{clean_subj}-{clean_comm}"
+                        if not commission.virtual_link:
+                            commission.virtual_link = v_link
+
                     for w in range(weeks_to_generate):
                         class_date = base_monday + timedelta(days=day_idx, weeks=w)
                         dt_start = datetime.combine(class_date, t_start)
                         dt_end = datetime.combine(class_date, t_end)
 
-                        existing_res = Reservation.query.filter_by(
+                        # En aulas virtuales la capacidad es infinita y pueden cursar múltiples comisiones en paralelo
-                            classroom_id=classroom.id,
+                        if is_room_virtual:
-                            start_time=dt_start,
+                            existing_res = Reservation.query.filter_by(
-                            end_time=dt_end
+                                classroom_id=classroom.id,
-                        ).first()
+                                commission_id=commission.id,
+                                start_time=dt_start,
+                                end_time=dt_end
+                            ).first()
+                        else:
+                            existing_res = Reservation.query.filter_by(
+                                classroom_id=classroom.id,
+                                start_time=dt_start,
+                                end_time=dt_end
+                            ).first()
 
                         if not existing_res:
                             res = Reservation(
@@ -386,8 +449,9 @@ class GoogleSheetsImporter:
                                 end_time=dt_end,
                                 purpose=f"{subject.code} - {subject.name}",
                                 status='CONFIRMED',
-                                expected_attendees=min(classroom.capacity, 30),
+                                expected_attendees=min(classroom.capacity, 30) if not is_room_virtual else 35,
                                 shift=turno,
+                                virtual_link=v_link,
                                 notes=f"Clase semanal {dia} ({turno}) - Carrera: {career.name}"
                             )
                             db.session.add(res)
@@ -395,6 +459,8 @@ class GoogleSheetsImporter:
                         else:
                             existing_res.shift = turno
                             existing_res.notes = f"Clase semanal {dia} ({turno}) - Carrera: {career.name}"
+                            if is_room_virtual and not existing_res.virtual_link:
+                                existing_res.virtual_link = v_link
 
                 if len(stats['sample_records']) < 10:
                     stats['sample_records'].append({

backend/app/services/user_service.py

@@ -0,0 +1,53 @@
+from typing import Optional, Dict, Any
+from datetime import datetime
+from app.models.user import User
+from app.repositories.user_repository import UserRepository
+from app import db
+
+class UserService:
+    """Capa de servicios para la autenticación, roles y perfil de usuarios."""
+
+    def __init__(self, repository: Optional[UserRepository] = None):
+        self.repository = repository or UserRepository()
+
+    def authenticate(self, email: str, password: str) -> Optional[User]:
+        """
+        Valida credenciales de acceso de un usuario.
+        Retorna la entidad User si es válido y activo; None en caso contrario.
+        """
+        user = self.repository.get_by_email(email)
+        if not user or not user.is_active:
+            return None
+
+        if user.check_password(password):
+            user.last_login = datetime.utcnow()
+            self.repository.save(user)
+            return user
+        return None
+
+    def get_by_id(self, user_id: int) -> Optional[User]:
+        """Obtiene un usuario por ID."""
+        return self.repository.get_by_id(user_id)
+
+    def get_by_email(self, email: str) -> Optional[User]:
+        """Obtiene un usuario por email."""
+        return self.repository.get_by_email(email)
+
+    def get_profile_data(self, user: User) -> Dict[str, Any]:
+        """Genera un diccionario estructurado del perfil y permisos del usuario."""
+        role_name = user.role_obj.name if user.role_obj else user.role
+        permissions = {}
+        if user.role_obj and hasattr(user.role_obj, 'permissions'):
+            for p in user.role_obj.permissions:
+                permissions[p.module] = p.access_level
+
+        return {
+            'id': user.id,
+            'name': user.name,
+            'email': user.email,
+            'role': role_name,
+            'is_admin': user.is_admin(),
+            'permissions': permissions,
+            'preferred_language': user.preferred_language,
+            'theme_preference': user.theme_preference
+        }

backend/app/utils/jwt_decorators.py

@@ -0,0 +1,86 @@
+from functools import wraps
+from flask import request, jsonify, g
+import jwt
+from app.services.jwt_service import JWTService
+from app.models.user import User
+
+def jwt_required(f):
+    """
+    Decorador para proteger endpoints REST mediante Bearer Token JWT.
+    Extrae y valida el token, inyectando el usuario en 'g.jwt_user' y el payload en 'g.jwt_payload'.
+    """
+    @wraps(f)
+    def decorated_function(*args, **kwargs):
+        auth_header = request.headers.get('Authorization', '')
+        token = None
+
+        if auth_header.startswith('Bearer '):
+            token = auth_header.split(' ', 1)[1].strip()
+        elif 'access_token' in request.cookies:
+            token = request.cookies.get('access_token')
+
+        if not token:
+            return jsonify({
+                'error': 'Unauthorized',
+                'message': 'Encabezado Authorization con Bearer token no proporcionado.'
+            }), 401
+
+        try:
+            payload = JWTService.decode_token(token, expected_type='access')
+            user_id = int(payload.get('sub'))
+            from app import db
+            user = db.session.get(User, user_id)
+
+            if not user or not user.is_active:
+                return jsonify({
+                    'error': 'Unauthorized',
+                    'message': 'Usuario no encontrado o cuenta desactivada.'
+                }), 401
+
+            g.jwt_user = user
+            g.jwt_payload = payload
+            g.jwt_token = token
+
+        except jwt.ExpiredSignatureError:
+            return jsonify({
+                'error': 'TokenExpired',
+                'message': 'El token de acceso ha expirado. Por favor renueve su sesión.'
+            }), 401
+        except jwt.InvalidTokenError as e:
+            return jsonify({
+                'error': 'InvalidToken',
+                'message': str(e)
+            }), 401
+        except Exception as e:
+            return jsonify({
+                'error': 'AuthenticationError',
+                'message': f'Fallo en la verificación del token: {str(e)}'
+            }), 401
+
+        return f(*args, **kwargs)
+    return decorated_function
+
+def jwt_role_required(*allowed_roles):
+    """
+    Decorador que verifica que el usuario autenticado vía JWT posea alguno de los roles permitidos.
+    """
+    def decorator(f):
+        @wraps(f)
+        @jwt_required
+        def decorated_function(*args, **kwargs):
+            user: User = g.jwt_user
+            if user.is_admin():
+                return f(*args, **kwargs)
+
+            user_role = (user.role_obj.name if user.role_obj else user.role).upper()
+            allowed = [r.upper() for r in allowed_roles]
+
+            if user_role not in allowed:
+                return jsonify({
+                    'error': 'Forbidden',
+                    'message': f'Acceso denegado. Se requiere uno de los siguientes roles: {", ".join(allowed_roles)}'
+                }), 403
+
+            return f(*args, **kwargs)
+        return decorated_function
+    return decorator