""" 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 = """ Admin EduSpace — Presentación Ejecutiva Final
Admin EduSpace
Defensa Final de Cátedra • UniCABA 2026
01 / 14
Notas de Orador
""" def main(): os.makedirs(os.path.dirname(OUTPUT_HTML), exist_ok=True) with open(OUTPUT_HTML, "w", encoding="utf-8") as f: f.write(HTML_TEMPLATE) print(f"[+] Presentación HTML Interactiva regenerada con éxito en {OUTPUT_HTML}!") if __name__ == "__main__": main()