Files
admin-edu-space/docs/entregables
..

Carpeta de Entregables Oficiales — Trabajo Práctico Integrador

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
Fecha Límite de Entrega: 12 de Noviembre de 2026
Proyecto: Admin Edu-Space (Plataforma Inteligente de Gestión Áulica, Asistencia IA y Control de Accesos)
Entorno Productivo en Vivo: https://eduspace.oemspot.com.ar
Repositorio Oficial: Rama dev


📂 Contenido del Paquete de Entrega

Esta carpeta reúne la totalidad de los componentes exigidos en la consigna del Trabajo Práctico Integrador de la cátedra, organizados según los criterios de la Rúbrica de Corrección de 100 Puntos:

Archivo / Documento Descripción y Alcance Entregable Asociado
INFORME_TECNICO_PROYECTO_FINAL.md Informe Técnico y Memoria Académica Integral (PDF-ready).
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 Guión y Estructura de Presentación Ejecutiva (PPT / Canva / Marp).
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
GUIA_DEMOSTRACION_Y_EVALUACION_DOCENTE.md Guía de Evaluación Rápida para el Docente (Smoke Test & RAG/API Test).
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 Evidencias de Gestión Ágil y Metodología SDD (Spec-Driven Development).
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 Galería de Capturas de Pantalla en Alta Resolución.
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

🎯 Resumen de la Propuesta Superadora

La consigna solicitaba inicialmente una división entre un microservicio en Java (Spring Boot) para lógica de negocio y un microservicio en Python para analítica predictiva. Como resultado de un análisis riguroso de arquitectura, desempeño en la nube y requerimientos de la comunidad universitaria de UniCABA, se desarrolló una solución arquitectónica superadora de grado industrial:

  1. Microservicio 1 (BFF & Web Gateway en Node.js 20 LTS + Express 5):

    • Capa de mediación y orquestación web con renderizado del lado del servidor (SSR con Nunjucks).
    • Gestión de sesiones criptográficas con cookies seguras HttpOnly, aislamiento de seguridad (Helmet, Rate Limiting).
    • Integración nativa de hardware con la Web Serial API para lectura en tiempo real de pistolas ópticas y escáneres COM de molinetes.
    • Huella de memoria mínima (~45 MB de RAM vs. los ~600 MB a 1 GB que requeriría una instancia tradicional de Spring Boot).
  2. Microservicio 2 (Core Transaccional de Alta Concurrencia en Python 3.12+ / FastAPI ASGI):

    • API RESTful modular y 100% asíncrona sobre FastAPI y SQLAlchemy 2.0 ORM (erradicando frameworks monolíticos legacy).
    • Tipado estricto y contratos con Pydantic v2 (BaseModel, Field) y documentación interactiva autogenerada en /docs (Swagger UI).
    • Autenticación híbrida: Google Workspace OAuth 2.0 institucional (@unicaba.edu.ar), Moodle 4.1 SSO y tokens JWT stateless.
  3. Motor Heurístico Predictivo (Algoritmo Genético Áulico):

    • Resolución de un problema computacional NP-Hard: optimización de asignaciones cuatrimestrales mediante algoritmos evolutivos (selección por torneo, cruza en 2 puntos, mutación adaptativa y función fitness multiobjetivo con penalizaciones duras y blandas).
    • Generación de cronogramas sin solapamientos en menos de 5 segundos para más de 200 comisiones.
  4. Incorporación Pionera de Inteligencia Artificial Local (LLMs) & RAG Embebido ("UdeCi"):

    • Superando con creces la exigencia de un simple predictor estadístico, se diseñó e integró un asistente de IA institucional local:
      • Conexión asíncrona no bloqueante (httpx.AsyncClient, timeout 600s) con servidores de inferencia locales (llama.cpp, Ollama) ejecutando modelos como Qwen 2.5 / 3 Coder 30B.
      • Arquitectura RAG (KnowledgeChunk) sobre normativas académicas, correlatividades y estatutos de UniCABA.
      • Inyección de Contexto en Vivo de Base de Datos (LiveContextService) con estricta privacidad de calificaciones.
      • Blindaje Perimetral (prompt_security.py) contra inyecciones de prompt y jailbreaks.
      • Servidor MCP (/api/v1/mcp) compatible con el estándar Model Context Protocol.
  5. Interoperabilidad Total con Ecosistemas Java / Spring Boot:

    • Para garantizar paridad con entornos empresariales que utilicen Spring Boot, el sistema cuenta con contratos DTO normalizados (SpringBootSyncPayloadDTO, SpringBootCommissionDTO, SpringBootClassroomDTO) y expone el endpoint POST /api/v1/optimizer/spring-boot/sync, permitiendo a backends en Java delegar el cálculo genético y recibir las asignaciones optimizadas.
  6. Control de Accesos Físicos, Multi-Serial COM y Reconocimiento de DNI Argentino:

    • Consola de recepción (/reception/scanner) con soporte para hasta 4 lectores seriales físicos simultáneos (Web Serial API).
    • Parser universal de DNI argentino (Renaper 2026 QR con JWT, 2012 PDF417, 2009 F/M, Mi Argentina y número directo con/sin puntos).
    • Credencial digital universitaria con código QR auto-rotativo cada 3 segundos y ventana de gracia estricta (anti-captura de pantalla).
  7. Despliegue Real en Producción Institucional:

    • Desplegado y operativo en la infraestructura institucional de UniCABA sobre un Contenedor Linux LXC en Proxmox (10.0.0.217), bajo proxy inverso Nginx con terminación SSL (Let's Encrypt), base de datos PostgreSQL 15, supervisión de servicios bajo systemd y 131 pruebas automatizadas aprobadas al 100% en pytest.

🔗 Accesos Directos de Evaluación