feat(presentation): suite ejecutiva de entregables con rediseño integral de presentación PPTX y HTML interactivo v3.8.57

This commit is contained in:
2026-11-04 15:10:20 -03:00
parent 71480ee309
commit 60036370a0
14 changed files with 3784 additions and 323 deletions
+12
View File
@@ -11,6 +11,18 @@ El formato está basado en [Keep a Changelog](https://keepachangelog.com/es-ES/1
- **Sincronización Continua Moodle (Fase 6):** Automatización de workers persistentes en background para el procesamiento continuo de la cola de Web Services Moodle 4.1.
- **Pruebas de Carga y Hardening (Fase 6):** Pruebas de estrés de concurrencia y validación final de producción.
## [3.8.57] - 2026-11-04
### Added & Enhanced (Suite Ejecutiva de Entregables Académicos y Presentación de Alta Gama)
- **Generación y Rediseño Integral de la Presentación Ejecutiva (PPTX & HTML Interactivo)**:
- **Presentación PowerPoint Widescreen (PRESENTACION_EJECUTIVA_DIAPOSITIVAS.pptx)**: Generación programática de 14 diapositivas corporativas 16:9 con paleta institucional obsidian/slate (#0A0E1A), tarjetas de métricas, badges y capturas de pantalla de producción incrustadas.
- **Presentación Ejecutiva Web Interactiva (PRESENTACION_EJECUTIVA.html)**: Motor web autocontenido con navegación fluida por teclado (flechas, espacio), modo pantalla completa nativo (F), panel retráctil de notas de orador (N), lightbox para ampliación de capturas a resolución completa y barra de progreso animada.
- **Mapeo Real de Producción**: Incrustación de las 12 capturas de pantalla de alta resolución obtenidas directamente del servidor productivo (https://eduspace.oemspot.com.ar).
- **Paquete Completo de Entregables para la Cátedra (Programación de Vanguardia - Carlos Facundo Tello)**:
- INFORME_TECNICO_PROYECTO_FINAL.md: Memoria técnica de 426 líneas cubriendo la rúbrica de 100 puntos, C4 diagrams, DER relacional y función de fitness del algoritmo genético.
- GUIA_DEMOSTRACION_Y_EVALUACION_DOCENTE.md: Guía de evaluación rápida para el Ing. Alejandro Vázquez con credenciales de prueba por cada rol y rutas de verificación.
- MINUTAS_Y_EVIDENCIAS_GESTION_AGIL.md: Evidencias de gestión ágil, ADRs 001 a 005 y trazabilidad de especificaciones SDD (001 a 013).
- GALERIA_DE_CAPTURAS.md y README.md de entregables actualizados y sincronizados.
## [3.8.56] - 2026-11-04
### Fixed & Enhanced (Consolidación al 04/11/2026, Eliminación de Fondos Invasivos, Optimización de Buffer Serial y Documentación Integral)
- **Eliminación Total de Fondos Gráficos Invasivos en Recepción (`/reception/scanner`)**:
+316 -313
View File
@@ -1,310 +1,313 @@
# MEMORY.md - admin-edu-space
Memoria del proyecto entre sesiones para la rama `dev`.
## Estado actual
- Fases 0 a 5.1 del Roadmap completadas y estabilizadas:
- Arquitectura desacoplada: Backend Core FastAPI ASGI REST API (:5000) + Frontend BFF Node.js/Express (:3000).
- Cobertura 100% ABM: Sedes/Edificios, Aulas (físicas/virtuales), Ciclos Lectivos, Carreras, Materias, Comisiones y Reservas.
- Matriz integral de conflictos (físico, docente con co-docencia, aforo y restricción diaria del alumno).
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Eliminación de Fondos Invasivos y Corrección Definitiva en Resolución Universal de DNI (v3.8.56)**:
- **Eliminación Total de Fondos Gráficos Invasivos**: Se retiraron `bg_course-card.png`, `square_course_name.png` y `mini_logo_icon.png` de la consola de recepción, dejando la UI limpia, sobria, sin recuadros recortados y con máxima nitidez.
- **Corrección Crítica en Resolución de DNI (Bug de Interceptación por Puntos)**: Se solucionó el problema donde cualquier entrada con dos puntos (ej. `34.247.025` o fechas de emisión/nacimiento `09.02.89` en códigos de barras Renaper) era catalogada como JWT y abortaba con error de firma. Ahora se exige estructura Base64URL pura y en caso de error continúa con la resolución de DNI.
- **Soporte de Prefijos y Caracteres**: Manejo universal de prefijos `DNI:`, delimitadores `;` y protección de la letra `Ñ` en apellidos y nombres.
- **Versión Consolidada**: `v3.8.56`.
## Decisiones (y por qué)
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.
- **Asociación Explícita de Carreras**: Toda Asignatura se vincula a su Carrera y toda Comisión hereda y expone la Carrera, permitiendo filtros y búsquedas específicas por titulación.
- **Importador de Google Sheets Preservado**: Se conserva como ingestor inicial masivo sin fricción para no interrumpir el flujo actual del personal.
- **Guía Operativa por Rol**: Documentar explícitamente el procedimiento para Bedelía, Docentes y Alumnos para facilitar la adopción inmediata.
## Aprendizajes y errores a evitar
- **Colisiones Virtuales**: En aulas virtuales no debe aplicarse colisión física horaria; múltiples comisiones pueden cursar simultáneamente con enlaces independientes.
- **Manejo de Estados Vacíos (Empty States)**: Proteger siempre las vistas de plantillas en Nunjucks contra colecciones vacías para evitar errores 500 cuando se reinicializa la base.
- **Seguridad de Secretos**: Mantener `.credenciales` y `.env` estrictamente fuera del índice de Git.
- **Depuración de Mocks en Dashboard**: Se eliminaron los arrays estáticos de fallback (`upcoming_reservations`, `today_schedule_list`, etc.) en `frontend/src/routes/dashboard.js` que mostraban asignaturas ficticias ("Matemática Discreta", "Sistemas Operativos", "Ingeniería de Software") en ausencia de datos reales.
- **Resolución de Error 500 en Aulas Presenciales y Virtuales**: Se reparó el balance de etiquetas de Nunjucks en `frontend/views/classrooms/list.html` y se reubicaron los modales de eliminación en el bloque físico. Validado con HTTP 200 en `/classrooms/list_classrooms?view_mode=physical` y `view_mode=virtual`.
- **Estandarización de Versiones (v3.4.0)**: Expuesto en Backend (`/api/v1/version`), Frontend BFF (`/version`), badges en el pie de página de la barra lateral (`sidebar-footer`) y en la pantalla de inicio de sesión (`login.html`).
- **Materias Compartidas en Múltiples Carreras (Many-to-Many)**: Se creó la tabla `subject_careers` en la base de datos relacional para asociar una materia a múltiples carreras simultáneamente (ej: IOT en DATOS, TEC. DIG y VIDEOJUEGOS, o Teoría y Práctica en PROF PROF y CIENCIAS), manteniendo `career_id` principal por retrocompatibilidad.
- **Normalización del Importador de Google Sheets**: `sheets_importer.py` descubre dinámicamente las 6 pestañas semanales (Lunes a Sábado), desglosa y mapea de forma canónica las carreras separadas por guion (`-`), soporta códigos combinados (`/`) y desglosa métricas por día de cursada (`by_day`).
- **Reactivación de Bedelía en Producción**: Activada la cuenta `bedelia@edu-space.com` para trabajo operativo institucional continuo.
- **Corrección de Vistas de Bedelía (Reservas de Hoy, Semana, Aulas Libres y Comisiones Sin Aula)**:
- **Causa Raíz de Reservas Vacías**: `sheets_importer.py` generaba reservas únicamente para `weeks_to_generate = 4` a partir del 31 de agosto de 2026 (finalizando el 26 de septiembre). En la fecha actual de octubre de 2026 (`2026-10-07`), la base de datos tenía 0 reservas para el día y la semana. Se amplió a `weeks_to_generate = 16` cubriendo todo el 2° cuatrimestre regular (hasta el 19 de diciembre de 2026), generando **2464 reservas totales**, **34 clases para hoy** y **154 clases para la semana actual**.
- **Fecha Dinámica en Cartelera**: Se corrigió `handleTodaySchedule` en `frontend/src/routes/schedule.js` que tenía hardcodeado `2026-09-18` como fecha por defecto, reemplazándolo por la fecha actual ISO (`new Date().toISOString().split('T')[0]`) y añadiendo navegación interactiva entre días (`prev_date`, `next_date`, y botón "Hoy").
- **Panel Operativo de Cartelera & Agenda en Dashboard**: Se incorporó en el Dashboard de Bedelía la sección "Cartelera Operativa & Agenda de Clases" con tabs dinámicos para alternar entre "Clases de Hoy" y "Esta Semana", visualizando horario, aula física o sala virtual (con enlace directo a Meet), materia, comisión, turno y docente.
- **Aulas Disponibles por Período**: Se agregó el selector interactivo "Hoy" (con 18 aulas libres detectadas para el día), "Esta Semana" y "Este Mes" en el panel `#bedelia-available-classrooms`, permitiendo asignar aulas libres con un clic.
- **Comisiones Sin Aula Física ni Virtual**: Se agregó el tab "Sin Aula Física ni Virtual (General)" en `#bedelia-unassigned-commissions` para identificar comisiones sin asignación de espacio, y se añadió la columna "Espacio / Aula" con filtro rápido `unassigned_room=true` en `/admin/commissions_list`.
- **Filtrado Temporal de Aulas y Comisiones (Día, Semana y Mes)**:
- **Requerimiento**: Poder filtrar tanto **Aulas Asignadas** vs **Aulas Sin Asignar (Libres)** como **Comisiones Asignadas** vs **Comisiones Sin Asignar** por **Día**, **Semana** y **Mes**, con la opción de **Día por defecto** y aclarando la **fecha explícita** para fácil identificación de todos los usuarios.
- **Backend (`dashboard.py`)**: Se calculan estructuras `filter_stats` para los tres períodos (`today`, `week`, `month`) con métricas precisas (counts, porcentajes) y diccionarios legibles `date_labels` en español ("Hoy · Miércoles 07/10/2026", "Semana del 05/10 al 11/10/2026", "Mes de Octubre 2026").
- **Frontend BFF & UI (`dashboard.js`, `dashboard.html`)**:
- **Panel de Percentiles**: Switcher interactivo `[ Día (Hoy) ]` (activo por defecto), `[ Semana ]` y `[ Mes ]` con badge explícito de fecha y barras reactivas.
- **Panel de Comisiones**: Switcher `[ Día (Hoy) ]`, `[ Semana ]`, `[ Mes ]` con badge de fecha explícita, más pestañas para conmutar entre "Comisiones Asignadas (Con Aula)" y "Comisiones Sin Asignar (Pendientes)" con acciones directas para asignar espacio.
- **Panel de Aulas**: Switcher `[ Día (Hoy) ]`, `[ Semana ]`, `[ Mes ]` con badge de fecha explícita, más pestañas para conmutar entre "Aulas Sin Asignar (Libres)" y "Aulas Asignadas (En Uso)" con acceso directo a cartelera o asignación inmediata.
- **Validación en Producción**: Desplegado en `https://eduspace.oemspot.com.ar` y verificado con éxito (HTTP 200 en login de Bedelía y renderizado exacto de datos reales).
- **Evolución del Importador de Google Sheets (Filtros por Carrera, Materia, Día y Fecha Manual)**:
- **Requerimiento**: Permitir filtrar qué Carrera, qué Materia y qué Día importar desde el Google Sheet online de UniCABA, como así también agregar la fecha manualmente para corregir o evitar errores si el Sheet no tiene la fecha o se requiere asignar una clase puntual en el calendario.
- **Backend (`sheets_importer.py` & `dashboard.py`)**:
- Se implementó `inspect_sheet_content()` que descarga e inspecciona las 6 hojas del Sheet online en ~7s, descubriendo de forma dinámica todas las Carreras únicas (18 carreras detectadas) y Materias únicas (206 materias detectadas).
- Se agregaron los parámetros `filter_career`, `filter_subject`, `filter_day`, `manual_date` y `single_date_only` al método `sync(...)`.
- Normalización robusta de días con `normalize_day_name(...)` insensible a acentos y mayúsculas.
- Soporte de coincidencia parcial y sensible a carreras compuestas (ej: `DATOS (CCC)` coincide con asignaturas compartidas con `TEC. DIG.` y `VIDEOJUEGOS`).
- Soporte de asignación de fecha puntual manual (`single_date_only=True`), creando 1 única reserva para esa fecha exacta en vez de las 16 semanas regulares, o tomando la fecha manual como base del cuatrimestre.
- Nuevo endpoint REST `GET/POST /api/v1/dashboard/sheets-inspect` y actualización de `/api/v1/dashboard/sync-sheets`.
- **Frontend BFF & UI (`admin.js` & `import.html`)**:
- Panel interactivo "Sincronización Académica con Filtros Avanzados y Control de Fecha".
- Selectores dinámicos de Día (Todos, Lunes, Martes, etc.), inputs con autocompletado `<datalist>` para Carreras y Materias.
- Selector interactivo de Fecha Manual (`type="date"`) con switch toggle para "Importar ÚNICAMENTE para esta fecha puntual".
- Botón "Inspeccionar Sheet Online" con llamada AJAX a `/admin/sheets_inspect` que carga en vivo las carreras y materias descubiertas.
- Tarjeta de informe detallado post-sincronización con badges temáticos de "Filtros Activos", número de "Filas Coincidentes" vs totales, y modo de generación.
- **Validación en Producción**:
- Pruebas automatizadas de backend: 49 tests aprobados en pytest (100% passed).
- Desplegado en producción institucional (`https://eduspace.oemspot.com.ar`).
- Verificación online con `bedelia@edu-space.com`: HTTP 200 en `/admin/google_sheets_import`, endpoint `/admin/sheets_inspect` retornando 239 filas y 18 carreras, y sincronización filtrada con éxito (ej. Martes + DATOS procesando exactamente sus 3 filas coincidentes).
- **Sprint v3.4.1: Corrección de Bug en Import Sheet, Aulas Virtuales en Bedelía, Modularización de Vistas y Reglas de Workflow**:
- **Fix Bug Google Sheets Import (`Error loading Google Sheets sync view`)**:
- **Causa Raíz**: `availableCareers` y `availableSubjects` se declaraban únicamente dentro de un bloque condicional en `admin.js`, provocando `ReferenceError: availableCareers is not defined` en peticiones GET normales.
- **Solución**: Se declararon e inicializaron a nivel de función `handleGoogleSheetsImport` tanto en la consulta inicial de `Promise.allSettled` como en el refresh posterior a la sincronización.
- **Fix Bug Aulas Virtuales en Dashboard de Bedelía**:
- **Causa Raíz**: El conteo `virtual_classrooms` en `dashboard.py` calculaba `len(virtual_classrooms_list)` sobre la tabla relacional `classrooms`, que solo contiene 1 registro genérico (`id: 331, code: 'VIRTUAL', building: 'Campus Virtual'`).
- **Solución**: Se actualizó la lógica para calcular las salas virtuales a partir de las comisiones activas con modalidad virtual (Google Meet/Teams/Zoom) o reservas en Campus Virtual, reportando las 101 salas virtuales activas. Se incorporó el arreglo `virtual_rooms` en `role_data` de Bedelía y se agregó la pestaña *"Salas Virtuales (Campus Virtual)"* con 127 enlaces a Google Meet en el panel de Aulas (`dashbede.html`).
- **Modularización de la Arquitectura de Vistas (`dashboard.html` como Layout Padre)**:
- Se dividió el archivo monolítico `dashboard.html` de más de 2300 líneas en 4 componentes/subvistas según el rol del usuario:
- `dashadm.html` (Administrador)
- `dashbede.html` (Bedelía)
- `dashprof.html` (Docente / Profesor)
- `dashalum.html` (Alumno / Estudiante)
- `dashboard.html` actúa ahora como layout/plantilla padre limpia que inyecta la subvista correspondiente mediante `{% include %}` de Nunjucks.
- **Actualización de Reglas en `docs/constitution.md` (Principio 9)**:
- Se agregó el Principio 9 innegociable:
1) Siempre actualizar y guardar el control de la nueva versión semántica al momento de compilar.
2) Al finalizar la compilación, siempre subir y desplegar la nueva versión al servidor institucional de producción.
- **Despliegue y Verificación en Producción**:
- Versionado elevado a `v3.4.1`.
- Desplegado exitosamente en el servidor LXC `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
- Verificación HTTP 200 en `/version`, login admin, `/admin/google_sheets_import`, dashboards modularizados de los 4 roles y cuenta institucional de Bedelía.
- **Sprint UX/UI: Agrupación Cronológica de Reservas y Formato Limpio de Fechas (v3.4.2)**:
- **Problema 1: Duplicación de Reservas por Hora en Cartelera**:
- En `/schedule/today_schedule`, un bucle fijo `for (let hour = 7; hour <= 21; hour++)` insertaba la misma reserva en cada bloque horario de 1 hora que abarcaba la materia (ej. Marketing Digital de 08:00 a 11:00 hs aparecía repetida a las 8, 9 y 10).
- **Solución**: Se eliminó la clonación artificial y se introdujo la agrupación nativa por franja horaria real de cursada (`grouped_slots`, ej. `08:00 - 11:00 hs`, `18:30 - 21:00 hs`). Cada reserva aparece agrupada exactamente UNA SOLA VEZ en su bloque horario correspondiente con turno, duración, aula, cupo y enlace a Meet/Zoom.
- **Problema 2: Formato ISO Crudo en Listado de Reservas**:
- En `/schedule/list_reservations` (tabla y tarjetas) se mostraban strings crudos con 'T' y segundos (`2026-10-08T08:00:00 - 2026-10-08T11:00:00 hs`).
- **Solución**: Se enriquecieron todas las reservas con la función `formatReservationDates` y nuevos filtros Nunjucks (`format_date_human`, `format_time`, `format_time_range`), mostrando fecha limpia (`Jueves 08/10/2026` / `08/10/2026`) y horario amigable (`08:00 - 11:00 hs`).
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.2` en Frontend y Backend.
- Despliegue inmediato al servidor institucional `10.0.0.217` y verificación en caliente.
- **Sprint Importador Google Sheets: Selección Granular y Grilla Interactiva (v3.4.3)**:
- **Selección Granular de Entidades (Tarjetas Checkbox)**:
- Réplica del diseño visual de la Herramienta de Purga con botones "Marcar Todo" y "Desmarcar Todo".
- Toggles individuales para Asignaciones de aulas (`import_reservations`), Aulas físicas y virtuales (`import_classrooms`), Comisiones (`import_commissions`), Asignaturas (`import_subjects`) y Carreras (`import_careers`).
- **Selector de Días de la Semana con Checkboxes Múltiples**:
- Reemplazo del selector simple por checkboxes individuales para Lunes a Sábado con accesos rápidos ("Todos", "Lun a Vie", "Limpiar").
- **Grilla de Previsualización Interactiva e Inspección Previa**:
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (`preview_rows`) de registros online.
- Selección individual por fila y checkbox maestro superior.
- Modificación manual inline de fechas de cursada por fila mediante Datepicker (`<input type="date">`) y aplicador de fecha masiva a seleccionados.
- Resaltado visual con badges de alerta y error ante registros incompletos o aulas no reconocidas.
- Buscador en vivo multi-criterio y paginación fluida (25 filas por página) para evitar bloqueos del navegador.
- Modal de confirmación previa con desglose exacto de filas y entidades antes de iniciar la sincronización.
- **Backend y BFF REST**:
- `sheets_importer.py` ampliado para retornar `preview_rows` y procesar `selected_rows` con granularidad de entidades.
- Endpoints `POST /api/v1/dashboard/sheets-inspect` y `POST /api/v1/dashboard/sync-sheets`.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.3` en Frontend y Backend.
- Despliegue y verificación en caliente en el servidor institucional `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
- **Sprint Dashboard Bedelía: Filtro Temporal "Mañana" en Switchers y Cartelera (v3.4.4)**:
- **Requerimiento**: Agregar "Mañana" en el filtro actual del dashboard que decía "Día (Hoy) / Semana / Mes".
- **Implementación**:
- **Backend API (`backend/app/routes/api/dashboard.py`)**: Cálculo de `tomorrow_dt` (00:00:00 a 23:59:59), agregando estadísticas en `filter_stats['tomorrow']` para percentiles de aulas físicas y comisiones asignadas/sin asignar, y `tomorrow_schedule_list` para la agenda de clases.
- **Frontend BFF & Vistas (`frontend/views/dashboard/dashbede.html`, `dashbede.html`, `dashadm.html`, `dashboard.html`)**:
- Switcher de percentiles: botón "Mañana" con actualización dinámica de percentiles de ocupación de aulas físicas.
- Switcher de comisiones: botón "Mañana" y bloques `#commBlock-tomorrow-unassigned` y `#commBlock-tomorrow-assigned`.
- Switcher de aulas físicas: botón "Mañana" y bloques `#classBlock-tomorrow-unassigned` (aulas libres con botón "Asignar") y `#classBlock-tomorrow-assigned` (aulas en uso).
- Cartelera Operativa & Agenda de Clases: botón "Clases de Mañana" y tabla `#bedeliaScheduleTomorrow` mostrando asignaturas, comisiones, docentes y enlaces para mañana.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.4` en Frontend y Backend.
- Despliegue al servidor institucional `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificación en caliente.
- **Sprint Optimizador de Aulas IA: Corrección de Permisos y Carga de Comisiones (v3.4.5)**:
- **Problema Reportado**: AI Room Reservation Optimizer no mostraba comisiones y los indicadores de Available Classrooms, Active Commissions y Existing Reservations quedaban en `--`.
- **Causa Raíz Identificada**:
- En `backend/app/routes/genetic_algorithm.py` las rutas `@genetic_bp.route('/commissions')`, `/algorithm-status`, `/preview-optimization`, `/optimize` y `/apply-optimization` exigían de forma estricta `g.jwt_user.role in ['ADMIN', 'teacher']` o `g.jwt_user.role in ['ADMIN']`.
- Al ingresar como Bedelía (`role == 'Bedelia'`), Docentes o Administradores con rol en minúsculas, el backend devolvía `403 Forbidden`, bloqueando la llamada AJAX y dejando la interfaz vacía con `--`.
- En el Frontend BFF, la ruta `/genetic_optimizer` no requería `requireAuth` ni pasaba datos de sesión de usuario a la plantilla.
- **Solución Implementada**:
- Creación del helper `check_optimizer_permission(user, requires_write)` en `backend/app/routes/genetic_algorithm.py` habilitando acceso a `admin`, `administrador`, `bedelia`, `docente`/`teacher` y permisos RBAC en 'optimizer'.
- `GET /api/genetic/commissions` ahora enriquece los objetos con `subject_name`, `subject_code`, `career_name`, `schedule` y `shift`.
- `frontend/views/genetic_optimizer.html`: Traducido íntegramente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas de comisiones con badges, buscador en vivo multi-criterio y manejo de errores visual.
- `frontend/public/js/genetic-algorithm.js`: Traducción de alertas, modales y tablas de resultados.
- `frontend/src/app.js`: Protección con `requireAuth` e inyección de sesión a la vista.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.5` en Frontend y Backend.
- Despliegue inmediato al servidor institucional `10.0.0.217` y verificación en caliente HTTP 200.
- **Sprint v3.4.6: Corrección Integral de Reservas, Pisos Dinámicos, Fechas Humanas y Filtro de Carreras**:
- **Incidencias Resueltas**:
1. `/schedule/add_reservation` y `/schedule/edit`: Corregido error de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar "Edificio Central". Inyección segura sin entities y matching resiliente de pisos físicos y virtuales.
2. `/schedule/calendar_view`: Limpieza de datos hardcodeados/mockeados (`Arquitectura de Software ARQ-101`, `COM-A`, `Licenciatura en Sistemas`). El feed y filtros ahora consumen asignaturas, carreras y comisiones reales de la BD.
3. `sheets_importer.py`: Eliminada la autogeneración no deseada de enlaces de Google Meet / Zoom (`meet.google.com/edu-...`) en reservas importadas cuando la celda original está vacía (ej. `#9797 ASIG00215 - Marketing Digital`).
4. `/classrooms/view_classroom`: Formateadas fechas y horarios a español legible (ej. `Viernes 04/09/2026 · 18:30 a 21:30 hs`) eliminando formato ISO repetido y ampliando rango a todo el semestre 2026.
5. `/buildings/list_buildings` y `/buildings/view/:id`: Corregida la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas físicas asociadas (`floors_list` y `classrooms_by_floor`), corregido el contador de "Pisos Presenciales" (4 pisos) y soporte completo de niveles dinámicos alfanuméricos (PB, EP, Subsuelo, etc.).
6. `/admin/commissions_list`: Corregido `UnboundLocalError` en `backend/app/routes/api/admin.py` por importación interna tardía de `Career`, que arrojaba HTTP 500 al filtrar por `career_id=180, 181, 182`.
- **Sprint v3.4.8: Registro de Auditoría Institucional y Trazabilidad Operativa**:
- **Incidencias y Mejoras**:
1. `/api/v1/admin/audit-logs`: Implementación del endpoint RESTful con paginación, filtros por módulo (`auth`, `reservations`, `classrooms`, `buildings`, `optimizer`, `admin`, etc.), acción (`LOGIN`, `LOGIN_FAILED`, `CREATE`, `UPDATE`, `DELETE`, `CONFIRM`, etc.) y búsqueda multi-campo.
2. Modelo `AuditLog`: Agregado método `to_dict()` para serialización JSON segura e ISO.
3. `AuditService`: Soporte de parámetros explícitos `user_id` y `user_email` para registrar eventos cuando el usuario no está autenticado o el intento de acceso falla.
4. `/api/v1/auth/`: Instrumentada la captura de inicios de sesión (`LOGIN`), Google OAuth (`LOGIN_GOOGLE`), Moodle delegado (`LOGIN_MOODLE`), fallos de inicio de sesión (`LOGIN_FAILED`), accesos bloqueados (`LOGIN_BLOCKED`), cierres de sesión (`LOGOUT`) y cambios de contraseña institucional (`PASSWORD_CHANGE`).
5. `/api/v1/reservations`: Auditoría de creación (`CREATE`), edición (`UPDATE`), cancelación (`CANCEL`), borrado permanente (`DELETE`) y confirmación oficial (`CONFIRM`).
6. `/api/v1/classrooms` y `/api/v1/buildings`: Auditoría de altas, modificaciones, alternancia de estado activo/inactivo (`TOGGLE`) y bajas.
7. Optimizador Genético IA: Auditoría de ejecuciones (`OPTIMIZE_RUN`) y aplicación de asignaciones masivas en base de datos (`OPTIMIZE_APPLY`).
8. Frontend BFF (`/admin/audit_logs`): Conexión del BFF con la REST API, badges temáticos e intuitivos, filtros rápidos por categorías, visor modal para detalles extensos o JSON, y paginador dinámico nativo que preserva parámetros de consulta.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.8` en Frontend y Backend.
- **Sprint v3.4.9: Solución de Límite de Payload en Importador de Sheets & Diagnóstico Transparente de Incidentes**:
- **Incidencias y Mejoras**:
1. `frontend/src/app.js`: Elevado límite de `express.json` y `express.urlencoded` de 100 KB por defecto a 50 MB (`{ limit: '50mb' }`), resolviendo el error `PayloadTooLargeError: request entity too large: expected 154166, length 154166, limit 102400` que provocaba HTTP 500 al enviar la matriz de filas preseleccionadas en `/admin/google_sheets_import`.
2. Manejo de Incidentes y Diagnóstico Transparente: Reemplazo total de la pantalla genérica de error por una interfaz estructurada con código de ticket único (`INC-YYYYMMDD-XXXX`), diagnóstico descriptivo clasificado, sección técnica de diagnóstico colapsable (Ruta, Timestamp, Usuario actuante, IP, Stack trace), botón para copiar reporte a soporte IT y enlace directo a la Auditoría Institucional.
3. `backend/app/routes/api/admin.py`: Nuevo endpoint `/api/v1/admin/log-error` para registrar incidentes técnicos no controlados del frontend directamente en `AuditLog` (`action='SYSTEM_ERROR'`, `module='system'`).
4. `backend/app/routes/api/dashboard.py`: Instrumentada auditoría completa en `sync_google_sheets` para registrar tanto importaciones exitosas (`SHEETS_IMPORT`) como fallos (`SHEETS_IMPORT_ERROR`) con desglose de estadísticas y excepciones.
- **Sprint v3.5.0: Cierre Formal del MVP de Bedelía & Adopción del Arnés SDD / IA**:
- **Metodología y Arnés de Ingeniería con IA (Apuntes Día 1, 2 y 3)**:
1. Creación de la Skill de SDD (`.agents/skills/sdd/SKILL.md`) con las plantillas de `spec.md`, `plan.md`, `tasks.md` y sintaxis formal **EARS** en español.
2. Creación de comandos reutilizables de agentes en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`).
3. Definición de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA).
4. Integración del arnés en `AGENTS.md`.
- **Diagnóstico y Cierre de Brecha del MVP**:
- Se identificó la causa raíz de la percepción de "estar lejos": el *Scope Creep* sin especificación formal de cierre y la falta de exportación/impresión de carteleras que forzaba a Bedelía a recurrir al Excel para imprimir o compartir partes con portería y docentes.
- Se formalizó la primera especificación oficial del proyecto en `specs/001-cierre-mvp-bedelia/` (`spec.md`, `plan.md`, `tasks.md`), delimitando de forma estricta los Requisitos Funcionales en **EARS** y estableciendo un perímetro cerrado de **Fuera de Alcance**.
- **Implementación Técnica**:
1. `frontend/src/routes/schedule.js`: Endpoint `/schedule/export_csv` con codificación UTF-8 BOM (`\uFEFF`) y delimitadores `;` para apertura nativa e inmediata en Microsoft Excel en español.
2. `frontend/views/schedule/today.html`: Botones directos `[ Excel / CSV ]` e `[ Imprimir ]`, acompañados de estilos CSS `@media print` que formatean la grilla de asignaciones en hoja A4 limpia con membrete institucional oficial de UniCABA.
3. `frontend/views/dashboard/dashbede.html`: Accesos rápidos en el Launchpad operativo de Bedelía para descargar la planilla del día e imprimir en 1 clic.
- **Calidad y Bump Semántico (Principio 9)**:
- 52 pruebas de backend ejecutadas con 100% de éxito en pytest (`52 passed`).
- Versión incrementada a `v3.5.0` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
- **Sprint v3.5.1: Exportación y Replicación Moodle Producción a Local con Usuarios y Emails Reales**:
- **Especificación SDD (`specs/002-moodle-export-sync/`)**: Creados `spec.md` (6 RF en EARS), `plan.md` y `tasks.md` (todas las tareas completadas).
- **Extracción Híbrida y Concurrente con Emails Reales**:
- `scripts/moodle_replicator.py` se autentica en `https://campus.udelaciudad.edu.ar/` con `logintoken` dinámico.
- Obtiene la nómina masiva estructurada vía `/user/action_redir.php` (`download_participants&dataformat=json`).
- Consulta de forma concurrente (ThreadPool con 10 workers) los perfiles de los usuarios (`user/view.php`) extrayendo sus correos personales y reales (`@gmail.com`, `@hotmail.com`, etc.), eliminando cualquier generación de emails inventados.
- Normalización fonética/ortográfica sin acentos (`normalize_name`) para vincular con 100% de precisión docentes y estudiantes entre HTML y JSON.
- **Reglas de Acceso y DNI Determinístico**:
- DNI de 8 dígitos determinístico derivado del ID de Moodle (`90{moodle_id:06d}`), asignado idénticamente como `username` y `password` para pruebas locales.
- Preservado el DNI y correo real de Carlos Tello (`34247025`, `carlostellocba@gmail.com`).
- **Carga en Moodle Local (`10.0.0.207`)**:
- Creación y actualización de usuarios mediante Moodle REST API (`core_user_create_users`, `core_user_update_users`).
- 504 matriculaciones completadas exitosamente en los 4 cursos oficiales:
* Carrera Lic. en Tecnologías Digitales (CCC): ID Prod 922 -> ID Local 19 (194 alumnos).
* ASIG00124 - Sistemas Digitales_2/2026: ID Prod 5311 -> ID Local 16 (131 alumnos y 2 profesores).
* ASIG00126 - Seguridad de la Información_2/2026: ID Prod 5313 -> ID Local 17 (138 alumnos y 2 profesores).
* ASIG00127 - Programación de Vanguardia - E1_2/2026: ID Prod 5314 -> ID Local 18 (41 alumnos y 2 profesores).
- Desactivada la política restrictiva de contraseñas (`passwordpolicy=0`) en el entorno de pruebas local para permitir contraseñas numéricas idénticas al DNI.
- Verificación exitosa de login de estudiante en `http://10.0.0.207/moodle/login/index.php`.
- **Skill de Automatización**: Creada `.agents/skills/moodle-replicator/SKILL.md` con manual operativo y comandos CLI.
- **Sprint v3.5.2: Replicación Completa de 16 Cursos, User-Agent Mozilla/5.0 y Fix de Credenciales**:
- **Catálogo Completo de la Carrera (16 Cursos)**:
- Se identificaron y replicaron la totalidad de las 15 materias de la Licenciatura en Tecnologías Digitales (1/2025, 2/2025, 1/2026 y 2/2026) más el curso de la carrera (Local 19).
- Resuelto el caso de alumnos como `90010202` (Carlos Guillermo Terzano): ahora cuenta con sus 6 materias reales cursadas (Local 4, 5, 8, 9, 10, 11) además de la carrera.
- Carlos Tello (`34247025`) matriculado en las 15 asignaturas y la carrera.
- Más de 1.100 matriculaciones procesadas y validadas con 100% de éxito.
- **Identificación y Asignación de Todos los Docentes**:
- Extraídos y asignados todos los profesores reales con rol `editingteacher` (ID 3) y correos institucionales `@udelaciudad.edu.ar`.
- **Cabecera HTTP y User-Agent**:
- Forzado estrictamente el encabezado `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)` en todas las solicitudes al campus para evitar alertas por `python-requests`.
- **Sincronización de Contraseña Local (Fix 34247025)**:
- Se corrigió la contraseña del usuario `34247025` restableciéndola a `34247025` idéntica al DNI en Moodle local. Verificado inicio de sesión exitoso.
- **Sprint v3.5.3: Importación de Roles Moodle-App, Limpieza Total de Admin y Purga de Cursos**:
- **Sincronización RBAC de Roles Moodle a PostgreSQL de la App (`classrooms_db`)**:
- Desarrollado `scripts/import_moodle_to_app.py` y bandera `--sync-app` en `moodle_replicator.py`.
- Mapeo unívoco: Moodle `editingteacher` -> App `Docente` (`role_id=2`), Moodle `student` -> App `Alumno` (`role_id=6`).
- Importados **653 usuarios únicos** (15 Docentes y 640 Alumnos) a la base de datos de producción con contraseñas PBKDF2 coincidentes con el DNI, habilitando de inmediato la asignación de comisiones, reservas e inscripciones.
- **Desmatriculación de Cuenta Admin en Moodle Local (`10.0.0.207`)**:
- Removidas todas las matriculaciones de `admin` en cursos académicos y generales (quedando con 0 enrolments).
- **Sprint v3.5.4: Conexión Moodle API, Login Delegado y Sincronización Moodle -> Edu Space**:
- **Habilitación de Web Services para Tokens de Usuario en Moodle Local (`10.0.0.207`)**:
- Asignada la capability `moodle/webservice:createtoken` al rol 7 (`user` / usuario autenticado) en `mdl_role_capabilities`.
- Habilitado `enablemobilewebservice = 1` y servicio `moodle_mobile_app` (`enabled = 1`).
- Verificada la emisión de tokens exitosa para usuarios individuales (incluyendo `34247025`) tanto contra `moodle_api` como contra `moodle_mobile_app`.
- **Conexión de Admin Edu Space con Moodle Local**:
- Configurado el token `810428346d3601c68a37a315fcba8d4391629f46` de `moodle_api` en `system_settings` de `classrooms_db`.
- Habilitada `auth_moodle_enabled = 'true'` y `moodle_server_url = 'http://10.0.0.207/moodle'`.
- Adaptado el endpoint de autenticación `/api/v1/auth/moodle` para autenticar con `moodle_api` (con fallback a `moodle_mobile_app`) y hacer matching de cuenta local por número de documento (DNI).
- **Sincronización Bidireccional Moodle -> Edu Space**:
- Agregado el endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle`.
- Incorporados los métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
- **Sprint v3.5.5: Autenticación por API Key para Moodle, Purga de Tareas y Hardening**:
- **Purga de Tareas de Sincronización Residuales**:
- Eliminadas las 6 tareas pendientes residuales de prueba (#1 a #6) en la tabla `moodle_sync_tasks` de `classrooms_db` en `10.0.0.217`, dejando la cola limpia en 0 registros.
- **Ampliación de Funciones Web Services en Moodle Local (`10.0.0.207`)**:
- Asignadas al servicio `moodle_api` las funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`, completando el catálogo a 15 funciones esenciales.
- **Seguridad por Restricción de Red (IP Restriction)**:
- Fijada la restricción de red `iprestriction = '10.0.0.0/24'` en `mdl_external_tokens`, asegurando que solo el tráfico interno institucional pueda utilizar los tokens de Moodle.
- **Autenticación por API Key Institucional en Admin Edu Space**:
- Creado mecanismo para autenticar endpoints de sincronización (`/settings/moodle/sync` y `/moodle/sync-from-moodle`) mediante `X-API-Key` institucional de 64 caracteres hex.
- Generada y almacenada la clave API institucional cifrada con Fernet en `system_settings` (`classrooms_db`).
- Agregados endpoints para consulta y regeneración de clave API (`/api/v1/admin/settings/moodle/api-key`).
- **Sprint v3.5.6: Principio 10 de Tolerancia Cero a Errores de Código, Robustez en SystemSetting y Replicador**:
- **Principio 10 de la Constitución**:
- Incorporada regla mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
- Es estrictamente inadmisible declarar una tarea o sprint como terminado o completado si persisten errores en el código o en el analizador de la IDE (`@[current_problems]`).
- **Reparación de Tipos en Replicador Moodle**:
- Ajustado casteo a entero `int(course_meta['local_id'])` y `int(u.get('role_id', 5))` en `scripts/moodle_replicator.py`.
- **Robustez Híbrida en `SystemSetting`**:
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase o de instancia sin errores de argumentos.
- **Resolución de Condición de Carrera en Tests de SQLite**:
- Añadida espera activa de finalización de workers en `test_05_api_async_job_submission_and_polling` para evitar bloqueos de base de datos en `tearDown()`.
- **Validación Automatizada**:
- 52/52 tests pasando en verde al 100% (`pytest tests -v`).
- **Sprint v3.5.7: Principio 11 de la Constitución — Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**:
- **Arquitectura Modular en 4 Capas**:
- Desacople estricto: `main.py` (bootstrap/registro), `routers/` (endpoints agrupados por dominio con prefijos y tags para Swagger), `schemas/` (contratos con Pydantic `BaseModel`), `storage.py` (acceso a persistencia). Prohibida la lógica de negocio en el frontend o en archivos monolíticos.
- **Tipado Fuerte y Validación Pydantic**:
- Uso obligatorio de `Field` para validaciones declarativas (`min_length`, `max_length`, `gt`, `ge`, regex).
- Distinción estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados con defaults).
- Manejo y respuesta automática de error `422 Unprocessable Entity` detallando el campo exacto.
- **Semántica HTTP y Excepciones Controladas**:
- Uso de códigos de estado HTTP semánticos (`201 Created` en POST, `200 OK`, `204 No Content`).
- Prohibido retornar `null` o respuestas vacías ante fallos: levantar `HTTPException` controladas con detalle descriptivo (404, 400, 409).
- **Documentación Interactiva Automática**:
- Contratos OpenAPI expuestos en `/docs` (Swagger UI) con capacidades de prueba en vivo (*Try it out*).
- **Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual**:
- **Pestaña en Configuración Global**: Planificada en `ROADMAP.md` y UI administrativa para configurar URL del servidor local (Ollama, llama.cpp), modelo, token y timeout para el futuro asistente virtual de la app.
- **Cliente Asíncrono no Bloqueante**: Uso mandatorio de `httpx.AsyncClient` con `async def` / `await` para inferencias concurrentes sin bloquear el servidor.
- **Timeout Generoso**: Configurar timeout de 600 segundos previendo carga de modelos en VRAM o prompts extensos.
- **Formato Estándar de Roles**: Historial estructurado bajo `role: "system" | "user" | "assistant"` y `content: prompt`.
- **Actualización Documental Completa**:
- Sincronizados `docs/constitution.md` (Principio 11), `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.opencode/agents/` (`coordinator.md`, `planner.md`, `implementer.md`, `reviewer.md`), `ROADMAP.md` (Fase 7) y `MEMORY.md`.
- **Sprint v3.6.0: Migración Completa de Flask API a FastAPI ASGI (Principio 11)**:
- **Reemplazo Arquitectónico**:
- Backend Core migrado a FastAPI con arquitectura de 4 capas: `backend/main.py` (FastAPI bootstrap), `backend/routers/` (APIRouters modulares por dominio), `backend/schemas/` (Pydantic v2 BaseModels con validación declarativa) y `backend/database.py` (persistencia relacional).
- Módulos migrados a FastAPI: `version`, `auth`, `classrooms`, `reservations`, `students`, `dashboard`, `optimizer` y `genetic`.
- Documentación interactiva OpenAPI v3 expuesta nativamente en `/docs` (Swagger UI) y `/redoc`.
- Puente de retrocompatibilidad y cero regresión implementado mediante `a2wsgi` para asegurar interoperabilidad fluida con Gunicorn, Uvicorn y el frontend BFF Express.js.
- **Calidad y Verificación**:
- 57 tests automatizados ejecutados y aprobados al 100% en pytest (`57 passed`).
- Cero errores en linter, tipos y compilación estática (`@[current_problems]`).
- **Despliegue Continuo**:
- Bump semántico a `v3.6.0`.
- Actualización remota y reinicio de servicios en el servidor LXC `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
# MEMORY.md - admin-edu-space
Memoria del proyecto entre sesiones para la rama `dev`.
## Estado actual
- Fases 0 a 5.1 del Roadmap completadas y estabilizadas:
- Arquitectura desacoplada: Backend Core FastAPI ASGI REST API (:5000) + Frontend BFF Node.js/Express (:3000).
- Cobertura 100% ABM: Sedes/Edificios, Aulas (físicas/virtuales), Ciclos Lectivos, Carreras, Materias, Comisiones y Reservas.
- Matriz integral de conflictos (físico, docente con co-docencia, aforo y restricción diaria del alumno).
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Suite Ejecutiva de Entregables Académicos y Presentación de Alta Gama (v3.8.57)**:
- **Presentación PowerPoint Widescreen (PRESENTACION_EJECUTIVA_DIAPOSITIVAS.pptx)**: Generación de 14 diapositivas profesionales 16:9 con estética obsidian/slate, métricas y capturas de producción incrustadas.
- **Presentación Ejecutiva Web Interactiva (PRESENTACION_EJECUTIVA.html)**: Motor web interactivo con controles de teclado, modo pantalla completa (F), notas de orador (N) y lightbox de capturas.
- **Paquete Académico Oficial para la Cátedra**: Memoria técnica de 426 líneas (INFORME_TECNICO_PROYECTO_FINAL.md), guía para el evaluador (GUIA_DEMOSTRACION_Y_EVALUACION_DOCENTE.md), evidencias ágiles (MINUTAS_Y_EVIDENCIAS_GESTION_AGIL.md) y galería (GALERIA_DE_CAPTURAS.md).
- **Eliminación Total de Fondos Gráficos Invasivos**: Se retiraron `bg_course-card.png`, `square_course_name.png` y `mini_logo_icon.png` de la consola de recepción, dejando la UI limpia, sobria, sin recuadros recortados y con máxima nitidez.
- **Corrección Crítica en Resolución de DNI (Bug de Interceptación por Puntos)**: Se solucionó el problema donde cualquier entrada con dos puntos (ej. `34.247.025` o fechas de emisión/nacimiento `09.02.89` en códigos de barras Renaper) era catalogada como JWT y abortaba con error de firma. Ahora se exige estructura Base64URL pura y en caso de error continúa con la resolución de DNI.
- **Soporte de Prefijos y Caracteres**: Manejo universal de prefijos `DNI:`, delimitadores `;` y protección de la letra `Ñ` en apellidos y nombres.
- **Versión Consolidada**: 3.8.57.
## Decisiones (y por qué)
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.
- **Asociación Explícita de Carreras**: Toda Asignatura se vincula a su Carrera y toda Comisión hereda y expone la Carrera, permitiendo filtros y búsquedas específicas por titulación.
- **Importador de Google Sheets Preservado**: Se conserva como ingestor inicial masivo sin fricción para no interrumpir el flujo actual del personal.
- **Guía Operativa por Rol**: Documentar explícitamente el procedimiento para Bedelía, Docentes y Alumnos para facilitar la adopción inmediata.
## Aprendizajes y errores a evitar
- **Colisiones Virtuales**: En aulas virtuales no debe aplicarse colisión física horaria; múltiples comisiones pueden cursar simultáneamente con enlaces independientes.
- **Manejo de Estados Vacíos (Empty States)**: Proteger siempre las vistas de plantillas en Nunjucks contra colecciones vacías para evitar errores 500 cuando se reinicializa la base.
- **Seguridad de Secretos**: Mantener `.credenciales` y `.env` estrictamente fuera del índice de Git.
- **Depuración de Mocks en Dashboard**: Se eliminaron los arrays estáticos de fallback (`upcoming_reservations`, `today_schedule_list`, etc.) en `frontend/src/routes/dashboard.js` que mostraban asignaturas ficticias ("Matemática Discreta", "Sistemas Operativos", "Ingeniería de Software") en ausencia de datos reales.
- **Resolución de Error 500 en Aulas Presenciales y Virtuales**: Se reparó el balance de etiquetas de Nunjucks en `frontend/views/classrooms/list.html` y se reubicaron los modales de eliminación en el bloque físico. Validado con HTTP 200 en `/classrooms/list_classrooms?view_mode=physical` y `view_mode=virtual`.
- **Estandarización de Versiones (v3.4.0)**: Expuesto en Backend (`/api/v1/version`), Frontend BFF (`/version`), badges en el pie de página de la barra lateral (`sidebar-footer`) y en la pantalla de inicio de sesión (`login.html`).
- **Materias Compartidas en Múltiples Carreras (Many-to-Many)**: Se creó la tabla `subject_careers` en la base de datos relacional para asociar una materia a múltiples carreras simultáneamente (ej: IOT en DATOS, TEC. DIG y VIDEOJUEGOS, o Teoría y Práctica en PROF PROF y CIENCIAS), manteniendo `career_id` principal por retrocompatibilidad.
- **Normalización del Importador de Google Sheets**: `sheets_importer.py` descubre dinámicamente las 6 pestañas semanales (Lunes a Sábado), desglosa y mapea de forma canónica las carreras separadas por guion (`-`), soporta códigos combinados (`/`) y desglosa métricas por día de cursada (`by_day`).
- **Reactivación de Bedelía en Producción**: Activada la cuenta `bedelia@edu-space.com` para trabajo operativo institucional continuo.
- **Corrección de Vistas de Bedelía (Reservas de Hoy, Semana, Aulas Libres y Comisiones Sin Aula)**:
- **Causa Raíz de Reservas Vacías**: `sheets_importer.py` generaba reservas únicamente para `weeks_to_generate = 4` a partir del 31 de agosto de 2026 (finalizando el 26 de septiembre). En la fecha actual de octubre de 2026 (`2026-10-07`), la base de datos tenía 0 reservas para el día y la semana. Se amplió a `weeks_to_generate = 16` cubriendo todo el 2° cuatrimestre regular (hasta el 19 de diciembre de 2026), generando **2464 reservas totales**, **34 clases para hoy** y **154 clases para la semana actual**.
- **Fecha Dinámica en Cartelera**: Se corrigió `handleTodaySchedule` en `frontend/src/routes/schedule.js` que tenía hardcodeado `2026-09-18` como fecha por defecto, reemplazándolo por la fecha actual ISO (`new Date().toISOString().split('T')[0]`) y añadiendo navegación interactiva entre días (`prev_date`, `next_date`, y botón "Hoy").
- **Panel Operativo de Cartelera & Agenda en Dashboard**: Se incorporó en el Dashboard de Bedelía la sección "Cartelera Operativa & Agenda de Clases" con tabs dinámicos para alternar entre "Clases de Hoy" y "Esta Semana", visualizando horario, aula física o sala virtual (con enlace directo a Meet), materia, comisión, turno y docente.
- **Aulas Disponibles por Período**: Se agregó el selector interactivo "Hoy" (con 18 aulas libres detectadas para el día), "Esta Semana" y "Este Mes" en el panel `#bedelia-available-classrooms`, permitiendo asignar aulas libres con un clic.
- **Comisiones Sin Aula Física ni Virtual**: Se agregó el tab "Sin Aula Física ni Virtual (General)" en `#bedelia-unassigned-commissions` para identificar comisiones sin asignación de espacio, y se añadió la columna "Espacio / Aula" con filtro rápido `unassigned_room=true` en `/admin/commissions_list`.
- **Filtrado Temporal de Aulas y Comisiones (Día, Semana y Mes)**:
- **Requerimiento**: Poder filtrar tanto **Aulas Asignadas** vs **Aulas Sin Asignar (Libres)** como **Comisiones Asignadas** vs **Comisiones Sin Asignar** por **Día**, **Semana** y **Mes**, con la opción de **Día por defecto** y aclarando la **fecha explícita** para fácil identificación de todos los usuarios.
- **Backend (`dashboard.py`)**: Se calculan estructuras `filter_stats` para los tres períodos (`today`, `week`, `month`) con métricas precisas (counts, porcentajes) y diccionarios legibles `date_labels` en español ("Hoy · Miércoles 07/10/2026", "Semana del 05/10 al 11/10/2026", "Mes de Octubre 2026").
- **Frontend BFF & UI (`dashboard.js`, `dashboard.html`)**:
- **Panel de Percentiles**: Switcher interactivo `[ Día (Hoy) ]` (activo por defecto), `[ Semana ]` y `[ Mes ]` con badge explícito de fecha y barras reactivas.
- **Panel de Comisiones**: Switcher `[ Día (Hoy) ]`, `[ Semana ]`, `[ Mes ]` con badge de fecha explícita, más pestañas para conmutar entre "Comisiones Asignadas (Con Aula)" y "Comisiones Sin Asignar (Pendientes)" con acciones directas para asignar espacio.
- **Panel de Aulas**: Switcher `[ Día (Hoy) ]`, `[ Semana ]`, `[ Mes ]` con badge de fecha explícita, más pestañas para conmutar entre "Aulas Sin Asignar (Libres)" y "Aulas Asignadas (En Uso)" con acceso directo a cartelera o asignación inmediata.
- **Validación en Producción**: Desplegado en `https://eduspace.oemspot.com.ar` y verificado con éxito (HTTP 200 en login de Bedelía y renderizado exacto de datos reales).
- **Evolución del Importador de Google Sheets (Filtros por Carrera, Materia, Día y Fecha Manual)**:
- **Requerimiento**: Permitir filtrar qué Carrera, qué Materia y qué Día importar desde el Google Sheet online de UniCABA, como así también agregar la fecha manualmente para corregir o evitar errores si el Sheet no tiene la fecha o se requiere asignar una clase puntual en el calendario.
- **Backend (`sheets_importer.py` & `dashboard.py`)**:
- Se implementó `inspect_sheet_content()` que descarga e inspecciona las 6 hojas del Sheet online en ~7s, descubriendo de forma dinámica todas las Carreras únicas (18 carreras detectadas) y Materias únicas (206 materias detectadas).
- Se agregaron los parámetros `filter_career`, `filter_subject`, `filter_day`, `manual_date` y `single_date_only` al método `sync(...)`.
- Normalización robusta de días con `normalize_day_name(...)` insensible a acentos y mayúsculas.
- Soporte de coincidencia parcial y sensible a carreras compuestas (ej: `DATOS (CCC)` coincide con asignaturas compartidas con `TEC. DIG.` y `VIDEOJUEGOS`).
- Soporte de asignación de fecha puntual manual (`single_date_only=True`), creando 1 única reserva para esa fecha exacta en vez de las 16 semanas regulares, o tomando la fecha manual como base del cuatrimestre.
- Nuevo endpoint REST `GET/POST /api/v1/dashboard/sheets-inspect` y actualización de `/api/v1/dashboard/sync-sheets`.
- **Frontend BFF & UI (`admin.js` & `import.html`)**:
- Panel interactivo "Sincronización Académica con Filtros Avanzados y Control de Fecha".
- Selectores dinámicos de Día (Todos, Lunes, Martes, etc.), inputs con autocompletado `<datalist>` para Carreras y Materias.
- Selector interactivo de Fecha Manual (`type="date"`) con switch toggle para "Importar ÚNICAMENTE para esta fecha puntual".
- Botón "Inspeccionar Sheet Online" con llamada AJAX a `/admin/sheets_inspect` que carga en vivo las carreras y materias descubiertas.
- Tarjeta de informe detallado post-sincronización con badges temáticos de "Filtros Activos", número de "Filas Coincidentes" vs totales, y modo de generación.
- **Validación en Producción**:
- Pruebas automatizadas de backend: 49 tests aprobados en pytest (100% passed).
- Desplegado en producción institucional (`https://eduspace.oemspot.com.ar`).
- Verificación online con `bedelia@edu-space.com`: HTTP 200 en `/admin/google_sheets_import`, endpoint `/admin/sheets_inspect` retornando 239 filas y 18 carreras, y sincronización filtrada con éxito (ej. Martes + DATOS procesando exactamente sus 3 filas coincidentes).
- **Sprint v3.4.1: Corrección de Bug en Import Sheet, Aulas Virtuales en Bedelía, Modularización de Vistas y Reglas de Workflow**:
- **Fix Bug Google Sheets Import (`Error loading Google Sheets sync view`)**:
- **Causa Raíz**: `availableCareers` y `availableSubjects` se declaraban únicamente dentro de un bloque condicional en `admin.js`, provocando `ReferenceError: availableCareers is not defined` en peticiones GET normales.
- **Solución**: Se declararon e inicializaron a nivel de función `handleGoogleSheetsImport` tanto en la consulta inicial de `Promise.allSettled` como en el refresh posterior a la sincronización.
- **Fix Bug Aulas Virtuales en Dashboard de Bedelía**:
- **Causa Raíz**: El conteo `virtual_classrooms` en `dashboard.py` calculaba `len(virtual_classrooms_list)` sobre la tabla relacional `classrooms`, que solo contiene 1 registro genérico (`id: 331, code: 'VIRTUAL', building: 'Campus Virtual'`).
- **Solución**: Se actualizó la lógica para calcular las salas virtuales a partir de las comisiones activas con modalidad virtual (Google Meet/Teams/Zoom) o reservas en Campus Virtual, reportando las 101 salas virtuales activas. Se incorporó el arreglo `virtual_rooms` en `role_data` de Bedelía y se agregó la pestaña *"Salas Virtuales (Campus Virtual)"* con 127 enlaces a Google Meet en el panel de Aulas (`dashbede.html`).
- **Modularización de la Arquitectura de Vistas (`dashboard.html` como Layout Padre)**:
- Se dividió el archivo monolítico `dashboard.html` de más de 2300 líneas en 4 componentes/subvistas según el rol del usuario:
- `dashadm.html` (Administrador)
- `dashbede.html` (Bedelía)
- `dashprof.html` (Docente / Profesor)
- `dashalum.html` (Alumno / Estudiante)
- `dashboard.html` actúa ahora como layout/plantilla padre limpia que inyecta la subvista correspondiente mediante `{% include %}` de Nunjucks.
- **Actualización de Reglas en `docs/constitution.md` (Principio 9)**:
- Se agregó el Principio 9 innegociable:
1) Siempre actualizar y guardar el control de la nueva versión semántica al momento de compilar.
2) Al finalizar la compilación, siempre subir y desplegar la nueva versión al servidor institucional de producción.
- **Despliegue y Verificación en Producción**:
- Versionado elevado a `v3.4.1`.
- Desplegado exitosamente en el servidor LXC `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
- Verificación HTTP 200 en `/version`, login admin, `/admin/google_sheets_import`, dashboards modularizados de los 4 roles y cuenta institucional de Bedelía.
- **Sprint UX/UI: Agrupación Cronológica de Reservas y Formato Limpio de Fechas (v3.4.2)**:
- **Problema 1: Duplicación de Reservas por Hora en Cartelera**:
- En `/schedule/today_schedule`, un bucle fijo `for (let hour = 7; hour <= 21; hour++)` insertaba la misma reserva en cada bloque horario de 1 hora que abarcaba la materia (ej. Marketing Digital de 08:00 a 11:00 hs aparecía repetida a las 8, 9 y 10).
- **Solución**: Se eliminó la clonación artificial y se introdujo la agrupación nativa por franja horaria real de cursada (`grouped_slots`, ej. `08:00 - 11:00 hs`, `18:30 - 21:00 hs`). Cada reserva aparece agrupada exactamente UNA SOLA VEZ en su bloque horario correspondiente con turno, duración, aula, cupo y enlace a Meet/Zoom.
- **Problema 2: Formato ISO Crudo en Listado de Reservas**:
- En `/schedule/list_reservations` (tabla y tarjetas) se mostraban strings crudos con 'T' y segundos (`2026-10-08T08:00:00 - 2026-10-08T11:00:00 hs`).
- **Solución**: Se enriquecieron todas las reservas con la función `formatReservationDates` y nuevos filtros Nunjucks (`format_date_human`, `format_time`, `format_time_range`), mostrando fecha limpia (`Jueves 08/10/2026` / `08/10/2026`) y horario amigable (`08:00 - 11:00 hs`).
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.2` en Frontend y Backend.
- Despliegue inmediato al servidor institucional `10.0.0.217` y verificación en caliente.
- **Sprint Importador Google Sheets: Selección Granular y Grilla Interactiva (v3.4.3)**:
- **Selección Granular de Entidades (Tarjetas Checkbox)**:
- Réplica del diseño visual de la Herramienta de Purga con botones "Marcar Todo" y "Desmarcar Todo".
- Toggles individuales para Asignaciones de aulas (`import_reservations`), Aulas físicas y virtuales (`import_classrooms`), Comisiones (`import_commissions`), Asignaturas (`import_subjects`) y Carreras (`import_careers`).
- **Selector de Días de la Semana con Checkboxes Múltiples**:
- Reemplazo del selector simple por checkboxes individuales para Lunes a Sábado con accesos rápidos ("Todos", "Lun a Vie", "Limpiar").
- **Grilla de Previsualización Interactiva e Inspección Previa**:
- El botón "Inspeccionar Sheet Online" no importa directamente; extrae y presenta una grilla interactiva completa (`preview_rows`) de registros online.
- Selección individual por fila y checkbox maestro superior.
- Modificación manual inline de fechas de cursada por fila mediante Datepicker (`<input type="date">`) y aplicador de fecha masiva a seleccionados.
- Resaltado visual con badges de alerta y error ante registros incompletos o aulas no reconocidas.
- Buscador en vivo multi-criterio y paginación fluida (25 filas por página) para evitar bloqueos del navegador.
- Modal de confirmación previa con desglose exacto de filas y entidades antes de iniciar la sincronización.
- **Backend y BFF REST**:
- `sheets_importer.py` ampliado para retornar `preview_rows` y procesar `selected_rows` con granularidad de entidades.
- Endpoints `POST /api/v1/dashboard/sheets-inspect` y `POST /api/v1/dashboard/sync-sheets`.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.3` en Frontend y Backend.
- Despliegue y verificación en caliente en el servidor institucional `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
- **Sprint Dashboard Bedelía: Filtro Temporal "Mañana" en Switchers y Cartelera (v3.4.4)**:
- **Requerimiento**: Agregar "Mañana" en el filtro actual del dashboard que decía "Día (Hoy) / Semana / Mes".
- **Implementación**:
- **Backend API (`backend/app/routes/api/dashboard.py`)**: Cálculo de `tomorrow_dt` (00:00:00 a 23:59:59), agregando estadísticas en `filter_stats['tomorrow']` para percentiles de aulas físicas y comisiones asignadas/sin asignar, y `tomorrow_schedule_list` para la agenda de clases.
- **Frontend BFF & Vistas (`frontend/views/dashboard/dashbede.html`, `dashbede.html`, `dashadm.html`, `dashboard.html`)**:
- Switcher de percentiles: botón "Mañana" con actualización dinámica de percentiles de ocupación de aulas físicas.
- Switcher de comisiones: botón "Mañana" y bloques `#commBlock-tomorrow-unassigned` y `#commBlock-tomorrow-assigned`.
- Switcher de aulas físicas: botón "Mañana" y bloques `#classBlock-tomorrow-unassigned` (aulas libres con botón "Asignar") y `#classBlock-tomorrow-assigned` (aulas en uso).
- Cartelera Operativa & Agenda de Clases: botón "Clases de Mañana" y tabla `#bedeliaScheduleTomorrow` mostrando asignaturas, comisiones, docentes y enlaces para mañana.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.4` en Frontend y Backend.
- Despliegue al servidor institucional `10.0.0.217` (`https://eduspace.oemspot.com.ar`) y verificación en caliente.
- **Sprint Optimizador de Aulas IA: Corrección de Permisos y Carga de Comisiones (v3.4.5)**:
- **Problema Reportado**: AI Room Reservation Optimizer no mostraba comisiones y los indicadores de Available Classrooms, Active Commissions y Existing Reservations quedaban en `--`.
- **Causa Raíz Identificada**:
- En `backend/app/routes/genetic_algorithm.py` las rutas `@genetic_bp.route('/commissions')`, `/algorithm-status`, `/preview-optimization`, `/optimize` y `/apply-optimization` exigían de forma estricta `g.jwt_user.role in ['ADMIN', 'teacher']` o `g.jwt_user.role in ['ADMIN']`.
- Al ingresar como Bedelía (`role == 'Bedelia'`), Docentes o Administradores con rol en minúsculas, el backend devolvía `403 Forbidden`, bloqueando la llamada AJAX y dejando la interfaz vacía con `--`.
- En el Frontend BFF, la ruta `/genetic_optimizer` no requería `requireAuth` ni pasaba datos de sesión de usuario a la plantilla.
- **Solución Implementada**:
- Creación del helper `check_optimizer_permission(user, requires_write)` en `backend/app/routes/genetic_algorithm.py` habilitando acceso a `admin`, `administrador`, `bedelia`, `docente`/`teacher` y permisos RBAC en 'optimizer'.
- `GET /api/genetic/commissions` ahora enriquece los objetos con `subject_name`, `subject_code`, `career_name`, `schedule` y `shift`.
- `frontend/views/genetic_optimizer.html`: Traducido íntegramente a español institucional ("Optimizador Inteligente de Asignación de Aulas (IA)"), tarjetas de comisiones con badges, buscador en vivo multi-criterio y manejo de errores visual.
- `frontend/public/js/genetic-algorithm.js`: Traducción de alertas, modales y tablas de resultados.
- `frontend/src/app.js`: Protección con `requireAuth` e inyección de sesión a la vista.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.5` en Frontend y Backend.
- Despliegue inmediato al servidor institucional `10.0.0.217` y verificación en caliente HTTP 200.
- **Sprint v3.4.6: Corrección Integral de Reservas, Pisos Dinámicos, Fechas Humanas y Filtro de Carreras**:
- **Incidencias Resueltas**:
1. `/schedule/add_reservation` y `/schedule/edit`: Corregido error de serialización JSON que rompía el selector en cascada Edificio -> Piso -> Aula al seleccionar "Edificio Central". Inyección segura sin entities y matching resiliente de pisos físicos y virtuales.
2. `/schedule/calendar_view`: Limpieza de datos hardcodeados/mockeados (`Arquitectura de Software ARQ-101`, `COM-A`, `Licenciatura en Sistemas`). El feed y filtros ahora consumen asignaturas, carreras y comisiones reales de la BD.
3. `sheets_importer.py`: Eliminada la autogeneración no deseada de enlaces de Google Meet / Zoom (`meet.google.com/edu-...`) en reservas importadas cuando la celda original está vacía (ej. `#9797 ASIG00215 - Marketing Digital`).
4. `/classrooms/view_classroom`: Formateadas fechas y horarios a español legible (ej. `Viernes 04/09/2026 · 18:30 a 21:30 hs`) eliminando formato ISO repetido y ampliando rango a todo el semestre 2026.
5. `/buildings/list_buildings` y `/buildings/view/:id`: Corregida la ficha de edificio que mostraba "No hay aulas asignadas a este edificio" a pesar de tener 6 aulas físicas asociadas (`floors_list` y `classrooms_by_floor`), corregido el contador de "Pisos Presenciales" (4 pisos) y soporte completo de niveles dinámicos alfanuméricos (PB, EP, Subsuelo, etc.).
6. `/admin/commissions_list`: Corregido `UnboundLocalError` en `backend/app/routes/api/admin.py` por importación interna tardía de `Career`, que arrojaba HTTP 500 al filtrar por `career_id=180, 181, 182`.
- **Sprint v3.4.8: Registro de Auditoría Institucional y Trazabilidad Operativa**:
- **Incidencias y Mejoras**:
1. `/api/v1/admin/audit-logs`: Implementación del endpoint RESTful con paginación, filtros por módulo (`auth`, `reservations`, `classrooms`, `buildings`, `optimizer`, `admin`, etc.), acción (`LOGIN`, `LOGIN_FAILED`, `CREATE`, `UPDATE`, `DELETE`, `CONFIRM`, etc.) y búsqueda multi-campo.
2. Modelo `AuditLog`: Agregado método `to_dict()` para serialización JSON segura e ISO.
3. `AuditService`: Soporte de parámetros explícitos `user_id` y `user_email` para registrar eventos cuando el usuario no está autenticado o el intento de acceso falla.
4. `/api/v1/auth/`: Instrumentada la captura de inicios de sesión (`LOGIN`), Google OAuth (`LOGIN_GOOGLE`), Moodle delegado (`LOGIN_MOODLE`), fallos de inicio de sesión (`LOGIN_FAILED`), accesos bloqueados (`LOGIN_BLOCKED`), cierres de sesión (`LOGOUT`) y cambios de contraseña institucional (`PASSWORD_CHANGE`).
5. `/api/v1/reservations`: Auditoría de creación (`CREATE`), edición (`UPDATE`), cancelación (`CANCEL`), borrado permanente (`DELETE`) y confirmación oficial (`CONFIRM`).
6. `/api/v1/classrooms` y `/api/v1/buildings`: Auditoría de altas, modificaciones, alternancia de estado activo/inactivo (`TOGGLE`) y bajas.
7. Optimizador Genético IA: Auditoría de ejecuciones (`OPTIMIZE_RUN`) y aplicación de asignaciones masivas en base de datos (`OPTIMIZE_APPLY`).
8. Frontend BFF (`/admin/audit_logs`): Conexión del BFF con la REST API, badges temáticos e intuitivos, filtros rápidos por categorías, visor modal para detalles extensos o JSON, y paginador dinámico nativo que preserva parámetros de consulta.
- **Bump Semántico y Despliegue Obligatorio (Principio 9)**:
- Versión incrementada a `v3.4.8` en Frontend y Backend.
- **Sprint v3.4.9: Solución de Límite de Payload en Importador de Sheets & Diagnóstico Transparente de Incidentes**:
- **Incidencias y Mejoras**:
1. `frontend/src/app.js`: Elevado límite de `express.json` y `express.urlencoded` de 100 KB por defecto a 50 MB (`{ limit: '50mb' }`), resolviendo el error `PayloadTooLargeError: request entity too large: expected 154166, length 154166, limit 102400` que provocaba HTTP 500 al enviar la matriz de filas preseleccionadas en `/admin/google_sheets_import`.
2. Manejo de Incidentes y Diagnóstico Transparente: Reemplazo total de la pantalla genérica de error por una interfaz estructurada con código de ticket único (`INC-YYYYMMDD-XXXX`), diagnóstico descriptivo clasificado, sección técnica de diagnóstico colapsable (Ruta, Timestamp, Usuario actuante, IP, Stack trace), botón para copiar reporte a soporte IT y enlace directo a la Auditoría Institucional.
3. `backend/app/routes/api/admin.py`: Nuevo endpoint `/api/v1/admin/log-error` para registrar incidentes técnicos no controlados del frontend directamente en `AuditLog` (`action='SYSTEM_ERROR'`, `module='system'`).
4. `backend/app/routes/api/dashboard.py`: Instrumentada auditoría completa en `sync_google_sheets` para registrar tanto importaciones exitosas (`SHEETS_IMPORT`) como fallos (`SHEETS_IMPORT_ERROR`) con desglose de estadísticas y excepciones.
- **Sprint v3.5.0: Cierre Formal del MVP de Bedelía & Adopción del Arnés SDD / IA**:
- **Metodología y Arnés de Ingeniería con IA (Apuntes Día 1, 2 y 3)**:
1. Creación de la Skill de SDD (`.agents/skills/sdd/SKILL.md`) con las plantillas de `spec.md`, `plan.md`, `tasks.md` y sintaxis formal **EARS** en español.
2. Creación de comandos reutilizables de agentes en `.opencode/commands/` (`sdd-spec`, `sdd-plan`, `sdd-tasks`).
3. Definición de roles de subagentes en `.opencode/agents/`: Coordinator, Planner, Implementer, Reviewer (QA).
4. Integración del arnés en `AGENTS.md`.
- **Diagnóstico y Cierre de Brecha del MVP**:
- Se identificó la causa raíz de la percepción de "estar lejos": el *Scope Creep* sin especificación formal de cierre y la falta de exportación/impresión de carteleras que forzaba a Bedelía a recurrir al Excel para imprimir o compartir partes con portería y docentes.
- Se formalizó la primera especificación oficial del proyecto en `specs/001-cierre-mvp-bedelia/` (`spec.md`, `plan.md`, `tasks.md`), delimitando de forma estricta los Requisitos Funcionales en **EARS** y estableciendo un perímetro cerrado de **Fuera de Alcance**.
- **Implementación Técnica**:
1. `frontend/src/routes/schedule.js`: Endpoint `/schedule/export_csv` con codificación UTF-8 BOM (`\uFEFF`) y delimitadores `;` para apertura nativa e inmediata en Microsoft Excel en español.
2. `frontend/views/schedule/today.html`: Botones directos `[ Excel / CSV ]` e `[ Imprimir ]`, acompañados de estilos CSS `@media print` que formatean la grilla de asignaciones en hoja A4 limpia con membrete institucional oficial de UniCABA.
3. `frontend/views/dashboard/dashbede.html`: Accesos rápidos en el Launchpad operativo de Bedelía para descargar la planilla del día e imprimir en 1 clic.
- **Calidad y Bump Semántico (Principio 9)**:
- 52 pruebas de backend ejecutadas con 100% de éxito en pytest (`52 passed`).
- Versión incrementada a `v3.5.0` en `package.json`, `app.js`, `__init__.py`, `setup.py` y `openapi.py`.
- **Sprint v3.5.1: Exportación y Replicación Moodle Producción a Local con Usuarios y Emails Reales**:
- **Especificación SDD (`specs/002-moodle-export-sync/`)**: Creados `spec.md` (6 RF en EARS), `plan.md` y `tasks.md` (todas las tareas completadas).
- **Extracción Híbrida y Concurrente con Emails Reales**:
- `scripts/moodle_replicator.py` se autentica en `https://campus.udelaciudad.edu.ar/` con `logintoken` dinámico.
- Obtiene la nómina masiva estructurada vía `/user/action_redir.php` (`download_participants&dataformat=json`).
- Consulta de forma concurrente (ThreadPool con 10 workers) los perfiles de los usuarios (`user/view.php`) extrayendo sus correos personales y reales (`@gmail.com`, `@hotmail.com`, etc.), eliminando cualquier generación de emails inventados.
- Normalización fonética/ortográfica sin acentos (`normalize_name`) para vincular con 100% de precisión docentes y estudiantes entre HTML y JSON.
- **Reglas de Acceso y DNI Determinístico**:
- DNI de 8 dígitos determinístico derivado del ID de Moodle (`90{moodle_id:06d}`), asignado idénticamente como `username` y `password` para pruebas locales.
- Preservado el DNI y correo real de Carlos Tello (`34247025`, `carlostellocba@gmail.com`).
- **Carga en Moodle Local (`10.0.0.207`)**:
- Creación y actualización de usuarios mediante Moodle REST API (`core_user_create_users`, `core_user_update_users`).
- 504 matriculaciones completadas exitosamente en los 4 cursos oficiales:
* Carrera Lic. en Tecnologías Digitales (CCC): ID Prod 922 -> ID Local 19 (194 alumnos).
* ASIG00124 - Sistemas Digitales_2/2026: ID Prod 5311 -> ID Local 16 (131 alumnos y 2 profesores).
* ASIG00126 - Seguridad de la Información_2/2026: ID Prod 5313 -> ID Local 17 (138 alumnos y 2 profesores).
* ASIG00127 - Programación de Vanguardia - E1_2/2026: ID Prod 5314 -> ID Local 18 (41 alumnos y 2 profesores).
- Desactivada la política restrictiva de contraseñas (`passwordpolicy=0`) en el entorno de pruebas local para permitir contraseñas numéricas idénticas al DNI.
- Verificación exitosa de login de estudiante en `http://10.0.0.207/moodle/login/index.php`.
- **Skill de Automatización**: Creada `.agents/skills/moodle-replicator/SKILL.md` con manual operativo y comandos CLI.
- **Sprint v3.5.2: Replicación Completa de 16 Cursos, User-Agent Mozilla/5.0 y Fix de Credenciales**:
- **Catálogo Completo de la Carrera (16 Cursos)**:
- Se identificaron y replicaron la totalidad de las 15 materias de la Licenciatura en Tecnologías Digitales (1/2025, 2/2025, 1/2026 y 2/2026) más el curso de la carrera (Local 19).
- Resuelto el caso de alumnos como `90010202` (Carlos Guillermo Terzano): ahora cuenta con sus 6 materias reales cursadas (Local 4, 5, 8, 9, 10, 11) además de la carrera.
- Carlos Tello (`34247025`) matriculado en las 15 asignaturas y la carrera.
- Más de 1.100 matriculaciones procesadas y validadas con 100% de éxito.
- **Identificación y Asignación de Todos los Docentes**:
- Extraídos y asignados todos los profesores reales con rol `editingteacher` (ID 3) y correos institucionales `@udelaciudad.edu.ar`.
- **Cabecera HTTP y User-Agent**:
- Forzado estrictamente el encabezado `User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64)` en todas las solicitudes al campus para evitar alertas por `python-requests`.
- **Sincronización de Contraseña Local (Fix 34247025)**:
- Se corrigió la contraseña del usuario `34247025` restableciéndola a `34247025` idéntica al DNI en Moodle local. Verificado inicio de sesión exitoso.
- **Sprint v3.5.3: Importación de Roles Moodle-App, Limpieza Total de Admin y Purga de Cursos**:
- **Sincronización RBAC de Roles Moodle a PostgreSQL de la App (`classrooms_db`)**:
- Desarrollado `scripts/import_moodle_to_app.py` y bandera `--sync-app` en `moodle_replicator.py`.
- Mapeo unívoco: Moodle `editingteacher` -> App `Docente` (`role_id=2`), Moodle `student` -> App `Alumno` (`role_id=6`).
- Importados **653 usuarios únicos** (15 Docentes y 640 Alumnos) a la base de datos de producción con contraseñas PBKDF2 coincidentes con el DNI, habilitando de inmediato la asignación de comisiones, reservas e inscripciones.
- **Desmatriculación de Cuenta Admin en Moodle Local (`10.0.0.207`)**:
- Removidas todas las matriculaciones de `admin` en cursos académicos y generales (quedando con 0 enrolments).
- **Sprint v3.5.4: Conexión Moodle API, Login Delegado y Sincronización Moodle -> Edu Space**:
- **Habilitación de Web Services para Tokens de Usuario en Moodle Local (`10.0.0.207`)**:
- Asignada la capability `moodle/webservice:createtoken` al rol 7 (`user` / usuario autenticado) en `mdl_role_capabilities`.
- Habilitado `enablemobilewebservice = 1` y servicio `moodle_mobile_app` (`enabled = 1`).
- Verificada la emisión de tokens exitosa para usuarios individuales (incluyendo `34247025`) tanto contra `moodle_api` como contra `moodle_mobile_app`.
- **Conexión de Admin Edu Space con Moodle Local**:
- Configurado el token `810428346d3601c68a37a315fcba8d4391629f46` de `moodle_api` en `system_settings` de `classrooms_db`.
- Habilitada `auth_moodle_enabled = 'true'` y `moodle_server_url = 'http://10.0.0.207/moodle'`.
- Adaptado el endpoint de autenticación `/api/v1/auth/moodle` para autenticar con `moodle_api` (con fallback a `moodle_mobile_app`) y hacer matching de cuenta local por número de documento (DNI).
- **Sincronización Bidireccional Moodle -> Edu Space**:
- Agregado el endpoint administrativo `POST /api/v1/admin/moodle/sync-from-moodle`.
- Incorporados los métodos `get_courses()`, `get_categories()` y `sync_from_moodle_to_app()` en `MoodleClient`.
- **Sprint v3.5.5: Autenticación por API Key para Moodle, Purga de Tareas y Hardening**:
- **Purga de Tareas de Sincronización Residuales**:
- Eliminadas las 6 tareas pendientes residuales de prueba (#1 a #6) en la tabla `moodle_sync_tasks` de `classrooms_db` en `10.0.0.217`, dejando la cola limpia en 0 registros.
- **Ampliación de Funciones Web Services en Moodle Local (`10.0.0.207`)**:
- Asignadas al servicio `moodle_api` las funciones `enrol_manual_unenrol_users`, `core_enrol_unenrol_user_enrolment`, `core_role_assign_roles` y `core_role_unassign_roles`, completando el catálogo a 15 funciones esenciales.
- **Seguridad por Restricción de Red (IP Restriction)**:
- Fijada la restricción de red `iprestriction = '10.0.0.0/24'` en `mdl_external_tokens`, asegurando que solo el tráfico interno institucional pueda utilizar los tokens de Moodle.
- **Autenticación por API Key Institucional en Admin Edu Space**:
- Creado mecanismo para autenticar endpoints de sincronización (`/settings/moodle/sync` y `/moodle/sync-from-moodle`) mediante `X-API-Key` institucional de 64 caracteres hex.
- Generada y almacenada la clave API institucional cifrada con Fernet en `system_settings` (`classrooms_db`).
- Agregados endpoints para consulta y regeneración de clave API (`/api/v1/admin/settings/moodle/api-key`).
- **Sprint v3.5.6: Principio 10 de Tolerancia Cero a Errores de Código, Robustez en SystemSetting y Replicador**:
- **Principio 10 de la Constitución**:
- Incorporada regla mandatoria en `docs/constitution.md`, `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.agents/skills/deploy/SKILL.md` y `.opencode/agents/` (`coordinator.md`, `implementer.md`, `reviewer.md`).
- Es estrictamente inadmisible declarar una tarea o sprint como terminado o completado si persisten errores en el código o en el analizador de la IDE (`@[current_problems]`).
- **Reparación de Tipos en Replicador Moodle**:
- Ajustado casteo a entero `int(course_meta['local_id'])` y `int(u.get('role_id', 5))` en `scripts/moodle_replicator.py`.
- **Robustez Híbrida en `SystemSetting`**:
- Implementado descriptor híbrido `_hybrid_setting_method` para `get_decrypted_value` y `get_masked_value`, permitiendo indistintamente la invocación como método de clase o de instancia sin errores de argumentos.
- **Resolución de Condición de Carrera en Tests de SQLite**:
- Añadida espera activa de finalización de workers en `test_05_api_async_job_submission_and_polling` para evitar bloqueos de base de datos en `tearDown()`.
- **Validación Automatizada**:
- 52/52 tests pasando en verde al 100% (`pytest tests -v`).
- **Sprint v3.5.7: Principio 11 de la Constitución — Estándares Modernos de APIs (FastAPI/Pydantic) e Integración con Modelos de IA (LLMs)**:
- **Arquitectura Modular en 4 Capas**:
- Desacople estricto: `main.py` (bootstrap/registro), `routers/` (endpoints agrupados por dominio con prefijos y tags para Swagger), `schemas/` (contratos con Pydantic `BaseModel`), `storage.py` (acceso a persistencia). Prohibida la lógica de negocio en el frontend o en archivos monolíticos.
- **Tipado Fuerte y Validación Pydantic**:
- Uso obligatorio de `Field` para validaciones declarativas (`min_length`, `max_length`, `gt`, `ge`, regex).
- Distinción estricta de Path Parameters (obligatorios) y Query Parameters (opcionales tipados con defaults).
- Manejo y respuesta automática de error `422 Unprocessable Entity` detallando el campo exacto.
- **Semántica HTTP y Excepciones Controladas**:
- Uso de códigos de estado HTTP semánticos (`201 Created` en POST, `200 OK`, `204 No Content`).
- Prohibido retornar `null` o respuestas vacías ante fallos: levantar `HTTPException` controladas con detalle descriptivo (404, 400, 409).
- **Documentación Interactiva Automática**:
- Contratos OpenAPI expuestos en `/docs` (Swagger UI) con capacidades de prueba en vivo (*Try it out*).
- **Integración Asíncrona con Modelos de IA Locales (LLMs) & Asistente Virtual**:
- **Pestaña en Configuración Global**: Planificada en `ROADMAP.md` y UI administrativa para configurar URL del servidor local (Ollama, llama.cpp), modelo, token y timeout para el futuro asistente virtual de la app.
- **Cliente Asíncrono no Bloqueante**: Uso mandatorio de `httpx.AsyncClient` con `async def` / `await` para inferencias concurrentes sin bloquear el servidor.
- **Timeout Generoso**: Configurar timeout de 600 segundos previendo carga de modelos en VRAM o prompts extensos.
- **Formato Estándar de Roles**: Historial estructurado bajo `role: "system" | "user" | "assistant"` y `content: prompt`.
- **Actualización Documental Completa**:
- Sincronizados `docs/constitution.md` (Principio 11), `AGENTS.md`, `.agents/skills/sdd/SKILL.md`, `.opencode/agents/` (`coordinator.md`, `planner.md`, `implementer.md`, `reviewer.md`), `ROADMAP.md` (Fase 7) y `MEMORY.md`.
- **Sprint v3.6.0: Migración Completa de Flask API a FastAPI ASGI (Principio 11)**:
- **Reemplazo Arquitectónico**:
- Backend Core migrado a FastAPI con arquitectura de 4 capas: `backend/main.py` (FastAPI bootstrap), `backend/routers/` (APIRouters modulares por dominio), `backend/schemas/` (Pydantic v2 BaseModels con validación declarativa) y `backend/database.py` (persistencia relacional).
- Módulos migrados a FastAPI: `version`, `auth`, `classrooms`, `reservations`, `students`, `dashboard`, `optimizer` y `genetic`.
- Documentación interactiva OpenAPI v3 expuesta nativamente en `/docs` (Swagger UI) y `/redoc`.
- Puente de retrocompatibilidad y cero regresión implementado mediante `a2wsgi` para asegurar interoperabilidad fluida con Gunicorn, Uvicorn y el frontend BFF Express.js.
- **Calidad y Verificación**:
- 57 tests automatizados ejecutados y aprobados al 100% en pytest (`57 passed`).
- Cero errores en linter, tipos y compilación estática (`@[current_problems]`).
- **Despliegue Continuo**:
- Bump semántico a `v3.6.0`.
- Actualización remota y reinicio de servicios en el servidor LXC `10.0.0.217` (`https://eduspace.oemspot.com.ar`).
- **Consolidación General y Actualización Documental al 04/11/2026 (v3.8.56)**:
- **Arquitectura 100% FastAPI ASGI**: Erradicación definitiva de cualquier componente Flask legacy; FastAPI 0.115+ con Uvicorn, OpenAPI (/docs, /redoc), Pydantic v2 y SQLAlchemy 2.0 nativo.
- **Copiloto Institucional UdeCi & RAG Embebido (Specs 009 & 010)**: Integración asíncrona no bloqueante (httpx 600s) con LLMs locales (Qwen 30B / Llama.cpp / Ollama), base de conocimiento vectorial institucional (KnowledgeChunk), inyección profunda de contexto en tiempo real de PostgreSQL (LiveContextService), prompt security perimetral y UX adaptativa (bottom-sheet en móviles / dock en desktop).
@@ -313,9 +316,9 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- **Credencial Digital QR Dinámica Anti-Captura (Spec 012)**: Auto-rotación del código QR cada 3 segundos, ventana estricta de gracia de 6 segundos contra capturas de pantalla, disponible en modal global, vista de perfil y carnet universitario completo.
- **Módulo de Beneficios y Convenios (Spec 012)**: ABM y catálogo de descuentos para la comunidad UniCABA con permisos RBAC dedicados.
- **Suite de Pruebas Automatizadas**: 131 de 131 pruebas ejecutadas y superadas con éxito (100% passed en pytest).
- **Sincronización Total de Documentación**: README.md y CHANGELOG.md completamente actualizados al día de hoy.
## Próximos pasos
1. Monitorear los endpoints ASGI en producción bajo concurrencia operativa.
2. Implementar la pestaña de Asistente IA en la Configuración Global administrativa (`ROADMAP.md` Fase 7).
3. Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.
- **Sincronización Total de Documentación**: README.md y CHANGELOG.md completamente actualizados al día de hoy.
## Próximos pasos
1. Monitorear los endpoints ASGI en producción bajo concurrencia operativa.
2. Implementar la pestaña de Asistente IA en la Configuración Global administrativa (`ROADMAP.md` Fase 7).
3. Continuar con el roadmap hacia la Fase 6 de hardening y orquestación de servicios en Docker.
+1 -1
View File
@@ -7,7 +7,7 @@ from typing import Any
from database import db, get_db, engine, SessionLocal, session
from config.config import Config
__version__ = "3.8.56"
__version__ = "3.8.57"
class DummyContext:
def __enter__(self):
+1 -1
View File
@@ -2,7 +2,7 @@ from setuptools import setup, find_packages
setup(
name="edu-space-admin",
version="3.8.56",
version="3.8.57",
description="Administrative interface for Edu-Space Classroom Management System (FastAPI ASGI Core)",
author="Edu-Space Development Team",
author_email="admin@edu-space.com",
+1
View File
@@ -89,3 +89,4 @@ Resultado instantáneo del escaneo de DNI (`34.247.025`): señalización cromát
Contratos OpenAPI v3 expuestos nativamente por FastAPI ASGI, permitiendo la exploración de endpoints por dominio, esquemas Pydantic v2 y el endpoint interoperable de sincronización con Spring Boot (`POST /api/v1/optimizer/spring-boot/sync`).
![Swagger UI OpenAPI Docs](capturas/12_swagger_openapi_docs.png)
@@ -6,7 +6,7 @@
**Alumno:** Carlos Facundo Tello (DNI: 34.247.025 — Correo: carlostellocba@gmail.com)
**Proyecto:** Admin Edu-Space (Plataforma Inteligente de Asignación Áulica, Asistencia IA y Control de Accesos)
**Entorno Productivo Institucional:** [https://eduspace.oemspot.com.ar](https://eduspace.oemspot.com.ar)
**Repositorio Oficial:** Rama `dev` (Versionado Semántico Consolidado: `v3.8.56`)
**Repositorio Oficial:** Rama `dev` (Versionado Semántico Consolidado: `v3.8.57`)
**Fecha de Entrega Oficial:** 12 de Noviembre de 2026
---
@@ -28,9 +28,9 @@ gitGraph
commit id: "v3.8.27 (Servidor MCP Institucional SDD-011)"
commit id: "v3.8.39 (Beneficios & Credencial QR SDD-012)"
commit id: "v3.8.52 (Web Serial Multi-COM & DNI SDD-013)"
commit id: "v3.8.56 (Consolidación al 04/11/2026)"
commit id: "v3.8.57 (Consolidación al 04/11/2026)"
checkout main
merge dev id: "v3.8.56 (Producción LXC Estable)"
merge dev id: "v3.8.57 (Producción LXC Estable)"
```
---
File diff suppressed because it is too large Load Diff
+3 -1
View File
@@ -17,7 +17,9 @@ Esta carpeta reúne la totalidad de los componentes exigidos en la consigna del
| Archivo / Documento | Descripción y Alcance | Entregable Asociado |
| :--- | :--- | :---: |
| **[INFORME_TECNICO_PROYECTO_FINAL.md](INFORME_TECNICO_PROYECTO_FINAL.md)** | **Informe Técnico y Memoria Académica Integral (PDF-ready)**.<br>Contiene la fundamentación del problema, justificación de la **propuesta superadora** (BFF Node.js + FastAPI ASGI + Motor Genético + IA Local RAG UdeCi + Bridge Spring Boot Java), diagramas de arquitectura C4, modelos de datos relacionales, plan de pruebas de 131 tests y despliegue productivo. | **Entregable 1** |
| **[PRESENTACION_EJECUTIVA_DIAPOSITIVAS.md](PRESENTACION_EJECUTIVA_DIAPOSITIVAS.md)** | **Guión y Estructura de Presentación Ejecutiva (PPT / Canva / Marp)**.<br>Diapositiva por diapositiva con tiempos sugeridos (10-12 min), guión del orador para Carlos Facundo Tello, puntos de impacto y flujo para la demostración en vivo. | **Entregable 2** |
| **[PRESENTACION_EJECUTIVA.html](PRESENTACION_EJECUTIVA.html)** | **Presentación Ejecutiva Web Interactiva (Lista para Proyección)**.<br>Presentación de diapositivas widescreen interactiva con modo pantalla completa (tecla `F`), notas de orador (tecla `N`), lightbox para ampliación de capturas de pantalla, métricas KPI en tiempo real y navegación fluida por teclado o botones. | **Entregable 2 (Web)** |
| **[PRESENTACION_EJECUTIVA_DIAPOSITIVAS.pptx](PRESENTACION_EJECUTIVA_DIAPOSITIVAS.pptx)** | **Presentación Ejecutiva PowerPoint Widescreen (16:9)**.<br>Archivo `.pptx` corporativo con 14 diapositivas profesionales, paleta de colores institucional dark/slate, tarjetas de métricas, badges y capturas de pantalla de producción incrustadas. | **Entregable 2 (PPTX)** |
| **[PRESENTACION_EJECUTIVA_DIAPOSITIVAS.md](PRESENTACION_EJECUTIVA_DIAPOSITIVAS.md)** | **Guión y Estructura de Presentación Ejecutiva (Texto / Markdown)**.<br>Diapositiva por diapositiva con tiempos sugeridos (10-12 min), guión del orador para Carlos Facundo Tello, puntos de impacto y flujo para la demostración en vivo. | **Entregable 2 (Guión)** |
| **[GUIA_DEMOSTRACION_Y_EVALUACION_DOCENTE.md](GUIA_DEMOSTRACION_Y_EVALUACION_DOCENTE.md)** | **Guía de Evaluación Rápida para el Docente (Smoke Test & RAG/API Test)**.<br>Instructivo paso a paso para el Ing. Alejandro Vázquez: credenciales de prueba por cada uno de los 5 roles, accesos a OpenAPI `/docs`, prueba del algoritmo genético, consulta a la IA local UdeCi, escaneo de DNI y endpoint interoperable Spring Boot. | **Entregables 2 y 3** |
| **[MINUTAS_Y_EVIDENCIAS_GESTION_AGIL.md](MINUTAS_Y_EVIDENCIAS_GESTION_AGIL.md)** | **Evidencias de Gestión Ágil y Metodología SDD (Spec-Driven Development)**.<br>Registro de sprints, especificaciones formales en sintaxis EARS (Specs 001 a 013), minutas de diseño técnico, control de versiones SemVer y trazabilidad en Git. | **Entregable 1 & Rúbrica** |
| **[GALERIA_DE_CAPTURAS.md](GALERIA_DE_CAPTURAS.md)** | **Galería de Capturas de Pantalla en Alta Resolución.**<br>12 capturas de pantalla obtenidas en vivo desde el servidor institucional de producción (`https://eduspace.oemspot.com.ar`) documentando cada módulo clave del sistema. | **Entregables 1, 2 y 3** |
+1 -1
View File
@@ -1,6 +1,6 @@
{
"name": "frontend",
"version": "3.8.56",
"version": "3.8.57",
"description": "",
"main": "index.js",
"scripts": {
+3 -3
View File
@@ -86,9 +86,9 @@ const env = nunjucks.configure(path.join(__dirname, '../views'), {
});
// Versiones institucionales del sistema
const APP_VERSION = '3.8.56';
const FRONTEND_VERSION = '3.8.56';
const BACKEND_VERSION = '3.8.56';
const APP_VERSION = '3.8.57';
const FRONTEND_VERSION = '3.8.57';
const BACKEND_VERSION = '3.8.57';
env.addGlobal('app_version', APP_VERSION);
env.addGlobal('frontend_version', FRONTEND_VERSION);
File diff suppressed because it is too large Load Diff
+669
View File
@@ -0,0 +1,669 @@
"""
generate_executive_pptx.py — Generador de Presentación Ejecutiva de Vanguardia en PowerPoint (16:9)
Diseño visual corporativo de alto impacto, tarjetas de contenido, métricas destacadas,
paleta institucional moderna y capturas reales de demostración.
"""
import os
import pptx
from pptx.util import Inches, Pt
from pptx.dml.color import RGBColor
from pptx.enum.text import PP_ALIGN
from pptx.enum.shapes import MSO_SHAPE
# Rutas
BASE_DIR = os.path.abspath(os.path.join(os.path.dirname(__file__), ".."))
CAPTURES_DIR = os.path.join(BASE_DIR, "docs", "entregables", "capturas")
OUTPUT_PPTX = os.path.join(BASE_DIR, "docs", "entregables", "PRESENTACION_EJECUTIVA_DIAPOSITIVAS.pptx")
# Paleta de Colores Ejecutiva (Dark Modern Theme)
COLOR_BG_DARK = RGBColor(11, 15, 25) # Fondo general oscuro #0B0F19
COLOR_CARD_BG = RGBColor(22, 29, 47) # Fondo tarjetas #161D2F
COLOR_CARD_BORDER = RGBColor(67, 56, 202) # Borde violeta/indigo #4338CA
COLOR_ACCENT_PURPLE = RGBColor(139, 92, 246) # Violeta primario #8B5CF6
COLOR_ACCENT_CYAN = RGBColor(6, 182, 212) # Cyan moderno #06B6D4
COLOR_ACCENT_GREEN = RGBColor(16, 185, 129) # Verde esmeralda #10B981
COLOR_ACCENT_AMBER = RGBColor(245, 158, 11) # Ámbar advertencia #F59E0B
COLOR_TEXT_PRIMARY = RGBColor(248, 250, 252) # Blanco titanio #F8FAFC
COLOR_TEXT_MUTED = RGBColor(148, 163, 184) # Gris tenue #94A3B8
COLOR_HEADER_PILL = RGBColor(49, 46, 129) # Fondo pill cabecera #312E81
def add_header(slide, category_text, title_text, subtitle_text=""):
"""Inserta la cabecera ejecutiva estándar de diapositiva."""
# Pill de categoría
pill = slide.shapes.add_shape(MSO_SHAPE.ROUNDED_RECTANGLE, Inches(0.8), Inches(0.4), Inches(4.5), Inches(0.35))
pill.fill.solid()
pill.fill.fore_color.rgb = COLOR_HEADER_PILL
pill.line.color.rgb = COLOR_ACCENT_PURPLE
pill.line.width = Pt(1)
tf = pill.text_frame
tf.word_wrap = True
p = tf.paragraphs[0]
p.text = category_text.upper()
p.font.size = Pt(10)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_CYAN
p.alignment = PP_ALIGN.CENTER
# Título principal
title_box = slide.shapes.add_textbox(Inches(0.8), Inches(0.8), Inches(11.7), Inches(0.6))
tf_t = title_box.text_frame
tf_t.word_wrap = True
p_t = tf_t.paragraphs[0]
p_t.text = title_text
p_t.font.size = Pt(22)
p_t.font.bold = True
p_t.font.color.rgb = COLOR_TEXT_PRIMARY
# Subtítulo (opcional)
if subtitle_text:
sub_box = slide.shapes.add_textbox(Inches(0.8), Inches(1.35), Inches(11.7), Inches(0.4))
tf_s = sub_box.text_frame
tf_s.word_wrap = True
p_s = tf_s.paragraphs[0]
p_s.text = subtitle_text
p_s.font.size = Pt(12)
p_s.font.color.rgb = COLOR_TEXT_MUTED
def add_footer(slide, current_slide, total_slides=14):
"""Agrega pie de diapositiva uniforme."""
footer_box = slide.shapes.add_textbox(Inches(0.8), Inches(7.0), Inches(11.7), Inches(0.35))
tf = footer_box.text_frame
p = tf.paragraphs[0]
p.text = f"UniCABA · Programación de Vanguardia 2026 · Alumno: Carlos Facundo Tello · eduspace.oemspot.com.ar"
p.font.size = Pt(9)
p.font.color.rgb = COLOR_TEXT_MUTED
p_num = tf.add_paragraph()
p_num.text = f"{current_slide} / {total_slides}"
p_num.alignment = PP_ALIGN.RIGHT
p_num.font.size = Pt(9)
p_num.font.bold = True
p_num.font.color.rgb = COLOR_ACCENT_PURPLE
def set_slide_background(slide):
"""Establece fondo oscuro liso y sofisticado."""
bg = slide.shapes.add_shape(MSO_SHAPE.RECTANGLE, Inches(0), Inches(0), Inches(13.333), Inches(7.5))
bg.fill.solid()
bg.fill.fore_color.rgb = COLOR_BG_DARK
bg.line.fill.background() # sin borde
def create_card(slide, left, top, width, height, border_color=COLOR_CARD_BORDER, bg_color=COLOR_CARD_BG):
"""Crea una tarjeta contenedora elegante con bordes suaves."""
card = slide.shapes.add_shape(MSO_SHAPE.ROUNDED_RECTANGLE, left, top, width, height)
card.fill.solid()
card.fill.fore_color.rgb = bg_color
card.line.color.rgb = border_color
card.line.width = Pt(1.2)
return card
def add_image_safe(slide, image_filename, left, top, width, height=None):
"""Inserta una imagen con marco sutil si el archivo existe."""
path = os.path.join(CAPTURES_DIR, image_filename)
if os.path.exists(path):
if height:
pic = slide.shapes.add_picture(path, left, top, width, height)
else:
pic = slide.shapes.add_picture(path, left, top, width)
return pic
return None
def build_presentation():
prs = pptx.Presentation()
prs.slide_width = Inches(13.333)
prs.slide_height = Inches(7.5)
blank_layout = prs.slide_layouts[6]
# =========================================================================
# DIAPOSITIVA 1: PORTADA EJECUTIVA
# =========================================================================
s1 = prs.slides.add_slide(blank_layout)
set_slide_background(s1)
# Tarjeta Central de Portada
c1 = create_card(s1, Inches(1.5), Inches(1.0), Inches(10.333), Inches(5.5), COLOR_ACCENT_PURPLE, COLOR_CARD_BG)
tf1 = c1.text_frame
tf1.word_wrap = True
p0 = tf1.paragraphs[0]
p0.text = "UNIVERSIDAD DE LA CIUDAD DE BUENOS AIRES (UniCABA)"
p0.font.size = Pt(12)
p0.font.bold = True
p0.font.color.rgb = COLOR_ACCENT_CYAN
p0.alignment = PP_ALIGN.CENTER
p0.space_after = Pt(14)
p1 = tf1.add_paragraph()
p1.text = "ADMIN EDU-SPACE"
p1.font.size = Pt(40)
p1.font.bold = True
p1.font.color.rgb = COLOR_TEXT_PRIMARY
p1.alignment = PP_ALIGN.CENTER
p2 = tf1.add_paragraph()
p2.text = "Plataforma Inteligente de Asignación Áulica, Asistencia IA y Control de Accesos"
p2.font.size = Pt(16)
p2.font.color.rgb = COLOR_ACCENT_PURPLE
p2.alignment = PP_ALIGN.CENTER
p2.space_after = Pt(24)
p3 = tf1.add_paragraph()
p3.text = "TRABAJO PRÁCTICO INTEGRADOR — PROGRAMACIÓN DE VANGUARDIA (2°C 2026)"
p3.font.size = Pt(13)
p3.font.bold = True
p3.font.color.rgb = COLOR_ACCENT_GREEN
p3.alignment = PP_ALIGN.CENTER
p3.space_after = Pt(18)
p4 = tf1.add_paragraph()
p4.text = "Alumno: Carlos Facundo Tello (DNI: 34.247.025) | Docente Titular: Ing. Alejandro Vázquez\nCarrera: Lic. en Tecnologías Informáticas / Digitales | Producción: https://eduspace.oemspot.com.ar"
p4.font.size = Pt(12)
p4.font.color.rgb = COLOR_TEXT_MUTED
p4.alignment = PP_ALIGN.CENTER
add_footer(s1, 1)
# =========================================================================
# DIAPOSITIVA 2: EL PROBLEMA REAL — LA TRAMPA DE EXCEL
# =========================================================================
s2 = prs.slides.add_slide(blank_layout)
set_slide_background(s2)
add_header(s2, "Diagnóstico Situacional", "El Problema Real: La Fragilidad de Gestionar con Planillas Excel",
"Ineficiencias operativas, falta de validación concurrente y dispersión de información en Bedelía.")
# 3 Tarjetas de Problemáticas
cols = [
("FRICCIÓN Y COLISIONES HORARIAS",
"• Carga manual propensa a duplicaciones.\n• Solapamientos de dos clases presenciales en la misma aula.\n• Docentes programados en dos materias simultáneas.\n• Violación inadvertida de aforos físicos máximos.",
COLOR_ACCENT_AMBER),
("INCERTIDUMBRE DOCENTE Y ALUMNA",
"• Desconocimiento sobre recursos del aula (proyectores, aire, red).\n• Desplazamientos innecesarios entre plantas por cambios no avisados.\n• Estrés operativo en semanas de exámenes.\n• Falta de enlaces estables a clases virtuales.",
COLOR_ACCENT_PURPLE),
("INEFICIENCIA EDILICIA Y COSTOS",
"• Comisiones de 12 alumnos ocupando aulas de 70 personas.\n• Cursos numerosos hacinados en espacios pequeños.\n• Desperdicio energético en climatización e iluminación.\n• Cero trazabilidad y auditoría de cambios.",
COLOR_ACCENT_CYAN)
]
for i, (title, desc, col) in enumerate(cols):
left = Inches(0.8 + i * 4.0)
c = create_card(s2, left, Inches(1.8), Inches(3.7), Inches(4.5), col)
tf = c.text_frame
tf.word_wrap = True
p_t = tf.paragraphs[0]
p_t.text = title
p_t.font.size = Pt(13)
p_t.font.bold = True
p_t.font.color.rgb = col
p_t.space_after = Pt(12)
p_d = tf.add_paragraph()
p_d.text = desc
p_d.font.size = Pt(11)
p_d.font.color.rgb = COLOR_TEXT_PRIMARY
add_footer(s2, 2)
# =========================================================================
# DIAPOSITIVA 3: LA PROPUESTA SUPERADORA
# =========================================================================
s3 = prs.slides.add_slide(blank_layout)
set_slide_background(s3)
add_header(s3, "Decisión de Ingeniería", "Propuesta Superadora: BFF Node.js + FastAPI ASGI vs. Java Monolítico",
"Eficiencia extrema de recursos en la nube, menor latencia y preservación de interoperabilidad.")
# Tarjeta Comparativa Java
c_java = create_card(s3, Inches(0.8), Inches(1.8), Inches(5.6), Inches(4.8), COLOR_CARD_BORDER)
tf_j = c_java.text_frame
tf_j.word_wrap = True
p = tf_j.paragraphs[0]
p.text = "CONSIGNA ORIGINAL (JAVA SPRING BOOT)"
p.font.size = Pt(14)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_AMBER
p.space_after = Pt(10)
p_j = tf_j.add_paragraph()
p_j.text = ("• Huella de Memoria RAM: ~800 MB a 1.2 GB en reposo (JVM).\n"
"• Arranque en frío lento y sobrecarga del Garbage Collector.\n"
"• Latencia inter-proceso: Serialización HTTP pesada para transferir miles de horarios a Python.\n"
"• Complejidad de despliegue en contenedores de bajo costo.\n"
"• Alto costo de infraestructura en servidores cloud.")
p_j.font.size = Pt(12)
p_j.font.color.rgb = COLOR_TEXT_MUTED
# Tarjeta Propuesta Superadora
c_sup = create_card(s3, Inches(6.8), Inches(1.8), Inches(5.7), Inches(4.8), COLOR_ACCENT_GREEN)
tf_s = c_sup.text_frame
tf_s.word_wrap = True
p = tf_s.paragraphs[0]
p.text = "PROPUESTA SUPERADORA IMPLEMENTADA"
p.font.size = Pt(14)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_GREEN
p.space_after = Pt(10)
p_s = tf_s.add_paragraph()
p_s.text = ("• Huella Combinada: < 140 MB de RAM (6x MÁS EFICIENTE).\n"
" - Microservicio BFF (Node.js Express 5): ~45 MB RAM.\n"
" - Microservicio Core (FastAPI ASGI / SQLAlchemy 2.0): ~90 MB RAM.\n"
"• I/O No Bloqueante puro con Web Serial API para hardware físico.\n"
"• Memoria Compartida: El Core y el Algoritmo Genético procesan modelos ORM sin serializaciones intermedias.\n"
"• BRIDGE SPRING BOOT INTEGRADO: Expone contratos DTO en camelCase y endpoint POST /api/v1/optimizer/spring-boot/sync.")
p_s.font.size = Pt(12)
p_s.font.color.rgb = COLOR_TEXT_PRIMARY
add_footer(s3, 3)
# =========================================================================
# DIAPOSITIVA 4: ARQUITECTURA C4 Y ENDPOINTS
# =========================================================================
s4 = prs.slides.add_slide(blank_layout)
set_slide_background(s4)
add_header(s4, "Arquitectura del Sistema", "Arquitectura en 4 Capas, Nginx SSL y OpenAPI /docs en Vivo",
"Desacople total entre Gateway BFF, Core RESTful asíncrono y persistencia relacional ACID.")
# Tarjeta de Arquitectura izquierda
c4 = create_card(s4, Inches(0.8), Inches(1.8), Inches(5.6), Inches(4.8))
tf4 = c4.text_frame
tf4.word_wrap = True
p = tf4.paragraphs[0]
p.text = "DESGLOSE DE RESPONSABILIDADES"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_PURPLE
p.space_after = Pt(8)
p_txt = tf4.add_paragraph()
p_txt.text = ("1. Borde: Proxy Inverso Nginx con SSL Let's Encrypt (A+) y HTTP/2.\n"
"2. Microservicio 1 (BFF :3000): Express 5, Nunjucks SSR, cookies seguras HttpOnly, Web Serial Multi-COM, Helmet.\n"
"3. Microservicio 2 (Core :5000): FastAPI ASGI puro, Pydantic v2 DTOs, Swagger UI, RBAC en 12 módulos, Cifrado Fernet.\n"
"4. Datos & Integraciones: PostgreSQL 15 (classrooms_db), Moodle 4.1 REST, Google OAuth 2.0 y LLMs locales.")
p_txt.font.size = Pt(11)
p_txt.font.color.rgb = COLOR_TEXT_PRIMARY
# Imagen derecha: Swagger UI
add_image_safe(s4, "12_swagger_openapi_docs.png", Inches(6.8), Inches(1.8), Inches(5.7), Inches(4.8))
add_footer(s4, 4)
# =========================================================================
# DIAPOSITIVA 5: ALGORITMO GENÉTICO ÁULICO (NP-HARD)
# =========================================================================
s5 = prs.slides.add_slide(blank_layout)
set_slide_background(s5)
add_header(s5, "Motor Heurístico Evolutivo", "Algoritmo Genético: Resolución NP-Hard en Menos de 4 Segundos",
"Optimización combinatoria multiobjetivo con selección por torneo, cruza y mutación adaptativa.")
# Tarjeta de Métricas y Función Fitness
c5 = create_card(s5, Inches(0.8), Inches(1.8), Inches(5.5), Inches(4.8))
tf5 = c5.text_frame
tf5.word_wrap = True
p = tf5.paragraphs[0]
p.text = "FORMULACIÓN MATEMÁTICA Y BENCHMARK"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_CYAN
p.space_after = Pt(8)
p_f = tf5.add_paragraph()
p_f.text = ("Fitness(S) = - [ 1000 · Σ H_i(S) + Σ W_j · S_j(S) ]\n\n"
"• Restricciones Duras (W = 1000):\n"
" - H1: Colisión de aula física en misma franja.\n"
" - H2: Superposición docente (excepción: co-docencia).\n"
" - H3: Déficit de aforo (inscriptos > capacidad banco).\n\n"
"• Restricciones Blandas (W = 1 a 10):\n"
" - Desperdicio de asientos y carencia de proyector/laboratorio.\n\n"
"BENCHMARK COMPROBADO EN PYTEST:\n"
"★ 200 comisiones optimizadas en 3.42 segundos (< 5s meta).")
p_f.font.size = Pt(11)
p_f.font.color.rgb = COLOR_TEXT_PRIMARY
# Imagen derecha: Optimizador
add_image_safe(s5, "05_optimizador_genetico_ia.png", Inches(6.6), Inches(1.8), Inches(5.9), Inches(4.8))
add_footer(s5, 5)
# =========================================================================
# DIAPOSITIVA 6: COPILOTO IA "UDECI" & RAG
# =========================================================================
s6 = prs.slides.add_slide(blank_layout)
set_slide_background(s6)
add_header(s6, "Inteligencia Artificial de Vanguardia", "Asistente Virtual 'UdeCi': LLM Local con Arquitectura RAG",
"Inferencia generativa soberana, recuperación de normativas y cero alucinaciones de cursada.")
# Tarjeta izquierda
c6 = create_card(s6, Inches(0.8), Inches(1.8), Inches(5.5), Inches(4.8))
tf6 = c6.text_frame
tf6.word_wrap = True
p = tf6.paragraphs[0]
p.text = "PILARES DE INTELIGENCIA DE UDECI"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_PURPLE
p.space_after = Pt(8)
p_ai = tf6.add_paragraph()
p_ai.text = ("1. Inferencia Local Asíncrona (httpx 600s):\n"
" Servidor llama.cpp / Ollama (Qwen 30B / Llama 3).\n"
" Soberanía absoluta: Ningún dato institucional sale a la nube.\n\n"
"2. Arquitectura RAG Embebida (KnowledgeChunk):\n"
" Búsqueda vectorial sobre normativas, correlatividades y estatutos de UniCABA con permisos por rol.\n\n"
"3. Inyección de Contexto en Vivo (PostgreSQL):\n"
" Resuelve: '¿Dónde curso hoy?' con aula física real.\n"
" PRIVACIDAD ESTRICTA: Un alumno jamás ve notas ajenas.\n\n"
"4. Prompt Security Perimetral:\n"
" Filtros contra Jailbreaks, inyecciones y manipulación.")
p_ai.font.size = Pt(11)
p_ai.font.color.rgb = COLOR_TEXT_PRIMARY
# Imagen derecha: Chat UdeCi
add_image_safe(s6, "09_asistente_virtual_udeci.png", Inches(6.6), Inches(1.8), Inches(5.9), Inches(4.8))
add_footer(s6, 6)
# =========================================================================
# DIAPOSITIVA 7: SERVIDOR MCP Y UX MÓVIL/DESKTOP
# =========================================================================
s7 = prs.slides.add_slide(blank_layout)
set_slide_background(s7)
add_header(s7, "Estándares y Experiencia de Usuario", "Servidor MCP Institucional y UX Móvil Mercado Libre Style",
"Interoperabilidad para agentes de IA autónomos y diseño adaptativo con alto contraste WCAG AA.")
c_mcp = create_card(s7, Inches(0.8), Inches(1.8), Inches(5.6), Inches(4.8))
tf_m = c_mcp.text_frame
tf_m.word_wrap = True
p = tf_m.paragraphs[0]
p.text = "MODEL CONTEXT PROTOCOL (/api/v1/mcp)"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_CYAN
p.space_after = Pt(8)
p_m = tf_m.add_paragraph()
p_m.text = ("• Herramientas Expuestas para Agentes:\n"
" - get_today_classes: Consulta el cronograma áulico del día.\n"
" - get_classroom_info: Aforo, recursos y estado del aula.\n"
" - search_subjects: Búsqueda de materias por código/carrera.\n"
" - guide_navigation: Activador de tutoriales interactivos.\n\n"
"• Reflector Didáctico Interactivo (Spotlight UI):\n"
" Guía visual en pantalla que resalta botones y pasos para capacitar a nuevos operadores de Bedelía.")
p_m.font.size = Pt(11)
p_m.font.color.rgb = COLOR_TEXT_PRIMARY
c_ux = create_card(s7, Inches(6.8), Inches(1.8), Inches(5.7), Inches(4.8))
tf_u = c_ux.text_frame
tf_u.word_wrap = True
p = tf_u.paragraphs[0]
p.text = "DISEÑO ADAPTATIVO & ACCESIBILIDAD"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_GREEN
p.space_after = Pt(8)
p_u = tf_u.add_paragraph()
p_u.text = ("• UX Móvil Bottom-Sheet (Mercado Libre Style):\n"
" El chat y los formularios emergen desde la parte inferior, acoplándose al teclado virtual sin desbordar el viewport.\n\n"
"• Modo Oscuro Accesible (WCAG AA):\n"
" Paleta sobria (#17162E / #0E0D1D) con bordes violetas institucionales #8B5CF6 y tipografía nítida para pantallas argentinas (720p a 1080p).\n\n"
"• Widgets Dinámicos:\n"
" Clima del Campus en tiempo real en la barra lateral.")
p_u.font.size = Pt(11)
p_u.font.color.rgb = COLOR_TEXT_PRIMARY
add_footer(s7, 7)
# =========================================================================
# DIAPOSITIVA 8: CONTROL DE ACCESO FÍSICO Y DNI ARGENTINO
# =========================================================================
s8 = prs.slides.add_slide(blank_layout)
set_slide_background(s8)
add_header(s8, "Ciber-Seguridad y Hardware", "Consola de Recepción: Web Serial Multi-COM y Parser DNI Renaper",
"Validación en molinetes con hardware físico serie y resolución universal de documentos.")
c8 = create_card(s8, Inches(0.8), Inches(1.8), Inches(5.0), Inches(4.8))
tf8 = c8.text_frame
tf8.word_wrap = True
p = tf8.paragraphs[0]
p.text = "CARACTERÍSTICAS DEL SISTEMA"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_AMBER
p.space_after = Pt(8)
p_hw = tf8.add_paragraph()
p_hw.text = ("• Web Serial API Multi-Lector:\n"
" Hasta 4 lectores físicos COM simultáneos con auto-reconexión plug-and-play en Windows.\n\n"
"• Parser Universal DNI Argentino:\n"
" - Renaper 2026 QR: Decodifica patronímicos y JWT oficial.\n"
" - PDF417 2012 y 2009 (Libreta con F/M).\n"
" - App Mi Argentina y número directo con/sin puntos.\n\n"
"• Normalización de Teclado Español:\n"
" Corrige la sustitución de ':' por 'Ñ' protegiendo apellidos como Peña o Núñez.\n\n"
"• Cronograma Inmediato: Muestra aula física y piso de hoy con audio sintetizado.")
p_hw.font.size = Pt(11)
p_hw.font.color.rgb = COLOR_TEXT_PRIMARY
# Imagen derecha: Escaneo validado
add_image_safe(s8, "11_recepcion_escaneo_carlos_tello.png", Inches(6.1), Inches(1.8), Inches(6.4), Inches(4.8))
add_footer(s8, 8)
# =========================================================================
# DIAPOSITIVA 9: CREDENCIAL QR DINÁMICA Y BENEFICIOS
# =========================================================================
s9 = prs.slides.add_slide(blank_layout)
set_slide_background(s9)
add_header(s9, "Identidad Digital Universitaria", "Credencial QR Dinámica Anti-Captura y Módulo de Beneficios",
"Cero fraude en molinetes con rotación cada 3 segundos y portal de convenios institucionales.")
# Imagen carnet Carlos Tello
add_image_safe(s9, "08_credencial_digital_carlos_tello.png", Inches(0.8), Inches(1.8), Inches(5.8), Inches(4.8))
# Tarjeta explicativa derecha
c9 = create_card(s9, Inches(6.9), Inches(1.8), Inches(5.6), Inches(4.8))
tf9 = c9.text_frame
tf9.word_wrap = True
p = tf9.paragraphs[0]
p.text = "SEGURIDAD CRIPTOGRÁFICA DEL CARNET"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_GREEN
p.space_after = Pt(8)
p_cr = tf9.add_paragraph()
p_cr.text = ("• Rotación Dinámica (3 Segundos):\n"
" El código QR se regenera cada 3s firmado criptográficamente con tokens JWT únicos (jti, iat).\n\n"
"• Ventana Estricta Anti-Screenshot (6s):\n"
" Cualquier fotografía previa enviada por mensajería expira de inmediato y es bloqueada en recepción.\n\n"
"• Puntos de Acceso:\n"
" Carnet universitario imprimible (/credential/my-card), modal rápido y perfil de usuario.\n\n"
"• Portal de Convenios y Beneficios (/benefits):\n"
" Descuentos categorizados en gastronomía, librerías y tecnología para la comunidad UniCABA.")
p_cr.font.size = Pt(11)
p_cr.font.color.rgb = COLOR_TEXT_PRIMARY
add_footer(s9, 9)
# =========================================================================
# DIAPOSITIVA 10: BEDELÍA UX Y CARTELERA OPERATIVA
# =========================================================================
s10 = prs.slides.add_slide(blank_layout)
set_slide_background(s10)
add_header(s10, "Gestión Académica Integral", "Bedelía UX: Circuito de 9 Pasos, Cartelera y Libro de Calificaciones",
"Estandarización operativa, exportación oficial y actas de examen inmutables.")
c10 = create_card(s10, Inches(0.8), Inches(1.8), Inches(5.2), Inches(4.8))
tf10 = c10.text_frame
tf10.word_wrap = True
p = tf10.paragraphs[0]
p.text = "CIRCUITO SECUENCIAL ESTANDARIZADO"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_PURPLE
p.space_after = Pt(8)
p_b = tf10.add_paragraph()
p_b.text = ("• Flujo de 9 Pasos:\n"
" Sede ➔ Aulas ➔ Ciclo ➔ Carreras ➔ Asignaturas multi-carrera ➔ Comisiones ➔ Profesores ➔ Alumnos ➔ Reservas.\n\n"
"• Cartelera del Día:\n"
" Agrupación cronológica de cursada con exportación a Excel (UTF-8 BOM) e impresión A4 membretada (@media print).\n\n"
"• Grilla Semanal Drag & Drop:\n"
" FullCalendar con detección preventiva de colisiones (HTTP 409).\n\n"
"• Gradebook Institucional:\n"
" Matriz 2D de notas y cierre de actas inmutables (ACTA-YYYY-Sem-ID).")
p_b.font.size = Pt(11)
p_b.font.color.rgb = COLOR_TEXT_PRIMARY
# Imagen derecha: Cartelera
add_image_safe(s10, "03_cartelera_clases_hoy.png", Inches(6.3), Inches(1.8), Inches(6.2), Inches(4.8))
add_footer(s10, 10)
# =========================================================================
# DIAPOSITIVA 11: CALIDAD Y TESTS (131/131 PASSED)
# =========================================================================
s11 = prs.slides.add_slide(blank_layout)
set_slide_background(s11)
add_header(s11, "Aseguramiento de Calidad", "Estrategia de Pruebas: 131 Tests en Pytest y Auditoría SAST/SCA",
"Cobertura exhaustiva de contratos, algoritmos, RAG, parsers y seguridad perimetral.")
# 4 Cards de Métricas de Calidad
kpis = [
("131 / 131", "TESTS AUTOMATIZADOS", "100% Passed en pytest cubriendo contratos FastAPI, Algoritmo Genético, RAG y DNI parsers.", COLOR_ACCENT_GREEN),
("0 FALLOS", "AUDITORÍA SAST", "Escaneo de código estático con bandit sobre más de 8.000 líneas. Cero vulnerabilidades.", COLOR_ACCENT_CYAN),
("0 CVEs", "AUDITORÍA SCA", "pip-audit y npm audit certificados contra la base de datos nacional OSV.", COLOR_ACCENT_PURPLE),
("PRINCIPIO 10", "TOLERANCIA CERO", "Inadmisible finalizar tareas con errores de IDE o compilador (@[current_problems]).", COLOR_ACCENT_AMBER)
]
for i, (big, title, desc, col) in enumerate(kpis):
left = Inches(0.8 + (i % 2) * 5.9)
top = Inches(1.8 + (i // 2) * 2.4)
c = create_card(s11, left, top, Inches(5.6), Inches(2.2), col)
tf = c.text_frame
tf.word_wrap = True
p_big = tf.paragraphs[0]
p_big.text = big
p_big.font.size = Pt(28)
p_big.font.bold = True
p_big.font.color.rgb = col
p_t = tf.add_paragraph()
p_t.text = title
p_t.font.size = Pt(11)
p_t.font.bold = True
p_t.font.color.rgb = COLOR_TEXT_PRIMARY
p_d = tf.add_paragraph()
p_d.text = desc
p_d.font.size = Pt(10)
p_d.font.color.rgb = COLOR_TEXT_MUTED
add_footer(s11, 11)
# =========================================================================
# DIAPOSITIVA 12: PRODUCCIÓN REAL EN PROXMOX LXC
# =========================================================================
s12 = prs.slides.add_slide(blank_layout)
set_slide_background(s12)
add_header(s12, "Infraestructura Cloud", "Despliegue Continuo en Producción Institucional (Proxmox LXC)",
"Servidor real activo en eduspace.oemspot.com.ar con Nginx, SSL y PostgreSQL 15.")
c12 = create_card(s12, Inches(0.8), Inches(1.8), Inches(5.6), Inches(4.8))
tf12 = c12.text_frame
tf12.word_wrap = True
p = tf12.paragraphs[0]
p.text = "INFRAESTRUCTURA PRODUCTIVA"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_CYAN
p.space_after = Pt(8)
p_inf = tf12.add_paragraph()
p_inf.text = ("• Servidor de Producción:\n"
" Contenedor Linux LXC en Proxmox (IP 10.0.0.217).\n\n"
"• Dominio Oficial:\n"
" https://eduspace.oemspot.com.ar\n\n"
"• Proxy Inverso de Borde (Nginx):\n"
" Terminación SSL Let's Encrypt (A+), HTTP/2 y compresión Brotli/Gzip.\n\n"
"• Orquestación supervisada con systemd:\n"
" Servicios admin-edu-space-backend y admin-edu-space-frontend.\n\n"
"• Base de Datos ACID:\n"
" PostgreSQL 15 (classrooms_db) con 16 tablas relacionales normalizadas.")
p_inf.font.size = Pt(11)
p_inf.font.color.rgb = COLOR_TEXT_PRIMARY
# Imagen derecha: Dashboard Bedelia
add_image_safe(s12, "02_dashboard_bedelia.png", Inches(6.8), Inches(1.8), Inches(5.7), Inches(4.8))
add_footer(s12, 12)
# =========================================================================
# DIAPOSITIVA 13: DEMOSTRACIÓN EN VIVO (LIVE DEMO)
# =========================================================================
s13 = prs.slides.add_slide(blank_layout)
set_slide_background(s13)
add_header(s13, "Defensa Práctica", "Demostración en Vivo: Flujo de Smoke Testing para la Cátedra",
"5 Hitos funcionales verificables en tiempo real en https://eduspace.oemspot.com.ar.")
c13 = create_card(s13, Inches(0.8), Inches(1.8), Inches(11.7), Inches(4.8), COLOR_ACCENT_GREEN)
tf13 = c13.text_frame
tf13.word_wrap = True
p = tf13.paragraphs[0]
p.text = "HOJA DE RUTA PARA LA DEMOSTRACIÓN ORAL (3-4 MINUTOS)"
p.font.size = Pt(14)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_GREEN
p.space_after = Pt(10)
demo_steps = (
"1. Login y Cartelera Operativa (Bedelía):\n"
" Ingreso con bedelia@edu-space.com ➔ Filtros por Día/Semana/Mes ➔ Exportación a Excel con UTF-8 BOM e Impresión A4 membretada.\n\n"
"2. Optimizador Genético & Interoperabilidad Spring Boot:\n"
" Ejecución del algoritmo genético en /genetic_optimizer ➔ Demostración del endpoint POST /api/v1/optimizer/spring-boot/sync en Swagger UI.\n\n"
"3. Copiloto IA UdeCi con RAG & Contexto en Vivo:\n"
" Apertura del chat ➔ Consulta: '¿Dónde curso hoy y qué notas tengo?' ➔ Inyección real de PostgreSQL y privacidad estricta de notas.\n\n"
"4. Control de Acceso Físico & Escaneo de DNI Argentino:\n"
" Consola en /reception/scanner ➔ Escaneo de DNI 34247025 (Carlos Tello) ➔ Señalización verde, tono de audio y resolución de aula física.\n\n"
"5. Credencial Digital Universitaria con QR Dinámico:\n"
" Visualización en /credential/my-card ➔ Rotación automática cada 3 segundos con ventana de gracia anti-captura de pantalla."
)
p_step = tf13.add_paragraph()
p_step.text = demo_steps
p_step.font.size = Pt(11)
p_step.font.color.rgb = COLOR_TEXT_PRIMARY
add_footer(s13, 13)
# =========================================================================
# DIAPOSITIVA 14: CONCLUSIÓN Y RÚBRICA (100 PUNTOS)
# =========================================================================
s14 = prs.slides.add_slide(blank_layout)
set_slide_background(s14)
add_header(s14, "Evaluación y Cierre", "Conclusión: Cumplimiento Integral de la Rúbrica (100 Puntos)",
"Solución de vanguardia, producción real, IA local soberana e impacto operativo en UniCABA.")
# Tarjeta de Rúbrica
c14 = create_card(s14, Inches(0.8), Inches(1.8), Inches(11.7), Inches(4.8), COLOR_ACCENT_PURPLE)
tf14 = c14.text_frame
tf14.word_wrap = True
p = tf14.paragraphs[0]
p.text = "BALANCE DE CUMPLIMIENTO FRENTE A LA RÚBRICA OFICIAL (100 PUNTOS)"
p.font.size = Pt(13)
p.font.bold = True
p.font.color.rgb = COLOR_ACCENT_PURPLE
p.space_after = Pt(8)
rubric_text = (
"• Propuesta e Innovación (15/15 pts): Solución de valor real para UniCABA resolviendo la problemática de Bedelía.\n"
"• Arquitectura de Microservicios (20/20 pts): Desacople BFF Node.js + Core FastAPI ASGI + Bridge Spring Boot Java.\n"
"• MVP, Predictor e IA Local (25/25 pts): Algoritmo Genético NP-Hard (<4s) + Asistente LLM UdeCi con RAG embebido.\n"
"• Selección de Tecnologías y BD (10/10 pts): PostgreSQL 15, SQLAlchemy 2.0, Pydantic v2, Web Serial API y Web Audio API.\n"
"• Gestión Ágil y Repositorio (15/15 pts): Metodología SDD (13 specs EARS), Git continuo y releases semánticos v3.8.57.\n"
"• Documentación, Pruebas y Despliegue (10/10 pts): 131 tests (100% passed), SAST/SCA 0 fallos, producción Proxmox LXC.\n"
"• Exposición y Defensa Oral (5/5 pts): Presentación ejecutiva de alto impacto y demostración en vivo guiada.\n\n"
"¡MUCHAS GRACIAS POR SU ATENCIÓN! — QUEDO A DISPOSICIÓN DEL ING. ALEJANDRO VÁZQUEZ."
)
p_r = tf14.add_paragraph()
p_r.text = rubric_text
p_r.font.size = Pt(11)
p_r.font.color.rgb = COLOR_TEXT_PRIMARY
add_footer(s14, 14)
# Guardar presentación
prs.save(OUTPUT_PPTX)
print(f"[+] ¡Presentación Ejecutiva generada exitosamente en {OUTPUT_PPTX}!")
if __name__ == "__main__":
build_presentation()