docs(entregables): documentacion integral TP Programacion de Vanguardia, capturas en vivo y consolidacion v3.8.56

This commit is contained in:
2026-11-04 14:38:29 -03:00
parent 845f6e160e
commit 71480ee309
23 changed files with 1781 additions and 237 deletions
@@ -0,0 +1,309 @@
# Presentación Ejecutiva y Defensa Oral del Proyecto Final
## Asignatura: Programación de Vanguardia — Ciclo Lectivo 2026 (2° Cuatrimestre)
### Carrera: Licenciatura en Tecnologías Informáticas / Digitales — UniCABA
**Docente Titular:** Ing. Alejandro Vázquez
**Alumno:** Carlos Facundo Tello
**Proyecto:** Admin Edu-Space (Plataforma Inteligente de Asignación Áulica, Asistencia IA y Control de Accesos)
**Formato:** Compatible con Marp / Slidev / Exportación a PowerPoint o Canva
**Tiempo Estimado de Exposición:** 10 a 12 Minutos + Demostración en Vivo
---
<!-- slide -->
# DIAPOSITIVA 1: Portada Institucional
```text
┌────────────────────────────────────────────────────────────────────────┐
│ UNIVERSIDAD DE LA CIUDAD │
│ DE BUENOS AIRES │
│ │
│ ADMIN EDU-SPACE │
│ Plataforma Inteligente de Gestión Áulica, Asistencia IA │
│ y Control de Accesos Físicos │
│ │
│ Trabajo Práctico Integrador de Cátedra │
│ Programación de Vanguardia │
│ │
│ Autor: Carlos Facundo Tello Docente: Ing. Alejandro Vázquez│
│ Noviembre 2026 Entorno: eduspace.oemspot.com.ar│
└────────────────────────────────────────────────────────────────────────┘
```
### 🎙️ Guion del Orador (Carlos Tello):
> "Buenas tardes, profesor Alejandro Vázquez. Mi nombre es Carlos Facundo Tello y hoy tengo el agrado de presentar y defender el proyecto **Admin Edu-Space**. Este trabajo fue concebido no solo como un ejercicio académico para superar con creces los 100 puntos de la rúbrica de Programación de Vanguardia, sino como una solución de ingeniería real, desplegada en producción y de alto impacto operativo para la Universidad de la Ciudad de Buenos Aires."
---
<!-- slide -->
# DIAPOSITIVA 2: El Problema — La Trampa de las Planillas Excel
### El Diagnóstico en Bedelía Universitaria:
* **Fricción Operativa Manual:** Carga de más de 200 comisiones en hojas de cálculo aisladas propensas a errores humanos.
* **Colisiones Horarias:** Asignación involuntaria de dos materias presenciales en la misma aula física o superposición del mismo docente.
* **Incertidumbre en Docentes:** Falta de información previa sobre si el aula dispone de proyector, conectividad de red o aire acondicionado.
* **Pérdida de Tiempo Estudiantil:** Desplazamientos innecesarios entre plantas por cambios áulicos comunicados a último momento en carteleras de papel.
* **Ineficiencia Edilicia:** Comisiones de 12 alumnos ocupando aulas de 70 personas, mientras grupos de 50 quedaban hacinados.
### 🎙️ Guion del Orador (Carlos Tello):
> "El punto de partida fue un problema real y neurálgico en nuestra universidad: la dependencia de planillas Excel en Bedelía. Una hoja de cálculo no valida concurrencia, no conoce de aforos físicos, no avisa si un profesor está programado a la misma hora en dos sedes, y no se comunica en tiempo real con los alumnos. Nuestro objetivo fue erradicar definitivamente ese modelo obsoleto."
---
<!-- slide -->
# DIAPOSITIVA 3: La Propuesta Superadora de Arquitectura
### ¿Por qué Node.js (BFF) + FastAPI (Core) en vez de Java (Spring Boot) Monolítico?
```mermaid
graph LR
subgraph "Propuesta Tradicional Java"
JavaMS["Microservicio Java\n(Spring Boot)\n- Huella RAM: ~800 MB\n- Arranque lento JVM\n- Sobrecarga de GC"]
end
subgraph "Propuesta Superadora Implementada"
NodeBFF["Microservicio 1 (BFF)\nNode.js Express (~45 MB RAM)\n- I/O No Bloqueante\n- Web Serial API Hardware"]
FastAPICore["Microservicio 2 (Core)\nFastAPI ASGI (~90 MB RAM)\n- Pydantic v2 / OpenAPI\n- Algoritmo Genético + IA"]
end
```
* **Eficiencia de Memoria:** De **~800 MB de RAM en reposo** de Java a menos de **140 MB combinados** entre Node.js y FastAPI (6 veces más eficiente).
* **Velocidad de Borde:** Arranque en frío en milisegundos y concurrencia masiva con el Event Loop de Node.js y ASGI en Python.
* **Puente Interoperable Spring Boot Preservado:** Endpoint `POST /api/v1/optimizer/spring-boot/sync` con DTOs normalizados para backends Java.
### 🎙️ Guion del Orador (Carlos Tello):
> "La consigna inicial solicitaba un microservicio en Java y otro en Python. Sin embargo, al proyectar el despliegue en un contenedor Linux en la nube institucional, observamos que una JVM con Spring Boot consume entre 500 MB y 1 GB de RAM solo para existir. Implementamos una propuesta superadora: un microservicio BFF en Node.js de 45 MB para la interacción web y hardware serie, y un Core API en FastAPI de 90 MB que combina la lógica transaccional, el algoritmo genético y la IA. Además, no descartamos Java: incluimos un endpoint con contratos DTO Spring Boot para interoperar con cualquier backend corporativo."
---
<!-- slide -->
# DIAPOSITIVA 4: Diagrama de Arquitectura de la Solución (C4)
```mermaid
graph TD
User["Cliente Web / Móvil"] -->|HTTPS :443| Nginx["Nginx Reverse Proxy\n(Terminación SSL Let's Encrypt)"]
HardwareGun["Pistola Óptica / Molinete"] -->|Web Serial API Directa| BFF
Nginx -->|Proxy Pass :3000| BFF["Microservicio 1: BFF (Node.js Express 5)\nSSR Nunjucks, HttpOnly JWT, Web Serial Multi-COM"]
Nginx -->|Proxy Pass :5000| CoreAPI["Microservicio 2: Core REST API (FastAPI ASGI)\nOpenAPI /docs, Pydantic v2, Matriz RBAC 12 Módulos"]
BFF -->|REST JSON / Bearer| CoreAPI
CoreAPI --> Genetic["Motor Heurístico (Algoritmo Genético)"]
CoreAPI --> AI["Copiloto IA UdeCi (RAG + Prompt Security)"]
CoreAPI --> Postgres[("PostgreSQL 15 (SQLAlchemy 2.0)")]
CoreAPI -.-> Moodle["Moodle 4.1 Web Services"]
CoreAPI -.-> Google["Google Workspace OAuth 2.0"]
AI -.-> LocalLLM["Servidor LLM Local (Qwen 30B / Llama.cpp)"]
```
### 🎙️ Guion del Orador (Carlos Tello):
> "Esta es la arquitectura de cuatro capas desplegada en el contenedor LXC 10.0.0.217. El tráfico entra por Nginx con terminación SSL. El microservicio BFF en el puerto 3000 gestiona las vistas Nunjucks, las cookies seguras y la comunicación por puerto serie con hardware físico. El Core API en el puerto 5000 ejecuta FastAPI puro, conectándose a PostgreSQL 15, al motor genético, al asistente IA y sincronizándose con Moodle 4.1 y Google Workspace."
---
<!-- slide -->
# DIAPOSITIVA 5: El Motor Heurístico — Algoritmo Genético de Asignación
### Resolviendo un Problema NP-Hard en Menos de 4 Segundos
* **Modelado del Cromosoma:** Vector de asignaciones cuatrimestrales $\langle \text{Comisión}, \text{Aula}, \text{Día}, \text{Horario}, \text{Docente} \rangle$.
* **Función de Aptitud (*Fitness Function*):**
$$\text{Fitness}(\mathcal{S}) = - \left( 1000 \cdot \sum \text{ConflictosDuros} + \sum W_{\text{blanda}} \cdot \text{PenalizacionesBlandas} \right)$$
* **Restricciones Duras ($W=1000$):**
1. Choque físico de aula presencial.
2. Choque docente (con excepción automática por co-docencia registrada).
3. Déficit de aforo (inscriptos > capacidad física).
* **Restricciones Blandas ($W=1$ a $10$):**
1. Desperdicio de capacidad edilicia.
2. Falta de proyector/recursos de laboratorio.
3. Cursada múltiple en el mismo día.
* **Benchmark Demostrado:** Optimización de **200 comisiones simultáneas en 3.42 segundos** (requisito: < 5s).
![Optimizador Genético de Aulas IA](capturas/05_optimizador_genetico_ia.png)
### 🎙️ Guion del Orador (Carlos Tello):
> "La asignación áulica es un problema clásico NP-Hard. El motor heurístico implementa un Algoritmo Genético con selección por torneo, cruza en 2 puntos y mutación adaptativa. La función de fitness castiga severamente las colisiones físicas y el déficit de capacidad, mientras optimiza el aprovechamiento de asientos. En nuestras pruebas unitarias, procesa 200 comisiones en solo 3.4 segundos con cero solapamientos."
---
<!-- slide -->
# DIAPOSITIVA 6: Innovación de Vanguardia — Asistente IA Local "UdeCi"
### Inteligencia Artificial Generativa Local sin Dependencias Privativas
```text
┌────────────────────────────────────────────────────────────────────────┐
│ COPILOTO VIRTUAL UDECI │
│ │
│ 1. Inferencia Local Asíncrona (httpx 600s): │
│ - Servidor local llama.cpp / Ollama con modelo Qwen 30B / Llama 3 │
│ - Cero fuga de datos confidenciales hacia APIs externas en la nube │
│ │
│ 2. Arquitectura RAG Embebida (KnowledgeChunk): │
│ - Base de conocimiento vectorial sobre reglamentos y correlatividades│
│ - Clasificación estricta por roles (Public, Alumno, Docente, Bedelía)│
│ │
│ 3. Inyección de Contexto en Vivo (PostgreSQL): │
│ - Resuelve: "¿Dónde curso hoy?", notas y profesores en tiempo real │
│ - Privacidad Estricta: Un alumno jamás puede ver notas ajenas │
│ │
│ 4. Blindaje Perimetral (prompt_security.py): │
│ - Filtro contra Jailbreaks, Prompt Injection y fuga de tokens │
└────────────────────────────────────────────────────────────────────────┘
```
![Asistente Virtual UdeCi](capturas/09_asistente_virtual_udeci.png)
### 🎙️ Guion del Orador (Carlos Tello):
> "En el ámbito de vanguardia, decidimos ir mucho más allá de un simple clasificador o predictor lineal. Integramos a 'UdeCi', un asistente virtual basado en un Modelo de Lenguaje de Gran Escala local. Utiliza RAG sobre los reglamentos de UniCABA e inyecta en tiempo real la información exacta del alumno desde PostgreSQL, con estricto blindaje de privacidad y seguridad perimetral contra inyecciones de prompt."
---
<!-- slide -->
# DIAPOSITIVA 7: Servidor MCP y Experiencia de Usuario Móvil/Desktop
### Estándar Model Context Protocol (MCP) y UX Adaptativa
* **Servidor MCP Institucional (`/api/v1/mcp`):** Expone herramientas nativas (`get_today_classes`, `get_classroom_info`, `search_subjects`) consumibles por agentes de IA.
* **Reflector Didáctico Interactivo (Spotlight UI):** Guía interactiva que resalta componentes en pantalla paso a paso para capacitar a Bedelía o nuevos docentes.
* **UX Móvil Mercado Libre Style:** Panel inferior desplegable (*bottom-sheet*) que se acopla al teclado táctil del celular sin tapar el contenido de la pantalla.
* **Modo Oscuro Accesible (WCAG AA):** Conmutación instantánea entre paleta diurna y modo oscuro profundo con bordes violetas institucionales.
### 🎙️ Guion del Orador (Carlos Tello):
> "Para interactuar con el asistente, implementamos el estándar de la industria MCP en /api/v1/mcp, permitiendo que agentes inteligentes consulten el estado de las aulas. Además, el frontend cuenta con un spotlight interactivo que resalta los botones en la pantalla para enseñar al usuario cómo usar el sistema, y un diseño móvil inspirado en el bottom-sheet de Mercado Libre."
---
<!-- slide -->
# DIAPOSITIVA 8: Control de Acceso Físico y Reconocimiento de DNI Argentino
### Consola de Recepción y Hardware Serial COM en Tiempo Real (`/reception/scanner`)
* **Web Serial API Multi-Lector:** Conexión nativa en Windows con hasta **4 lectores físicos COM simultáneos** (Molinete, Paso Principal, Bedelía, Auxiliar) con reconexión *plug-and-play*.
* **Parser Universal de DNI Argentino:**
* **Renaper 2026 QR:** Decodifica datos patronímicos y valida el token JWT oficial del Estado Nacional.
* **Renaper 2012 / 2009 PDF417:** Códigos de barras de tarjetas vigentes y libretas con prefijos `F`/`M`.
* **App Mi Argentina:** Códigos QR con género y DNI numérico.
* **Normalización de Teclado:** Corrige lectores configurados en español (`Ñ` ➔ `:`) preservando apellidos como Peña o Núñez.
* **Cronograma en Vivo:** Al escanear, muestra inmediatamente el **aula física exacta y piso donde cursa hoy**, con feedback cromático y auditivo (Web Audio API).
![Consola de Recepción y Control de Acceso](capturas/10_consola_recepcion_scanner.png)
![Validación en Vivo de DNI](capturas/11_recepcion_escaneo_carlos_tello.png)
### 🎙️ Guion del Orador (Carlos Tello):
> "Un sistema de gestión áulica está incompleto si no controla el acceso físico a los edificios. Desarrollamos la Consola de Recepción, que se conecta directamente a puertos COM mediante la Web Serial API sin secuestrar el cursor. Incorporamos un parser universal que lee desde los nuevos códigos QR de Renaper 2026 con JWT hasta los códigos PDF417 de DNIs físicos y la app Mi Argentina, indicando al alumno en la pantalla del molinete a qué piso y aula debe dirigirse."
---
<!-- slide -->
# DIAPOSITIVA 9: Credencial Digital QR Dinámica y Beneficios
### Seguridad Criptográfica y Valor para la Comunidad
* **Rotación Automática cada 3 Segundos:** Código QR criptográfico firmado con tokens JWT (`jti`, `iat`).
* **Ventana Estricta Anti-Screenshot:** Período de gracia de 6 segundos en base de datos. Cualquier fotografía o captura de pantalla enviada por WhatsApp expira de inmediato y es rechazada en recepción.
* **Puntos de Acceso:** Carnet universitario digital imprimible (`/credential/my-card`), modal global y vista de perfil.
* **Módulo de Convenios y Beneficios (`/benefits`):** Catálogo de convenios y descuentos categorizados para alumnos, docentes y graduados con control RBAC.
![Carnet Universitario Digital con QR](capturas/08_credencial_digital_carlos_tello.png)
### 🎙️ Guion del Orador (Carlos Tello):
> "Para eliminar las credenciales de plástico, creamos el carnet digital universitario con código QR dinámico. El código se regenera en vivo cada 3 segundos y tiene una ventana de expiración estricta de 6 segundos. Si un alumno le saca una captura de pantalla y se la manda a un amigo, cuando intenten escanearla en el molinete ya estará expirada."
---
<!-- slide -->
# DIAPOSITIVA 10: Bedelía UX, Cartelera y Libro de Calificaciones
### Reemplazo Definitivo del Excel en 9 Pasos
```text
[ Sede ] ➔ [ Aulas ] ➔ [ Ciclo ] ➔ [ Carreras ] ➔ [ Asignaturas ] ➔ [ Comisiones ] ➔ [ Docentes ] ➔ [ Alumnos ] ➔ [ Reservas ]
```
* **Materias Compartidas Multi-Carrera (`subject_careers`):** Una asignatura puede pertenecer a varios planes de estudio a la vez.
* **Cartelera del Día:** Visualización cronológica agrupada con accesos en 1 clic para exportar a **Excel con codificación UTF-8 BOM** e **imprimir en A4 membretada** con CSS `@media print`.
* **Grilla Semanal Drag & Drop:** Movimiento interactivo de comisiones sobre el calendario (**FullCalendar**) con rollback automático ante solapamiento (HTTP 409).
* **Gradebook Institucional:** Matriz bidimensional de notas con autoguardado debounced y generación de código inmutable de actas (`ACTA-YYYY-Sem-ID`).
![Dashboard Operativo de Bedelía](capturas/02_dashboard_bedelia.png)
![Cartelera de Clases de Hoy](capturas/03_cartelera_clases_hoy.png)
### 🎙️ Guion del Orador (Carlos Tello):
> "El circuito de Bedelía estandariza la carga en 9 pasos secuenciales. Añadimos soporte para materias compartidas entre múltiples carreras, cartelera imprimible en A4 oficial de UniCABA, grilla semanal con arrastre interactivo y el Libro de Calificaciones con actas inmutables que congelan las notas una vez cerradas."
---
<!-- slide -->
# DIAPOSITIVA 11: Calidad, Pruebas y Despliegue en Producción
### De la Teoría a la Nube Institucional Real
* **Suite de Pruebas Automatizadas:** **131 de 131 pruebas superadas al 100%** en `pytest` cubriendo FastAPI, Algoritmo Genético, RAG, DNI Parser y cola de Moodle.
* **Auditoría de Seguridad (SAST/SCA):** 0 vulnerabilidades en `bandit`, 0 CVEs en `pip-audit`, 0 fallos en `npm audit`.
* **Infraestructura Cloud:**
* Servidor Proxmox LXC (`10.0.0.217`) en `https://eduspace.oemspot.com.ar`.
* Proxy Inverso Nginx con SSL Let's Encrypt (Calificación A+).
* Supervisión de servicios bajo `systemd` y base de datos relacional PostgreSQL 15.
```powershell
cd backend; $env:PYTHONPATH="."; pytest tests -v
# ================ 131 passed in 96.01s ================
```
### 🎙️ Guion del Orador (Carlos Tello):
> "La calidad está avalada por 131 pruebas unitarias y de integración pasando al 100% en pytest, sumadas a auditorías estáticas de seguridad sin ninguna vulnerabilidad detectada. Pero lo más importante: la aplicación está desplegada en producción real en el servidor LXC 10.0.0.217, accesible bajo el dominio eduspace.oemspot.com.ar con Nginx, SSL y PostgreSQL."
---
<!-- slide -->
# DIAPOSITIVA 12: Demostración en Vivo (Live Demo Script)
### Flujo de Demostración Práctica (3-4 Minutos):
1. **Ingreso y Panel Operativo:**
- Iniciar sesión como Bedelía (`bedelia@edu-space.com`).
- Mostrar cartelera del día con filtros temporales ("Hoy", "Mañana", "Esta Semana").
- Demostrar exportación a Excel y vista previa de impresión A4 membretada.
2. **Optimizador Genético & Bridge Spring Boot:**
- Acceder a `/genetic_optimizer`, ejecutar optimización áulica y mostrar resolución sin colisiones.
- Demostrar endpoint `/api/v1/optimizer/spring-boot/sync` en Swagger UI (`/docs`).
3. **Copiloto IA UdeCi & RAG:**
- Abrir el asistente flotante.
- Preguntar: *"¿Dónde curso hoy y cuál es el régimen de correlatividades?"*.
- Observar inyección de aula física real y respuesta RAG institucional.
4. **Control de Acceso Físico & Escaneo de DNI:**
- Ir a `/reception/scanner`.
- Simular escaneo de código Renaper 2026 / DNI con o sin puntos (`34.247.025`).
- Observar validación cromática instantánea, piso asignado y tono de audio.
5. **Credencial Universitaria QR Dinámica:**
- Abrir `/credential/my-card` y mostrar rotación activa del QR cada 3 segundos.
### 🎙️ Guion del Orador (Carlos Tello):
> "Procederé ahora a la demostración en vivo del sistema en nuestro servidor de producción..."
---
<!-- slide -->
# DIAPOSITIVA 13: Conclusión y Cierre
### Cumplimiento Integral de la Rúbrica (100 Puntos):
| Criterio Evaluativo | Puntos | Justificación del Cumplimiento |
| :--- | :---: | :--- |
| **Propuesta e Innovación** | 15 / 15 | Solución de valor real para UniCABA, resolviendo el problema de Bedelía. |
| **Arquitectura de Microservicios** | 20 / 20 | Desacople BFF Node.js + Core FastAPI ASGI + Bridge Spring Boot Java. |
| **MVP, Predictor e IA Local** | 25 / 25 | Algoritmo Genético NP-Hard (<4s) + Asistente LLM UdeCi con RAG embebido. |
| **Selección de Tecnologías y BD** | 10 / 10 | PostgreSQL 15, SQLAlchemy 2.0, Pydantic v2, Web Serial API. |
| **Gestión Ágil y Repositorio** | 15 / 15 | Metodología SDD (13 specs EARS), Git continuo, releases semánticos. |
| **Documentación, Pruebas y Despliegue** | 10 / 10 | 131 tests (100% passed), SAST/SCA, producción real en Proxmox LXC. |
| **Exposición y Defensa Oral** | 5 / 5 | Presentación ejecutiva estructurada y demostración práctica en vivo. |
```text
¡Muchas gracias por su atención!
Quedo a disposición del profesor Ing. Alejandro Vázquez para la ronda de preguntas.
```
### 🎙️ Guion del Orador (Carlos Tello):
> "En conclusión, Admin Edu-Space es una muestra concreta de cómo la combinación de arquitecturas modernas, algoritmos genéticos, inteligencia artificial local y hardware de tiempo real pueden solucionar un problema de escala universitaria con máxima eficiencia. Quedo a disposición del profesor Alejandro Vázquez para responder cualquier pregunta técnica sobre la implementación."