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

161 lines
8.9 KiB
Markdown

# 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.