"""
Generador de la Presentación Ejecutiva en HTML Interactivo para Admin EduSpace.
Crea docs/entregables/PRESENTACION_EJECUTIVA.html con diseño de nivel ejecutivo,
navegación por teclado, modo pantalla completa (F), notas de orador (N), lightbox de imágenes y métricas KPI.
"""
import os
import json
OUTPUT_HTML = os.path.abspath(os.path.join(os.path.dirname(__file__), "..", "docs", "entregables", "PRESENTACION_EJECUTIVA.html"))
SLIDES = [
{
"id": 1,
"category": "DEFENSA FINAL ACADÉMICA — CICLO 2026",
"title": "Admin Edu-Space",
"subtitle": "Plataforma Inteligente de Asignación Áulica, Asistencia IA y Control de Accesos",
"badge": "TRABAJO PRÁCTICO INTEGRADOR — PROGRAMACIÓN DE VANGUARDIA",
"is_cover": True,
"author": "Carlos Facundo Tello (DNI: 34.247.025)",
"institution": "UniCABA — Universidad de la Ciudad de Buenos Aires",
"professor": "Ing. Alejandro Vázquez",
"term": "2° Cuatrimestre 2026",
"metrics": [
{"value": "131/131", "label": "Tests Automatizados", "icon": "bi-check-circle-fill", "color": "text-emerald-400"},
{"value": "100/100", "label": "Rúbrica de Cátedra", "icon": "bi-award-fill", "color": "text-amber-400"},
{"value": "100%", "label": "Producción en Proxmox", "icon": "bi-cloud-check-fill", "color": "text-cyan-400"},
{"value": "4", "label": "Subsistemas Desacoplados", "icon": "bi-diagram-3-fill", "color": "text-indigo-400"},
],
"notes": "Apertura formal de la defensa. Presentar al alumno Carlos Facundo Tello, agradecer al profesor Ing. Alejandro Vázquez y resaltar que el proyecto implementa una solución de nivel institucional desplegada en producción real."
},
{
"id": 2,
"category": "DIAGNÓSTICO SITUACIONAL",
"title": "El Problema Real: La Fragilidad de Gestionar con Excel",
"subtitle": "Ineficiencias operativas, falta de validación concurrente y dispersión de datos en Bedelía",
"image": "capturas/02_dashboard_bedelia.png",
"image_caption": "Dashboard operativo de Bedelía con KPIs y circuito académico en tiempo real",
"points": [
"Fricción y Colisiones Horarias: Carga manual propensa a duplicaciones, solapamientos físicos de aula y docentes asignados a dos materias simultáneas.",
"Incertidumbre Docente y Alumna: Desconocimiento sobre recursos del aula (proyectores, aire, red) y desplazamientos innecesarios por cambios no avisados.",
"Ineficiencia Edilicia y Costos: Comisiones de 12 alumnos ocupando aulas magnas de 70 personas o cursos numerosos hacinados sin control de aforo.",
"Desconexión con el Campus Virtual: Brecha entre las planillas de Bedelía y el entorno virtual en Moodle 4.1."
],
"kpis": [
{"num": "+350 hs", "desc": "Ahorro cuatrimestral en tareas manuales"},
{"num": "0", "desc": "Conflictos y colisiones horarias"},
{"num": "100%", "desc": "Trazabilidad de reservas y matriculaciones"}
],
"notes": "Explicar la problemática real de Bedelía: hojas de cálculo frágiles, falta de validaciones concurrentes y la necesidad de una plataforma integral que resuelva el día a día."
},
{
"id": 3,
"category": "DECISIÓN DE INGENIERÍA",
"title": "Propuesta Superadora: BFF Node.js + FastAPI ASGI",
"subtitle": "Eficiencia extrema de recursos en la nube, menor latencia y preservación de interoperabilidad",
"image": "capturas/01_login_institucional.png",
"image_caption": "Portal institucional con SSO Google Workspace (@unicaba.edu.ar) y cookies HttpOnly",
"points": [
"Consigna Original (Java Monolítico): Huella de RAM de ~800 MB a 1.2 GB en reposo (JVM), arranque en frío lento y alto costo en la nube.",
"Propuesta Superadora Implementada: Huella combinada menor a 140 MB de RAM (6x más eficiente: Node.js BFF ~45 MB + FastAPI Core ~90 MB).",
"I/O No Bloqueante Puro: Soporte de Web Serial API para lectura directa de hardware físico de molinetes.",
"Bridge Spring Boot Integrado: Módulo Java interoperable con DTOs en camelCase y endpoint POST /api/v1/optimizer/spring-boot/sync."
],
"kpis": [
{"num": "< 140 MB", "desc": "RAM total de ambos microservicios"},
{"num": "6x", "desc": "Mayor eficiencia de recursos vs JVM"},
{"num": "100%", "desc": "Interoperabilidad Java Spring Boot"}
],
"notes": "Punto de impacto académico: justificar con datos medidos por qué la propuesta desacoplada Node.js + FastAPI es técnicamente superior a un monolito Java, sin dejar de cumplir la consigna mediante el bridge Spring Boot."
},
{
"id": 4,
"category": "ARQUITECTURA DEL SISTEMA",
"title": "Arquitectura en 4 Capas y OpenAPI /docs en Vivo",
"subtitle": "Desacople total entre Gateway BFF, Core RESTful asíncrono y persistencia relacional ACID",
"image": "capturas/12_swagger_openapi_docs.png",
"image_caption": "Contratos OpenAPI 3.1 interactivos tipados con Pydantic v2 en Swagger UI",
"points": [
"Borde Seguro: Proxy Inverso Nginx con terminación SSL Let's Encrypt (A+) y protocolo HTTP/2 en producción.",
"Microservicio 1 (BFF :3000): Express 5, Nunjucks SSR, cookies seguras HttpOnly, Web Serial Multi-COM y Helmet.",
"Microservicio 2 (Core :5000): FastAPI ASGI nativo, contratos Pydantic v2, Swagger UI interactivo, RBAC en 12 módulos y Cifrado Fernet.",
"Datos & Integraciones: PostgreSQL 15 (classrooms_db), Moodle 4.1 REST, Google Workspace OAuth 2.0 y LLMs locales."
],
"kpis": [
{"num": "< 35 ms", "desc": "Latencia P95 en consultas"},
{"num": "16 Tablas", "desc": "Modelo relacional ACID en PostgreSQL"},
{"num": "100%", "desc": "Contratos OpenAPI /docs expuestos"}
],
"notes": "Mostrar el diagrama C4 mental: Nginx adelante, BFF mediando la experiencia de usuario y Core FastAPI procesando transacciones con Pydantic v2 y SQLAlchemy 2.0."
},
{
"id": 5,
"category": "MOTOR HEURÍSTICO EVOLUTIVO",
"title": "Algoritmo Genético: Resolución NP-Hard en < 4 Segundos",
"subtitle": "Optimización combinatoria multiobjetivo con selección por torneo, cruza y mutación adaptativa",
"image": "capturas/05_optimizador_genetico_ia.png",
"image_caption": "Consola del Optimizador Genético Áulico con métricas de convergencia y fitness",
"points": [
"Formulación Matemática del Fitness: Fitness(S) = - [ 1000 · Σ H_i(S) + Σ W_j · S_j(S) ].",
"Restricciones Duras (W = 1000): H1: Colisión de aula física en misma franja; H2: Superposición docente; H3: Déficit de aforo.",
"Restricciones Blandas (W = 1 a 10): Minimización de desperdicio de asientos y cercanía de recursos multimedia requeridos.",
"Benchmark Comprobado en Pytest: 200 comisiones optimizadas en 3.42 segundos (< 5s de meta original)."
],
"kpis": [
{"num": "3.42 s", "desc": "Tiempo de convergencia para 200 comisiones"},
{"num": "0", "desc": "Colisiones duras resultantes"},
{"num": "94.2%", "desc": "Factor de ocupación áulica óptimo"}
],
"notes": "Detallar el componente heurístico: resolución de un problema computacionalmente complejo (NP-Hard) que automatiza en segundos lo que a Bedelía le tomaba semanas."
},
{
"id": 6,
"category": "INTELIGENCIA ARTIFICIAL DE VANGUARDIA",
"title": "Asistente Virtual 'UdeCi': LLM Local con Arquitectura RAG",
"subtitle": "Inferencia generativa soberana, recuperación de normativas y cero alucinaciones de cursada",
"image": "capturas/09_asistente_virtual_udeci.png",
"image_caption": "Chatbot UdeCi asistiendo a estudiantes y Bedelía con respuestas contextuales en vivo",
"points": [
"Inferencia Local Asíncrona (httpx 600s): Servidor llama.cpp / Ollama on-premise. Soberanía absoluta: ningún dato sale a la nube.",
"Arquitectura RAG Embebida (KnowledgeChunk): Búsqueda de normativas académicas, correlatividades y estatutos con filtrado por rol.",
"Inyección de Contexto en Vivo: Resuelve preguntas como '¿Dónde curso hoy y qué notas tengo?' consultando la base de datos PostgreSQL.",
"Prompt Security Perimetral: Filtros activos contra jailbreaks, inyecciones de prompt y divulgación de calificaciones ajenas."
],
"kpis": [
{"num": "100%", "desc": "Privacidad soberana on-premise"},
{"num": "600 s", "desc": "Timeout asíncrono no bloqueante"},
{"num": "$0", "desc": "Costo recurrente por tokens"}
],
"notes": "Demostrar cómo UdeCi trasciende el típico bot de reglas: usa un LLM local con RAG y base de datos en vivo, respetando la privacidad institucional."
},
{
"id": 7,
"category": "ESTÁNDARES Y EXPERIENCIA DE USUARIO",
"title": "Servidor MCP Institucional y UX Móvil Adaptativa",
"subtitle": "Interoperabilidad para agentes autónomos y diseño responsivo accesible WCAG AA",
"image": "capturas/07_modulo_convenios_beneficios.png",
"image_caption": "Módulo institucional de Convenios y Beneficios universitarios para estudiantes",
"points": [
"Model Context Protocol (/api/v1/mcp): Expone herramientas estructuradas (get_today_classes, get_classroom_info, search_subjects) para agentes de IA externos.",
"Reflector Didáctico Interactivo (Spotlight UI): Guía visual en pantalla que resalta botones y pasos para capacitar a nuevos operadores de Bedelía.",
"UX Móvil Bottom-Sheet: Formularios y chat que emergen desde la parte inferior adaptándose al teclado virtual del smartphone.",
"Modo Oscuro Institucional: Paleta sobria (#0F131D / #07090E) con bordes violetas (#6366F1) de alto contraste visual."
],
"kpis": [
{"num": "MCP 1.0", "desc": "Estándar de interoperabilidad de agentes"},
{"num": "WCAG AA", "desc": "Accesibilidad de contraste y fuentes"},
{"num": "100%", "desc": "Adaptable a móviles y escritorio"}
],
"notes": "Resaltar el cumplimiento del protocolo MCP (Model Context Protocol) para conectar agentes externos y la experiencia de usuario mobile-first."
},
{
"id": 8,
"category": "CIBER-SEGURIDAD Y HARDWARE IOT",
"title": "Consola de Recepción: Web Serial Multi-COM y DNI Renaper",
"subtitle": "Validación en molinetes con hardware físico serie y resolución universal de documentos",
"image": "capturas/11_recepcion_escaneo_carlos_tello.png",
"image_caption": "Validación instantánea de credencial del alumno Carlos Facundo Tello en recepción",
"points": [
"Web Serial API Multi-Lector: Hasta 4 lectores físicos COM simultáneos con auto-reconexión plug-and-play en Chromium.",
"Parser Universal de DNI Argentino: Renaper 2026 QR con JWT, PDF417 2012/2009 (Libreta con F/M), App Mi Argentina y DNI plano.",
"Normalización de Teclado Español: Corrige automáticamente la sustitución de ':' por 'Ñ' protegiendo apellidos como Peña o Núñez.",
"Resolución Inmediata de Aula: Al escanear la tarjeta, el sistema indica el aula, piso y horario exacto con síntesis de voz Web Audio API."
],
"kpis": [
{"num": "< 50 ms", "desc": "Tiempo de resolución de documento"},
{"num": "4 Puertos", "desc": "Multiplexación serial COM simultánea"},
{"num": "100%", "desc": "Compatibilidad con formatos Renaper"}
],
"notes": "Mostrar la captura real del escaneo de Carlos Facundo Tello: cómo el sistema parsea el DNI, valida la regularidad y avisa el aula en tiempo real."
},
{
"id": 9,
"category": "IDENTIDAD DIGITAL UNIVERSITARIA",
"title": "Credencial QR Dinámica y Beneficios Estudiantiles",
"subtitle": "Cero fraude en molinetes con rotación cada 3 segundos y ventana de gracia anti-captura",
"image": "capturas/08_credencial_digital_carlos_tello.png",
"image_caption": "Carnet digital universitario de Carlos Facundo Tello con código QR auto-rotativo",
"points": [
"Rotación Criptográfica (3 Segundos): El código QR se regenera periódicamente firmado con tokens JWT únicos (jti, iat).",
"Ventana Estricta Anti-Screenshot (6s): Cualquier captura de pantalla compartida por WhatsApp expira y es rechazada por el molinete.",
"Puntos de Acceso Transparentes: Carnet universitario imprimible (/credential/my-card), modal rápido y perfil de usuario.",
"Portal de Convenios (/benefits): Catálogo de descuentos en gastronomía, librerías y tecnología para la comunidad UniCABA."
],
"kpis": [
{"num": "3 Seg", "desc": "Período de rotación del código QR"},
{"num": "0 Fraude", "desc": "Bloqueo efectivo de capturas de pantalla"},
{"num": "JWT", "desc": "Firma criptográfica stateless"}
],
"notes": "Punto de ciberseguridad aplicada: la credencial digital rota cada 3 segundos impidiendo el préstamo indebido de fotos o capturas de pantalla."
},
{
"id": 10,
"category": "GESTIÓN ACADÉMICA INTEGRAL",
"title": "Bedelía UX: Circuito de 9 Pasos y Cartelera Operativa",
"subtitle": "Estandarización operativa, exportación oficial y actas de examen inmutables",
"image": "capturas/03_cartelera_clases_hoy.png",
"image_caption": "Cartelera interactiva de clases de hoy con exportación a Excel e impresión A4",
"points": [
"Circuito Guiado de 9 Pasos: Sedes → Aulas → Ciclos → Carreras → Asignaturas → Comisiones → Docentes → Alumnos → Reservas.",
"Cartelera del Día: Visualización cronológica de cursadas con exportación a Excel (UTF-8 BOM) e impresión A4 membretada.",
"Grilla Semanal Calendario: Vista de FullCalendar interactiva con detección preventiva de colisiones (HTTP 409).",
"Actas de Examen Inmutables: Cierre de actas con firma digital interna y numeración oficial (ACTA-YYYY-Sem-ID)."
],
"kpis": [
{"num": "9 Pasos", "desc": "Circuito secuencial obligatorio"},
{"num": "Excel BOM", "desc": "Exportación nativa compatible con Office"},
{"num": "A4 Print", "desc": "Estilos CSS de impresión institucional"}
],
"notes": "El circuito de 9 pasos garantiza orden institucional: no se puede crear una comisión sin aula o materia asociada. La cartelera permite imprimir la hoja de Bedelía del día."
},
{
"id": 11,
"category": "CALENDARIO Y DISTRIBUCIÓN HORARIA",
"title": "Grilla Semanal y Gestión de Espacios Áulicos",
"subtitle": "Visualización matricial por turnos y catálogo de sedes con aforo y equipamiento",
"image": "capturas/04_grilla_semanal_calendario.png",
"image_caption": "Grilla semanal de distribución horaria con filtros por carrera, turno y sede",
"points": [
"Matriz Horaria Semanal: Organización visual por turnos (Mañana, Tarde, Noche) y días de la semana con código de colores por carrera.",
"Catálogo Integral de Sedes y Aulas: Registro de capacidades físicas, disposición de bancos y disponibilidad de aire acondicionado y proyector.",
"Asignaturas Compartidas: Soporte relacional N:M (subject_careers) para asignaturas troncales compartidas entre varias carreras.",
"Restricción Diaria de Alumnos: Regla de negocio que previene doble cursada presencial el mismo día salvo autorización expresa."
],
"kpis": [
{"num": "100%", "desc": "Prevención de solapamiento físico"},
{"num": "3 Turnos", "desc": "Mañana, Tarde y Noche soportados"},
{"num": "N : M", "desc": "Materias compartidas entre carreras"}
],
"notes": "Mostrar cómo la grilla semanal da visibilidad total al bedel y al cuerpo docente, reduciendo las dudas de cursada a cero."
},
{
"id": 12,
"category": "ASEGURAMIENTO DE CALIDAD",
"title": "Estrategia de Pruebas: 131 Tests en Pytest y Auditoría SAST",
"subtitle": "Cobertura exhaustiva de contratos, algoritmos, RAG, parsers y seguridad perimetral",
"image": "capturas/06_catalogo_aulas_y_sedes.png",
"image_caption": "Catálogo de sedes y aulas validado por la suite de pruebas automatizadas",
"points": [
"131 / 131 Tests Aprobados (100% Passed): Pruebas unitarias y de integración en Pytest cubriendo contratos FastAPI, algoritmo genético y RAG.",
"Auditoría Estática SAST (Bandit): Escaneo de código fuente sobre más de 8.000 líneas de Python con cero vulnerabilidades detectadas.",
"Auditoría de Dependencias SCA: pip-audit y npm audit certificados contra la base de datos nacional de vulnerabilidades (OSV).",
"Principio 10 — Tolerancia Cero: Prohibido dar por finalizada cualquier tarea con errores en el código o en la consola."
],
"kpis": [
{"num": "131 / 131", "desc": "Tests automatizados aprobados (100%)"},
{"num": "0 Fallos", "desc": "Vulnerabilidades en escaneo Bandit SAST"},
{"num": "0 CVEs", "desc": "Alertas de seguridad en librerías"}
],
"notes": "Destacar la rigurosidad en calidad de software: 131 pruebas automáticas ejecutadas sin un solo fallo y auditorías estáticas continuas."
},
{
"id": 13,
"category": "INFRAESTRUCTURA CLOUD",
"title": "Despliegue Continuo en Producción Institucional",
"subtitle": "Servidor real activo en eduspace.oemspot.com.ar con Nginx, SSL y Proxmox LXC",
"image": "capturas/10_consola_recepcion_scanner.png",
"image_caption": "Consola de recepción operativa en tiempo real en el servidor productivo",
"points": [
"Servidor de Producción Real: Contenedor Linux LXC en nodo Proxmox VE corporativo (IP interna 10.0.0.217).",
"Dominio Oficial y SSL: Accesible públicamente en https://eduspace.oemspot.com.ar con certificado Let's Encrypt (A+).",
"Supervisión con Systemd: Servicios desacoplados admin-edu-space-backend y admin-edu-space-frontend con autorestart.",
"Base de Datos PostgreSQL 15: Instancia relacional ACID con 16 tablas y respaldos automatizados continuos."
],
"kpis": [
{"num": "99.9%", "desc": "Disponibilidad del servidor en producción"},
{"num": "SSL A+", "desc": "Calificación Qualys SSL Labs"},
{"num": "Git Dev", "desc": "Despliegue continuo con control semántico"}
],
"notes": "El sistema está funcionando en vivo. No es un proyecto que corre únicamente en la laptop del alumno, sino que está en la nube institucional de UniCABA."
},
{
"id": 14,
"category": "EVALUACIÓN Y CIERRE",
"title": "Conclusión y Demostración Práctica",
"subtitle": "Cumplimiento integral de la rúbrica de 100 puntos y salto de calidad para UniCABA",
"is_closing": True,
"author": "Carlos Facundo Tello",
"professor": "Prof. Ing. Alejandro Vázquez",
"deliverables": [
{"title": "Informe Técnico Completo", "file": "INFORME_TECNICO_PROYECTO_FINAL.md", "desc": "426 líneas de análisis arquitectónico, diagramas C4 y modelo relacional"},
{"title": "Guía de Evaluación Docente", "file": "GUIA_DEMOSTRACION_Y_EVALUACION_DOCENTE.md", "desc": "Rutas de smoke testing, cuentas por rol y endpoints OpenAPI"},
{"title": "Minutas y Gestión Ágil", "file": "MINUTAS_Y_EVIDENCIAS_GESTION_AGIL.md", "desc": "ADRs 001-005, specs SDD (001-013) y evidencias de sprints"},
{"title": "Presentación PowerPoint (16:9)", "file": "PRESENTACION_EJECUTIVA_DIAPOSITIVAS.pptx", "desc": "14 diapositivas profesionales para proyector o Google Slides"}
],
"live_demo_link": "https://eduspace.oemspot.com.ar",
"notes": "Agradecer al profesor Ing. Alejandro Vázquez por su cátedra y abrir inmediatamente la demostración en vivo siguiendo la Guía de Evaluación Docente."
}
]
HTML_TEMPLATE = """