Files
admin-edu-space/docs/entregables/README.md
T

74 lines
7.4 KiB
Markdown

# 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](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_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** |
| **[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** |
---
## 🎯 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
* **Plataforma Productiva:** [https://eduspace.oemspot.com.ar](https://eduspace.oemspot.com.ar)
* **Documentación Interactiva Swagger UI:** [https://eduspace.oemspot.com.ar/docs](https://eduspace.oemspot.com.ar/docs)
* **Documentación ReDoc:** [https://eduspace.oemspot.com.ar/redoc](https://eduspace.oemspot.com.ar/redoc)
* **Verificación de Versión Pública:** [https://eduspace.oemspot.com.ar/version](https://eduspace.oemspot.com.ar/version)