# Guía de Demostración, Evaluación Rápida y Smoke Testing ## Asignatura: Programación de Vanguardia — Ciclo Lectivo 2026 (2° Cuatrimestre) ### Cátedra: Ing. Alejandro Vázquez — Alumno: Carlos Facundo Tello **Proyecto:** Admin Edu-Space **URL de Producción en Vivo:** [https://eduspace.oemspot.com.ar](https://eduspace.oemspot.com.ar) **Documentación OpenAPI (Swagger):** [https://eduspace.oemspot.com.ar/docs](https://eduspace.oemspot.com.ar/docs) --- ## 1. Matriz de Cuentas y Credenciales de Prueba Para evaluar la segmentación basada en roles (**RBAC**), los dashboards personalizados y las restricciones de seguridad, se encuentran configuradas y activas en producción las siguientes cuentas institucionales de prueba: | Rol Institucional | Correo / Identificador | Contraseña | Enfoque y Puntos Clave de Evaluación | | :--- | :--- | :--- | :--- | | **Administrador** | `admin@edu-space.com` | `admin123` | Cockpit global, auditoría de seguridad, gestión de usuarios/roles, configuración del Asistente IA, credenciales QR e impersonación. | | **Bedelía** | `bedelia@edu-space.com` | `bedelia123` | Circuito de 9 pasos, cartelera del día (exportar Excel / imprimir A4), grilla semanal Drag & Drop, optimizador genético de aulas. | | **Docente** | `docente@edu-space.com` | `docente123` | Portal de cátedra, enlaces Google Meet, Libro de Calificaciones (*Gradebook*) y actas inmutables. | | **Alumno (Carlos Tello)** | `carlostellocba@gmail.com` *(o DNI `34247025`)* | `34247025` | Brújula *"¿Dónde curso hoy?"*, consulta de notas personales (privacidad estricta), carnet QR rotativo cada 3s y chat UdeCi. | | **Recepción** | `recepcion@edu-space.com` | `recepcion123` | Consola de control de accesos (`/reception/scanner`), lectores seriales COM, escaneo de DNI argentino y verificación de aula. | > [!NOTE] > **Acceso de Contingencia Directo:** Si los proveedores externos no estuvieran disponibles, el Administrador puede ingresar directamente por la pasarela de emergencia local en: `https://eduspace.oemspot.com.ar/adm/login`. --- ## 2. Guía de Pruebas Rápidas Paso a Paso ### Prueba 1: Algoritmo Genético de Optimización Áulica (Problema NP-Hard) 1. Iniciar sesión como **Bedelía** (`bedelia@edu-space.com` / `bedelia123`). 2. En el menú lateral, seleccionar **"Optimizador Genético (IA)"** (o ingresar a `/genetic_optimizer`). 3. Observar los indicadores en vivo: *Comisiones Activas*, *Aulas Disponibles* y *Restricciones Duras*. 4. Pulsar el botón **"Ejecutar Optimización de Aulas"**. 5. **Resultado esperado:** En menos de 4 segundos, el motor evolutivo procesa la población de cromosomas mediante selección por torneo y cruza en dos puntos, presentando la tabla de asignaciones óptimas con **cero colisiones físicas de aula** y **cero superposiciones docentes**. --- ### Prueba 2: Interoperabilidad con Microservicios Java / Spring Boot La plataforma implementa un endpoint de sincronización interoperable con esquemas en formato *camelCase* (`SpringBootSyncPayloadDTO`), permitiendo que cualquier microservicio corporativo en Spring Boot delegue la optimización de espacios en Edu-Space. 1. Abrir la documentación interactiva en **[Swagger UI (/docs)](https://eduspace.oemspot.com.ar/docs)**. 2. Localizar el router **Optimizer & Genetic Algorithm** y el endpoint `POST /api/v1/optimizer/spring-boot/sync`. 3. Pulsar en **"Try it out"** y enviar el siguiente payload de prueba JSON representativo de Spring Boot: ```json { "requestId": "REQ-SPRING-BOOT-EVAL-2026", "academicTerm": "2026-2C", "commissions": [ { "commissionId": 901, "subjectCode": "PV-2026", "subjectName": "Programacion de Vanguardia", "studentsCount": 35, "preferredShift": "NOCHE", "weekday": "Jueves", "startTime": "18:30", "endTime": "21:30", "teacherId": 15 }, { "commissionId": 902, "subjectCode": "BD-2026", "subjectName": "Bases de Datos Avanzadas", "studentsCount": 28, "preferredShift": "NOCHE", "weekday": "Jueves", "startTime": "18:30", "endTime": "21:30", "teacherId": 22 } ], "classrooms": [ { "classroomId": 101, "name": "Aula 204 - Laboratorio", "capacity": 40, "building": "Edificio Central" }, { "classroomId": 102, "name": "Aula 301 - Teoria", "capacity": 30, "building": "Edificio Central" } ] } ``` 4. **Resultado esperado:** Retorna código `200 OK` con un payload JSON estructurado conteniendo `status: "OPTIMIZATION_COMPLETED"`, las asignaciones resueltas libres de conflicto y el cálculo de la función *fitness*. --- ### Prueba 3: Copiloto Virtual "UdeCi" con IA Local y RAG Embebido 1. Iniciar sesión como alumno con **Carlos Tello** (`carlostellocba@gmail.com` / `34247025`). 2. Abrir el asistente flotante en la esquina inferior derecha (icono de robot/chat violeta). 3. **Pregunta 1 (Contexto en Vivo de Base de Datos):** * Prompt: *"¿Dónde tengo que cursar hoy y qué materias tengo inscriptas?"* * **Resultado esperado:** UdeCi consulta en vivo PostgreSQL mediante `LiveContextService` y responde indicando el aula física exacta, el piso en la Sede Central (Perón 802) y los docentes a cargo. 4. **Pregunta 2 (RAG sobre Normativas Institucionales):** * Prompt: *"¿Cuál es la nota mínima para promocionar y cómo se calculan las actas de regularidad?"* * **Resultado esperado:** El motor RAG busca en `knowledge_chunks` y responde citando el estatuto de UniCABA (promoción directa con 7 o más en ambas instancias, regularidad con 4 o más). 5. **Pregunta 3 (Privacidad de Calificaciones):** * Prompt: *"Mostrame las notas del alumno Terzano o de otros compañeros."* * **Resultado esperado:** El sistema aplica el filtro de privacidad y responde cordialmente indicando que por políticas de seguridad de UniCABA solo puede exhibir las calificaciones propias del usuario autenticado. --- ### Prueba 4: Consola de Recepción y Parser Universal de DNI Argentino 1. Iniciar sesión como **Recepción** (`recepcion@edu-space.com` / `recepcion123`) o ingresar a `/reception/scanner`. 2. Probar la simulación de lectura con los siguientes casos de prueba en el campo del lector: * **Caso A (DNI con puntos):** Tipear o pegar `34.247.025` y presionar Enter. * **Resultado:** Cuadro esmeralda `border-success`, sonido armónico ascendente, muestra a *Carlos Facundo Tello*, confirmando su estado de alumno regular y detallando el **aula física asignada y piso para hoy**. * **Caso B (Formato Renaper 2026 QR con JWT embebido):** Pegar la cadena: ```text 00749743816"TELLO"CARLOS FACUNDO"34247025"G"09-02-89"23-04-26"eyJhbGciOiJSUzI1NiJ9.eyJzdWIiOiIzNDI0NzAyNSJ9.test ``` * **Resultado:** El parser universal extrae de forma instantánea el número `34247025` en la posición 3, asociando de inmediato al usuario en pantalla. * **Caso C (Formato PDF417 de libreta antigua con prefijo alfabético):** Pegar: ```text "f5592570 "A"1"SAUCEDO"LILIANA"... ``` * **Resultado:** El parser filtra el prefijo `F` y extrae el documento `5592570`. * **Caso D (Normalización de pistola con teclado español):** Pegar `UNICABAÑUSRÑ144ÑDNIÑ34247025`. * **Resultado:** Traduce `Ñ` a `:` en los tags de protocolo sin alterar los apellidos y valida al usuario. --- ### Prueba 5: Credencial Digital QR Dinámica Anti-Captura 1. Desde el perfil de **Carlos Tello** o la barra lateral, hacer clic en el botón de credencial (`bi-qr-code-scan`) o navegar a `/credential/my-card`. 2. **Resultado esperado:** * Se visualiza el carnet universitario oficial de UniCABA con el código QR activo. * **Rotación automática:** Cada **3 segundos**, una barra de progreso animada avanza y el código QR se regenera con un nuevo token JWT criptográfico (`jti`, `iat`). * **Protección anti-screenshot:** Si se intenta reutilizar un token después de 6 segundos, el backend lo rechaza por firma expirada (`jwt.ExpiredSignatureError`). --- ### Prueba 6: Cartelera Operativa y Exportación A4 / Excel 1. Ingresar como **Bedelía** a `/schedule/today_schedule`. 2. Probar los switchers de período: *"Día (Hoy)"*, *"Mañana"*, *"Esta Semana"* y *"Este Mes"*. 3. Pulsar en **"Excel / CSV"**: descarga un archivo `.csv` con BOM UTF-8 y delimitadores `;` que abre perfectamente formateado en Microsoft Excel en español. 4. Pulsar en **"Imprimir"**: activa el diálogo de impresión con estilos CSS `@media print`, presentando la grilla limpia en hoja A4 con membrete institucional de UniCABA. --- ### Prueba 7: Ejecución Local de la Suite de 131 Pruebas Automatizadas Para verificar la integridad técnica de todo el backend en un entorno de desarrollo local: ```powershell cd backend $env:PYTHONPATH="." .\venv\Scripts\pytest tests -v ``` **Resultado esperado:** ```text ======================= 131 passed in 96.01s (0:01:36) ======================= ``` Cero errores y 100% de éxito en la totalidad de los contratos, algoritmos genéticos, parsers y servicios de dominio.