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

8.9 KiB

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
Documentación OpenAPI (Swagger): 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).
  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:
{
  "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"
    }
  ]
}
  1. 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:
    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:
    "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:

cd backend
$env:PYTHONPATH="."
.\venv\Scripts\pytest tests -v

Resultado esperado:

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