fix(optimizer): implementar endpoints POST /api/genetic y proxy Express (v3.8.9)

This commit is contained in:
2026-10-23 17:16:48 -03:00
parent 7da12d90cc
commit e89f1b0457
10 changed files with 395 additions and 25 deletions
+9 -6
View File
@@ -9,12 +9,15 @@ Memoria del proyecto entre sesiones para la rama `dev`.
- Libro de Calificaciones (*Gradebook*) con actas de regularidad inmutables.
- Autenticación híbrida (Google OAuth 2.0, Moodle SSO, Local) y Modo Impersonación.
- Reinicialización segura del sistema con contraseña de Administrador.
- **Sprint Activo: Corrección de Plantillas Nunjucks (Duplicate extra_css) — v3.8.8**:
- **Corrección de Plantillas Frontend**:
- Reparado error de renderizado en `frontend/views/base.html`: eliminada la definición duplicada de `{% block extra_css %}` en la línea 32, preservando la definición canónica en la línea 876 antes de `</head>`.
- Corregida la expresión de corte de texto en `frontend/views/admin/users/list.html` con `.slice(0, 16)`.
- Verificada la compilación exitosa del 100% de las plantillas `.html` mediante suite de escaneo Nunjucks.
- **Versión Consolidada**: `v3.8.8`.
- **Sprint Activo: Endpoints y Proxy de Optimización Genética (/api/genetic) — v3.8.9**:
- **Endpoints de Algoritmo Genético en FastAPI (`/api/genetic`)**:
- Implementado `POST /api/genetic/preview-optimization` para cálculo preliminar de aptitud (fitness), resumen de comisiones y reporte de colisiones estimadas.
- Implementado `POST /api/genetic/optimize` para ejecución de generaciones evolutivas concurrentes y propuesta de reservas.
- Implementado `POST /api/genetic/apply-optimization` para confirmación y persistencia de reservas en base de datos.
- Definidos esquemas Pydantic DTO con tipado fuerte (`GeneticPreviewRequestDTO`, `GeneticOptimizeRequestDTO`, `GeneticApplyRequestDTO`).
- **Proxy Inverso en Frontend Express BFF**:
- Configurado enrutador `/api/genetic` en `frontend/src/app.js` con inyección transparente de token Bearer para llamadas AJAX del navegador (`genetic-algorithm.js`), subsanando el error 404 (Not Found).
- **Versión Consolidada**: `v3.8.9`.
## Decisiones (y por qué)
- **Flujo Secuencial de Bedelía (9 Pasos)**: Estandarizar la carga operativa en: 1) Sede -> 2) Aula -> 3) Ciclo Lectivo -> 4) Carrera -> 5) Materia (vinculada a Carrera) -> 6) Comisión (asociada a Materia, Carrera y Ciclo) -> 7) Profesores -> 8) Alumnos -> 9) Reserva de Espacio. Esto asegura consistencia e integridad relacional.